TTeams | Folia & Paper Team Plugin [No Dupe / Claims / Wars / Banking]

[HR][/HR]

⚡ Why TTeams?
Most legacy team and clan plugins suffer from three critical problems on modern servers:

1. Shared Inventory Duplication: Desynchronization glitches when multiple players view team chests simultaneously.
2. Main Thread Tick Lag: Blocking database operations freeze the server.
3. Folia Crashes: Region-threading violations that crash modern multi-threaded servers.

TTeams solves all of these. Engineered from the ground up for modern Paper, Purpur, and Folia 1.21+ servers, TTeams delivers enterprise-grade performance, complete anti-duplication architecture, and an intuitive GUI-first player experience.

[HR][/HR]

Core Features

️ Sub-Microsecond Territory Claims & 5x5 Radar GUI

• Sub-50ns Query Speed: In-memory spatial hash (world:chunkX:chunkZ) backed by SQLite (WAL) or MySQL.
• Visual 5x5 Chunk Radar (/team map): Real-time graphical chunk grid showing owned territory (Green), enemy claims (Red), allied claims (Blue), and wilderness (White). Claim or unclaim land with a single click.
• Full Protection: Protects blocks, containers (chests, barrels, hoppers), redstone mechanisms (doors, trapdoors, levers, buttons), armor stands, and animals against grief and explosions.

Zero-Dupe Shared Team Enderchest (/team chest)

• Single In-Memory Instance: Multiple teammates interact with the exact same live inventory object simultaneously. Real-time synchronization eliminates desync exploits.
• Optimistic Revision Database Locking: Atomic updates (WHERE team_id = ? AND revision = ?) prevent item loss and rollback errors.
• Graceful Shutdown Auto-Flush: Dirty storage inventories are automatically saved to disk before shutdown.

14-Permission Granular Role Matrix (/team permissions)

• Full control over: BUILD, DESTROY, CONTAINERS, INTERACT, BANK_DEPOSIT, BANK_WITHDRAW, CLAIM, UNCLAIM, INVITE, KICK, WAR_MANAGE, UPGRADES, SET_HOME, SET_WARP.
• Four hierarchical roles: Recruit ➔ Member ➔ Officer ➔ Co-Leader ➔ Leader.
• Leaders can toggle permissions dynamically per role through a color-coded dye GUI.

Mutex-Protected Team Banking

• Pool money into a shared team treasury with strict mutex locks preventing double-spending.
• Seamless integration with Vault (EssentialsX, Treasury, etc.).
• Microsecond-timestamped audit logs and console alerts for large transactions.

⚔️ Competitive Team Wars & Progression

• Scheduled Wars: 24-hour truce countdown followed by an intense 2-hour battle. First team to reach target score wins the pot and team XP.
• Anti-Farming Protection: Enforces a 300s kill cooldown and same-IP checks to stop alt-account score farming.
• 100-Level XP Curve: Earn team XP from mining, mob kills, and PvP to unlock extra claims, roster capacity, and perks.

Web Maps & Discord Integrations

• Dynmap & BlueMap: Real-time 2D and 3D territory polygon overlays with customizable team colors and HTML tooltips.
• DiscordSRV: Dispatches automated embeds when teams are founded, disbanded, level up, or declare war.

⚡ 1-Click Legacy Migration Engine (/ta import)

• Seamlessly import legacy teams, members, bank balances, homes, and claims from BetterTeams or SeaTeams:
  
  Code (Text):

  /ta import betterteams confirm

[HR][/HR]

⌨️ Player Commands & Permissions

Main Command: /team (Aliases: /t, /teams)
Default Permission: tteams.use (Granted to all players)

Command	Description
/team	Opens the interactive main team hub GUI
/team create <name> [tag]	Creates a new team with validated name and tag
/team disband	Prompts 2-factor modal confirmation to delete team
/team invite <player>	Sends a 5-minute interactive invite to target
/team accept <team>	Accepts a pending team invite
/team kick <player>	Kicks a lower-ranking member from the team
/team promote <player>	Promotes a member to higher rank
/team permissions [role]	Opens live role permission toggle GUI
/team chest	Opens shared anti-dupe team enderchest
/team claim	Claims current chunk for your team
/team map	Opens interactive 5x5 chunk claiming radar
/team deposit <amount>	Deposits Vault currency into team bank
/team withdraw <amount>	Withdraws currency from team bank
/team sethome [name]	Sets private team home location
/team home [name]	Teleports asynchronously (Folia-safe) to team home
/team war declare <team>	Declares war against a rival team
/team sos	Broadcasts emergency GPS coordinates to teammates
/tc <msg> / /ac <msg>	Quick team / ally chat channels

[HR][/HR]

Admin Commands & Permissions

Admin Command: /tteamsadmin (Alias: /ta)
Admin Permission: tteams.admin (Default: OP)
Bypass Permission: tteams.admin.bypass (Bypass claim protections)

• /ta inspect <team> - View complete team database record, stats, and roster.
• /ta lock <team> / /ta unlock <team> - Freeze/unfreeze team actions during moderation.
• /ta diagnostics - Real-time Folia status, JVM memory footprint, and sub-50ns cache telemetry.
• /ta import <betterteams|seateams> [confirm] - 1-click legacy migration engine.
• /ta addmoney <team> <amt> / /ta takemoney <team> <amt> - Manage team bank balances.
• /ta setlevel <team> <lvl> / /ta setxp <team> <xp> - Manage team progression.
• /ta reload - Hot-reloads configuration files.

[HR][/HR]

PlaceholderAPI & LuckPerms

PlaceholderAPI (25+ Placeholders):
%tteams_name%, %tteams_tag%, %tteams_role%, %tteams_level%, %tteams_xp%, %tteams_bank%, %tteams_claims_count%, %tteams_kdr%, %tteams_members_online%

LuckPerms Dynamic Contexts:
tteams-in-team, tteams-is-leader, tteams-role, tteams-level

[HR][/HR]

Installation

1. Download TTeams-1.0.0.jar from the GitHub Releases link below.
2. Place the JAR file into your server's plugins/ folder.
3. Verify your server is running Java 21 and Paper, Purpur, or Folia 1.21+.
4. Start your server. SQLite (WAL) is enabled by default with zero configuration required!