PowerPlugin: Unified Class-Based RPG System \nPowerPlugin transforms your PaperMC server into a full-fledged class-based RPG. Every player picks (or is assigned) a distinct power class\u2014each 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.<\/p>\n
Architecture Overview \nClass Registry A Map playerClasses stores each player\u2019s chosen class name (\u201cUndead\u201d, \u201cKiborg\u201d, \u201cAutomaton\u201d, \u201cRichman\u201d, etc.).<\/p>\n
Resource & Cooldown Trackers<\/p>\n
Map playerWealth tracks dynamic wealth for the Richman class.<\/p>\n
Map cooldown maps enforce per-player cooldowns on abilities.<\/p>\n
API Versioning Compiled against Paper API 1.21.6-R0.1-SNAPSHOT, with api-version: 1.21 in plugin.yml.<\/p>\n
Utility Methods Central helpers like isInSunlight(Player), isNight(Player), and isUndead(Player) live in shared utility classes for maximum reuse.<\/p>\n
Class Descriptions \nUndead \nA cursed warrior caught between life and death.<\/p>\n
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.<\/p>\n
Water Weakness Entering any Material.WATER or BUBBLE_COLUMN deals periodic damage, spawns smoke particles, and sends a chilling message.<\/p>\n
Vampiric Strikes On hitting living entities (via EntityDamageByEntityEvent), Undead soak life back\u2014more health at night\u2014with a per-player cooldown, heart particles, and spectral sounds.<\/p>\n
Night Speed While the sun sleeps, Undead gain a permanent speed buff to hunt in the graveyard.<\/p>\n
Kiborg \nA high-tech soldier of tomorrow fitted with built-in weaponry.<\/p>\n
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\u00d7 speed, has configurable yield, and can be set non-incendiary.<\/p>\n
Cooldown & Overheat A 60-second cooldown simulates weapon overheat, disabling fire if still active.<\/p>\n
Underwater Lockout Submerge and the Kiborg\u2019s systems disable, warning the player that firing is offline.<\/p>\n
Tactical Feedback Ghast-shoot sounds, optional smoke rings on charge, and console messages maintain immersion.<\/p>\n
Automaton \nA half-mechanical humanoid powered by internal energy cores.<\/p>\n
Self-Destruct At low energy or via command, triggers an AOE explosion that damages nearby entities.<\/p>\n
Terrain Debuffs Standing on metal slows the Automaton, while lava contact inflicts heat damage.<\/p>\n
Energy Feeds Special \u201cpower cells\u201d or electric pressure plates refill hunger\/energy, enabling extended uptime.<\/p>\n
Passive Armor Enhanced physical resistance but critical vulnerability to electrical shocks.<\/p>\n
Ambient FX Crackling electric arcs, metallic clanks, and motor hums follow your every move.<\/p>\n
Richman \nAn aristocrat whose wealth is both boon and burden.<\/p>\n
Greed Metric Inventory value and held currency sum up to a \u201cgreed\u201d score, recalculated every few seconds.<\/p>\n
Wealth Buffs Crossing wealth thresholds grants mining speed boosts, saturation buffs, and bonus damage vs. mobs.<\/p>\n
Richness Debuffs Hoard too much, and you suffer slowness and accelerated hunger to balance the scales.<\/p>\n
Dynamic Feedback Gold-colored particles swirl when buffs activate; chat messages notify you of your rising or falling fortune.<\/p>\n
Extensibility & Next Steps \nConfigurable Balancing via config.yml for cooldown durations, damage values, and particle counts.<\/p>\n
New Classes can be added by registering a new key in playerClasses, hooking events, and defining custom checks with shared utilities.<\/p>\n
Localization & Commands such as \/class me, \/class switch , and per-class help in multiple languages.<\/p>\n
Performance & Cleanup: automatically clear maps on player logout, migrate deprecated health APIs to modern Attributes, and benchmark heavy listeners.<\/p>\n
With PowerPlugin, your server becomes an immersive RPG playground where environment, class synergy, and strategic cooldowns define epic battles and unforgettable adventures.<\/p>\n
– \ud83d\udcbb Command `\/test me` – will show the player’s state: HP, saturation, class, greed level, etc.<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. Download `MyPlugin.jar`. \n2. Place it in the `plugins` folder on the Paper or Spigot server. \n3. Restart the server. \n4. Configure the plugin via commands or config (if required).<\/p>\n
## \u2699\ufe0f Requirements<\/p>\n
– Minecraft 1.20+ (or any compatible version with API changes) \n– Java 17+ \n– PaperMC or compatible Spigot server<\/p>\n