KatanaMod

A plugin for Paper 1.20.2 for adding custom Katanas with unique effects and models.

Available weapons:

• Wakizashi (Poison for 5 seconds on impact)
• Tantō (Teleport behind opponent, 5 second cooldown)
• Tachi (Right-click forward dash, 20 second cooldown)
• Ōdachi (Right-click web under opponent, 30 second cooldown)
• Chisa-katana (5s freeze + 10s blindness on impact)
• Shuriken (Thrown weapon, ignites for 1 second, returns on miss, max stack size 16)

How do I download and install the mod? (Tutorial)

Part 1: Plugin (Server)

1. Download or build the latest KatanaMod-<version>.jar file (./gradlew build command in the root directory). You can find the file in the build/libs directory.
2. Place the .jar file in the plugins/ folder of your Minecraft server (Paper Engine 1.20.2 and Java 17 required).
3. Restart the server (or use the /reload confirm command).
4. All versions available in /build/libs (optional)

Part 2: Resource Pack (Client)

To make swords have custom textures instead of the standard iron sword appearance:

1. Copy the KatanaModTexturePack folder to %appdata%/.minecraft/resourcepacks/ (Windows) or ~/.minecraft/resourcepacks/ (Linux/Mac).
2. Launch Minecraft, go to Options -> Resource Packs, and move the pack from the left to the right.
3. Click Done.

Part 3: In-Game

Administrator commands (requires katanamod.admin permission, operators automatically have it):

• `/katana give <YourNickname> <katana name>

You can also obtain them through crafting:

• Wakizashi: 2 iron ingots on top, 1 stick on bottom.
• Tantō: 2 copper ingots on top, 1 stick on bottom.
• And MORE!!!