HomeJavaModsFish Replacer
Fish Replacer
title.png

Do you have an enchantment's system and don't want your players to catch enchanted books by fishing?
Do you want players to be able to fish fantastic custom items?
Do you want players to be able to fish only fish?
Do you want to give your players the opportunity to fish for unique items?
Do you want to execute custom commands when a player is fishing?

Fish Replacer will allow you to have full control over fishing inside your server! You'll have access to all the standard drops, edit and replace them as you like. It's user friendly and intuitive.

Important: Fish Replacer fully supports only Spigot 1.13 and newer versions. It can also work with older versions, but not all the features will be available (fishes CANNOT be edited).

features.png
  • Replace fished objects​
  • Create and use custom objects​
  • Remove vanilla standard drop​
  • Run custom commands when you're fishing something​
  • Change the drop experience​
  • Change the drop durability​
  • Change the drop enchantment​
  • Send personalized messages when a player fishes an entity​
  • Show text title when an enitity is fished​
  • Play specific sounds when an enitity is fished​
  • Play specific visual effect when an enitity is fished​
[​IMG]


configuration.png
Spoiler: Config.yml
Code (Text):

# ------------------------------ #
#  Fish Replacer
#  Replace and personalize fishes and items fished
#  (c) Vallo
# ------------------------------ #

# ------------------------ #
#       INSTRUCTIONS       #
# ------------------------ #
# This config file is divided into 2 categorie: "vanilla" and "custom". DO NOT change these names
# or the plugin will not work properly!
# The "vanilla" category contains all the possible drops you can fish in vanilla. Example: "COD", "SALMON", "ENCHANTED_BOOK" etc. DO NOT modify
# these names or the plugin will not work properly!
# Each drop has 6 options: "replace", "item", "commands","exp", "message", "title" and "sound".

# ###- GENERAL SETTINGS -###
# There are two settings: "customitem" and "override-vanilla". Enable them with "true" or disable them "false".

# ***customitem***
# If set to "true" the player will be able to fish for custom items in addition to vanilla ones. Items can be customized in their appropriate section.
# If set to "false" the player will be able to fish only for vanilla items ("replace" function will stil be taken into account).

# ***override-vanilla***
# If set to "true" the player will be able to fish only for custom items.
# If set to "false" with "customitem" set to "true", custom items will be mixed with vanilla ones.
# The plugin will randomly select an item from vanilla and custom items together.


# ###- VANILLA SETTINGS -###
# ***replace***
# Must be set to true or false. If "replace" is set to true, the drop will be replaced by the item you set (if "Item" and
# "Commands" are left blank, there will be no drop). If set to false, the drop won't be affected by this plugin.

# ***item***
# Set here the name of the entity that replaces the one being fished. If you want to fish the base entity with added
# functionality (see "commands"), repeat the drop's name. You can enter more than one entity using a comma (",").
# In this case, a random entity will be selected from those listed. Example: item: COD,APPLE,BOW

# ***durability***
# Here you can assing a custom durability value to your items. If the field is left empty, default values will be applied.
# You can use up to 2 values. With just 1 value, items will have such value as durability. With 2 values, items will have a random value
# between the range of chosen numbers. Separate these values with a comma (",") and no spaces. Example: "durability: 50,126"
# Attention, values have to be sort in order. Lowest value at left and highest at right.

# ***enchantment***
# Contains a list of all the enchantments an item will have. Enchantments must follow this path "enchantment,enchantment level".
# You can use every enchantment ID of vanilla Minecraft. Example:
# enchantment:
#      - unbreaking,3
#      - sharpness,1

# ***commands***
# Contains the command to execute when the entity is being fished. You can execute multiple commands.
# If a command is directly related to a player who is fishing you can use the name %PLAYER% (WARNING: This is case sensitive,
# type it as shown and with both "%"). At the moment of the execution %PLAYER% will be replaced
# with the player's name. Example: - heal %PLAYER% ------> - heal Vallo

# ***exp***
# Contains the experience value the drop will provide. If left blank, default values will be applied.
# If set to 0, no experience will be dropped.

# ***message***
# When an entity is fished, the text here will be displayed. Leave it blank to show no message.

# ***title***
# Contains title and subtitle text you want to show to a player when an entity is caught. This option allows only 2 values.
# The first one will be used for the title, while the latter (if present) will be used for the subtitle.
# Adding other values won't have any effect. For more details check the following example. Leave the field empty if you don't want to show any titles.

# ***sound***
# Contains the ID of the sound that will be played when an entity is fished.
# Every  ID sound presents in the following link can be used: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
# Only 1 sound is allowed. Leave the field empty if you don't want any sound to be played.

# ***effect***
# You can insert one of these visual effects on the hook/bobber when an entity is fished: ENDER_SIGNAL, MOBSPAWNER_FLAMES, POTION_BREAK, SMOKE.

# Example:
#  COD:
#    replace: true
#    item: COD
#    commands:
#      - op %PLAYER%
#      - te givetokens %PLAYER% 10        #This is an example command taken from the TokenEnchant plugin.
#      - exp give %PLAYER% 5              #This is an example command based on Essentials "exp give".
#    exp:
#    message: "&3You have fished a &4&rCOD!"
#    title:
#      - "&5You caught 10 Token"
#      - "&2You are lucky!"
#    sound: ENTITY_CAT_PURR
#    effect: MOBSPAWNER_FLAMES
# This example executes two commands when a COD is fished, sends a message to the player "You have fished a COD", shows the player
# the title "You caught 10 Token" and the subtitle "You are lucky!", play a sound ENTITY_CAT_PURRa and show visual effect MOBSPAWNER_FLAMES.
# (neither the fish caught nor the experience received get changed)

# ###- CUSTOM SETTINGS -###
# ***name***
# Contains a personalized name for your custom item. Example: name: "&3Apple of God"

# ***quantity***
# Here you can assing a custom quantity value to your items.
# You can use up to 2 values. With just 1 value, items will have such value as quantity. With 2 values, items will have a random value
# between the range of chosen numbers. Separate these values with a comma (",") and no spaces. Example: "quantity: 1,5"
# Attention, values have to be sort in order. Lowest value at left and highest at right.

# ***chance***
# Contains a value between 0 and 100. Such value will be the chance to fish the custom item.
# Only integer values (no comma or dot) between "0" (no chance to be fished) and "100" (100% chance to be fished) are allowed.
# ATTENTION: in order to work properly, total chance of all custom items must result in 100!


# ***lore***
# Contains a description of the item.

# ***durability, enchantment, commands, exp, message, title, sound, effect***
# Same as the vanilla settings.


customitem: false
override-vanilla: false
vanilla:
  COD:
    replace: false
    item: COD
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  SALMON:
    replace: false
    item: SALMON
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  TROPICAL_FISH:
    replace: false
    item: TROPICAL_FISH
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  PUFFERFISH:
    replace: false
    item: PUFFERFISH
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  BOW:
    replace: false
    item: BOW
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  ENCHANTED_BOOK:
    replace: false
    item: ENCHANTED_BOOK
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  FISHING_ROD:
    replace: false
    item: FISHING_ROD
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  NAME_TAG:
    replace: false
    item: NAME_TAG
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  NAUTILUS_SHELL:
    replace: false
    item: NAUTILUS_SHELL
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  SADDLE:
    replace: false
    item: SADDLE
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  LILY_PAD:
    replace: false
    item: LILY_PAD
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  BOWL:
    replace: false
    item: BOWL
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  LEATHER:
    replace: false
    item: LEATHER
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  LEATHER_BOOTS:
    replace: false
    item: LEATHER_BOOTS
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  ROTTEN_FLESH:
    replace: false
    item: ROTTEN_FLESH
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  STICK:
    replace: false
    item: STICK
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  STRING:
    replace: false
    item: STRING
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  POTION:
    replace: false
    item: POTION
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  BONE:
    replace: false
    item: BONE
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  INK_SAC:
    replace: false
    item: INK_SAC
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  TRIPWIRE_HOOK:
    replace: false
    item: TRIPWIRE_HOOK
    durability:
    enchantment:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
custom:
# Below you will find two sample custom objects. Replace or delete them if you want to insert custom objects.
  DIAMOND_SWORD:
    name:
    quantity:
    chance:
    enchantment:
    lore:
    durability:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
  DIAMOND_PICKAXE:
    name:
    quantity:
    chance:
    enchantment:
    lore:
    durability:
    commands:
    exp:
    message:
    title:
    sound:
    effect:
 



For any support requests or suggestions for adding new features, feel free to post in the Fish Replacer discussion on the Spigot forum. ^^

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Fish Replacer is a free Minecraft Java mod. Compatible with Minecraft 1.13. Downloaded 718 times (via Spigot). Download it and open it directly in the game.

Explore more