Commands Usage

Commands & Administration

BuildersWand provides a comprehensive set of commands for both players and administrators. All commands use the /bw alias and include tab completion for easy use.

Player Commands

Basic Commands

/bw or /bw help

Permission: builderswand.use

Description: Displays the help menu with available commands

Usage: /bw

/bw give

Permission: builderswand.give Description: Gives a wand to yourself or another player Usage:

• /bw give <wand_name> <player> # player is optional here - Gives a specific wand by name

Example:

- /bw give Steve advanced

/bw undo

Permission: builderswand.undo

Description: Undoes your last wand action

Usage: /bw undo Notes:

• Only works for players (not console)

• Limited to last 3 actions

• Works for both placement and breaking actions

Administrator Commands

Configuration Management

/bw reload

Permission: builderswand.reload

Description: Reloads all configuration files

Usage: /bw reload What it reloads:

• config.yml settings

• wands.yml wand definitions

• Language files

• Translation system

Statistics & Monitoring

/bw stats

Permission: builderswand.admin.stats

Description: Displays usage statistics

Usage: /bw stats

Shows:

• Total players and wands used

• Top 5 players by block usage

• Wand usage statistics

• Blocks placed vs broken

/bw clearstats

Permission: builderswand.admin.clearstats

Description: Clears all collected statistics

Usage: /bw clearstats

Warning: This action cannot be undone

Logging Management

/bw logs

Permission: builderswand.admin.logs

Description: Shows logging configuration status

Usage: /bw logs

Displays:

• Whether logging is enabled

• Console logging status

• File logging status

• Log file location and size limits

/bw cleanuplogs

Permission: builderswand.admin.cleanuplogs

Description: Cleans up old log files

Usage: /bw cleanuplogs

What it does:

• Removes log files older than retention period

• Frees up disk space

• Maintains log file size limits

Permission System

Player Permissions

• builderswand.use - Basic wand usage

• builderswand.give - Give wands to players

• builderswand.undo - Use undo functionality

Wand-Specific Permissions

• builderswand.use.basic - Use basic wand

• builderswand.use.advanced - Use advanced wand

• builderswand.use.expert - Use expert wand

• builderswand.use.creative - Use creative wand

• builderswand.craft.basic - Craft basic wand

• builderswand.craft.advanced - Craft advanced wand

• builderswand.craft.expert - Craft expert wand

• builderswand.craft.creative - Craft creative wand

Administrative Permissions

• builderswand.reload - Reload configuration

• builderswand.admin.stats - View statistics

• builderswand.admin.clearstats - Clear statistics

• builderswand.admin.logs - View logging status

• builderswand.admin.cleanuplogs - Clean up logs

• builderswand.bypass.* - Bypass all restrictions

World & Region Permissions

• builderswand.use.world.<worldname> - Use wands in specific world

• builderswand.use.region.<regionname> - Use wands in specific region

• builderswand.bypass.permissions - Bypass all permission checks

Command Examples

For Players

• /bw # Show help

• /bw give Steve advanced # Give Steve an advanced wand

• /bw undo # Undo last action

For Administrators

• /bw reload # Reload all configs

• /bw stats # View usage statistics

• /bw clearstats # Clear all statistics

• /bw logs # Check logging status

• /bw cleanuplogs # Clean up old logs

Configuration Management

Reloading Configuration

The /bw reload command safely reloads all configuration files:

• Stops any ongoing operations

• Loads new configuration values

• Updates wand definitions

• Refreshes language files

• Maintains player data integrity

Best Practices

1. Test changes first: Always test configuration changes on a test server

2. Backup configs: Keep backups of working configurations

3. Reload during low activity: Reload during server maintenance windows

4. Monitor after reload: Check for any errors in console after reloading

Statistics & Monitoring

What's Tracked

• Player statistics: Blocks placed/broken per player

• Wand usage: Which wands are used most frequently

• Session data: Current session block counts

• Daily limits: Daily usage tracking

Statistics Commands

• /bw stats - View comprehensive statistics

• /bw clearstats - Reset all statistics

Logging Features

• Console logging: Real-time console output

• File logging: Persistent log files

• Log rotation: Automatic log file management

• Size limits: Configurable log file sizes

Troubleshooting Commands

Common Issues

1. Permission denied: Check player has required permissions

2. Wand not found: Verify wand tier/name exists in config

3. Player not found: Ensure player is online

4. Statistics disabled: Enable statistics in config

Debug Information

• Check console for error messages

• Use /bw logs to verify logging status

• Review permission nodes with permission plugins

• Test commands with different permission levels

Easter Egg

There's a hidden easter egg command that provides a fun surprise for those who discover it. The command includes special sound effects and messages, but we won't spoil the fun by revealing it here!