👻 DeadSpirit Plugin

DeadSpirit is a Minecraft plugin that tracks your combat history and introduces a thrilling consequence to player death: the return of your own restless spirit as a Revenant!

---

✨ Features

📖 Mob Codex (Kill Tracker)

DeadSpirit meticulously tracks every single mob you defeat across all worlds.

• Use the /mobcodex command to open the Kill Log GUI.
• The interactive menu displays exactly how many times you've killed a specific entity.
• Admins can check another player's mob codex using /mobcodex <player>.

💀 Revenants (Player Death Echoes)

Death is no longer just a respawn screen. Sometimes, the malicious energy left behind by a fallen player will manifest into a formidable enemy!

• Spawn Chance: When a player dies, there is a chance (configurable, default 30%) that a Revenant of that player will spawn exactly where they died.
• Adaptive Monster Types: The type of undead that spawns adapts dynamically to your environment and the weapons you held:
  • Nether Environments: Spawns a Zombie, Skeleton, or Wither Skeleton.
  • Desert Biomes: Spawns a Husk.
  • Swamp Biomes: Spawns a Drowned.
  • Holding a Trident: Spawns a Drowned.
  • Holding a Bow: Spawns a Skeleton (or a Stray if you died in a freezing biome).
• Steals Your Gear: The Revenant is terrifying because it equips an exact replica of the armor, main-hand weapon, and shield you were using at the moment of your death!
• Buffed With Magic: Your restless spirit is infused with dark energy. The Revenant spawns with 2 to 3 permanent, random, high-level potion effects.
• Bounty: Defeating a Revenant drops Emeralds as a reward for laying the spirit to rest!

---

💻 Commands

• /mobcodex - Opens the Mob Kill History GUI for yourself.
• /mobcodex <player> - Opens the Mob Kill History GUI for a specified player.

---

🔧 Configuration

All variables for the Revenant spawn chances and emerald drops are strictly customizable via config.yml.

config.yml (Example values)

config-version: "240807-prod"

# Chance for a Revenant to spawn when a player dies (0.3 = 30% chance)
mob-spawn-chance: 0.3

# Default fallback mob type if biome conditions don't match
mob-type: "RANDOM"

# Potion effects the Revenant can randomly receive upon spawn
effects:
  - SPEED
  - STRENGTH
  - REGENERATION
  - FIRE_RESISTANCE
  - INVISIBILITY
  - JUMP

# The min and max amount of potion effects the Revenant gets
min-effects: 2
max-effects: 3

# Emerald drop reward for killing a Revenant
emerald-drop-chance: 0.5
emerald-min: 1
emerald-max: 2

---

🏗 How to Build

The project uses Gradle as its build tool and targets Paper 1.21 (Java 21).

1. Ensure you have Java 21 installed on your system.
2. Open a terminal or Command Prompt in the root directory of the plugin folder.
3. Run the Gradle build command:
   • On Windows: .\gradlew.bat clean build
   • On Linux/Mac: ./gradlew clean build
4. Wait for the compilation process to finish. If successful, you'll see a BUILD SUCCESSFUL message.
5. The compiled .jar file will be located in the build/libs/ folder.
6. Copy the compiled .jar into your Minecraft server's plugins folder, and start the server!