# StormMMO StormMMO is a broad RPG skill progression plugin for Paper servers. It adds mcMMO-style levelling, active abilities, passive bonuses, leaderboards, persistent player profiles, admin tools, storage diagnostics, and API/events for optional integrations. StormMMO intentionally does not include party mechanics. Party ownership, party chat, sharing, and friendly-fire rules belong in StormParty, while StormMMO focuses on skills, XP, abilities, profiles, and progression events. ## Skills StormMMO includes 19 displayed skills: - Acrobatics - Alchemy - Archery - Axes - Crossbows - Excavation - Fishing - Herbalism - Maces - Mining - Repair - Salvage - Smelting - Spears - Swords - Taming - Tridents - Unarmed - Woodcutting Salvage and Smelting are derived child skills. Salvage uses Repair and Fishing levels; Smelting uses Mining and Repair levels. ## Features - 1-100 RPG progression using the `STANDARD` formula. - `RETRO` is accepted as a compatibility alias and currently uses the same 1-100 curve. - Configurable maximum level up to 100, global XP multiplier, level-up broadcasts, and actionbar progress. - Gathering progression for Mining, Excavation, Woodcutting, Herbalism, and Fishing. - Combat progression for Swords, Axes, Unarmed, Archery, Crossbows, Maces, Spears, Tridents, and Taming. - Utility progression for Repair and Alchemy, with derived Salvage and Smelting systems. - Acrobatics progression from fall survival, rolls, and dodges. - Leaderboards for power level and individual skills. - Player rank lookup and profile inspection. - Admin XP and level editing, with derived skills following their parent skills. - Profile backups, storage status, audit tools, forced saves, and reload support. - Per-world progression control with blacklist or whitelist mode. - Creative, spectator, AFK metadata, and vanished metadata filtering. - Anti-exploit handling for player-placed blocks, spawner mob XP, repeated acrobatics locations, teleport lockout, and repeated combat XP on the same target. ## Active Abilities StormMMO includes active abilities with configurable ready windows, durations, cooldowns, particles, and sounds. - Super Breaker for Mining - Blast Mining for Mining - Giga Drill Breaker for Excavation - Tree Feller for Woodcutting - Green Terra for Herbalism - Serrated Strikes for Swords - Skull Splitter for Axes - Berserk for Unarmed - Explosive Shot for Archery All active abilities unlock at level 5 except Blast Mining, which unlocks at Mining 10. Players can ready abilities through right-click actions or with `/stormability `. StormMMO avoids readying abilities from normal interactions with containers, doors, workstations, redstone controls, and similar blocks. When BlockLedger inspector mode is active, inspection clicks are not treated as StormMMO ability actions. ## Gameplay Coverage StormMMO includes: - Level-scaled bonus drop rolls. - Excavation treasure rewards. - Fishing XP, shake drops, treasure drops, and fish diet bonuses. - Hylian Luck-style Herbalism emerald rewards. - Automatic crop replanting. - Repair anvils using iron blocks. - Salvage anvils using gold blocks. - Material consumption for repair and salvage. - Configurable repair enchant preservation. - Configurable salvage enchant extraction. - Furnace ownership tracking for Mining, Repair, and derived Smelting progression. - Smelting bonus output and fuel burn improvements from effective Smelting level. - Brewing ownership tracking for Alchemy progression. - Sword rupture effects. - Axe critical hits. - Armour-sensitive limit break damage, PvP by default with optional PvE support. - Archery daze and arrow recovery rolls. - Mace cripple effects. - Spear momentum effects. - Unarmed disarm. - Taming XP and wolf combat bonuses. - Acrobatics roll and dodge. ## Integrations StormMMO works standalone. Missing optional plugins do not stop it from running. ThunderPerms: - StormMMO declares detailed skill, ability, command, admin, and bypass permission nodes. - ThunderPerms can grant or deny access through normal Bukkit permission handling. BlockLedger: - StormMMO checks BlockLedger inspector state when the API is available. - Inspector clicks are ignored by StormMMO’s ability and utility-block interaction handling. StormEconomy: - StormEconomy can listen to StormMMO level-up events and XP-gain events. - StormEconomy can pay configurable level-up rewards, and optional XP-gain rewards when enabled in StormEconomy. StormParty: - StormParty can listen to StormMMO XP-gain events and share bonus XP with nearby eligible party members. - StormMMO itself does not contain party ownership, chat, or sharing logic. StormQuests: - StormQuests can listen to StormMMO XP and level events. - StormQuests can use StormMMO levels for requirements and grant StormMMO XP rewards. Developer/API integrations: - Registers `StormMmoApi` through Bukkit services. - Other plugins can query profiles, skill levels, power level, leaderboards, global XP multiplier, and storage health. - Other plugins can award StormMMO XP through the API. - Emits `StormMmoXpGainEvent` when XP is awarded and event emission is enabled. - Emits `StormMmoLevelUpEvent` when a skill level increases and event emission is enabled. StormMMO declares soft dependencies on: - ThunderPerms - BlockLedger - Teamwork - ThreatMeter - Alignments - Lifesaver - NPCs - Bodyguard Its integration diagnostics also report TestLab when present. ## Commands Main commands: - `/stormmmo help` - `/stormmmo status` - `/stormmmo integrations` - `/stormmmo audit` - `/stormmmo storage` - `/stormmmo backup` - `/stormmmo save` - `/stormmmo reload` - `/stormstats [player]` - `/stormskill [player]` - `/stormtop [power|skill] [page]` - `/stormrank [player]` - `/storminspect ` - `/stormability [on|off|toggle|ability]` - `/stormcooldowns` Admin commands: - `/stormxp ` - `/stormlevel ` ## Permissions Normal player access is granted by `stormmmo.defaults`, which includes the main player commands, notifications, all skill permissions, and all ability permissions. General permissions: - `stormmmo.defaults` - `stormmmo.use` - `stormmmo.notify` - `stormmmo.commands.stats` - `stormmmo.commands.skill` - `stormmmo.commands.top` - `stormmmo.commands.rank` - `stormmmo.commands.ability` - `stormmmo.commands.cooldowns` - `stormmmo.skills.all` - `stormmmo.abilities.all` Admin and bypass permissions: - `stormmmo.admin` - `stormmmo.commands.inspect` - `stormmmo.commands.admin.xp` - `stormmmo.commands.admin.level` - `stormmmo.commands.admin.save` - `stormmmo.commands.admin.backup` - `stormmmo.commands.admin.reload` - `stormmmo.commands.admin.audit` - `stormmmo.bypass.world` - `stormmmo.bypass.cooldown` Skill permissions use `stormmmo.skills.`, for example `stormmmo.skills.mining`. Ability permissions use `stormmmo.abilities.`, for example `stormmmo.abilities.super_breaker`. ## Storage and Security StormMMO supports YAML, SQLite, MySQL, and MariaDB. SQLite is enabled by default for durable local player data. Security-focused storage behaviour includes: - SQLite paths are constrained to the plugin data folder. - MySQL and MariaDB default JDBC examples use hostname-verifying TLS modes. - Insecure remote JDBC settings are warned about at startup. - Credential-like JDBC query parameters are redacted in diagnostics and removed from the JDBC URL before connection. - Username and password config fields are used for database credentials. - Profile backups through `/stormmmo backup`. - Manual saves through `/stormmmo save`. - Autosave with configurable interval. - Storage health reporting through commands and API. - Config validation with safe fallbacks for invalid numeric settings.

StormMMO

0.2.1

0.2.0

0.1.1

0.1.0