๐ง Z-Craft Admin Commands: Complete Staff Reference
Essential command reference for Z-Craft staff and administrators. This comprehensive guide covers all moderation, server management, and administrative commands used to maintain a safe and fair gaming environment.
Command Access: Requires appropriate permission levels โข All commands logged โข Use responsibly
Important: Admin commands should only be used by authorized staff. All actions are logged and monitored. Misuse may result in administrative action.
๐ Permission Levels & Access Control
Staff Hierarchy
| Permission Level | Role Title | Access Scope | Key Responsibilities |
|---|
| Level 0 | Regular Player | Basic commands only | N/A |
| Level 1 | Moderator | Chat moderation, basic player management | Handle minor violations, assist players |
| Level 2 | Administrator | Full moderation, server config | Ban management, server settings |
| Level 3 | Senior Admin | Database access, system control | Advanced troubleshooting, restarts |
| Level 4 | Owner/Developer | Full system access | Custom commands, core modifications |
Command Categories
- ๐ฏ Moderation - Player discipline and chat control
- ๐งญ Teleportation - Movement and location management
- ๐ฐ Economy - Currency and shop administration
- ๐ Server - Performance and system management
- ๐ Information - Player data and statistics
- ๐ก๏ธ Security - Protection and anti-cheat tools
๐ฏ Player Moderation Commands
Warning & Communication Control
| Command | Parameters | Permission | Description | Example |
|---|
/warn | <player> <reason> | Level 1+ | Issue official warning to player | /warn Player1 Spamming chat |
/mute | <player> <duration> <reason> | Level 1+ | Temporarily mute player chat | /mute Player1 30m Excessive caps |
/unmute | <player> | Level 1+ | Remove active mute | /unmute Player1 |
/chat mute | [duration] | Level 2+ | Mute entire server chat | /chat mute 10m |
/chat unmute | | Level 2+ | Restore server chat | /chat unmute |
Disciplinary Actions
| Command | Parameters | Permission | Description | Example |
|---|
/kick | <player> <reason> | Level 1+ | Remove player from server | /kick Player1 Rule violation |
/ban | <player> <reason> | Level 2+ | Permanent ban from server | /ban Player1 Griefing |
/tempban | <player> <duration> <reason> | Level 2+ | Temporary ban with time limit | /tempban Player1 7d Severe toxicity |
/unban | <player> | Level 2+ | Remove active ban | /unban Player1 |
/pardon | <player> | Level 2+ | Alias for unban | /pardon Player1 |
| Command | Parameters | Permission | Description | Example |
|---|
/banlist | [page] | Level 2+ | View all active bans | /banlist |
/ban info | <player> | Level 2+ | Detailed ban information | /ban info Player1 |
/ban ip | <ip> <reason> | Level 3+ | Ban by IP address | /ban ip 192.168.1.1 Alt account abuse |
/pardon ip | <ip> | Level 3+ | Remove IP ban | /pardon ip 192.168.1.1 |
Time Units for Temporary Actions:
30s - 30 seconds
5m - 5 minutes
2h - 2 hours
7d - 7 days
1w - 1 week
30d - 30 days
1M - 1 month
System Monitoring
| Command | Parameters | Permission | Description | Example |
|---|
/tps | | Level 1+ | View server TPS (performance) | /tps |
/mem | | Level 2+ | Memory usage statistics | /mem |
/entities | [world] | Level 2+ | Count loaded entities | /entities |
/chunks | | Level 2+ | View loaded chunks | /chunks |
/gc | | Level 3+ | Force garbage collection | /gc |
Server Control
| Command | Parameters | Permission | Description | Example |
|---|
/save-all | | Level 2+ | Save all worlds to disk | /save-all |
/restart | <delay> [reason] | Level 3+ | Schedule server restart | /restart 5m Maintenance update |
/stop | [reason] | Level 4 | Shut down server | /stop Emergency shutdown |
/reload | | Level 4 | Reload server configuration | /reload |
World & Environment
| Command | Parameters | Permission | Description | Example |
|---|
/weather | <clear/rain/thunder> [duration] | Level 2+ | Change weather | /weather clear 1200 |
/time set | <day/night/ticks> | Level 2+ | Set world time | /time set day |
/time add | <ticks> | Level 2+ | Advance time | /time add 6000 |
/difficulty | <peaceful/easy/normal/hard> | Level 3+ | Change difficulty | /difficulty normal |
๐ฐ Economy & Currency Management
Player Currency Control
| Command | Parameters | Permission | Description | Example |
|---|
/money give | <player> <amount> | Level 2+ | Add credits to player | /money give Player1 1000 |
/money take | <player> <amount> | Level 2+ | Remove credits from player | /money take Player1 500 |
/money set | <player> <amount> | Level 2+ | Set exact balance | /money set Player1 2500 |
/balance | [player] | All players | Check balance | /balance Player1 |
/baltop | | All players | View richest players | /baltop |
Shop Administration
| Command | Parameters | Permission | Description | Example |
|---|
/shop create | <name> <type> | Level 2+ | Create new shop | /shop create weapons buy |
/shop add | <shop> <item> <price> | Level 2+ | Add item to shop | /shop add weapons diamond_sword 100 |
/shop remove | <shop> <item> | Level 2+ | Remove item from shop | /shop remove weapons diamond_sword |
/shop delete | <shop> | Level 3+ | Delete entire shop | /shop delete weapons |
/shop list | | Level 1+ | View all shops | /shop list |
Economy Monitoring
| Command | Parameters | Permission | Description | Example |
|---|
/economy stats | | Level 2+ | Server economy overview | /economy stats |
/transactions | <player> [page] | Level 2+ | View player transactions | /transactions Player1 |
/economy reset | <confirm> | Level 4 | Reset all balances (dangerous!) | /economy reset CONFIRM |
| Command | Parameters | Permission | Description | Example |
|---|
/playerinfo | <player> | Level 1+ | Complete player profile | /playerinfo Player1 |
/seen | <player> | Level 1+ | Last login information | /seen Player1 |
/playtime | <player> | Level 1+ | Total playtime | /playtime Player1 |
/stats | <player> | All players | Player statistics | /stats Player1 |
/rank | <player> | All players | Current rank | /rank Player1 |
Logging & Investigation
| Command | Parameters | Permission | Description | Example |
|---|
/logs chat | <player> [time] | Level 2+ | View chat history | /logs chat Player1 1d |
/logs blocks | <player> [time] | Level 2+ | Block placement/breaking | /logs blocks Player1 1h |
/logs transactions | <player> | Level 2+ | Economy activity | /logs transactions Player1 |
/logs export | <player> [type] | Level 3+ | Export logs to file | /logs export Player1 chat |
๐ก๏ธ Protection & Security
Claim Management
| Command | Parameters | Permission | Description | Example |
|---|
/claim admin | <player> | Level 2+ | Admin claim area | /claim admin Player1 |
/unclaim | <x> <z> [world] | Level 2+ | Remove claim | /unclaim 100 200 overworld |
/claimlist | [player] | Level 1+ | View claims | /claimlist Player1 |
/trust | <player> | All players | Allow building access | /trust Friend1 |
/untrust | <player> | All players | Remove building access | /untrust Friend1 |
Security Controls
| Command | Parameters | Permission | Description | Example |
|---|
/lockdown | [on/off] | Level 3+ | Prevent new claims | /lockdown on |
/anticheat check | <player> | Level 2+ | Manual cheat scan | /anticheat check Player1 |
/anticheat ban | <player> <reason> | Level 3+ | Anti-cheat ban | /anticheat ban Player1 Fly hack |
๐ง Advanced Administration
Plugin Management
| Command | Parameters | Permission | Description | Example |
|---|
/plugins | | Level 2+ | List all plugins | /plugins |
/plugin info | <name> | Level 2+ | Plugin details | /plugin info Essentials |
/plugin reload | <name> | Level 3+ | Reload plugin | /plugin reload Lifesteal |
/plugin enable | <name> | Level 3+ | Enable plugin | /plugin enable NewPlugin |
/plugin disable | <name> | Level 3+ | Disable plugin | /plugin disable OldPlugin |
Configuration Management
| Command | Parameters | Permission | Description | Example |
|---|
/config reload | | Level 3+ | Reload all configs | /config reload |
/config set | <path> <value> | Level 3+ | Change config value | /config set lifesteal.max-hearts 20 |
/config get | <path> | Level 2+ | View config value | /config get lifesteal.max-hearts |
Database Operations
| Command | Parameters | Permission | Description | Example |
|---|
/db backup | | Level 3+ | Create database backup | /db backup |
/db restore | <timestamp> | Level 4 | Restore from backup | /db restore 2024-01-15_12-00 |
/db check | | Level 3+ | Integrity check | /db check |
/db optimize | | Level 3+ | Performance optimization | /db optimize |
๐ Debugging & Troubleshooting
| Command | Parameters | Permission | Description | Example |
|---|
/debug lag | | Level 2+ | Identify lag sources | /debug lag |
/debug entities | <x> <z> <radius> | Level 2+ | Entity analysis | /debug entities 0 0 50 |
/debug chunks | <x> <z> <radius> | Level 2+ | Chunk analysis | /debug chunks 0 0 10 |
/debug plugins | | Level 3+ | Plugin diagnostics | /debug plugins |
Player Monitoring
| Command | Parameters | Permission | Description | Example |
|---|
/trace | <player> [duration] | Level 2+ | Monitor player actions | /trace Player1 5m |
/invsee | <player> | Level 1+ | View player inventory | /invsee Player1 |
/enderchest | <player> | Level 2+ | View ender chest | /enderchest Player1 |
๐ Command Usage Guidelines
Best Practices
Always Include Reasons:
- Provide clear, specific reasons for disciplinary actions
- Document evidence and context
- Use consistent formatting
Communication Standards:
- Be professional and respectful in all interactions
- Explain actions clearly to affected players
- Use appropriate communication channels
Documentation Requirements:
- Log all significant actions
- Include timestamps and context
- Maintain detailed records for appeals
Common Command Patterns
Moderation Workflow:
/warn Player1 First offense warning
/mute Player1 30m Continued violation
/kick Player1 Final warning
/tempban Player1 1d Pattern of violations
Investigation Process:
/playerinfo Player1 - Basic information
/logs chat Player1 1h - Recent activity
/seen Player1 - Login patterns
/stats Player1 - Behavior analysis
โ ๏ธ Critical Commands & Safety
Dangerous Operations
These commands can cause data loss or server instability. Use extreme caution:
/economy reset - Irreversible balance reset
/db restore - Overwrites current data
/stop - Immediate server shutdown
/money set - Economy impact
Always:
- Create backups before major operations
- Test commands in a development environment first
- Have rollback procedures ready
- Notify other administrators of major changes
โ Command Troubleshooting
Common Issues
Command Not Working:
- Check your permission level with
/rank
- Verify command syntax
- Ensure target player is online
- Check for plugin conflicts
Permission Errors:
- Contact higher-level staff for access
- Verify youโre in the correct group
- Check if command is enabled in config
Unexpected Results:
- Review command logs
- Check for conflicting plugins
- Verify target exists
- Test with simpler parameters
Getting Help
Internal Resources:
/help - Basic command list
/adminhelp - Staff command reference
- Discord #staff channel for assistance
External Support:
- Plugin documentation
- Server administration forums
- Professional Minecraft hosting support
Remember: With great power comes great responsibility. Use these commands to maintain a fair, safe, and enjoyable environment for all Z-Craft players. All administrative actions are logged and subject to review. ๐ก๏ธโ๏ธ๐
โ
Best Practices:
- Log all administrative actions
- Use
/warn before /mute
- Check logs before banning
- Communicate with team
- Document decisions
- Review appeals fairly
Need help with commands? Ask in staff-help channel! ๐