EasyTeam
Team System
Players can create, manage, and join teams with a full GUI and command system.
Creating a Team:
/teamcreate or the GUI "Create Team" button opens a form where you set a team name, tag (short abbreviation), and choose from 20 colors via a color picker grid.- Teams start as open (anyone can join) or closed (invite-only), configurable in settings.
Browsing & Joining Teams:
/teamlist or "Browse Teams" in the GUI shows all teams on the server with their name, tag, member count, open/closed status.- Open teams have a "Join" button. Closed teams require an invite.
- Each team can also be viewed for more details via the "View" button.
Team Info Page:
- Shows the team name, tag, color swatch, member count, and open/closed status.
- Sidebar navigation with: Members, Settings (owner only), Team Homes (owner only), Leave, and Invite (owner only).
Member Management:
- The Members page lists all members with their role and username.
- Owner can promote members to Officer, demote Officers back to Member, and kick anyone.
- Officers can kick Members.
- Roles: Owner (gold), Officer (blue), Member (gray).
Team Settings (Owner Only):
- Change team name, tag, open/closed status.
- Full 20-color picker grid to change the team color.
- Disband the team entirely.
- Form fields are preserved when switching colors (no wipe on rebuild).
Invitations (Owner Only):
- /teaminvite <player> or the GUI invite button sends an invite.
- Invites expire after a set time.
- Invited players see pending invites via /team → "My Invites" with Accept/Decline buttons and a countdown timer.
Chat Integration
- Team Tag in Chat: When a player in a team sends a message, their team tag appears before their name in the color the team chose (e.g., a green
[ABC] prefix).
- Team Chat: Typing
@t <message> sends a private message only visible to teammates, with a bold colored tag prefix.
Home System (Owner Only)
- Accessible from the Team Info sidebar → "Team Homes".
- Up to 3 homes per team, stored under the team's UUID.
- Set Home: Type a name in the input field and click "Set Home" — saves your current position.
- Teleport: Click the "Teleport" button next to any saved home to warp there.
- Delete: Remove a home with the "Delete" button.
Commands
| Command |
Description |
| /team |
Opens the main Teams GUI menu |
/teamcreate |
Opens the team creation GUI |
/teamlist |
Opens the Browse Teams GUI |
/teaminfo |
Shows your current team's info GUI |
| /teaminvite <player> |
Invite a player (owner only) |
| /teamjoin <team> |
Join an open team by name |
/teamleave |
Leave your current team |
| /teamkick <player> |
Kick a member (owner/officer) |
| /teampromote <player> |
Promote to Officer (owner only) |
| /teamdemote <player> |
Demote to Member (owner only) |
/teamdisband |
Disband the team (owner only) |
/teamchat <msg> |
Send a team-only message |
/sethome <name> |
Set a home at current location |
/home <name> |
Teleport to a saved home |
/delhome <name> |
Delete a saved home |
/homes |
List all your saved homes |
Technical Details
- All data persists to JSON files (teams.json,
homes.json) in the server's mods directory.
- GUI pages are built with Hytale's custom UI system (.ui templates + InteractiveCustomUIPage Java classes).
- Dynamic rows (team lists, member lists, invite lists) are rendered via appendInline with fully inlined styles.
- Event listener hooks into
PlayerChatEvent for tag display and team chat, and PlayerConnectEvent/PlayerDisconnectEvent for online status tracking.
