TooMuchLoot Mod Wiki

TooMuchLoot is an essential tool for modpack creators and server administrators looking to balance the gameplay experience in Minecraft. In large modpacks, many mods automatically inject their items into vanilla loot tables (such as Dungeon or Desert Temple chests), often diluting the loot pool and making rare vanilla items nearly impossible to find.

This mod solves that problem by scanning all registered loot tables upon initialization and providing a framework to modify them via simple JSON configuration files. Unlike other mods that might only allow adding items, TooMuchLoot provides the surgical precision needed to remove specific entries or wipe a loot table clean to start from scratch.

The mod operates by hooking into the ChestGenHooks system, which was the standard method for handling container loot in Minecraft.

Initialization Process

1. Scanning: When a world is loaded, the mod scans every loot category registered by both Vanilla Minecraft and any installed mods (e.g., Thaumcraft, IndustrialCraft 2).
2. Caching: The current state of these loot tables is cached in memory.
3. Parsing: The mod reads all .json files located in the config/TooMuchLoot/ directory.
4. Application: The instructions within the JSON files (add, remove, or replace) are applied to the cached loot tables, overriding the default generation settings.

Key Features

• Dynamic Control: Changes can be applied without restarting the entire game by using the reload command.
• Mod Compatibility: Automatically detects loot tables added by other mods, provided they use the standard Forge ChestGenHooks system.
• Precision Weighting: Allows users to define the exact 'weight' of an item, which determines its rarity relative to other items in the same pool.

TooMuchLoot provides a single base command with sub-commands to help manage and debug loot tables in real-time.

The mod is configured through JSON files located in config/TooMuchLoot/. You can create multiple files (e.g., vanilla_tweaks.json, mod_additions.json) to keep your changes organized.

JSON Structure

Each JSON file should contain an array of objects. Each object represents a single modification rule.

Action Types

• add: Adds a new item entry to the specified category.
• remove: Removes all instances of a specific item from the specified category.
• replace: Clears the entire category and replaces it with the items defined in the JSON.

Example Configuration

[
 {
 "action": "remove",
 "category": "DUNGEON_CHEST",
 "item": "minecraft:saddle"
 },
 {
 "action": "add",
 "category": "VILLAGE_BLACKSMITH",
 "item": "minecraft:diamond",
 "weight": 10,
 "min": 1,
 "max": 3
 }
]

Parameter Definitions

TooMuchLoot can modify any category registered in the game. Below are the standard vanilla categories available in 1.7.10:

• DUNGEON_CHEST: Found in standard 16x16 cobblestone dungeons.
• MINESHAFT_CORRIDOR: Found in Abandoned Mineshaft chest minecarts.
• PYRAMID_DESERT_CHEST: Found in the four chests at the bottom of Desert Temples.
• PYRAMID_JUNGLE_CHEST: Found in the hidden chests within Jungle Temples.
• PYRAMID_JUNGLE_DISPENSER: The loot inside the traps of Jungle Temples.
• STRONGHOLD_CORRIDOR: Chests found in the hallways of Strongholds.
• STRONGHOLD_LIBRARY: Chests found in Stronghold libraries (usually containing books/paper).
• STRONGHOLD_CROSSING: Chests found in the tiered crossing rooms of Strongholds.
• VILLAGE_BLACKSMITH: The chest found in the Blacksmith building in NPC villages.
• BONUS_CHEST: The optional chest that spawns near the player upon world creation.

File Locations

• Config Folder: .minecraft/config/TooMuchLoot/ - Place your .json files here.
• Dump File: .minecraft/TooMuchLoot-Dump.txt - Generated after running /tml dump.

Requirements

• Minecraft Version: 1.7.10
• Forge: Requires a compatible version of Minecraft Forge for 1.7.10.
• Note: This mod is a utility and does not add new blocks, items, or mobs to the game. It is strictly for managing existing data structures.