🎣Custom Rod

Custom rods allow you to introduce fully configurable fishing rods with unique behavior and gameplay advantages. Each rod is defined through its own configuration file and can have any number of modifiers attached to it.

Creating Rod

1. Go to the /lfish menu and click the Custom Rod.

2. Put the rod in the Add button to create a new custom rod config. All rod files are stored in server/plugins/LiteFish/fishing_rods.

1. You can set modifications for this rod, or link it to the modification config using the LINK button.

Bait / Rune Slots

Custom fishing rods can define how many bait or rune slots they provide. These slots determine how many items of each type can be inserted into the rod.

How It Works

• When a rod is created or given to a player (via menu or command), it automatically receives an additional lore line indicating an empty slot. Example:

  lang.slot_empty: "<#555555><bait slot>"

• The rod can hold as many runes or baits as defined in its configuration.

• When inserting or removing a slot item, the system looks for the exact lang.slot_empty string inside the item lore and replaces or updates it accordingly.

⚠️ Item Identification and the compare System ⚠️

It is important for the plugin to reliably identify custom fishing rods. However, rods may change over time — for example:

• bait/rune insertion modifies the lore,

• durability decreases during use,

• additional NBT data may appear from other plugins,

• players may intentionally edit lore with external tools.

To avoid misidentification and ensure stability, each custom rod configuration can specify which fields should be used for comparison.

The compare Field 🧠 Understanding compare

You can define which item attribute(s) the plugin should use to recognize the rod. Any attributes not listed in compare will be ignored during identification.

Example

"item": {
  "material": "FISHING_ROD",
  "display_name": "§cCustom Rod",
  "lore": [
    "§7A custom fishing rod.",
    "§7Holds two bait slots."
  ],
  "compare": "display_name"
}

What This Means

• When giving the rod (via menu or command), it will be created with the specified material, name, and lore.

• When the plugin later tries to identify this rod in the player’s inventory, it will compare only the display_name.

• Any other changes — lore edits, added NBT tags, different damage value, placeholder updates, bait/rune data — will be ignored.

As long as the rod keeps the same display_name, the plugin will always treat it as the configured custom rod.