Skip to main content

Setup

Introduction​

Dimension Fishing is a fancy new feature which allows players to fish inside lava or the end's void!

All configs are located under dimension-fishing inside config.yml.

Configuration​

Permission​

This is the permission the player needs to have to start this type of fishing.

If the player does not have it, the hook will act like vanilla.

Allowed Worlds​

This is a list of worlds this type of fishing is enabled in.

If this is missing or empty, the plugin will default to the following:

  • Void is enabled in worlds with the THE_END environment.
  • Lava is enabled in worlds with the NETHER environment.

Swallow Sound​

This sound is played when the player misses the fish and the hook is "swallowed" by the lava or void.

It follows the same format as the Sound RewardType.

Bite Sound​

This sound is played when the fish bites the hook.

It follows the same format as the Sound RewardType.

Lure Particles​

These particles are shown when the fish is being lured towards the hook.

It is configured in a map format, so you can stack as many particles as you'd like.

  • particle is the type of particle to use. See the Paper JavaDocs for a full list.
  • amount is the amount to show at the same time. This will allow you to stack the same particle on top of itself.
  • color - If the particle says it uses Color, Spell, or DustOptions, you can use this config. Example: color: "#55FFFF".
  • color-transition - If the particle uses DustTransition, you can use this config. Example: color-transition: "#55FFFF,#FF55FF,10".
  • data - Allows control over the DataType a particle might need. This is shown on the JavaDoc page linked above.
    • For BlockData, you need to provide a block Material: data: cobblestone.
    • For ItemStack, you need to provide an item Material: data: diamond_pickaxe.
    • For Float, you provide a float value: data: 1.0.
    • For Integer, you provide an integer value: data: 1.
    • Unsupported types are: Vibration, Trail, Geyser, GeyserBase.

If particles are set up incorrectly, you will be warned in console, and they will no longer be shown. When a player runs the reload command, all particles are spawned at their current location to filter out broken ones.

Explanation​

Lava Fishing​

Lava fishing is done by casting your fishing hook into lava.

If you fail to catch a fish, the hook will burn in the lava and play a burning sound (configurable).

Void Fishing​

Void fishing is done by casting your fishing hook into the “void".

Despite the name, the void is not required. When the hook is cast, a random number between 4 and 6 is chosen. The hook is considered “void fishing” once it falls that many blocks below the player.

If you fail to catch a fish, the hook will be teleported away (destroyed) and play a teleport sound (configurable).