StormParty

StormParty

StormParty adds persistent lightweight parties for Paper servers. It gives players party roles, party chat, request-based teleporting, friendly-fire protection, proximity reward sharing, and optional StormEconomy bank linking.

It is designed to sit alongside StormMMO, StormEconomy, Teamwork, Alignments, ThreatMeter, and other gameplay plugins without forcing party logic into those systems.

Features

• Persistent parties with configurable names and member limits.
• Party roles: Leader, Officer, Member, and Guest.
• Invite, accept, deny, leave, disband, transfer, kick, promote, and demote commands.
• Party chat through /party chat and /pc.
• Party info and party list commands.
• Friendly-fire protection between party members.
• Configurable default friendly-fire state.
• Request-based party teleporting.
• Teleport expiry, warmup, cooldown, movement cancellation, and damage cancellation.
• Optional XP sharing from StormMMO events.
• Optional money reward sharing from StormEconomy reward events.
• Optional linked StormEconomy party banks.
• Bank member syncing for non-Guest party members.
• Admin audit, storage, backup, save, reload, prune, and reset commands.
• Party chat spy permission for staff.
• Admin override permission for party role checks.
• Local backups before destructive actions when enabled.
• Bukkit events for party creation, membership, chat, roles, teleporting, reward sharing, and disbanding.
• StormPartyApi for other plugins.

Integrations

StormParty works standalone, but it can integrate 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 create and link StormEconomy bank accounts to parties.
• Can sync bank membership when party members join, leave, promote, demote, link, or unlink a bank.
• Can share StormEconomy reward events with nearby eligible party members.
• Ignores StormParty-generated reward keys to prevent reward loops.

StormMMO:

• Can listen for StormMMO XP gain events.
• Can share a configurable bonus amount of XP with nearby eligible party members.
• Ignores StormParty-generated XP sources to prevent XP loops.

Developer/API integrations:

• Registers StormPartyApi.
• Registers StormPartyPermissionBridge.
• Emits StormPartyCreateEvent.
• Emits StormPartyMemberJoinEvent.
• Emits StormPartyMemberLeaveEvent.
• Emits StormPartyRoleChangeEvent.
• Emits StormPartyChatEvent.
• Emits StormPartyTeleportEvent.
• Emits StormPartyRewardShareEvent.
• Emits StormPartyDisbandEvent.

Soft dependencies:

• ThunderPerms
• StormEconomy
• StormMMO
• Teamwork
• Alignments
• ThreatMeter
• Lifesaver
• NPCs
• Bodyguard

The current release directly uses ThunderPerms, StormEconomy, and StormMMO. Missing soft dependencies do not stop StormParty from running.

Commands

Party commands:

• /party create <name>
• /party invite <player>
• /party accept <party|player>
• /party deny
• /party leave
• /party disband
• /party transfer <player>
• /party kick <player>
• /party promote <player>
• /party demote <player>
• /party chat <message>
• /pc <message>
• /party info [party]
• /party list
• /party tp <player>
• /party tpaccept
• /party tpdeny
• /party friendlyfire <on|off>

Bank commands:

• /party bank create
• /party bank link <bank>
• /party bank unlink
• /party bank info

Admin commands:

• /stormparty status
• /stormparty audit
• /stormparty storage
• /stormparty backup
• /stormparty save
• /stormparty reload
• /stormparty prune
• /stormparty reset

Permissions

• stormparty.defaults
• stormparty.use
• stormparty.create
• stormparty.invite
• stormparty.chat
• stormparty.teleport
• stormparty.bank
• stormparty.admin
• stormparty.admin.audit
• stormparty.admin.backup
• stormparty.admin.reload
• stormparty.admin.save
• stormparty.admin.prune
• stormparty.admin.reset
• stormparty.admin.spy
• stormparty.admin.override

Storage and Security

StormParty 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 /stormparty backup.
• Manual saves through /stormparty save.
• Autosave with configurable interval.
• Optional backup before destructive party actions.
• Storage health reporting through commands.
• Config validation with safe fallbacks for invalid limits and patterns.

Defaults

• Maximum party size: 8.
• Invite expiry: 60 seconds.
• Friendly fire: off.
• Reward sharing range: 32 blocks.
• XP sharing bonus: 25%, capped by config.
• Money sharing bonus: 25%, capped by config.
• Teleport request expiry: 30 seconds.
• Teleport warmup: 5 seconds.
• Teleport cooldown: 60 seconds.
• Teleport cancels on movement or damage.

Notes

StormParty focuses on party ownership, social tools, teleporting, friendly-fire rules, bank links, and reward sharing. It does not replace StormMMO progression, StormEconomy balances, or Teamwork trust mechanics; it connects to those systems where useful while keeping party management separate.