StormFactions

# StormFactions StormFactions is a native factions plugin for Paper servers. It provides persistent factions, chunk claims, player power, diplomacy, land protection, faction chat, homes, warps, SafeZone and WarZone claims, and optional StormEconomy bank support. It is built for servers that want faction land control without relying on an external factions plugin or a separate protection system. ## Features - Persistent factions with configurable names, tags, descriptions, and MOTDs. - Faction ranks: Leader, Co-Leader, Officer, Member, and Recruit. - Invites, joins, denials, leaving, disbanding, kicking, promoting, demoting, and leadership transfer. - Faction chat through `/f chat` and `/fc`. - Faction info, list, top, who, power, and map commands. - Player power with death loss, regeneration, minimum and maximum values, and claim capacity. - Chunk claiming, radius claiming, unclaiming, unclaim all, and autoclaim. - SafeZone and WarZone admin claims. - Overclaiming rules for vulnerable enemy land. - Diplomacy with Ally, Truce, Neutral, and Enemy relations. - Configurable ally and truce limits. - Friendly-fire controls for allies and truces. - Faction homes and warps with warmup, cooldown, movement cancellation, and damage cancellation. - Optional faction bank creation, linking, deposits, withdrawals, and balances through StormEconomy. - Optional faction upkeep based on claim count. - Local audit records for major faction actions. - Admin bypass, audit, storage, backup, save, reload, prune, and reset tools. - Bukkit events and `StormFactionsApi` for integrations. ## Land Protection StormFactions protects faction land at the chunk level. Protection can cover: - Block breaking and placing. - Containers. - Interactive blocks such as doors, gates, buttons, levers, bells, lecterns, and redstone controls. - Entities, armour stands, hanging entities, and vehicles. - Buckets. - Fluid flow. - Pistons. - Fire spread and ignition. - Explosions. - Crop trampling. - Mob griefing. Explosion and environmental protection respects land state. WarZone and wilderness remain open, SafeZone is protected, and vulnerable faction land can allow explosions when configured. ## Integrations StormFactions works standalone, but it integrates with other Thunder plugins when they are installed. ThunderPerms: - Uses ThunderPerms for command permission checks when available. - Falls back to Bukkit permissions if ThunderPerms is missing or unavailable. StormEconomy: - Can charge creation, claim, sethome, and setwarp costs. - Can require StormEconomy for costs or skip costs if no provider is available. - Can create or link StormEconomy banks for factions. - Supports faction bank deposits, withdrawals, balances, and upkeep charges. BlockLedger: - StormFactions registers `StormFactionsApi`. - BlockLedger can read StormFactions claim context through the API and attach claim metadata to ledger records. Developer/API integrations: - Registers `StormFactionsApi`. - Registers `StormFactionsPermissionBridge`. - Emits faction events for creation, disbanding, member joins/leaves, rank changes, relation changes, claims, unclaims, overclaims, power changes, bank actions, upkeep, chat, and teleports. Soft dependencies: - ThunderPerms - StormEconomy - StormParty - StormMMO - Teamwork - Alignments - BlockLedger - Lifesaver - NPCs - Bodyguard The current release directly uses ThunderPerms and StormEconomy. Other plugins can integrate through the API and events. ## Commands Faction commands: - `/f create ` - `/f invite ` - `/f join ` - `/f deny ` - `/f leave` - `/f disband` - `/f kick ` - `/f promote ` - `/f demote ` - `/f transfer ` - `/f info [faction]` - `/f list` - `/f top` - `/f who ` - `/f power [player]` - `/f map` - `/f motd ` - `/f desc ` - `/f tag ` - `/f chat ` - `/fc ` Diplomacy commands: - `/f ally ` - `/f truce ` - `/f neutral ` - `/f enemy ` Claim commands: - `/f claim [radius]` - `/f unclaim [radius]` - `/f autoclaim` - `/f unclaimall` Home and warp commands: - `/f sethome` - `/f home` - `/f warp set ` - `/f warp del ` - `/f warp list` - `/f warp go ` Bank commands: - `/f bank create` - `/f bank deposit ` - `/f bank withdraw ` - `/f bank balance` - `/f bank link ` - `/f bank unlink` Aliases: - `/faction` - `/factions` Admin commands: - `/stormfactions status` - `/stormfactions audit` - `/stormfactions storage` - `/stormfactions backup` - `/stormfactions save` - `/stormfactions reload` - `/stormfactions prune` - `/stormfactions reset confirm` - `/stormfactions bypass` - `/stormfactions safezone [radius]` - `/stormfactions warzone [radius]` ## Permissions - `stormfactions.defaults` - `stormfactions.use` - `stormfactions.create` - `stormfactions.claim` - `stormfactions.chat` - `stormfactions.home` - `stormfactions.warp` - `stormfactions.bank` - `stormfactions.admin` - `stormfactions.admin.audit` - `stormfactions.admin.backup` - `stormfactions.admin.reload` - `stormfactions.admin.save` - `stormfactions.admin.prune` - `stormfactions.admin.reset` - `stormfactions.admin.bypass` - `stormfactions.admin.claims` ## Storage and Security StormFactions supports YAML, SQLite, MySQL, and MariaDB. SQLite is the default storage backend. Security-focused storage behaviour includes: - Secure MySQL and MariaDB JDBC examples using certificate or hostname verification. - JDBC credential redaction in diagnostics and storage status. - Credential-like JDBC query parameters stripped before database connections are opened. - Manual backups through `/stormfactions backup`. - Manual saves through `/stormfactions save`. - Autosave with configurable interval. - Optional backup before destructive actions. - Storage health reporting through admin commands. - Config validation with safe fallbacks for invalid limits and patterns. ## Notes StormFactions focuses on faction ownership, claims, diplomacy, power, and land protection. StormParty remains separate for lightweight player parties, while StormEconomy handles balances and banks when economy integration is enabled.