Teamwork

Teamwork

Rewards trusted nearby players with small cooperative buffs, balanced trust building, and anti-abuse safeguards.

Teamwork is a standalone Paper plugin that encourages players to work together without turning cooperation into an easy farm. Players build pair-based trust by staying near each other, avoiding PvP with each other, and contributing useful recent activity such as mining, cutting, or hostile mob combat.

Trust is tracked by UUID pair, not player name, so it remains stable across name changes.

Features

• Pair-based trust tracking with stable order-independent UUID keys.
• Same-world proximity checks with configurable radius, vertical limit, drop radius, and optional line of sight.
• Passive trust gain after players stay near each other long enough.
• Balanced activity mode by default, so one active player cannot easily farm trust with an AFK player.
• Activity trust from mining, cutting, hostile mob hits, and hostile mob kills.
• Configurable activity scores, contribution windows, recipient limits, and per-pair gain caps.
• PvP lockout prevents players from building or receiving teamwork credit with someone they recently fought.
• Optional trust reset when PvP happens.
• Indirect PvP attribution for knockback/fall damage, player-placed lava/fire, TNT source data, pets, lingering clouds, and recently placed end crystals.
• Configurable damage reduction buffs for trusted nearby teammates.
• Damage reduction can be enabled or disabled by source category, including PvP, hostile melee, hostile projectiles, environmental damage, fall, void, explosions, magic, and sonic boom.
• Configurable Haste buff based on trusted nearby teammates.
• Haste protects equal or stronger beacon/potion effects by default.
• Player filters for spectator, creative, dead, AFK metadata, and vanished metadata.
• World blacklist or whitelist support.
• Player-placed block tracking helps reduce block-break trust farming.
• Spatial bucket scanning reduces proximity work on larger servers.
• Actionbar status messages can show active teammate count and damage reduction.
• Optional Bukkit integration events for other plugins.
• Admin tools for status, trust checks, top pairs, exact pair inspection, debug diagnostics, save, backup, prune, reset, and reload.

Buffs

Teamwork currently supports two main cooperative buffs:

• Damage reduction from trusted nearby teammates.
• Haste from trusted nearby teammates.

By default, damage reduction applies to hostile melee and hostile projectile damage, but not PvP. This keeps Teamwork useful in PvE while avoiding abuse as a PvP damage sponge.

Persistence

Teamwork can run in memory-only mode or save trust data between restarts.

Supported modes:

• MEMORY_ONLY
• YAML_WITH_DECAY
• SQLITE_WITH_DECAY
• MYSQL_WITH_DECAY
• MARIADB_WITH_DECAY

The decay modes allow trust to fade while players are inactive or offline, which helps keep old pair data from becoming permanent server clutter.

Storage And Security

• Memory-only mode is the default.
• YAML, SQLite, MySQL, and MariaDB persistence are optional.
• SQLite paths are kept inside the plugin data folder.
• Example MySQL and MariaDB URLs use certificate and hostname verification.
• JDBC credentials are redacted from status and diagnostics.
• Old pair state can be pruned automatically.
• Backups can be created from the command line before maintenance.

Commands

Main command:

• /teamwork

Common commands:

• /teamwork status
• /teamwork trust <player>
• /teamwork top [page]
• /teamwork leaderboard [page]
• /teamwork pair <online-player|uuid> <online-player|uuid>
• /teamwork debug
• /teamwork save
• /teamwork backup
• /teamwork prune
• /teamwork reset <online-player|uuid> <online-player|uuid>
• /teamwork reload

Permissions

Every permission defaults to operator access.

Grant all Teamwork permissions:

• teamwork.admin

Or assign individual permissions:

• teamwork.use
• teamwork.status
• teamwork.trust
• teamwork.top
• teamwork.pair
• teamwork.debug
• teamwork.save
• teamwork.backup
• teamwork.prune
• teamwork.reset
• teamwork.reload

Optional Integrations

Teamwork works with several other Thunder plugins while still remaining fully standalone.

• Alignments can consume TeamworkCooperationEvent as trusted cooperation evidence, letting real nearby teamwork influence alignment scoring.
• ThreatMeter can read Teamwork’s active trusted teammate count through TeamworkApi and reduce threat score when a player has trusted support nearby.
• StormEconomy can listen for Teamwork cooperation events and pay configurable cooperation rewards.
• Other plugins can use TeamworkApi to check active trusted teammate count, pair trust score, conflict lockout status, pair details, top pairs, and persistence health.

These hooks are optional. If the other plugins are not installed, Teamwork keeps working normally with its own trust, buffs, commands, and persistence.

Notes

Teamwork is designed to reward real cooperation, not passive proximity farming. The default configuration uses balanced contribution checks, PvP lockouts, AFK/vanish filters, player-placed block filtering, gain caps, and trust decay options to keep the system fair on public servers.