⚓ SeaTeams

Advanced Team & Clan Plugin · Fully GUI-Based · 100% Async · Folia Native

---

[!TIP] Join the Community!
Join our Discord Server for live test servers, direct developer support, and custom add-ons!

---

Overview

Most team plugins ship with incomplete feature sets—lacking offline stat tracking, action logging, safe database updates, or crashing the moment you run them on multi-threaded servers like Folia.

SeaTeams fixes every single one of those gaps:

• ⚡ 100% Async Architecture — Every database query and data operation runs completely off the main thread. Zero TPS impact, even on heavily populated servers.
• 🌿 Native Folia Support — Built ground-up with Folia’s regional scheduler. No hacky workarounds or thread race conditions.
• 📊 Offline-Correct Statistics — Kills, deaths, block counts, and playtime are recorded in SeaTeams' persistent database—never relying on Bukkit's limited online API.
• 🔄 Automated Schema Migrations — Updating the plugin never wipes your team data. Database migrations run seamlessly on startup.
• 🔓 DRM-Free & Unobfuscated — Clean, performant code with no external license verification or phone-home systems.

---

---

What's New

• 📈 Per-Member Offline Statistics — Full tracking for kills, deaths, mob kills, blocks, and playtime with first-login backfill so existing progress is preserved.
• ⚙️ Database Schema Migrations — Automatically handles updates by adding missing columns without touching existing bank balances, Enderchests, or team rosters.
• 🔒 Dupe-Proof Enderchest Auto-Save — 30-second background auto-saves combined with detailed per-player diff logs on inventory close.
• 🆘 Interactive SOS / Help Alert — Instant team broadcast with clickable coordinates that trigger /tpa automatically.
• 📫 Mass-Mail System — Send items directly from your hand to every team's mailbox using /teamadmin mail *.
• 🕵️ Admin Inspect Mode — Gain full leader access to any team menu with anonymous action broadcasting.
• ⚔️ Configurable PvP Scope — Dynamically switch between global PvP or team-only friendly fire toggles.

---

Feature Comparison

Feature	⚓ SeaTeams	Most Other Team Plugins
Folia Regional Scheduler	✅ Native	❌ Unsupported
Offline Player Statistics	✅ Full DB Tracking	❌ Online Only
Bank & Enderchest Action Logs	✅ Detailed Logs	⚠️ Rare / Basic
Safe DB Schema Migrations	✅ Automatic	⚠️ Wipes Data
Help / SOS with Clickable /tpa	✅ Built-in	❌ None
DRM-Free & Unobfuscated	✅ Yes	⚠️ Varies

---

---

Features

Teams & Roles

• 4 Configurable Roles: Leader, Co-Leader, Officer, Member (all permissions & names customizable in settings.yml).
• Invite System: Up to 18 pending invites per player.
• Safety Dialogs: GUI confirmation popups for kicking members, leaving, or disbanding a team.
• Friendly Fire Toggle: Real-time toggle inside the GUI with no menu re-opening required.
• Name Protection: Built-in configurable banned-word filter.

Team Bank

• Economy Integration: Full support for Vault (EssentialsX, CMI, etc.).
• Quick Deposit Buttons: $100, $1,000, or custom amounts typed directly in chat.
• Transaction Audit Logs: View Today, Yesterday, 7 Days, or custom date ranges (Leader/Co-Leader restricted).
• Admin Alerts: Console logging for transactions $\ge $1,000$.
• Smart Formatting: Automatic K / M / B shorthand balance formatting.

Team Enderchest

• Shared Inventory: 3-row GUI storage accessible by authorized team members.
• Diff Logging: Records exact items deposited/withdrawn by player and timestamp.
• 30s Auto-Save: Background save thread guarantees full dupe protection.

Player Statistics

• Tracked Metrics: Kills, Deaths, Mobs Killed, Blocks Placed, Blocks Broken, EXP Levels, Balance, Playtime.
• Drill-Down GUI: Click any metric to inspect individual team member heads and specific values.
• Historical Backfill: Automatically imports existing vanilla Bukkit stats on first run.

Homes & Extras

• Team Homes: Hopper-style 5-slot GUI home menu with teleportation and overwrite confirmations.
• Alliance System: Ally requests and dedicated alliance chat channel via /ac.
• Team Mailbox: 27-slot cross-team item delivery menu.
• Top Teams Leaderboard: GUI display featuring player heads and customizable lore.

SOS System

• Instant Emergency Alert: Broadcasts coordinates and world name to all online teammates via /team help.
• Clickable Teleport: Teammates can click the chat prompt to run /tpa instantly.
• Sound Cues & Cooldowns: Plays distinct audio notifications with a configurable 60s cooldown.

---

Commands

Player Commands

Command	Description
/team	Opens the main interactive Team GUI
/team create <name>	Create a new team
/team invite <player>	Invite a player to your team
/team help	Broadcast an SOS alert with clickable coordinates
/team home	Teleport to team home
/team bank	Open the shared team bank GUI
/team chat (or /tc)	Toggle team chat channel
/team ally <team>	Send an alliance request to another team
/team leaderboard	Open top teams leaderboard GUI

Admin Commands

Command	Description	Permission
/teamadmin inspect <team>	Open any team's menu with full leader permissions	seateams.admin
/teamadmin spy	Toggle global team & ally chat spy	seateams.admin
/teamadmin mail *	Deliver item in hand to every team's mailbox	seateams.admin
/teamadmin delete <team>	Force-disband a team (with confirmation GUI)	seateams.admin
/teamadmin bank <team> <+/->	Add or remove money from a team bank	seateams.admin
/teamadmin reload-leaderboard	Force refresh top-team scores immediately	seateams.admin

---

Permissions

Permission	Description	Default
seateams.use	Access to /team command and main GUI	true
seateams.create	Ability to create a team	true
seateams.admin	Access to all /teamadmin commands	op
seateams.reload	Ability to reload plugin configurations	op
seateams.bypass.bannedwords	Bypass team name filter	op
seateams.bypass.creationcost	Bypass economic team creation costs	op

---

PlaceholderAPI

SeaTeams includes full PlaceholderAPI support out of the box for scoreboards, tab-lists, chat formatters, and holograms (DecentHolograms, TAB, FeatherBoard, etc.).

Team Placeholders

• %seateams_name% — Team Name
• %seateams_role% — Player's Role
• %seateams_kills% — Total Team Kills
• %seateams_deaths% — Total Team Deaths
• %seateams_rank% — Team Leaderboard Rank
• %seateams_score% — Total Team Score
• %seateams_bank% — Formatted Bank Balance (1.5M)
• %seateams_online% — Online Member Count
• %seateams_level% — Team Level
• %seateams_allies% — Allied Teams Count

Leaderboard Placeholders

%seateams_top_1_name%    • %seateams_top_1_score%
%seateams_top_1_leader%  • %seateams_top_1_kills%