Ultimate Fishing

From Craftaro Originals

Enhance your fishing experience with an added range of fish rarities, custom loot, and the ability to sell your catches. Add creativity and achievement to normal fishing.
Part of the Ultimate Series.

Getting Started

To install Ultimate Fishing you will need to:

  1. Turn your server off.
  2. Add the required dependencies: Vault, Economy Management Plugin.
  3. Add in the latest version of Ultimate Fishing which you can find in our marketplace.
  4. Turn your server back on.

Plugin Files

Commands and Permissions

Command Description Permission Node
/uf Displays the plugin information page. Default
/uf settings Opens the in-game settings GUI for EpicFishing. ultimatefishing.admin
/uf reload Reload the Configuration and Language files for UltimateFishing.
/uf sell Opens the sell GUI. ultimatefishing.sell
/uf sellall Shortcut to sell all from the player's inventory. ultimatefishing.sellall
/uf baitshop Open the bait shop. ultimatefishing.baitshop
Allows players to catch a specific fish rarity. Example: ultimatefishing.fish.large ultimatefishing.fish.<rarity>
Allows players to use UltimateFishing. ultimatefishing.use

Incompatible Plugins

Tutorials

Custom Drops (Lootables)

About This

With lootables, you can decide anything that you wish you could obtain from fishing.

Editing a Lootable

In order to edit the lootables, you need to have a basic understanding of how to work with the JSON storage format. You are able to modify the tables from the preexisting configuration, and you could also use an online JSON editor to help you write a valid JSON, such as this one here.

Loot Tables

The loot tables are split into two objects, those being: Lootables and Loot. Lootables are the parent object which holds all of the loot for the entity. Loot is the child object that is held by the Lootables object.

There are various Loot options, which are:

  • Type - The material used for this drop.
  • Command - The command used for this drop. Commands are compatible with the placeholder '%player%'. It should be noted that if the entity is not killed by a player while this placeholder is being used, the command will not run.
  • Data - The data value that corresponds with the material type. It should be noted that this is unsupported and unused in Minecraft versions of 1.13 and above.
  • Name - The name applied to the dropped loot.
  • Lore - The lore applied to the dropped loot.
  • Enchantments - The enchantments applied to the dropped loot. Using the value "Random" will process the enchantment as if it were going through an enchanting table.
  • Burned Type - Material used if the entity dies while on fire.
  • Chance - The chance that the material will drop.
  • Min - The minimum amount of materials dropped or commands run.
  • Max - The maximum amount of materials dropped or commands run.
  • Looting - Will the looting enchantment be usable for this loot?
  • Looting Chance Increase - By how much each level of looting advances the max drop count.
  • Only Drop For - Should this drop only be applicable to specific entities?
  • Is Charged - This loot will only drop if the mob is killed by a charged creeper.
  • Child Loot - Should this loot house child loot?
  • Child Loot Drop Count Min - What is the minimum amount of child loot that should drop?
  • Child Loot Drop Count Max - What is the maximum amount of child loot that should drop?
  • Wielded Enchantment Chance Overrides - The override for chances applied by the wield item.
  • Damage Min - Min amount of applied damage.
  • Damage Max - Max amount of applied damage.

Examples

In this example, pigs will drop 1 - 3 white wool, 1 - 3 red wool, and will run a command 1 - 3 times.

{
  "Type": "PIG",
  "Loot": [
    {
      "Type": "WHITE_WOOL",
      "Chance": 100,
      "Min": 1,
      "Max": 3,
      "Looting": true
    },
    {
      "Type": "RED_WOOL",
      "Chance": 100,
      "Min": 1,
      "Max": 3,
      "Looting": true
    },
    {
      "Command": "say %player% killed a pig.",
      "Chance": 100,
      "Min": 1,
      "Max": 3,
      "Looting": true
    }
  ]
}

In this example, pigs will drop white wool 50% of the time, while dropping red wool if the pig dies while on fire. Pigs also have a 100% chance of dropping either yellow or green wool.

{
  "Type": "PIG",
  "Loot": [
    {
      "Type": "WHITE_WOOL",
      "Burned Type": "RED_WOOL",
      "Chance": 50,
      "Min": 1,
      "Max": 3,
      "Looting": true
    },
    {
      "Chance": 100,
      "Min": 1,
      "Max": 1,
      "Looting": true,
      "Child Loot Drop Count Min": 1,
      "Child Loot Drop Count Max": 1,
      "Child Loot": [
        {
          "Type": "YELLOW_WOOL",
          "Chance": 50,
          "Min": 1,
          "Max": 3,
          "Looting": true
        },
        {
          "Type": "GREEN_WOOL",
          "Name": "&3test",
          "Lore": [
            "&4test2",
            "&5test3",
            "&6test4"
          ],
          "Enchantments": {
            "KNOCKBACK": 1,
            "SWEEPING_EDGE": 1
          },
          "Chance": 50,
          "Min": 1,
          "Max": 3,
          "Looting": true
        }
      ]
    }
  ]
}

In this example, pigs will drop a bow bow that is enchanted randomly with an Enchanting Table of level 26. The bow will also be damaged between 10 and 100 percent. There is also a 20% chance that the player will be opped.

  {
  "Type": "PIG",
  "Loot": [
    {
      "Type": "BOW",
        "Enchantments": {
        "RANDOM": 26
      },
      "Chance": 0.7,
      "Min": 1,
      "Max": 1,
      "Wielded Enchantment Chance Overrides": {
        "LUCK:2": 1.3,
        "LUCK:1": 1.0,
        "LUCK:3": 1.6
      },
      "Damage Min": 10,
      "Damage Max": 100,
      "Looting": true
    },
    {
      "COMMAND": "OP %player%",
      "Chance": 20,
      "Min": 1,
      "Max": 1,
      "Looting": true
    }
  ]
}

Youtube Tutorial

Build 1.0.4