Command Reference

MCBasketball provides a comprehensive set of commands for arena management, gameplay, and administration. All commands require the appropriate permissions.

Getting Help

Access the in-game help system anytime:

/mcbasketball help 1

🏗️ Arena Management Commands

Create & Copy Arenas

`/mcbasketball create`

Creates a new arena from scratch.

/mcbasketball create <name> <displayName>

Parameters: - name - Unique identifier for the arena (no spaces) - displayName - User-friendly name (supports color codes)

Example:

/mcbasketball create stadium1 &6Golden Stadium

`/mcbasketball copy`

Duplicates an existing arena with all its settings.

/mcbasketball copy <source> <name> <displayName>

Parameters: - source - Name of existing arena to copy - name - New arena identifier
- displayName - Display name for the new arena

Example:

/mcbasketball copy stadium1 stadium2 &bBlue Stadium

Arena Control

`/mcbasketball delete`

Permanently removes an arena and its configuration.

/mcbasketball delete <name>

Destructive Action

This action cannot be undone. Make sure to backup your arena files if needed.

`/mcbasketball list`

Shows all arenas and their current status.

/mcbasketball list [player]

Output Example:

stadium1 [Golden Stadium] [enabled]
arena2 [Practice Field] [disabled]

`/mcbasketball toggle`

Enables or disables an arena.

/mcbasketball toggle <name>

Enabled: Players can join and play
Disabled: Arena is inaccessible to players

🎮 Player Commands

Joining & Leaving

`/mcbasketball join`

Join a specific game, optionally choosing a team.

/mcbasketball join <name> [team] [player]

Parameters: - name - Arena name to join - team - red, blue, or referee (optional) - player - Target player (admin only)

Examples:

/mcbasketball join stadium1
/mcbasketball join stadium1 red
/mcbasketball join stadium1 blue Steve

`/mcbasketball leave`

Leave the current game.

/mcbasketball leave [player]

🔧 Setup & Configuration Commands

Selection Tools

`/mcbasketball axe`

Get the selection tool for marking areas.

/mcbasketball axe

Usage: - Left-click: Select first corner (Point A) - Right-click: Select second corner (Point B)

`/mcbasketball select`

Apply your axe selection to define arena areas.

/mcbasketball select <name> <type>

Area Types: - field - Main playing area - red_goal - Red team's goal - blue_goal - Blue team's goal

Example:

/mcbasketball select stadium1 field

`/mcbasketball location`

Set specific points using your current position.

/mcbasketball location <name> <type>

Location Types: - ball - Where the ball spawns - red_spawnpoint - Red team spawn - blue_spawnpoint - Blue team spawn
- red_lobby - Red team lobby (minigames) - blue_lobby - Blue team lobby (minigames) - referee_spawnpoint - Referee position - referee_lobby - Referee lobby - leave_spawnpoint - Where players go when leaving

Visual Aids

`/mcbasketball highlight`

Toggle visual boundaries for easier arena editing.

/mcbasketball highlight <name>

Shows particle effects or blocks around defined areas.

⚙️ Customization Commands

Team Equipment

`/mcbasketball inventory`

Copy your current inventory as the team's default gear.

/mcbasketball inventory <name> <team>

Teams: red or blue

`/mcbasketball armor`

Copy your current armor as the team's default equipment.

/mcbasketball armor <name> <team>

Game Rules

`/mcbasketball gamerule`

Modify arena settings and game mechanics.

/mcbasketball gamerule <key> <name> <value>

Common Game Rules: - gameType - hubgame, minigame, or refereegame - maxScore - Points needed to win - duration - Game length in seconds

Example:

/mcbasketball gamerule gameType stadium1 minigame

🛡️ Referee Commands (Patreon Feature)

Control match flow during tournaments and events.

Game Control

Command	Description
`/mcbasketball referee startgame`	Start lobby countdown
`/mcbasketball referee stop`	End current period/game
`/mcbasketball referee whistleresume`	Resume play, enable ball
`/mcbasketball referee whistlestop`	Pause game, disable ball
`/mcbasketball referee freezetime`	Freeze timer and ball
`/mcbasketball referee nextperiod`	Move to next game period

Ball Control

Command	Description
`/mcbasketball referee setball [x] [y] [z] [yaw] [pitch] [world]`	Teleport ball to position
`/mcbasketball referee setballrel [forward] [sideward]`	Set ball relative to referee

Player Management

Command	Description
`/mcbasketball referee yellowcard <player>`	Give yellow card
`/mcbasketball referee redcard <player>`	Give red card
`/mcbasketball referee kickplayer <player>`	Remove player from game

🏷️ Signs & Integration

`/mcbasketball sign`

Create interactive signs for easy player access.

/mcbasketball sign <name> <type>

Sign Types: - join - Join any available team - leave - Leave current game - team_red - Join red team specifically
- team_blue - Join blue team specifically

Usage: 1. Run the command 2. Right-click any sign to convert it

🔧 System Commands

`/mcbasketball placeholder`

Test placeholder values for scoreboards and displays.

/mcbasketball placeholder <placeholder>

Example:

/mcbasketball placeholder %mcbasketball_game_redScore%

`/mcbasketball reload`

Reload arena configurations without restarting.

/mcbasketball reload [name]

No name: Reload all arenas
With name: Reload specific arena

💡 Pro Tips

Command Efficiency

Use tab completion to see available options
Most commands support partial arena name matching
Commands are case-insensitive for convenience

Permission Requirements

Regular players need mcbasketball.command for basic commands
Arena editing requires mcbasketball.edit
Referee commands need mcbasketball.referee.join

Admin Features

Many commands accept a player parameter when you have admin permissions, allowing you to manage other players' arena participation.