# Team-HomeGUI-Plugin **Version 1.3.0** | PaperMC 1.21 | Java 21 A feature-rich PaperMC plugin combining a **team system** with a **GUI-based home manager**, cooldowns, economy support, PlaceholderAPI integration, and Essentials override. --- ## Features | Category | Feature | |----------|---------| | Teams | Create, invite, leave, kick, disband | | Roles | Owner / Admin / Member hierarchy | | Team Chat | Toggle private/global chat per-player | | Team Home | Set and teleport to team home | | Personal Homes | Up to 5 personal homes via inventory GUI | | Confirm Delete | Confirmation GUI before deleting a home | | Cooldowns | Per-player teleport cooldown | | Warmup | XP-bar countdown with optional freeze | | Economy | Vault-based charges for set / teleport / create | | Anti-PvP | Disable friendly fire between team members | | PlaceholderAPI | `%team_*%` placeholders | | Essentials | Intercepts `/home` and `/sethome` to open the GUI | --- ## Requirements | Dependency | Required | |------------|----------| | PaperMC 1.21 | ✅ | | Java 21 | ✅ | | Vault | Optional (economy features) | | PlaceholderAPI | Optional | | EssentialsX | Optional (GUI override) | --- ## Installation 1. Build with Maven: `mvn clean package` 2. Copy the resulting `.jar` from `target/` to your server's `plugins/` folder 3. Start the server — config files are generated automatically 4. Edit `plugins/Team-HomeGUI-Plugin/team-config.yml` and `home-config.yml` 5. Reload with `/reload confirm` or restart --- ## Commands ### Player Commands | Command | Description | |---------|-------------| | `/team create ` | Create a new team | | `/team invite ` | Invite a player to your team | | `/team invite accept` | Accept a pending invite | | `/team invite deny` | Deny a pending invite | | `/team leave` | Leave your team (owner must confirm) | | `/team kick ` | Kick a member (owner/admin) | | `/team info [team]` | Show team info | | `/team members [team]` | List team members | | `/team list [page]` | Browse all teams | | `/team home` | Teleport to team home | | `/team sethome` | Set the team home (owner/admin) | | `/team chat enable\|disable` | Toggle team-only chat | | `/team msg ` | Send a team message | | `/team color ` | Change team display color | | `/team settings name ` | Rename your team | | `/team settings color ` | Change color | | `/team settings members-can-invite ` | Toggle invite permissions | | `/team settings promote ` | Promote to Admin | | `/team settings demote ` | Demote from Admin | | `/team settings transfer ` | Transfer ownership | | `/home` | Open home GUI | | `/sethome [name]` | Set a home (opens GUI) | | `/delhome ` | Delete a home | ### Admin Commands | Command | Description | |---------|-------------| | `/team admin create ` | Create the admin team | | `/team admin add ` | Add player to admin team | | `/team admin ban ` | Ban from admin commands | | `/team admin unban ` | Unban from admin commands | | `/team admin manage ` | Show team details | | `/team admin remove ` | Disband a team | | `/team admin list` | List all teams | | `/team admin settings

Team-HomeGUI Plugin

Compatibility

Minecraft: Java Edition

Platforms

Tags

Creators

Details

HomeGUI

Team Commands