also make sure that its easy to create a texturepack for it
📄
pasted-code-1785703089153.txt
txt
495 lines
▶
# **TotemCraft v1.0 - Full Design Document**
## 📦 General Information
**Plugin Name:** TotemCraft
**Minecraft Version:** Paper **1.21.11**
**Type:** Survival • PvP • Progression
---
# 🌟 Core Concept
Every player is given **one random Soul Totem** when they first join the server.
Each Soul Totem:
* Is permanently bound to its owner.
* Gives unique passive and active abilities.
* Holds **6 Charges**.
* Cannot be traded or stored.
* Is the player's only source of Totem of Undying protection.
There are **8 Soul Totems**, each representing a different Soul.
---
# ❤️ Soul Totems
Every player receives **ONE** random Soul Totem.
Examples:
* ⚔ Berserker Totem
* 🛡 Guardian Totem
* 🌪 Wind Totem
* 🏹 Hunter Totem
* 🔥 Ember Totem
* 🌊 Tide Totem
* 🌑 Shadow Totem
* ❤️ Vital Totem
The Soul is **random** and permanent unless changed by an admin.
---
# ❤️ Charges
Every Soul Totem has:
**Maximum Charges: 6**
Players begin with:
**6 Charges**
Whenever the Totem activates:
* -1 Charge
Example
```text
6 → 5 → 4 → 3 → 2 → 1 → 0
```
---
# ⚔ Recharge System
## Player Kill
Every player kill grants:
+1 Charge
Maximum:
6
To prevent abuse, the plugin should include anti-farming protection (such as preventing repeated kills of the same player from awarding charges within a cooldown).
---
## Totem Shards
Players can craft **Totem Shards**.
Using one instantly restores:
+1 Charge
### Restriction
You **cannot craft a Totem Shard if you have 3 or more Charges.**
Crafting is only allowed when you have:
* 0 Charges ✅
* 1 Charge ✅
* 2 Charges ✅
If you have:
* 3 Charges ❌
* 4 Charges ❌
* 5 Charges ❌
* 6 Charges ❌
Crafting is blocked.
This keeps Totem Shards as a recovery mechanic instead of a way to stay permanently maxed.
---
# 💀 Death
If your Soul Totem reaches:
**0 Charges**
and you die:
* The Soul Totem breaks.
* You lose every Soul ability.
* Totem protection is gone.
---
# 🌱 Totem Revival
Used to restore a broken Soul Totem.
Available by:
* Crafting
* Admin Command
After revival:
* Soul returns.
* Charges reset to 1.
---
# ✨ Soul Abilities
Every Soul has:
* Passive Ability
* Active Ability
Examples:
### Berserker
Passive:
+15% melee damage
Active:
Blood Rush
---
### Guardian
Passive:
10% damage reduction
Active:
Temporary shield.
---
### Wind
Passive:
Speed I
Active:
Dash.
---
### Hunter
Passive:
Improved ranged combat.
Active:
Focus.
---
### Ember
Passive:
Fire Resistance.
Active:
Flame Burst.
---
### Tide
Passive:
Water Breathing.
Active:
Water Dash.
---
### Shadow
Passive:
Speed after kills.
Active:
Short invisibility.
---
### Vital
Passive:
Faster regeneration.
Active:
Second Wind.
---
# 🌌 End Totem
The **only craftable special totem**.
Extremely rare.
Single-use.
### Ability
When activated:
* Prevents death.
* Teleports the player to their spawn point (or world spawn if no bed is set).
* Grants:
* Regeneration
* Resistance
* Fire Resistance
* Short invulnerability
* Is consumed after use.
It is intended as a legendary escape item, not a replacement for the Soul Totem.
---
## Recipe
* 🥚 1 × Dragon Egg
* 👁️ 4 × Eyes of Ender
* 🟢 1 × Totem of Undying
* 💎 1 × Totem Shard
The Dragon Egg is **consumed** in the recipe, making each End Totem an incredibly valuable end-game item.
---
# ⚖ Banisher (Admin Only)
Cannot be crafted.
Moderation item.
### Right Click
* Clears inventory
* Clears armor
* Clears offhand
* Clears XP
* Clears potion effects
Everything removed is safely backed up.
---
## Eternal Judgment
Places the player into a permanent Banished state.
The player cannot:
* Move
* Jump
* Attack
* Use items
* Eat
* Break blocks
* Place blocks
* Open inventories
* Pick up items
* Drop items
The effect lasts until an admin removes it.
---
# 🌿 Restorer (Admin Only)
Admin-only item.
Purpose:
Undo everything the Banisher did.
### Right Click a Banished player
Restores:
* Inventory
* Armor
* Offhand
* XP
* Potion effects
Removes:
* Permanent Banished state.
If no backup exists, nothing happens.
---
# 🔒 Item Protection
Plugin items cannot be:
* Dropped
* Traded
* Stolen
* Placed into chests
* Barrels
* Ender Chests
* Shulker Boxes
* Hoppers
* Droppers
* Dispensers
* Furnaces
* Item Frames
* Bundles (if supported)
The only exception is **admin items** (Banisher and Restorer), which admins may store and move freely.
---
# 🖥 INVENTORY GUI
## `/totem`
Shows:
* Current Soul
* Current Charges
* Passive Ability
* Active Ability
* Active Ability Cooldown
---
## Recipe Editor (Admin)
```
/totem recipes
```
Allows admins to edit:
* Totem Shard recipe
* Totem Revival recipe
* End Totem recipe
Completely in-game.
No config editing required.
---
## Admin Panel
```
/totem admin
```
Contains:
* Give Souls
* Revive Souls
* View Charges
* Recipe Editor
* Give Banisher
* Give Restorer
* Reload Plugin
---
# Commands
### Player
```text
/totem
```
---
### Admin
```text
/totem revive
/totem setsoul
/totem setcharges <0-6>
/totem addcharges
/totem removecharges
/totem info
/totem recipes
/totem admin
/totemcraft reload
/banisher give
/restorer give
```
---
# Permissions
```
totemcraft.admin
totemcraft.revive
totemcraft.setsoul
totemcraft.charges
totemcraft.recipes
totemcraft.reload
totemcraft.banisher
totemcraft.restorer
```
---
# Configurable Options
Everything should be configurable in `config.yml`, including:
* Maximum Charges
* Starting Charges
* Soul abilities and cooldowns
* Totem Shard crafting rules
* Anti-farming settings for charge rewards
* End Totem recipe
* Totem Revival recipe
* INVENTORY GUI titles
* Messages
* Sounds
* Particles
* Banisher settings
* Restorer behavior
---
# Gameplay Loop
1. Join the server and receive a **random Soul Totem**.
2. Start with **6 charges**.
3. Use your Soul's passive and active abilities to survive and fight.
4. Every Totem activation consumes **1 charge**.
5. Defeat players to regain charges, or craft **Totem Shards** if you're down to **2 charges or fewer**.
6. If you reach **0 charges** and die, your Soul Totem breaks until it's restored.
7. Work toward crafting the **legendary End Totem**, which requires sacrificing the **Dragon Egg** for a one-time lifesaving escape.
8. Admins moderate using the **Banisher** and **Restorer**, while server owners can customize recipes through the in-game Recipe Editor.
## One suggestion before development
The one remaining piece I'd design before coding is the **eight Soul Totems** in detail. Since they're now the centerpiece of the plugin, each one should have:
* A distinct passive ability.
* A unique active ability with a balanced cooldown.
* A custom display name and lore.
* A custom model or texture (if you use a resource pack).
If every Soul Totem feels equally powerful but plays differently, TotemCraft will have a strong identity and good replayability.
Create the Paper plugin foundation, persistent soul and charge system, commands, permissions, and configuration.
Implement Soul Totem abilities, resurrection handling, recharge mechanics, protected items, Banisher, and Restorer.
Add inventory GUIs, configurable recipes with an in-game recipe editor, and admin controls.
Include resource-pack templates and custom model data configuration for easy texture creation.
i found a bug in the server none of the commands are working and the plugin is disabled
Fixed the plugin disable issue in plugin.yml.
The root cause was invalid YAML:
commands: totem:
Because the command section was malformed, Paper could not properly load the plugin descriptor, so the plugin disabled and none of the commands registered.
I also corrected the dependency declaration so XSeries can load from the plugin:
libraries:
- com.github.cryptomorin:XSeries:13.0.0
Rebuild and replace the plugin JAR, then restart the server completely. Check the console for any remaining startup error if it still disables.
[00:16:55 ERROR]: Command exception: /totemcraft:restorer org.bukkit.command.CommandException: Cannot execute command 'totemcraft:restorer' in plugin TotemCraft v1.0.0 - plugin is disabled. at org.bukkit.command.PluginCommand.execute(PluginCommand.java:37) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.command.brigadier.bukkit.BukkitCommandNode$BukkitBrigCommand.run(BukkitCommandNode.java:83) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at com.mojang.brigadier.context.ContextChain.runExecutable(ContextChain.java:73) ~[brigadier-1.3.10.jar:?] at net.minecraft.commands.execution.tasks.ExecuteCommand.execute(ExecuteCommand.java:30) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.tasks.ExecuteCommand.execute(ExecuteCommand.java:13) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.UnboundEntryAction.lambda$bind$0(UnboundEntryAction.java:8) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.CommandQueueEntry.execute(CommandQueueEntry.java:5) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.ExecutionContext.runCommandQueue(ExecutionContext.java:104) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.executeCommandInContext(Commands.java:469) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.performCommand(Commands.java:374) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.performCommand(Commands.java:362) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.network.ServerGamePacketListenerImpl.performUnsignedChatCommand(ServerGamePacketListenerImpl.java:2375) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.network.ServerGamePacketListenerImpl.lambda$handleChatCommand$12(ServerGamePacketListenerImpl.java:2348) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.TickTask.run(TickTask.java:18) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.BlockableEventLoop.doRunTask(BlockableEventLoop.java:177) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.ReentrantBlockableEventLoop.doRunTask(ReentrantBlockableEventLoop.java:24) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.doRunTask(MinecraftServer.java:1525) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.doRunTask(MinecraftServer.java:188) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.BlockableEventLoop.pollTask(BlockableEventLoop.java:151) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.pollTaskInternal(MinecraftServer.java:1505) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.pollTask(MinecraftServer.java:1499) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.recordTaskExecutionTimeWhileWaiting(MinecraftServer.java:1225) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1341) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:388) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at java.base/java.lang.Thread.run(Thread.java:1516) ~[?:?] [00:17:05 INFO]: K4ibol issued server command: /totem [00:17:05 ERROR]: Command exception: /totem org.bukkit.command.CommandException: Cannot execute command 'totem' in plugin TotemCraft v1.0.0 - plugin is disabled. at org.bukkit.command.PluginCommand.execute(PluginCommand.java:37) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.command.brigadier.bukkit.BukkitCommandNode$BukkitBrigCommand.run(BukkitCommandNode.java:83) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at com.mojang.brigadier.context.ContextChain.runExecutable(ContextChain.java:73) ~[brigadier-1.3.10.jar:?] at net.minecraft.commands.execution.tasks.ExecuteCommand.execute(ExecuteCommand.java:30) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.tasks.ExecuteCommand.execute(ExecuteCommand.java:13) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.UnboundEntryAction.lambda$bind$0(UnboundEntryAction.java:8) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.CommandQueueEntry.execute(CommandQueueEntry.java:5) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.ExecutionContext.runCommandQueue(ExecutionContext.java:104) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.executeCommandInContext(Commands.java:469) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.performCommand(Commands.java:374) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.performCommand(Commands.java:362) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.network.ServerGamePacketListenerImpl.performUnsignedChatCommand(ServerGamePacketListenerImpl.java:2375) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.network.ServerGamePacketListenerImpl.lambda$handleChatCommand$12(ServerGamePacketListenerImpl.java:2348) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.TickTask.run(TickTask.java:18) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.BlockableEventLoop.doRunTask(BlockableEventLoop.java:177) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.ReentrantBlockableEventLoop.doRunTask(ReentrantBlockableEventLoop.java:24) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.doRunTask(MinecraftServer.java:1525) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.doRunTask(MinecraftServer.java:188) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.BlockableEventLoop.pollTask(BlockableEventLoop.java:151) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.pollTaskInternal(MinecraftServer.java:1505) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.pollTask(MinecraftServer.java:1499) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.recordTaskExecutionTimeWhileWaiting(MinecraftServer.java:1225) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1341) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:388) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at java.base/java.lang.Thread.run(Thread.java:1516) ~[?:?] [00:17:14 INFO]: K4ibol issued server command: /totemcraft:banisher [00:17:14 ERROR]: Command exception: /totemcraft:banisher org.bukkit.command.CommandException: Cannot execute command 'totemcraft:banisher' in plugin TotemCraft v1.0.0 - plugin is disabled. at org.bukkit.command.PluginCommand.execute(PluginCommand.java:37) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.command.brigadier.bukkit.BukkitCommandNode$BukkitBrigCommand.run(BukkitCommandNode.java:83) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at com.mojang.brigadier.context.ContextChain.runExecutable(ContextChain.java:73) ~[brigadier-1.3.10.jar:?] at net.minecraft.commands.execution.tasks.ExecuteCommand.execute(ExecuteCommand.java:30) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.tasks.ExecuteCommand.execute(ExecuteCommand.java:13) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.UnboundEntryAction.lambda$bind$0(UnboundEntryAction.java:8) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.CommandQueueEntry.execute(CommandQueueEntry.java:5) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.execution.ExecutionContext.runCommandQueue(ExecutionContext.java:104) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.executeCommandInContext(Commands.java:469) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.performCommand(Commands.java:374) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.commands.Commands.performCommand(Commands.java:362) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.network.ServerGamePacketListenerImpl.performUnsignedChatCommand(ServerGamePacketListenerImpl.java:2375) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.network.ServerGamePacketListenerImpl.lambda$handleChatCommand$12(ServerGamePacketListenerImpl.java:2348) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.TickTask.run(TickTask.java:18) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.BlockableEventLoop.doRunTask(BlockableEventLoop.java:177) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.ReentrantBlockableEventLoop.doRunTask(ReentrantBlockableEventLoop.java:24) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.doRunTask(MinecraftServer.java:1525) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.doRunTask(MinecraftServer.java:188) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.util.thread.BlockableEventLoop.pollTask(BlockableEventLoop.java:151) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.pollTaskInternal(MinecraftServer.java:1505) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.pollTask(MinecraftServer.java:1499) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.recordTaskExecutionTimeWhileWaiting(MinecraftServer.java:1225) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1341) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:388) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at java.base/java.lang.Thread.run(Thread.java:1516) ~[?:?]
I’ll trace the plugin’s enable path first—the command stack trace only confirms Paper disabled it, while the actual cause will be in the startup error. Then I’ll fix the first enable-time failure and any descriptor mismatch preventing registration.
The startup failure is in recipe registration, not command execution. The configured End Totem recipe uses A: AIR while A is present in its shape; RecipeManager skips AIR, leaving an unmapped recipe symbol, which makes Paper throw during onEnable() and disables the plugin. I’m fixing that recipe and making registration safely convert empty ingredients to blank recipe slots so the in-game editor cannot recreate the same failure.
Fixed the startup-disable bug.
Root cause: the End Totem recipe had an AIR ingredient assigned to a symbol that was still present in the recipe shape. Paper rejected that invalid shaped recipe during onEnable(), disabling TotemCraft before commands could execute.
Changes made:
Corrected the default End Totem recipe.
Updated recipe registration to convert
AIRingredients into empty recipe slots.Prevented recipes saved through the editor from recreating the invalid-symbol issue.
Rebuild and replace the JAR, then perform a full server restart. The /totem, /banisher, and /restorer commands should register normally.
From the screenshot, I can see:
* ✅ TotemCraft v1.0.0 is loaded. * ✅ It shows up in /plugins, so the plugin enabled successfully. * ❌ But the command you ran says:
> "An unexpected error occurred trying to execute that command."
That means the plugin didn't fail to load—it crashed while running a command.
I need one thing:
Please send the server console error that appears after you run the command.
It will look something like this:
[ERROR]: null
org.bukkit.command.CommandException: Unhandled exception...
...
Caused by:
java.lang.NullPointerException
...
or
java.lang.IllegalArgumentException
The full stack trace is what tells us exactly what's wrong.
Also tell me:
- What command did you type?
* /totem * /totem admin * /totem recipes * Something else?
- Are you using:
* Paper 1.21.11? (I think yes) * The plugin I helped design, or one generated by another AI (Claude, Gemini, etc.)?
- If possible, upload either:
* your latest.log (logs/latest.log), or * the console output after the error.
Once I have the stack trace, I can usually pinpoint the bug in a minute or two.
The plugin is enabled, so the failure is inside the command handler rather than startup.
Please provide:
The exact command used, such as
/totem,/totem admin, or/totem recipes.The complete console stack trace immediately afterward, including every
Caused by:section.
You can extract it from logs/latest.log by searching for:
Unhandled exception executing command
The deepest Caused by line—often a NullPointerException, invalid material, or inventory error—will identify the fix.
m ake shure it works at 1.21.11
Audit TotemCraft for 1.21.11 compatibility and command-time failures.
Patch the affected code/config, then verify all referenced APIs and command paths.
Updated TotemCraft for Paper 1.21.11 compatibility:
Replaced removed
EntityResurrectEvent#getHand().Replaced removed
Player#getBedSpawnLocation()withgetRespawnLocation().Updated recipe removal to
Bukkit.removeRecipe(key, false).Updated
ShapedRecipe#shape(...)to use aList<String>.Updated recipe ingredients to use
ItemStackchoices.
The plugin’s declared Paper API target is already:
io.papermc.paper:paper-api:1.21.11-R0.1-SNAPSHOT
These changes address the 1.21.11 API breakages affecting startup and /totem reload/recipe commands.
[09:18:00 ERROR]: Error occurred while enabling TotemCraft v1.0.0 (Is it up to date?) java.lang.ArrayIndexOutOfBoundsException: Index 0 out of bounds for length 0 at net.minecraft.world.item.crafting.ShapedRecipePattern.unpack(ShapedRecipePattern.java:70) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.world.item.crafting.ShapedRecipePattern.of(ShapedRecipePattern.java:65) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.world.item.crafting.ShapedRecipePattern.of(ShapedRecipePattern.java:60) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at org.bukkit.craftbukkit.inventory.CraftShapedRecipe.addToCraftingManager(CraftShapedRecipe.java:54) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at org.bukkit.craftbukkit.CraftServer.addRecipe(CraftServer.java:1478) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at org.bukkit.Server.addRecipe(Server.java:1027) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.Bukkit.addRecipe(Bukkit.java:1119) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at TotemCraft-1.0.0.jar//com.kodari.totemcraft.recipe.RecipeManager.register(RecipeManager.java:108) ~[?:?] at TotemCraft-1.0.0.jar//com.kodari.totemcraft.recipe.RecipeManager.registerRecipes(RecipeManager.java:34) ~[?:?] at TotemCraft-1.0.0.jar//com.kodari.totemcraft.TotemCraft.onEnable(TotemCraft.java:28) ~[?:?] at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:279) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at io.papermc.paper.plugin.manager.PaperPluginInstanceManager.enablePlugin(PaperPluginInstanceManager.java:207) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at io.papermc.paper.plugin.manager.PaperPluginManagerImpl.enablePlugin(PaperPluginManagerImpl.java:109) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:520) ~[paper-api-1.21.11-R0.1-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.CraftServer.enablePlugin(CraftServer.java:639) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at org.bukkit.craftbukkit.CraftServer.enablePlugins(CraftServer.java:596) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.initPostWorld(MinecraftServer.java:636) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:365) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1253) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at net.minecraft.server.MinecraftServer.lambda$spin$2(MinecraftServer.java:388) ~[paper-1.21.11.jar:1.21.11-116-6f71be8] at java.base/java.lang.Thread.run(Thread.java:1516) ~[?:?] make sure the plugin is enabled
Fix the invalid shaped-recipe pattern that crashes Paper 1.21.11 during
onEnable.Add validation so a malformed/empty configured pattern cannot disable the plugin.
Check the registration path for any additional 1.21.11 incompatibility.
Fixed the Paper 1.21.11 enable crash in RecipeManager.
Changes:
Validates recipe shapes before calling
ShapedRecipe#shape.Rejects empty rows, invalid row lengths, and oversized patterns.
Falls back to a valid
3x3pattern when configuration data is malformed.Catches recipe-registration errors so one invalid recipe cannot disable TotemCraft.
Logs the affected recipe instead of crashing the plugin.
Replace the old JAR with the newly built version and restart the server. Your current config.yml recipes are valid, so the previous crash likely came from an empty or malformed recipe shape in the server’s existing configuration.
I like simplifying it down to 4 Souls. It gives each one a stronger identity and makes balancing much easier. Here's the updated design based on your ideas, with a few balance tweaks noted.
---
TotemCraft v2 - Souls
There are now only 4 Soul Totems:
* ⚔️ Berserker Totem * 🛡️ Guardian Totem * 🌪️ Wind Totem * 🌑 Shadow Totem
Every player receives one random Soul Totem.
---
❤️ Charges
* Starting Charges: 3 * Maximum Charges: 6 * Every Totem pop: -1 Charge * Every player kill: +1 Charge * Totem Shards can only be crafted when you have 0–2 Charges.
---
⚔️ Berserker Totem
Passive
* Permanent Strength I.
Upgraded (6 Charges)
* Strength I becomes Strength II.
Ability
/totem ability
Blood Rush
* Gain Speed III for 15 seconds. * Cooldown: 3 minutes.
---
🛡️ Guardian Totem
Passive
* Permanent Regeneration I.
Upgraded (6 Charges)
* Permanent Regeneration II.
Ability
/totem ability
Divine Protection
* Gain Resistance V for 15 seconds. * Cooldown: 4 minutes.
---
🌪️ Wind Totem
Passive
* No Fall Damage.
Upgraded (6 Charges)
* Permanent Speed I. * Still immune to fall damage.
Ability
/totem ability
Dash
* Launch yourself forward. * Cooldown: 30 seconds.
---
🌑 Shadow Totem
Passive
* Permanent Invisibility.
Upgraded (6 Charges)
* Passive Invisibility. * Hostile mobs ignore you (unless you attack them).
Ability
/totem ability
Shadow Veil
* All nearby players receive:
* Slowness V * Blindness * Duration: 15 seconds. * Cooldown: 4 minutes.
---
Ability Command
Every Soul uses the same command:
/totem ability
The plugin automatically activates the ability for the Soul Totem you currently own.
Example:
* Berserker → Blood Rush * Guardian → Divine Protection * Wind → Dash * Shadow → Shadow Veil
No right-clicking required.
---
Removed
The following Souls have been removed:
* ❌ Hunter * ❌ Ember * ❌ Tide * ❌ Vital
The only Soul Totems are now:
* Berserker * Guardian * Wind * Shadow
---
One balance concern
The Shadow Totem is the only one I'd be careful with. Permanent invisibility can be extremely powerful in Minecraft PvP, especially if armor also becomes invisible. A possible compromise is:
* Armor remains visible (so players can still spot you), or * You become visible for a few seconds whenever you attack or take damage.
That keeps the stealth theme while avoiding situations where players are almost impossible to track in combat. Everything else looks like a solid foundation for a unique progression system.
Replace the existing soul/totem model with the four Soul Totems and their charge rules.
Implement
/totem abilitywith each soul’s passive, upgraded passive, cooldown, and active effect.Update recipes, commands, persistence, and event listeners to remove the old souls and preserve enable safety.
Verify Paper 1.21.11 compatibility and cross-file references.
The four-soul enum and /totem ability path are in place. I’m correcting the remaining passive behavior so it matches the specification exactly and removing the last old-soul runtime references.
Implemented the TotemCraft v2 four-soul system for Paper 1.21.11:
Removed Hunter, Ember, Tide, and Vital.
Added only:
Berserker
Guardian
Wind
Shadow
Starting charges changed to 3.
Maximum charges remain 6.
Totem pops consume one charge and break the soul at zero.
Player kills award one charge.
Totem Shards remain craftable only at 0–2 charges.
Added
/totem ability.Added the requested abilities and cooldowns:
Berserker: Speed III for 15 seconds, 3-minute cooldown.
Guardian: Resistance V for 15 seconds, 4-minute cooldown.
Wind: Forward dash, 30-second cooldown.
Shadow: Nearby players receive Slowness V and Blindness for 15 seconds, 4-minute cooldown.
Added the correct passive effects and six-charge upgrades.
Wind now has fall-damage immunity.
Shadow gains hostile-mob avoidance at six charges and becomes exposed when attacking or taking damage.
Removed old soul references from Java code and configuration.
Fixed the charge-zero broken-state handling.
Replace the old JAR with the newly built JAR and fully restart the Paper 1.21.11 server.
also make sure all totems are deleted after death but you get them back if u respawn and make sure they all have the curse of vanishing enhant also make sure all the chat messages are clean and minimalistic and also the guiss
Make death/respawn restore behavior reliable while removing all dropped/owned totems on death.
Add Curse of Vanishing to every Soul Totem and ensure it survives item creation/reload paths.
Clean up player-facing messages and GUI titles/lore for a minimalistic presentation.
Verify the changes against Paper 1.21.11 APIs and existing command flows.
Implemented:
All Soul Totems are removed on death, including:
Main inventory
Off-hand
Armor slots
Death drops
The player’s saved Soul Totem is restored after respawn with its current soul and charges.
Every Soul Totem now receives Curse of Vanishing automatically.
Existing Soul Totems are refreshed with the enchantment when recreated.
Cleaned up chat messages to be shorter and more minimal.
Simplified GUI titles and button labels.
Fixed recipe GUI title formatting and message placeholders.
Kept the implementation compatible with Paper 1.21.11.
Restart the server after replacing the plugin JAR. Death must be followed by a normal respawn for the Soul Totem to be restored.
package com.kodari.totemcraft;
import com.kodari.totemcraft.command.TotemCommand;
import com.kodari.totemcraft.gui.RecipeEditorGUI;
import com.kodari.totemcraft.gui.TotemGUI;
import com.kodari.totemcraft.listener.TotemListener;
import com.kodari.totemcraft.recipe.RecipeManager;
import com.kodari.totemcraft.util.ItemFactory;
import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.command.CommandSender;
import org.bukkit.plugin.java.JavaPlugin;
public class TotemCraft extends JavaPlugin {
private ItemFactory itemFactory;
private TotemManager totemManager;
private RecipeManager recipeManager;
private TotemListener totemListener;
@Override
public void onEnable() {
saveDefaultConfig();
this.itemFactory = new ItemFactory(this);
this.totemManager = new TotemManager(this);
this.recipeManager = new RecipeManager(this);
this.totemManager.load();
this.recipeManager.registerRecipes();
TotemListener listener = new TotemListener(this);
this.totemListener = listener;
Bukkit.getPluginManager().registerEvents(listener, this);
TotemCommand command = new TotemCommand(this);
if (getCommand("totem") != null) {
getCommand("totem").setExecutor(command);
getCommand("totem").setTabCompleter(command);
}
if (getCommand("banisher") != null) {
getCommand("banisher").setExecutor(command);
}
if (getCommand("restorer") != null) {
getCommand("restorer").setExecutor(command);
}
Bukkit.getScheduler().runTaskTimer(this, () -> this.totemManager.tick(), 20L, 100L);
}
@Override
public void onDisable() {
if (this.totemManager != null) {
this.totemManager.save();
}
}
public void reloadPlugin() {
reloadConfig();
this.recipeManager.registerRecipes();
}
public ItemFactory getItemFactory() {
return itemFactory;
}
public TotemManager getTotemManager() {
return totemManager;
}
public RecipeManager getRecipeManager() {
return recipeManager;
}
public TotemListener getTotemListener() {
return totemListener;
}
public String color(String message) {
return ChatColor.translateAlternateColorCodes('&', message == null ? "" : message);
}
public String message(String path, Object... replacements) {
String value = getConfig().getString(path, path);
for (int i = 0; i + 1 < replacements.length; i += 2) {
value = value.replace("%" + replacements[i] + "%", String.valueOf(replacements[i + 1]));
}
return color(value);
}
public void send(CommandSender sender, String path, Object... replacements) {
sender.sendMessage(message(path, replacements));
}
}