Custom Fishing Loot

🎣 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

🔌 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:

1. Press F3 + H in game
2. Hover over any item
3. 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