🛡️ ApxTeams

ApxTeams is a modern, lightweight, and modular team management plugin designed for Paper and Spigot 1.21+ Minecraft servers. Built for both survival and enterprise networks, it features intuitive inventory GUIs, granular permissions, combat protection, teleportation, private team chat, and lag-free statistics.

✨ Features

• 🖥️ Clean Inventory GUIs:

  • Modern team management menus with pagination, sorting (Role, Name, Online status), and search.
  • Member management and permission toggles.
  • Confirmation GUIs to prevent accidental kicks or disbands.
  • Team Settings and Top Leaderboards GUI.

• 👥 Role Hierarchy & Granular Permissions:

  • 4 Role tiers: Owner, Co-Owner, Moderator, and Member.
  • Configurable permissions per role (inviting, kicking, sethome, toggling PvP, team chat, etc.).

• ⚔️ Friendly Fire (PvP) Protection:

  • Prevents teammates from hurting each other (melee, arrows, tridents, and harmful splash potions) when PvP is toggled off.

• 🏠 Team Home & Teleports:

  • Teleport warmup countdown with Title and ActionBar alerts.
  • Movement cancellation if player moves during warmup.
  • Configurable teleport cooldowns.

• 💬 Private Team Chat:

  • Dedicated team chat mode (/team chat) and quick messaging (/tchat <message>).
  • Staff spy permission (apxteams.chat.spy) to monitor chat.

• 📊 Statistics & Leaderboard:

  • Tracks Kills, Deaths, K/D Ratio, Blocks Broken, Blocks Placed, and Playtime.
  • Asynchronous background batching ensures zero impact on server tick rate (TPS).
  • Top teams leaderboard GUI with cycling metrics.

• 💾 Database Storage:

  • SQLite (Default): Ready to use instantly with zero configuration.
  • MySQL / MariaDB: Enterprise support powered by HikariCP connection pooling.

📋 Commands

Player Commands (/team or /t, /teams)

Quick Chat Command (/tchat or /tc)

• /tchat — Toggles team chat mode
• /tchat <message> — Sends a quick message to teammates

Admin Commands (/teamadmin or /tadmin)

• /teamadmin reload — Reloads config and menus
• /teamadmin list — Lists all registered teams
• /teamadmin info <team> — Inspects detailed team data
• /teamadmin delete <team> — Force-disbands a team

🔑 Permissions

• apxteams.use — Basic access to player commands (Default: true)
• apxteams.create — Permission to create a team (Default: true)
• apxteams.leaderboard — Permission to view top leaderboard (Default: true)
• apxteams.admin — Full administrative control (Default: op)
• apxteams.chat.spy — Allows staff to view team chats (Default: op)

🧩 Compatibility & Requirements

• Server: Paper, Purpur, Spigot (1.21+)
• Java: Java 17 or higher
• Optional Hooks:
  • PlaceholderAPI (Placeholders support)
  • Vault (Team creation / rename costs)