QuantumTeams Documentation
Requirements

• Spigot/Paper 1.21+
• Vault plugin
• Economy plugin (EssentialsX, QuantumEconomy, etc.)

Installation

1. Download QuantumTeams-1.0.0.jar
2. Place in your server's plugins/ folder
3. Ensure Vault and an economy plugin are installed
4. Restart server
5. Configure config.yml in plugins/QuantumTeams/

Commands
Basic Commands

• /team create <name> - Create a new team (free)
• /team disband - Disband your team (owner only)
• /team invite <player> - Invite a player to your team
• /team join <team> - Accept a team invitation
• /team leave - Leave your current team
• /team kick <player> - Kick a member from the team
• /team info [team] - View team information
• /team list - List all teams on the server

Member Management

• /team promote <player> - Promote a member (MEMBER→MODERATOR→ADMIN)
• /team demote <player> - Demote a member (ADMIN→MODERATOR→MEMBER)
• /team transfer <player> - Transfer team ownership (owner only)

Team Bank

• /team bank - View team bank balance
• /team deposit <amount> - Deposit money into team bank
• /team withdraw <amount> - Withdraw money from team bank (Admin+ only)

Team Home & Warps

• /team sethome - Set team home location (Admin+ only)
• /team home - Teleport to team home (3 second delay)
• /team delhome - Delete team home (Admin+ only)
• /team setwarp <name> - Create a team warp (Admin+ only)
• /team warp <name> - Teleport to a team warp
• /team delwarp <name> - Delete a team warp (Admin+ only)
• /team warps - List all team warps

Team Features

• /team echest - Open team ender chest (54 slots, shared storage)
• /team pvp - Toggle friendly fire on/off (owner only)
• /team ally <team> - Send ally request to another team
• /team unally <team> - Remove team from allies
• /team allies - List your team's allies

Team Chat

• /tc or /teamchat - Toggle team chat mode
• /tc <message> - Send a message to team chat

Admin Commands

• /team admin delete <team> - Delete any team
• /team admin info <team> - View any team's information

Role System
OWNER (Red)

• Full team control
• Can use all commands
• Cannot be kicked or demoted
• Can transfer ownership
• Can disband team
• Can toggle PvP

ADMIN (Red)

• Invite and kick members
• Promote/demote to MODERATOR
• Withdraw from bank
• Set home and warps
• All features except ownership transfer

MODERATOR (Yellow)

• Invite members
• Deposit to bank
• Use home, warps, echest
• Basic team features

MEMBER (Gray)

• Deposit to bank
• Use home, warps, echest
• Basic team features

⚙️ Configuration
Team Settings
yaml
team:
max-members: 10 # Maximum team size
min-name-length: 3 # Minimum team name length
max-name-length: 16 # Maximum team name length
allow-spaces: false # Allow spaces in team names
alphanumeric-only: true # Team names must be alphanumeric
default-role: MEMBER # Default role for new members
Economy
yaml
economy:
bank-enabled: true # Enable team bank system
creation-cost: 0.0 # Cost to create a team (0 = free)
daily-upkeep: 0.0 # Daily maintenance cost (disabled)
Team Bank
yaml
bank:
allow-deposits: true
allow-withdrawals: true
deposit-roles: [OWNER, ADMIN, MODERATOR, MEMBER] # Who can deposit
withdraw-roles: [OWNER, ADMIN] # Who can withdraw
Team Ender Chest
yaml
echest:
enabled: true
size: 54 # Inventory size (9, 18, 27, 36, 45, 54)
access-roles: [OWNER, ADMIN, MODERATOR, MEMBER]
Team Home
yaml
home:
enabled: true
teleport-delay: 3 # Delay in seconds before teleporting
cancel-on-move: true # Cancel teleport if player moves
set-roles: [OWNER, ADMIN] # Who can set home
use-roles: [OWNER, ADMIN, MODERATOR, MEMBER] # Who can use home
PvP & Allies
yaml
pvp:
allow-toggle: true # Allow teams to toggle friendly fire
default-enabled: false # Friendly fire disabled by default

allies:
enabled: true
max-allies: 3 # Maximum number of allies per team
ally-pvp-protection: true # Allies can't hurt each other
Warps
yaml
warps:
enabled: true
max-warps: 3 # Maximum warps per team
create-roles: [OWNER, ADMIN]
delete-roles: [OWNER, ADMIN]
Invitations
yaml
invitations:
timeout: 60 # Invitation expires after 60 seconds
max-pending: 5 # Max pending invitations per team
Notifications
yaml
notifications:
member-join: true # Notify team when member joins server
member-leave: true # Notify team when member leaves server
bank-transactions: true # Notify on deposits/withdrawals
Permissions
yaml
quantumteams.use # Basic team commands (default: true)
quantumteams.create # Create teams (default: true)
quantumteams.admin # Admin commands (default: op)
quantumteams.admin.delete # Delete any team (default: op)
quantumteams.admin.bypass # Bypass team limits (default: op)
Usage Examples
Creating and Managing a Team
/team create Warriors
→ Team created!

/team invite Steve
→ Invited Steve to team Warriors

(Steve): /team join Warriors
→ Steve joined the team!

/team promote Steve
→ Promoted Steve to Moderator

/team info
→ View team details
Using Team Bank
/team deposit 5000
→ Deposited $5000 to team bank

/team bank
→ Team bank balance: $5000

/team withdraw 1000 (Admin+ only)
→ Withdrew $1000 from team bank
Setting Up Base
/team sethome
→ Team home set!

/team setwarp farm
→ Warp 'farm' created!

/team home
→ Teleporting to team home in 3 seconds...

/team warp farm
→ Teleporting to warp 'farm'...
Team Storage
/team echest
→ Echest opened
→ (Put items in shared chest)
→ Close inventory
→ Echest saved
Alliances
/team ally Dragons
→ Ally request sent to Dragons

(Dragons owner): /team ally Warriors
→ Teams are now allies! (Can't hurt each other in PvP)
️ Data Storage
Teams are saved in plugins/QuantumTeams/teams.yml:

yaml
teams:
warriors:
owner: "uuid-here"
members:
uuid1: ADMIN
uuid2: MODERATOR
uuid3: MEMBER
bank-balance: 5000.0
home:
world: world
x: 100.5
y: 64.0
z: -200.5
friendly-fire: false
allies:
- dragons
warps:
farm:
world: world
x: 50.0
y: 70.0
z: 100.0
echest: [item data...]
Auto-saves every 5 minutes and on server shutdown.

️ Troubleshooting
"Team already exists"

• Team names are case-insensitive and must be unique

"You don't have permission"

• Check your role in /team info
• Some features require Admin or Owner role

Items disappearing from echest

• Items save only when you close the echest
• Don't reload the plugin while echests are open

Can't teleport to home

• Make sure you don't move during the 3-second delay
• Teleport is cancelled if you move

Economy not working

• Ensure Vault and an economy plugin are installed
• Check console for Vault registration messages

Support & Links
For issues, suggestions, or support, contact the plugin developer or server administrators.

Plugin Version: 1.0.0
API Version: 1.21+
Dependencies: Vault (required), Economy plugin (required)