🎣 Custom Fishing Loot

Configure what items you catch while fishing with a powerful weight-based system!

✨ Features

🎯 Catch ANY items - diamonds, emeralds, enchanted books, or modded items
⚖️ Weight-based chances - control exactly how rare each item is
🔄 Two modes - vanilla fish only, custom items only, or both with configurable balance
📦 Min/max counts - set item stack sizes
⚙️ Easy configuration - simple text file
🌐 Server-friendly - works on multiplayer servers

🎮 How It Works

The mod uses a weight system to determine what you catch:

Example weights:

💎 Diamond (weight 10)  = 10 out of 100 total = 10% chance
🔧 Iron    (weight 30)  = 30 out of 100 total = 30% chance
🪙 Gold    (weight 60)  = 60 out of 100 total = 60% chance

Simple rule: Higher weight = more common drops! 📈

⚙️ Configuration

Config file: config/customfishingloot-common.toml

📝 Basic Example

keepVanillaLoot = true
vanillaWeight = 100
customLootItems = [
    "minecraft:iron_ingot,15,1,3",
    "minecraft:diamond,1,1,1"
]

🔧 Options

keepVanillaLoot

✅ true = Catch either vanilla fish OR custom items (weighted chance)
❌ false = Catch only custom items (no fish)

vanillaWeight (only when keepVanillaLoot = true)

Controls how often you get vanilla fish vs custom items
📈 Higher = more fish
📉 Lower = more custom items
Default: 100

customLootItems

Format: "modid:item_id,weight,minCount,maxCount"
Example: "minecraft:diamond,10,1,3" means:
- 💎 Item: Diamond
- ⚖️ Weight: 10 (rarity)
- 📦 Drop 1-3 diamonds

📋 Configuration Examples

⚖️ Balanced (50/50)

Approximately half fish, half treasures:

keepVanillaLoot = true
vanillaWeight = 100
customLootItems = [
    "minecraft:iron_ingot,50,2,4",
    "minecraft:gold_ingot,30,1,3",
    "minecraft:diamond,10,1,2",
    "minecraft:emerald,10,1,1"
]

Result:

🐟 50% vanilla fish
💎 50% custom treasures (iron most common, diamond rare)

💰 Treasure Heavy

Lots of valuable items, less fish:

keepVanillaLoot = true
vanillaWeight = 30
customLootItems = [
    "minecraft:iron_ingot,40,2,5",
    "minecraft:gold_ingot,30,1,4",
    "minecraft:diamond,20,1,3",
    "minecraft:emerald,10,1,2"
]

Result:

🐟 23% vanilla fish
💎 77% custom treasures

🎯 Only Custom

No vanilla fish at all:

keepVanillaLoot = false
customLootItems = [
    "minecraft:diamond,50,1,5",
    "minecraft:netherite_scrap,10,1,1"
]

Result:

🐟 0% vanilla fish
💎 100% custom items

⚔️ Early Game Helper

Useful resources for survival:

keepVanillaLoot = true
vanillaWeight = 100
customLootItems = [
    "minecraft:iron_ingot,30,2,5",
    "minecraft:string,25,3,6",
    "minecraft:leather,20,2,4",
    "minecraft:bone,15,2,4",
    "minecraft:experience_bottle,10,1,2"
]

🎲 Understanding Weights

🧮 How Chances Are Calculated

With these weights:

vanillaWeight = 100
customLootItems = [
    "minecraft:iron_ingot,50,1,3",
    "minecraft:diamond,10,1,1"
]

Total weight: 100 + 50 + 10 = 160

Chances:

🐟 Vanilla fish: 100/160 = 62.5%
🔧 Iron ingots: 50/160 = 31.25%
💎 Diamonds: 10/160 = 6.25%

📊 Weight Guidelines

Weight Range	Rarity	Frequency
100+	🟢 Very Common	Every 2-3 catches
50-99	🟡 Common	Every 3-5 catches
20-49	🟠 Uncommon	Every 5-10 catches
10-19	🔴 Rare	Every 10-20 catches
5-9	🟣 Very Rare	Every 20-40 catches
1-4	⭐ Legendary	Every 50-100 catches

🔌 Works with Modded Items

Add items from any mod:

customLootItems = [
    "minecraft:diamond,20,1,3",
    "create:brass_ingot,30,2,5",
    "thermal:copper_ingot,40,3,6"
]

How to find item IDs:

Press F3 + H in game
Hover over any item
The ID appears at the bottom of the tooltip 🔍

💬 Common Questions

Q: How do I make diamonds very rare? A: Give diamonds a low weight (like 1-5) and other items higher weights.

Q: Can I remove vanilla fish completely? A: Yes! Set keepVanillaLoot = false

Q: Does this work on servers? A: Yes! Install on the server side. Clients don't need it. 🌐

Q: Can I use this in my modpack? A: Absolutely! No permission needed. 📦

Q: Items don't drop? A: Close Minecraft before editing the config file. 💾

🎯 Perfect For

🏝️ Skyblock maps
🎮 Custom survival challenges
📦 Modpacks
🌐 Servers with custom economies
🎣 Making fishing more rewarding
⚖️ Balanced progression systems

🖥️ Technical Info

Minecraft: 1.20.1
Mod Loader: Forge 47.3.0+
Config: config/customfishingloot-common.toml
Side: Server-side (client optional)

🌟 Why Use This Mod?

✅ Simple - Easy config, no complex files
✅ Flexible - Complete control over fishing rewards
✅ Balanced - Weight system lets you fine-tune drop rates
✅ Lightweight - No lag or performance impact
✅ Compatible - Works with other mods

📜 License

MIT License - Free to use in any modpack or server! 🎉

🔄 Changelog

Version 1.0.1

🐛 Fixed: Custom items not dropping when keepVanillaLoot = true
🔧 Fixed: Players now properly receive either vanilla fish OR custom items based on weights
⚡ Improved: Changed event priority for better compatibility

Version 1.0.0

✨ Initial release
⚖️ Weight-based loot system
🔧 Configurable vanilla/custom balance
📦 Min/max item counts
🔌 Modded item support
🌐 Server-friendly