Ultimate Fishing

From Songoda Wiki
Jump to navigation Jump to search

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.

Getting Started[edit | edit source]

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[edit | edit source]

config.yml

rarity.yml

bait.yml

normal.json

es_US.yml

Commands and Permissions[edit | edit source]

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[edit | edit source]

Tutorials[edit | edit source]

Custom Drops (Lootables)[edit | edit source]

About This[edit | edit source]

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

Editing a Lootable[edit | edit source]

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[edit | edit source]

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?
  • 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 (Examples are pulled from UltimateStacker's Lootables, and are based off of mob drops.  The same system can be used with UltimateFishing, but from things you can get from fishing.)

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

 1 {
 2   "Type": "PIG",
 3   "Loot": [
 4     {
 5       "Type": "WHITE_WOOL",
 6       "Chance": 100,
 7       "Min": 1,
 8       "Max": 3,
 9       "Looting": true
10     },
11     {
12       "Type": "RED_WOOL",
13       "Chance": 100,
14       "Min": 1,
15       "Max": 3,
16       "Looting": true
17     },
18     {
19       "Command": "say %player% killed a pig.",
20       "Chance": 100,
21       "Min": 1,
22       "Max": 3,
23       "Looting": true
24     }
25   ]
26 }

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.

 1 {
 2   "Type": "PIG",
 3   "Loot": [
 4     {
 5       "Type": "WHITE_WOOL",
 6       "Burned Type": "RED_WOOL",
 7       "Chance": 50,
 8       "Min": 1,
 9       "Max": 3,
10       "Looting": true
11     },
12     {
13       "Chance": 100,
14       "Min": 1,
15       "Max": 1,
16       "Looting": true,
17       "Child Loot Drop Count Min": 1,
18       "Child Loot Drop Count Max": 1,
19       "Child Loot": [
20         {
21           "Type": "YELLOW_WOOL",
22           "Chance": 50,
23           "Min": 1,
24           "Max": 3,
25           "Looting": true
26         },
27         {
28           "Type": "GREEN_WOOL",
29           "Name": "&3test",
30           "Lore": [
31             "&4test2",
32             "&5test3",
33             "&6test4"
34           ],
35           "Enchantments": {
36             "KNOCKBACK": 1,
37             "SWEEPING_EDGE": 1
38           },
39           "Chance": 50,
40           "Min": 1,
41           "Max": 3,
42           "Looting": true
43         }
44       ]
45     }
46   ]
47 }

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.

 1   {
 2   "Type": "PIG",
 3   "Loot": [
 4     {
 5       "Type": "BOW",
 6         "Enchantments": {
 7         "RANDOM": 26
 8       },
 9       "Chance": 0.7,
10       "Min": 1,
11       "Max": 1,
12       "Wielded Enchantment Chance Overrides": {
13         "LUCK:2": 1.3,
14         "LUCK:1": 1.0,
15         "LUCK:3": 1.6
16       },
17       "Damage Min": 10,
18       "Damage Max": 100,
19       "Looting": true
20     },
21     {
22       "Command": "OP %player%",
23       "Chance": 20,
24       "Min": 1,
25       "Max": 1,
26       "Looting": true
27     }
28   ]
29 }

Youtube Tutorial[edit | edit source]

Build 1.0.4