Custom Teams: PvP Events for Minecraft Servers

Custom Teams lets admins run FFA or 4-team PvP events with kits, spawns, and GUI setup for Minecraft. Download it for Paper today.

Custom Teams

Running a PvP event on a Minecraft server usually means juggling scoreboard commands, hand-placed spawn points, and a spreadsheet of who fights whom. Custom Teams is a Paper plugin that turns that chaos into a clean, GUI-driven workflow. Built by imNikos, it gives admins a full control panel for hosting either a free-for-all brawl or a structured four-team battle, complete with custom kits, smart spawn placement, and per-player kit saving. If you have ever wanted to host a server tournament without writing a single command block, this is the tool for the job.

What Custom Teams Actually Does

At its core, Custom Teams for Minecraft handles the two most popular event formats on survival and PvP servers. In Free-For-All mode, any number of players fight solo with white nametags, and the winner's own name is announced instead of a team label. In Teams mode, four fixed squads — Red, Blue, Green, and Yellow — get light color variants across nametags, the tab list, and chat prefixes, so everyone can tell friend from foe at a glance. The plugin is built on Paper and Bukkit APIs, so it runs on Paper and Paper-based forks rather than vanilla or Fabric servers.

Version and Loader Support

Custom Teams targets Paper 1.21.11 and requires Java 17 or newer, matching the requirements of your server's Minecraft version. Because it leans on Paper's Adventure text components, AsyncChatEvent, and modern world height methods, it will not work on plain Spigot or Fabric. Admins running a Paper-based fork such as Purpur should find it behaves identically, since the underlying APIs are the same.

Spawn Systems That Do the Math for You

Setting up spawns is where most event plugins fall apart, and Custom Teams solves it with two distinct approaches. For team battles, you enter an in-world editing mode with a hotbar tool that lets you drop multiple spawn points per color, reset individual teams, and save everything only when you hit Save and Exit. For FFA, you can either place one exact spawn point per participant or drop a single center marker and let the plugin spread players evenly around it in a radius that scales with player count. Every auto-generated location is checked for safe, non-suffocating ground before use.

Kits, Safety Windows, and Spectating

Combat fairness is baked into the design. A master kit editor lets you build a shared loadout — armor, offhand, potion effects, and all 27 inventory slots — that every participant receives at match start. On top of that, each player can save and load up to three personal kits through the /ct kits menu, stored per-player and independent of the event kit. Matches open with five seconds of invincibility so nobody gets ambushed while loading in, and winners enjoy ten seconds of protection during the victory celebration. Players who die are moved to spectator mode automatically and can rejoin as a spectator or leave the event entirely with /ct leave, which restores their pre-event inventory and location.

If you would rather skip manual jar management, the foxygame.net launcher streamlines the whole process by offering Custom Teams directly from its curated add-on catalog, so server owners can install and keep it updated with a single click.

How to Install Custom Teams

Getting started takes only a few minutes, and the setup is standard for Paper plugins.

  • Confirm your server runs Paper 1.21.11 (or a compatible Paper fork) with Java 17 or higher.
  • Download Custom Teams from a trusted plugin source and place the jar file in your server's plugins folder.
  • Restart the server so the plugin generates its config.yml and kits.yml files.
  • Grant yourself the customteams.admin permission, then run /ct to open the control panel.
  • Configure your teams or FFA roster, set spawns, build the master kit, and hit Start Event.

Kits and spawn points persist in kits.yml across restarts, so you only need to set things up once. Toggles for starting gamemode, health-on-kill, and natural regeneration are all switchable from the admin GUI and save to config.yml immediately. Note that the natural regeneration toggle only affects players currently in the event, leaving non-participants and the world itself untouched.

Final Thoughts

Custom Teams fills a gap that many server owners know well: a polished, admin-friendly event system that does not require command-line wizardry. The fixed color palette for teams is a minor limitation inherited from Minecraft's scoreboard system, but it hardly matters when everything else — rosters, spawns, kits, and match flow — is handled through a clean interface. Whether you are hosting a weekly FFA night or a four-team tournament, this plugin gives you the structure to run it smoothly.