Overview#
RLTweaker is a specialized utility mod designed to address the unique challenges of large-scale modpacks like RLCraft. It functions primarily as a "patcher," injecting fixes and performance enhancements into both vanilla Minecraft and various popular mods. Its primary goals are to eliminate game-breaking bugs, prevent item duplication exploits, and optimize server-side performance to ensure a smooth gameplay experience in high-entity environments.
The mod is highly modular, allowing pack developers to toggle specific patches on or off via a centralized configuration file. While it was built for RLCraft, it is fully compatible with any 1.12.2 modpack and includes a dedicated command to automatically configure the mod for general use.
Vanilla Minecraft Patches#
RLTweaker introduces several critical fixes to the base Minecraft engine to improve stability and AI behavior. These patches are essential for preventing crashes and reducing lag in complex worlds.
| Patch Name | Description |
|---|---|
| Aggressive Motion Checker | Tackles motion issues related to "division by zero" errors that can cause entities to vanish or crash the game. |
| Door Pathfinding Fix | Corrects a long-standing vanilla bug where mobs would fail to recognize doors as valid paths, allowing them to navigate structures more effectively. |
| Less Collisions | Optimizes entity collision performance, which is vital for modpacks that increase the maximum entity radius or density. |
| Particle Threading | Makes particle rendering thread-safe to prevent memory corruption and crashes during intense combat or magical effects. |
| Anvil Dupe Patch | Fixes multiple item duplication exploits involving anvils and modded interactions. |
| Hopper Optimization | Adds configuration options to tweak hopper behavior, reducing the tick-rate impact of large storage systems. |
| Item Frame Dupe Fix | Prevents a common exploit where items could be duplicated using modded item frames. |
| Pathfinding Chunk Cache | Stops "ghost chunkloading" when the game creates pathfinding caches, significantly reducing unnecessary RAM usage. |
| Replace Random Update Handler | Replaces the default random update handler with a faster alternative to boost overall TPS (Ticks Per Second). |
Mod Compatibility and Tweaks#
A core feature of RLTweaker is its ability to modify the behavior of other mods to fit a hardcore survival environment. It provides specific patches for over 30 different mods.
Lycanites Mobs
RLTweaker provides deep integration for Lycanites Mobs, focusing on boss mechanics and spawning logic.
- Boss Health Bars: Fixes tracking issues for boss health bars, ensuring they display correctly even at long distances.
- ForgeData Tags: Adds custom tags (
rltweaker.lycanitesbossandrltweaker.lycanitesbossrange) that allow any entity to be treated as a boss by the game engine. - Spawning Fixes: Prevents certain Lycanites creatures from spawning in invalid locations or through walls.
Tough As Nails
- Thirst Bar Rendering: Fixes a common HUD bug where the thirst bar would fail to render or overlap with other UI elements.
- Temperature Logic: Provides more granular control over how environmental temperature affects the player.
Quark and Reskillable
- Ancient Tomes: Changes the behavior of Quark's Ancient Tomes. It removes the standard anvil recipe and requires the tome to be held in the offhand to merge with an item in the main hand.
- Skill Requirements: Fixes issues where Reskillable requirements were not properly enforced on certain modded items.
Battle Towers
- Tower Golem AI: Prevents Tower Golems from being easily defeated by drowning or being trapped in boats/minecarts.
- Projectile Swapping: Allows the Golem's projectile to be replaced with a Lycanites Mobs projectile for increased difficulty.
Additional Mod Patches
| Mod | Tweak Description |
|---|---|
| Aquaculture | Fixes Neptune loot tables and a bug involving freshwater fishing. |
| Better Survival | Fixes mounted combat issues and Nunchaku hit detection. |
| Ice and Fire | Prevents statues from picking up items and cleans up entity data when statues are spawned. |
| Waystones | Fixes a crash related to Bound and Return scrolls and prevents them from accidentally resetting spawn points. |
| Potion Core | Allows specific potion effects (like Potion Sickness) to be made incurable by the "Cure" effect. |
| Rustic | Adds control over the effects granted by drinking Wine and fixes the "Tipsy" status logic. |
Mechanics and Performance#
Beyond simple bug fixes, RLTweaker introduces several mechanical changes designed to keep worlds clean and performant over long periods of time.
- Item Cleanup: Automatically despawns items on the ground after a configurable amount of time to prevent "lag drops" from massive explosions or mob deaths.
- Mineshaft Worldgen Cleanup: Regularly wipes mineshaft data files to save RAM and prevent save file bloat.
- Container Distance Check: Automatically closes container interfaces (chests, furnaces) if the player moves too far away, preventing various duplication exploits.
- Damage Tilt Effect: Restores the classic Minecraft "Damage Tilt" effect, where the camera tilts in the direction the player took damage from, enhancing immersion.
- World Tick Removal: Optionally removes certain world ticks used for smoke particles and obsolete spawners to maximize server performance.
Commands#
RLTweaker includes several administrative commands to help players and server owners manage the mod's extensive feature set.
/rladvisor: Analyzes the current modpack and provides recommendations on which RLTweaker patches should be enabled or disabled based on the installed mods./rltweakerconfig improvementsonly: A quick-setup command that enables all performance and bug-fix patches while leaving gameplay-altering tweaks disabled. This is ideal for non-RLCraft modpacks./rltweaker reload: Reloads the configuration file without requiring a game restart (note: some patches may still require a restart to take effect).
Configuration#
The configuration for RLTweaker is divided into three main categories: Client, Patches, and Server.
Client Settings
Focuses on UI and rendering fixes for mods like Classy Hats, Potion Core, and Fancy Block Particles. This includes the damageTilt toggle and HUD alignment fixes.
Patches Settings
This is the largest section, containing toggles for every individual fix mentioned in the Vanilla and Mod Compatibility sections. It is recommended to use /rladvisor to determine the best settings for your specific mod list.
Contains logic-heavy tweaks for world generation (Roguelike Dungeons, Recurrent Complex), enchantment behavior (So Many Enchantments), and entity management (Spawner Control, Lycanites Mobs). This section also handles the itemCleanup timers and mineshaftData management.
