> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.z-craft.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Z-Craft Admin Commands | Complete Staff Command Reference

> Comprehensive guide to all Z-Craft admin and staff commands for moderation, server management, and player administration.

# 🔧 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.

<Info>
  **Command Access:** Requires appropriate permission levels • All commands logged • Use responsibly
</Info>

<Warning>
  **Important:** Admin commands should only be used by authorized staff. All actions are logged and monitored. Misuse may result in administrative action.
</Warning>

## 👑 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`                     |

### Ban Management & Information

| 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`                |

### Duration Formats

**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

## 🌐 Server Management & Performance

### 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` |

## 📊 Information & Investigation Tools

### Player Information

| 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

### Performance Debugging

| 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:**

1. `/warn Player1 First offense warning`
2. `/mute Player1 30m Continued violation`
3. `/kick Player1 Final warning`
4. `/tempban Player1 1d Pattern of violations`

**Investigation Process:**

1. `/playerinfo Player1` - Basic information
2. `/logs chat Player1 1h` - Recent activity
3. `/seen Player1` - Login patterns
4. `/stats Player1` - Behavior analysis

## ⚠️ Critical Commands & Safety

### Dangerous Operations

<Warning>
  **These commands can cause data loss or server instability. Use extreme caution:**
</Warning>

* `/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! 💚