Home›Java›Mods›RG Team
RG Team
ModsJava

RG Team

Java mod listed for Minecraft 1.21. Downloads from the MC Java Mods app on Android.

by RishavTheOG · on Modrinth

⬇ Download on Modrinth
RG Team — screenshot 1

A GUI-first team plugin for Paper 1.21+. Built from scratch, no code borrowed from older team plugins.

It covers most of what I'd want from a team system on a survival or SMP server: teams with ranks, invites, team chat, a shared home, a bank, an actual shared enderchest, allies, stats, and a leaderboard. All data is UUID-based and saved the moment it changes, so nothing gets lost on restart.

Requirements: Paper 1.21 or newer (Purpur works too since it still runs the Paper API), Java 21. Not Folia compatible — the plugin uses the Bukkit scheduler and the plain Inventory API, and I didn't write a Folia variant. Sorry.

Image

How the GUIs work

Most team plugins I looked at resolve menu clicks by checking the display name of the item you clicked. That stops working the moment somebody renames a button, or when the client and server inventory get out of sync. So I did it differently:

There are 21 menus in total, driven by a small framework: GuiManager creates a GuiSession per player, each session owns GuiButton objects per slot, and the inventory uses a custom RGGuiHolder — the code never relies on inventory titles. The shared enderchest uses a separate holder (RGTeamStorageHolder) because it behaves like real storage instead of a menu.

The menus, for reference:

Features

One design note: the GUI and the commands are not separate feature sets. Both call the same service layer, so a button click and its equivalent command go through identical validation. You can run the whole plugin from chat if you hate menus.

Installation

  1. Grab RG_Team-1.0.2.jar from the releases page, or build it yourself (see below).
  2. Put it in plugins/.
  3. Optional: install Vault plus an economy plugin if you want the team bank, and PlaceholderAPI if you want team placeholders.
  4. Start the server. Config files are generated in plugins/RG_Team/ on first run.

Building from source

JDK 21 and Maven 3.9+:

git clone <repo>
cd RG_Team
mvn -DskipTests package

The jar ends up at target/RG_Team-1.0.2.jar.

Commands

Base command is /team, with /rgteam as an alias.

General

Team lifecycle

Invites

Members

Settings

Chat

Home

Bank (needs Vault)

Storage

Allies

Leaderboard

Admin (needs rgteam.admin.*)

Permissions

Node Default What it does
rgteam.use true base access to /team
rgteam.create true create a team
rgteam.join true join an open team
rgteam.invite true send invites (role config still applies)
rgteam.kick true kick members (role config still applies)
rgteam.promote true promote / demote members
rgteam.sethome true set / delete the team home
rgteam.bank.use true deposit to the team bank
rgteam.bank.withdraw false bypass the role requirement for withdrawals
rgteam.admin.* op all admin commands + the inspect GUI

To be clear: permissions do not override role checks unless the docs above say they do. Someone with rgteam.kick still can't kick anybody if their role doesn't allow kicking.

Configuration

Everything is generated on first launch in plugins/RG_Team/. There are three files:

PlaceholderAPI

If PAPI is present the plugin registers the rgteam expansion on its own:

Players without a team get a configurable fallback (placeholders.emptyValue in config, default None).

Data files

All data keys off player UUIDs; names are only cached for display, so a name change doesn't break anything.

File Contents
teams.yml teams, their members and roles, settings, home, bank, stats, enderchest contents
invites.yml pending invites with expiry timestamps
allyrequests.yml pending ally requests
admin-actions.log append-only log of admin actions

Changelog

1.0.2 — premium console banner. Adds a bordered ANSI banner on enable showing version, author, server, team count, and Vault/PAPI status.

1.0.1 — clickable prompts and an ally selector fix. Invites and ally requests now include clickable [ACCEPT] / [DENY] in chat. Also fixed the ally flow: the browser now runs in a selector mode when you're adding an ally, so clicking a team sends the request instead of opening its details.

1.0.0 — initial release, full feature set as documented above.

License

Original work by RishavTheOG. No license has been picked yet, so treat it as all rights reserved — ask before redistributing.


If the plugin works for you, a star on the repo (or a review on Modrinth) is appreciated. Found a bug? Open an issue on GitHub.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more