IdentitySteal

A dynamic, evolving identity system for PvP servers — inspired by Jumanji-style adventure and mystery.

---

---

🎯 What is IdentitySteal?

IdentitySteal brings role-based identity cards to your PvP server. Every player receives a locked identity card that grants unique abilities — from flight and invisibility to summoning armies and manipulating the fabric of reality.

But it doesn't stop there. Earn XP, evolve your identity through tiers, and unlock enhanced ability power. Commit to your role or swap it out and start fresh — the choice is yours.

---

---

✨ Core Systems

🎴 Identity Card System

• Every player gets a Card Roller on first join
• Use it to receive a random identity card from a balanced distribution pool
• Cards are locked to your hotbar — can't be dropped, moved, or destroyed
• Right-click to activate primary ability, Shift+Right-click for secondary
• Each card has a unique texture via the resource pack

📈 Identity Evolution

Progression that rewards dedication to your role.

• Earn XP from successful ability activations (+10 XP) and player kills (+50 XP)
• Evolve to Tier II at 1,000 XP — your abilities gain a 1.2× multiplier (stronger duration, damage, summon counts, and more)
• Evolution effects — challenge complete sound, totem particles, and a title announcement when you rank up
• Anti-abuse protection — 60-second per-victim kill cooldown prevents XP farming
• Role change = reset — switching identities wipes all progress, encouraging role commitment
• Fully persistent across server restarts

📊 Sidebar Scoreboard

A built-in, real-time scoreboard that displays your identity stats.

• Per-player boards — each player gets their own scoreboard instance
• Non-invasive — automatically detects and respects other scoreboard plugins
• Fully customizable layout — title and lines with MiniMessage, &-codes, and placeholders
• Togglable — players hide/show with /identity scoreboard toggle
• Performance-optimized — cached rendering, configurable update interval

🔄 Identity Swapper

Want a new role? The Identity Swapper item lets you re-roll your identity at any time. Admins can distribute them via commands.

---

🎭 15 Unique Roles

Every role plays differently. Each has its own config file (roles/<role>.yml) with adjustable cooldowns, durations, and toggles.

⚔️ Combat Roles

Role	Playstyle	Ability
Imposter	Stealth / Thief	Kill a player to steal their role's ability. New kills replace the old one.
Blitz	Burst Damage	Unleash area-of-effect lightning strikes dealing massive damage around you.
Frost	Area Control	Freeze enemies and terrain — slows, damages, and debuffs all players in range.
Rebel	Warlord	Summon allied Vindicators and gain totem immortality for the duration.

🛡️ Tactical Roles

Role	Playstyle	Ability
Anchor	Tactician	Build a teleportation network — place anchors and permanent waypoints with GUI management.
Observer	Scout	Enter spectator mode to scout enemy positions with countdown warnings.
Ghost	Phantom	Gain flight, invisibility, and invulnerability. Secondary: broadcast a fake death message.
Trickster	Illusionist	Spawn NPC clones of yourself to confuse and distract opponents in combat.

🔮 Support Roles

Role	Playstyle	Ability
Healer	Support	Instantly restore health and apply regeneration to yourself or nearby allies.
Forge	Enchanter	Temporarily enchant your worn armor with powerful protection enchantments.
Prophet	Mystic	Access a divine enchantment library — browse categories and claim enchanted books.
Archivist	Scholar	Transform mysterious shards into overpowered enchanted books (levels 3–10!).

🌊 Specialist Roles

Role	Playstyle	Ability
Pawn	Shifter	Manipulate your size via GUI — grow up to 3× or shrink to 0.3× for strategic advantage.
Mirror	Mimic	Copy the abilities of nearby players and use them temporarily.
Poseidon	Aquatic	Master of the ocean — water breathing, enhanced swimming, and drowned army summoning.

---

🔌 PlaceholderAPI & TAB Integration

Full PlaceholderAPI integration with 10+ placeholders. Works with TAB plugin out of the box.

Placeholder	Returns
%identitysteal_role%	Current role display name
%identitysteal_role_id%	Internal role ID
%identitysteal_tier%	Current tier level (1 or 2)
%identitysteal_xp%	Current XP amount
%identitysteal_nexttier_xp%	XP remaining to next tier
%identitysteal_cooldown_primary%	Primary ability cooldown
%identitysteal_cooldown_secondary%	Secondary ability cooldown

All placeholders work in the built-in scoreboard even without PlaceholderAPI installed.

---

⚙️ Fully Configurable

Everything is under your control via config.yml and individual roles/*.yml files:

• Toggle any role on or off individually
• Adjust XP rewards and tier thresholds
• Customize cooldowns and durations per role
• Configure messages with full MiniMessage support (RGB gradients, bold, hover, etc.)
• Particle effects and sounds — choose particle types, counts, sounds, volume, and pitch
• Scoreboard layout — custom title, lines, and update interval
• Card slot — choose which hotbar slot the identity card occupies
• Distribution system — deck-style shuffling ensures all roles are dealt before any repeats
• Evolution system — fully configurable or disable entirely

---

📋 Commands & Permissions

Command	Description	Permission
/identity info	View your current role and ability info	identitysteal.use
/identity reload	Hot-reload all config files	identitysteal.admin
/identity give <player> <role>	Give a specific identity card	identitysteal.admin
/identity roller [player]	Give a Card Roller item	identitysteal.admin
/identity swapper [player] [amount]	Give Identity Swapper items	identitysteal.admin
/identity resetcooldown <player> [role]	Reset a player's ability cooldown	identitysteal.admin
/identity scoreboard toggle	Toggle sidebar visibility	identitysteal.scoreboard
/identity scoreboard reload	Hot-reload scoreboard config	identitysteal.admin
/identity placeholders list	List all available placeholders	identitysteal.use

Aliases: /id, /role

---

📥 Installation

1. Paper 1.21+ server (Purpur also supported)
2. Java 21+
3. Official Resource Pack — required for card textures
4. PlaceholderAPI — optional, for external integrations
5. TAB — optional, works via PAPI placeholders

Drop the JAR in your /plugins folder. Default configs are generated on first run.

---

🔒 Lightweight & Safe

• Thread-safe cooldown management
• Cached scoreboard rendering — no unnecessary updates
• Memory cleanup on player disconnect
• Error isolation — one player's failure never crashes the server
• Graceful degradation — all temporary effects are force-cleaned on disconnect
• Non-invasive scoreboard — respects other plugins by default
• bStats — anonymous usage statistics

---