
LootTweaker
A CraftTweaker addon that allows loot tables to be edited with ZenScript
About this Mod
LootTweaker
LootTweaker is an addon for CraftTweaker that allows loot tables to be tweaked with ZenScript files. The vanilla loot table system is limited to overriding existing loot tables or creating entirely new ones.
LootTweaker allows you to make small or large tweaks to loot tables, without having to override the table completely.
Documentation
https://loottweaker-docs.readthedocs.io/en/latest/
Mixin
As of 0.4.0, LootTweaker requires Mixin. You must add a Mixin loader such as MixinBootstrap to your mods folder, or Minecraft will crash with Unable to launch java.lang.ClassNotFoundException: org.spongepowered.asm.launch.MixinTweaker as the error.
FAQ
Will there be a 1.13/1.14/1.15/... version?
LootTweaker will be remaining on 1.12.x. The CraftTweaker team has added an excellent API for the post-1.13 loot system to CraftTweaker itself.
Therefore, rather than spending a lot of energy on understanding the post-1.13 loot system and creating a useful ZenScript interface to it, I have chosen to continue to improve LootTweaker for 1.12.x.
What should I use instead of LootTweaker in 1.13/1.14/1.15/...?
CraftTweaker versions for Minecraft 1.13 and later have an excellent loot API. It's quite different from LootTweaker's, but much more capable.
Can LootTweaker edit mob/structure/whatever loot?
LootTweaker edits loot tables. If a vanilla mechanic or mod mechanic uses loot tables, LootTweaker can edit those tables. To find out if a mod uses loot tables, check its documentation or ask the author.
Can LootTweaker create new loot tables?
Yes, this feature was implemented in version 0.2.0. See the documentation for the class loottweaker.LootTweaker for details.
Can LootTweaker automatically find and remove all of an item from loot tables?
No, though the feature is being worked on. There is no estimate for when it will be ready.
Can LootTweaker be installed only on the server?
Server-only installation is possible with LootTweaker 0.1.7 or later. However CraftTweaker requires that it is installed on both server and client.
Clients without LootTweaker installed will still be able to use LootTweaker commands, but the feedback messages will be untranslated.
Note that loot table dumps occur serverside.
Client-only installation of LootTweaker is not supported.
Important Notes:
Only LootTweaker for 1.12 is still developed.
A Forge version of at least 14.23.5.2779 is required
Want more loot conditions/functions?
Take a look at Loot Overhaul by tmtravlr.
Need help or have a question?
LootTweaker's GitHub has a discussion forum where you can search previous questions and ask your own.
The Discord still exists, but I'm experimenting with Github Discussions as it's more easily searched by its own search and search engines such as Google.
If you comment on Modrinth, it may be some time before your comment is read.
Have a suggestion?
Create an issue here.
If you comment on Modrinth, it may be some time before your comment is read.
Available Versions
How to Install LootTweaker on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.12.2).
Install Mod
Open the mod browser in the dashboard and search for "LootTweaker". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.12.2, 1.11.2, 1.11.1 (+2 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
LootTweaker server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.12.2). You can switch loaders with one click in the panel.
Is LootTweaker compatible with forge?
LootTweaker officially supports forge for Minecraft 1.12.2, 1.11.2, 1.11.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with LootTweaker – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if LootTweaker consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install LootTweaker with just one click on your server.