JustTeams

A teams, clans, and guilds plugin for Paper, Folia, and proxy networks. Players form a team with a tag and a name, invite members, and run the whole thing from clean in game menus. It handles roles and per member permissions, a shared bank and ender chest, homes and warps, allies, PvP, a five tier upgrade system, quests, points, and leaderboards, and it speaks to every player in their own language. The goal is to stay fast and stable on busy servers and in sync across a network.

Runs on Minecraft 1.21.11 up to 26.2, on Paper, Folia, and Folia forks like Purpur and CanvasMC. No internal server code, so it keeps working across the 26.x line.

How it works

Create a team with /team create <tag> <name>, where the tag comes first and the name can have spaces. Set a solid colour or a hex gradient with /team setcolor, and it follows the tag, the name, chat, and the tab list everywhere. Everything runs from a central menu (/team), and every menu, message, and command is configurable and translatable.

Teams live in a database, so nothing is tied to one server. On a network the same team, bank, points, and ender chest are the same everywhere, and changes show up on the other servers as they happen.

Roles and permissions

• Owner, Co Owner, and Member roles, each with its own colour and icon
• Per member toggles for bank withdraw, ender chest, set home, use home, and the management rights (edit members, kick, promote, demote)
• The owner grants exactly what each rank can do from the member menu, so co owners get only the control you allow
• Transfer ownership, promote, demote, and kick, all with confirmation and safe against a member switching teams mid action

Bank, upgrades, and storage

• Team bank backed by Vault, with a per member withdraw permission, a configurable max balance, and race free deposits and withdrawals that stay correct even across servers
• Tier upgrades: five tiers that raise the member cap and ender chest size, add a PvP damage bonus, and cut the home cooldown. Pay with money, points, or both (team_upgrades.cost_type), and every perk is hard capped in code so no config mistake can break balance
• Shared ender chest, sized by tier, safe to open across a network, and protected against duplication and item loss

Homes, warps, chat, and allies

• Team home with warmup, cooldown, and a cooldown reduction from upgrades
• Team warps, multiple per team, each with an optional password and cost, and a per member use permission
• Team chat, local and cross server, with a toggle and a character prefix, plus a staff chat spy
• Allies between teams with mutual confirmation and a configurable max
• Team glow to highlight teammates in the team colour through PacketEvents, and a PvP toggle with a cooldown

Quests, points, and leaderboards

• Team quests that rotate automatically, reward points and money, and include anti farm guards. Add your own in quests.yml
• Team points, a season friendly score separate from the bank, set or awarded by staff or the API
• Leaderboards for kills, balance, members, and points, with positional placeholders for scoreboards and tab

Per player languages

• Every player picks the language JustTeams speaks to them with /team usersettings. The choice is saved and follows them across restarts and servers, and team broadcasts render per recipient
• Ships full English, Spanish, French, and German. Drop in a lang/<code>.yml to add your own
• Anything you did not translate falls back to the base language automatically, so a message is never blank or half done

Delegated pricing

You decide which team actions a team owner may price for their own team, and the cap for each. Owners set their prices from /team prices, members pay the team's price, and the owner and permitted co owners do not. Critical actions like creation and rename stay locked to your defaults. Everything is stored per team and syncs across the network.

Network and cross server

• Shared MySQL backbone so teams, bank, points, and ender chests stay in step across Velocity or BungeeCord
• Optional Redis for instant updates: team chat, member changes, balance, settings, and disband propagate the moment they happen
• Money and point changes are applied and read back atomically, so nothing is lost or doubled when two servers act at once

Admin and technical

• Admin menu to manage any team: edit balance and stats, force disband, view a team's home, warps, and ender chest, and edit members, with the permission re checked on every click
• PlaceholderAPI support with a large set: tag, coloured tag, name, description, role, members online, bank, points, tier, and the leaderboard placeholders
• Show a custom name for players (for example %cmi_user_nickname%) in every menu and member list
• Folia, Purpur, and Paper detected automatically, with all entity, inventory, and teleport work kept on the correct region threads
• Optional hooks: ExcellentClaims land protection, EternalCombat combat tagging, Floodgate and Geyser for Bedrock, and TAB for grouping team members in the tab list

Commands

Command	What it does
/team	Open the team menu
/team create <tag> <name>	Create a team
/team invite <player>	Invite a player
/team join <team>	Join a public team or request to join
/team bank	Open the team bank
/team enderchest	Open the shared ender chest
/team sethome / /team home	Set and teleport to the team home
/team setwarp <name> / /team warp <name>	Create and use team warps
/team setcolor	Set the team colour or gradient
/team chat	Toggle team chat
/team quests	Open the quests menu
/team points	View team points
/team top	Open the leaderboards
/team prices	Set the team's own action prices
/team usersettings	Choose your language
/team admin	Open the staff management panel

The full command and permission list is in the docs.

Compatibility

• Java 21 or newer
• Paper, Folia, or a Folia fork such as Purpur or CanvasMC
• Minecraft 1.21.11 through 26.2
• Requires Vault for the bank and costs, and PlaceholderAPI for placeholders
• Optional hooks: Redis, MySQL, PacketEvents, ExcellentClaims, EternalCombat, Floodgate, Geyser, TAB

Setup

1. Put the jar in your plugins folder
2. Start the server once to generate the config files
3. Set your options in config.yml, and the menus and messages in gui.yml and messages.yml
4. Run /team admin reload

Updating is safe. New options are merged into your existing files, your old configs are backed up first, and your comments and layout stay where you put them.

Visual Description

ignore: teams, clan, guild, factions