operationragnarok

also make sure that its easy to create a texturepack for it

📎 1 file 7,503 chars
📄
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.
Kodari AI
KodariAug 2 at 8:43 pm 3
TotemCraft
TotemCraft is a Paper 1.21.11 survival PvP progression plugin built around permanent Soul Totems. Players receive one randomly selected soul with passive and active abilities, six rechargeable charges, kill rewards, shard recovery, revival mechanics, and unique custom items. It also adds the legendary End Totem, administrator Banisher and Restorer tools, protected plugin items, configurable recipes, GUIs, permissions, cooldowns, anti-farming protection, persistent player data, and resource-pack-ready custom model data.
  1. Create the Paper plugin foundation, persistent soul and charge system, commands, permissions, and configuration.

  2. Implement Soul Totem abilities, resurrection handling, recharge mechanics, protected items, Banisher, and Restorer.

  3. Add inventory GUIs, configurable recipes with an in-game recipe editor, and admin controls.

  4. Include resource-pack templates and custom model data configuration for easy texture creation.

operationragnarok

i found a bug in the server none of the commands are working and the plugin is disabled

Kodari AI
KodariAug 2 at 10:08 pm 4

Fixed the plugin disable issue in plugin.yml.

The root cause was invalid YAML:

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:

YAML
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.

operationragnarok

[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) ~[?:?]

Kodari AI
KodariAug 2 at 10:27 pm 3

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 AIR ingredients 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.

operationragnarok

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:

text
[ERROR]: null
org.bukkit.command.CommandException: Unhandled exception...
...
Caused by:
java.lang.NullPointerException
...

or

text
java.lang.IllegalArgumentException

The full stack trace is what tells us exactly what's wrong.

Also tell me:

  1. What command did you type?

* /totem * /totem admin * /totem recipes * Something else?

  1. Are you using:

* Paper 1.21.11? (I think yes) * The plugin I helped design, or one generated by another AI (Claude, Gemini, etc.)?

  1. 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.

Kodari AI
KodariAug 2 at 10:30 pm 1

The plugin is enabled, so the failure is inside the command handler rather than startup.

Please provide:

  1. The exact command used, such as /totem, /totem admin, or /totem recipes.

  2. The complete console stack trace immediately afterward, including every Caused by: section.

You can extract it from logs/latest.log by searching for:

Plain Text
Unhandled exception executing command

The deepest Caused by line—often a NullPointerException, invalid material, or inventory error—will identify the fix.

operationragnarok

m ake shure it works at 1.21.11

Kodari AI
KodariAug 2 at 10:43 pm 3
  1. Audit TotemCraft for 1.21.11 compatibility and command-time failures.

  2. 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() with getRespawnLocation().

  • Updated recipe removal to Bukkit.removeRecipe(key, false).

  • Updated ShapedRecipe#shape(...) to use a List<String>.

  • Updated recipe ingredients to use ItemStack choices.

The plugin’s declared Paper API target is already:

Gradle
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.

operationragnarok

[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

Kodari AI
KodariAug 3 at 7:19 am 1
  1. Fix the invalid shaped-recipe pattern that crashes Paper 1.21.11 during onEnable.

  2. Add validation so a malformed/empty configured pattern cannot disable the plugin.

  3. 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 3x3 pattern 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.

operationragnarok

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

text
/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

text
/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

text
/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

text
/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:

text
/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.

Kodari AI
KodariAug 3 at 7:48 am 7
  1. Replace the existing soul/totem model with the four Soul Totems and their charge rules.

  2. Implement /totem ability with each soul’s passive, upgraded passive, cooldown, and active effect.

  3. Update recipes, commands, persistence, and event listeners to remove the old souls and preserve enable safety.

  4. 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.

operationragnarok

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

Kodari AI
KodariAug 3 at 7:55 am 4
  1. Make death/respawn restore behavior reliable while removing all dropped/owned totems on death.

  2. Add Curse of Vanishing to every Soul Totem and ensure it survives item creation/reload paths.

  3. Clean up player-facing messages and GUI titles/lore for a minimalistic presentation.

  4. 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.

Kodari can make mistakes. Review important code before using.
Files
resource-pack
src
build.gradle
README.md
settings.gradle
Code
28 2,090
src/main/java/com/kodari/totemcraft/TotemCraft.java
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));
    }
}