Slash Blade Tweaker
If you have ever felt limited by the predefined swords in the Slash Blade mod for Minecraft, you are not alone. The Slash Blade Tweaker add-on is the ultimate solution for players who want to break free from the default katana roster and forge their own path. This powerful tool, built for modpack creators and adventurous players alike, puts the entire blade registry in your hands. Instead of settling for what the base mod gives you, you can now define, redefine, and completely reimagine every aspect of your drawn sword, from its kill count to its special attack behavior.
What Does Slash Blade Tweaker Actually Do?
At its core, this add-on acts as a bridge between the Slash Blade mod and the CraftTweaker/ZenScript scripting language. It allows you to manipulate the internal "Blade Registry" — the database that stores every original sword type in the game. In the vanilla Slash Blade experience, most katanas are technically the same item, differentiated only by hidden NBT data. This tweaker lets you create new "original swords" and register them into that database, making them fully functional and obtainable in-game.
The most recommended way to register a new blade is through the BladeRegistry chain. This method is clean, efficient, and allows for infinite chaining. You start by calling named to begin crafting your sword, then adjust parameters like kill count, refinement level, and proud soul value. Finally, you call register to lock it in. The entire process can look like this:
BladeRegistry.named("example:test_one").killCount(10000).refine(1000).proudSoul(2600000).texture("named/sange/white").model("named/sange/sange").specialAttack(20).wrap(BladeRegistry.findItem("minecraft:wooden_sword")).process(function(s){SERegistry.addSEToItem(s, "test_se");return s;}).register().named("example:test_two").register();This chain can go on infinitely, allowing you to register dozens of unique blades in a single script file.
Understanding SA and SE Systems
To truly master Slash Blade Tweaker for Minecraft, you need to understand the two core combat systems it modifies: Special Attacks (SA) and Special Effects (SE).
Special Attacks (SA)
SA is your unique attack method when wielding a drawn sword. In the base mod, SA is identified by a numerical ID stored in the NBT data. This tweaker provides a straightforward registration method via SARegistry.registerSA(int, String, ISpecialAttackFunction). The string parameter is used for the translation key (flammpfeil.slashblade.specialattack.%NAME%), while the function is called both client-side and server-side when the player activates the attack. This gives you granular control over what happens when a player right-clicks with your custom blade.
Special Effects (SE)
SE functions similarly to enchantments but is represented purely as NBT data. It has no inherent interface or function; instead, other systems read this data to apply effects. SE uses a string as its registration name. A simple registration looks like this: SEType.create(10, "example_se").register(); — where the first number is the default level, and the string is the name (with the translation key slashblade.seffect.name.%NAME%). You can add SE to items by directly manipulating NBT or using the SERegistry#addSEToItem helper.
The "Wrap" Feature and Demo Items
One of the most interesting features is the wrap mechanic. Every blade type can have a "wrapper" item — typically a wooden sword. When you attack with your custom drawn sword, the game actually uses the wrapper item's attack logic. This is why creative-mode previews of custom blades show a line stating they are "demo items" with the power of a wooden sword. The real power comes when you synthesize the blade using the "Nameless" Ruby and a katana. This process inherits the katana's ability, durability, and damage, while also gaining the +4 attack damage bonus that phantom blade types (like Extreme Slash or Wave Blade Gentian) provide.
If you are looking to get started quickly, you can download Slash Blade Tweaker from the official CurseForge page or the mod's GitHub releases. The add-on supports Minecraft versions 1.12.2 and 1.16.5, and it requires both the Slash Blade mod and CraftTweaker to function. The installation process is straightforward: drop the JAR file into your mods folder and ensure you have the dependencies. For a hassle-free setup, many players use the foxygame.net launcher, which offers a one-click install feature that automatically resolves dependencies and version conflicts for Slash Blade Tweaker, ensuring you spend more time crafting katanas and less time troubleshooting.
How to Install and Get Started
Learning how to install this add-on is simple. First, make sure you have the correct versions of Minecraft Forge, Slash Blade, and CraftTweaker. Then, follow these steps:
- Download the Slash Blade Tweaker JAR file from a trusted source.
- Navigate to your
.minecraftfolder and open themodsdirectory. - Place the JAR file inside the folder and launch the game.
- Create a new script file in the
scriptsfolder (CraftTweaker's directory) to start defining your blades.
Once in-game, you can test your scripts using the /reload command. For those who prefer a more curated experience, the foxygame.net launcher maintains an add-on catalog where you can browse and install Slash Blade Tweaker alongside compatible modpacks. The launcher also handles auto-updates, so you never miss a bug fix or new feature release.
Re-registering Existing Blades
Beyond creating new swords, this tweaker allows you to modify existing ones. The BladeRegistry#reregister(String, IItemStack) method lets you force an ItemStack to be registered under a specific blade name, effectively overriding its original properties. For example, to change the default kill count of the "White Fox" blade:
val blade = BladeRegistry.getBladeItemStack("flammpfeil.slashblade.named.fox.white");BladeUtils.setKillCount(blade, 114514);BladeRegistry.reregister("flammpfeil.slashblade.named.fox.white", blade);After running this script, taking the White Fox from creative mode will give you a blade with 114,514 kills already recorded. This is perfect for creating boss-tier rewards or testing end-game content.
Conclusion
Slash Blade Tweaker is an indispensable tool for anyone serious about modding Minecraft's combat. It transforms the Slash Blade mod from a fixed collection of swords into a blank canvas. Whether you are building a custom RPG modpack, creating a unique PvP arena, or just want a katana that reflects your playstyle, this add-on delivers the flexibility you need. The scripting language is approachable for beginners and powerful enough for veterans. So why wait? Dive into the documentation, experiment with the BladeRegistry chain, and start forging your legendary arsenal today.
Remember, the only limit is your imagination — and your ZenScript skills. Happy crafting, and may your blades never dull.