MythicRod
A small Paper plugin for custom fishing.
Heads up. This is a Paper plugin. Spigot might still run it, but it has not been tested on Spigot and nothing is guaranteed. The Paper jar lives on
GitHub releases.
What it does
Replaces vanilla fishing with weighted, biome-scoped, permission-gated drop tables. Four rod tiers tune the odds. Stats, leaderboards, GUIs, PlaceholderAPI, and a developer API ship in the same jar.
Features
- Weighted drop tables. Per-category drops with weight, amount, custom name, lore, enchantments, glow, item flags, custom model data, and a per-drop permission.
- Biome filters. Each drop can list biomes, so ocean, desert, jungle each roll their own table.
- Four rod tiers. basic, advanced, legendary, mythic. Each is gated by its own permission and has a tunable luck multiplier in config.yml.
- Catch celebrations. Per-player particles and sound for every tier. Top tiers add a short helix, throttled to once per 4 seconds per player so it does not flood.
- Stats and leaderboard. Lifetime catches, per-tier counts, top fishers. Async flushed to YAML.
- GUI hub. Config toggles, drop editor (live, no reload), rod picker, stats viewer, language picker with curated head textures.
- Brigadier commands. Native tab completion. Live drop ids, categories, biomes, and player names from current state.
- PlaceholderAPI tokens. %mythicrod_total%, %mythicrod_legendary%, %mythicrod_rod_tier%, plus per-tier counts.
- Developer API. createRod(tier), previewEligibleDrops(uuid, biome), external drop providers, 5 Paper events (bite, roll, catch, stats, reload). Published through JitPack.
- Localisation. English and Japanese ship in the jar. Crowdin wired for more.
- Optional Nexo integration. Drop tables accept Nexo item ids when Nexo is installed.
- Folia ready. Scheduler hands off to the correct entity, region, or global thread on the Paper jar.
Example drops.yml
Code (Text):
features:
rods:
luck-multipliers:
basic: 1.0
advanced: 1.25
legendary: 1.5
mythic: 2.0
drops:
global:
- { identifier: DIAMOND, weight: 5, amount: 1 }
- { identifier: IRON_INGOT, weight: 30, amount: 1 }
legendary:
excalibur:
identifier: NETHERITE_SWORD
weight: 1
name: '<aqua><bold>Excalibur</bold></aqua>'
lore: ['<gray>A legendary blade']
enchantments: { sharpness: 10 }
glowing: true
permission: mythicrod.drops.legendary
biomes: [minecraft:ocean]
Commands
Code (Text):
/mythicrod Open the GUI hub
/mythicrod stats [player] Personal stats or someone else's
/mythicrod top Leaderboard by tier or last-catch
/mythicrod drops Browse drop tables by category
/mythicrod drops preview <biome> What you would roll at that biome
/mythicrod rod Pick your default rod tier
/mythicrod give <player> <tier> Give a rod (admin)
/mythicrod showcase <tier> Preview the tier celebration (admin)
/mythicrod reload Hot-reload config and drop tables
/mythicrod status Runtime status (version, drops, integrations)
Permissions
Code (Text):
mythicrod.* op All features
mythicrod.gui true Open the GUI
mythicrod.stats.view true View your own stats
mythicrod.stats.leaderboard true View the leaderboard
mythicrod.drops.view true Browse the drops menu
mythicrod.drops.rare op Roll rare drops
mythicrod.drops.legendary op Roll legendary drops
mythicrod.rod.advanced op Use advanced rod
mythicrod.rod.legendary op Use legendary rod
mythicrod.rod.mythic op Use mythic rod
mythicrod.admin.reload op Hot reload
mythicrod.admin.give op Give rods
mythicrod.admin.config op Edit drops and config
mythicrod.admin.debug op debug / testroll / showcase
Runtime
- Paper 1.21+ or Folia. Supported runtime. Folia scheduler hand-off is region-aware.
- Spigot 1.21.x. Might still run. Untested. Some Adventure, Brigadier, or Folia paths may misbehave.
- Java 21+.
- Developer API: com.github.xcutiboo:MythicRod:v2026.1.1 on JitPack (compileOnly). See the docs.
Links