PowerPlugin: Unified Class-Based RPG System
PowerPlugin transforms your PaperMC server into a full-fledged class-based RPG. Every player picks (or is assigned) a distinct power class—each with its own strengths, weaknesses, and signature abilities. The plugin is built for Minecraft 1.21.x, relies on a clean event-driven architecture, and is easily extensible.

Architecture Overview
Class Registry A Map<UUID, String> playerClasses stores each player’s chosen class name (“Undead”, “Kiborg”, “Automaton”, “Richman”, etc.).

Resource & Cooldown Trackers

Map<UUID, Double> playerWealth tracks dynamic wealth for the Richman class.

Map<UUID, Long> cooldown maps enforce per-player cooldowns on abilities.

API Versioning Compiled against Paper API 1.21.6-R0.1-SNAPSHOT, with api-version: 1.21 in plugin.yml.

Utility Methods Central helpers like isInSunlight(Player), isNight(Player), and isUndead(Player) live in shared utility classes for maximum reuse.

Class Descriptions
Undead
A cursed warrior caught between life and death.

Sunlight Vulnerability By checking world time, weather, sky light level, and roof exposure, exposed Undead players catch fire via player.setFireTicks() alongside flame sounds and ash particles.

Water Weakness Entering any Material.WATER or BUBBLE_COLUMN deals periodic damage, spawns smoke particles, and sends a chilling message.

Vampiric Strikes On hitting living entities (via EntityDamageByEntityEvent), Undead soak life back—more health at night—with a per-player cooldown, heart particles, and spectral sounds.

Night Speed While the sun sleeps, Undead gain a permanent speed buff to hunt in the graveyard.

Kiborg
A high-tech soldier of tomorrow fitted with built-in weaponry.

Fireball Launcher Right-click air or block with an empty hand to fire a customized Fireball. It spawns at eye level, flies at 1.5× speed, has configurable yield, and can be set non-incendiary.

Cooldown & Overheat A 60-second cooldown simulates weapon overheat, disabling fire if still active.

Underwater Lockout Submerge and the Kiborg’s systems disable, warning the player that firing is offline.

Tactical Feedback Ghast-shoot sounds, optional smoke rings on charge, and console messages maintain immersion.

Automaton
A half-mechanical humanoid powered by internal energy cores.

Self-Destruct At low energy or via command, triggers an AOE explosion that damages nearby entities.

Terrain Debuffs Standing on metal slows the Automaton, while lava contact inflicts heat damage.

Energy Feeds Special “power cells” or electric pressure plates refill hunger/energy, enabling extended uptime.

Passive Armor Enhanced physical resistance but critical vulnerability to electrical shocks.

Ambient FX Crackling electric arcs, metallic clanks, and motor hums follow your every move.

Richman
An aristocrat whose wealth is both boon and burden.

Greed Metric Inventory value and held currency sum up to a “greed” score, recalculated every few seconds.

Wealth Buffs Crossing wealth thresholds grants mining speed boosts, saturation buffs, and bonus damage vs. mobs.

Richness Debuffs Hoard too much, and you suffer slowness and accelerated hunger to balance the scales.

Dynamic Feedback Gold-colored particles swirl when buffs activate; chat messages notify you of your rising or falling fortune.

Extensibility & Next Steps
Configurable Balancing via config.yml for cooldown durations, damage values, and particle counts.

New Classes can be added by registering a new key in playerClasses, hooking events, and defining custom checks with shared utilities.

Localization & Commands such as /class me, /class switch <name>, and per-class help in multiple languages.

Performance & Cleanup: automatically clear maps on player logout, migrate deprecated health APIs to modern Attributes, and benchmark heavy listeners.

With PowerPlugin, your server becomes an immersive RPG playground where environment, class synergy, and strategic cooldowns define epic battles and unforgettable adventures.

- Atmospheric effects:
- Whispers, strange sounds, illusory shadows and lightning.

- Command `/test me` - will show the player's state: HP, saturation, class, greed level, etc.

## Installation

1. Download `MyPlugin.jar`.
2. Place it in the `plugins` folder on the Paper or Spigot server.
3. Restart the server.
4. Configure the plugin via commands or config (if required).

## ⚙️ Requirements

- Minecraft 1.20+ (or any compatible version with API changes)
- Java 17+
- PaperMC or compatible Spigot server

## Commands

text
/test me
/test illusoryOres <time> <x> <y> <z>

power <nickname> <class>