Commands

Commands Reference

Complete list of all Coder commands with descriptions and permissions.

---

🎮 Player Commands

/coder run

Execute a script immediately.

/coder run <script_name>

Parameters:

• <script_name> - Name of the script file (without .cd extension) Permission: coder.run

Examples:

/coder run hello
/coder run announcer
/coder run welcome-message

Returns:

• ✅ Script executed successfully
• ❌ Script not found
• ❌ Execution error with details

---

/coder reload

Reload a script without restarting the server.

/coder reload <script_name>

Parameters:

• <script_name> - Name of the script to reload Permission: coder.reload

Examples:

/coder reload hello
/coder reload announcer

Use Cases:

• Update script after editing
• Clear script variables
• Test changes without server restart

---

/coder load

Load a script into server memory for faster execution.

/coder load <script_name>

Parameters:

• <script_name> - Name of the script to load Permission: coder.load

Examples:

/coder load daily-announcer
/coder load server-welcome

Benefits:

• Faster execution on repeated runs
• Always ready in memory
• Ideal for frequently-used scripts Note: Memory-loaded scripts persist until unloaded or server restarts.

---

/coder unload

Unload a script from server memory.

/coder unload <script_name>

Parameters:

• <script_name> - Name of the script to unload Permission: coder.unload

Examples:

/coder unload daily-announcer
/coder unload server-welcome

Use Cases:

• Free up memory
• Stop running repeated tasks
• Disable a script temporarily

---

/coder list

List all available scripts on the server.

/coder list [page]

Parameters:

• [page] - Optional page number (default: 1) Permission: coder.list

Example Output:

═══════════════════════════════════════
Available Scripts (Page 1/2)
═══════════════════════════════════════
1. announcer.cd ...................... [LOADED]
2. welcome.cd ........................ [READY]
3. restart-alert.cd .................. [READY]
4. daily-rewards.cd .................. [LOADED]
═══════════════════════════════════════
Use /coder run <name> to execute

Legend:

• [LOADED] - Script is in memory
• [READY] - Script is available but not in memory
• [ERROR] - Script has syntax errors

---

/coder info

Get information about a specific script.

/coder info <script_name>

Parameters:

• <script_name> - Name of the script Permission: coder.info

Example Output:

Script: announcer.cd
Location: /plugins/Coder/scripts/announcer.cd
Status: LOADED
Size: 256 bytes
Created: 2026-01-15
Modified: 2026-06-19
Execution Count: 427
Last Execution: 2 minutes ago
Memory Usage: 2.4 KB

---

/coder debug

Enable/disable debug mode for detailed logging.

/coder debug [on|off]

Parameters:

• [on|off] - Enable or disable (toggle if omitted) Permission: coder.debug

Examples:

/coder debug on          # Enable debug mode
/coder debug off         # Disable debug mode
/coder debug             # Toggle debug mode

What Debug Mode Shows:

• Detailed script execution steps
• Variable values during execution
• Performance metrics
• Error stack traces

---

/coder update

Check for and optionally install plugin updates.

/coder update [install]

Parameters:

• [install] - Optional, automatically install update Permission: coder.update

Examples:

/coder update           # Check for updates
/coder update install   # Download and install latest

Example Output:

Checking for Coder updates...
Latest version: 1.7.4
Your version: 1.7.2
✅ Update available!
Use: /coder update install

---

👨‍💼 Admin Commands

/coder admin

Access administrative functions.

/coder admin <subcommand> [args]

Permission: coder.admin

Subcommands:

/coder admin config reload

Reload configuration file.

/coder admin config reload

Takes effect immediately without server restart.

---

/coder admin cache clear

Clear compiled script cache.

/coder admin cache clear

Use When:

• Cache grows too large
• Scripts compile incorrectly
• Freeing up disk space

---

/coder admin stats

Show server statistics.

/coder admin stats

Example Output:

═════════════════════════════════════
Coder Statistics
═════════════════════════════════════
Total Scripts: 15
Scripts Loaded: 5
Total Executions: 1,247
Memory Used: 12.5 MB
Cache Size: 3.2 MB
Uptime: 5 days, 3 hours
═════════════════════════════════════

---

/coder admin reset

Reset all script data (use with caution!).

/coder admin reset [confirm]

Parameters:

• [confirm] - Type confirm to actually reset Use When:
• Recovering from corruption
• Starting fresh ⚠️ WARNING: This deletes all stored variables!

---

🔧 Developer Commands

/coder compile

Compile a script without executing (Java/Python only).

/coder compile <script_name>

Permission: coder.compile

Use Cases:

• Check for syntax errors
• Pre-compile frequently-used scripts
• Debug compilation issues

---

/coder validate

Validate script syntax without execution.

/coder validate <script_name>

Permission: coder.validate

Output:

Script: myScript.cd
Status: ✅ Valid
Syntax Errors: 0
Warnings: 0

or

Script: myScript.cd
Status: ❌ Invalid
Syntax Error on line 3:
  Expected 'broadcast' but got 'broadcst'

---

🔐 Permission Nodes

Permission	Command	Level
coder.list	/coder list	User
coder.run	/coder run	User
coder.reload	/coder reload	Moderator
coder.load	/coder load	Moderator
coder.unload	/coder unload	Moderator
coder.info	/coder info	Moderator
coder.debug	/coder debug	Moderator
coder.update	/coder update	Admin
coder.admin	/coder admin	Admin
coder.compile	/coder compile	Developer
coder.validate	/coder validate	Developer
coder.*	All commands	Owner

---

📋 Permission Setup Examples

LuckPerms Setup

/lp user <player> permission set coder.run true
/lp user <player> permission set coder.list true
/lp group mods permission set coder.reload true
/lp group admins permission set coder.admin true

PermissionsEx Setup

/pex user <player> add coder.run
/lp user <player> add coder.list
/pex group mods add coder.reload
/pex group admins add coder.admin

Default Operators

By default, server operators (OP) have all Coder permissions.

---

🎯 Command Usage Guide

For Beginners

Basic permissions to set:

coder.list  - See available scripts
coder.run   - Execute scripts

For Moderators

Add these to moderator role:

coder.reload   - Reload scripts
coder.load     - Load scripts into memory
coder.unload   - Unload scripts
coder.debug    - Enable debugging

For Administrators

Add these to admin role:

coder.admin    - Administrative functions
coder.update   - Check/install updates
coder.compile  - Compile scripts

For Script Developers

Add these to developer role:

coder.run      - Execute scripts
coder.reload   - Reload scripts
coder.compile  - Compile scripts
coder.validate - Validate scripts
coder.debug    - Debug scripts

---

💡 Command Tips

Quick Execution

Create shortcuts for frequent scripts:

# In a script or alias
/coder run announcer

Batch Reload

If you modify multiple scripts:

/coder reload script1
/coder reload script2
/coder reload script3

Monitor Performance

Check statistics regularly:

/coder admin stats
/coder debug on

Safe Testing

When testing scripts:

1. Test with /coder validate first
2. Load into memory: /coder load
3. Execute with /coder run
4. Check debug output: /coder debug on

---

❓ Command Troubleshooting

"Unknown command" Error

Cause: Command misspelled or plugin not loaded

Fix:

/coder list    # If this works, plugin is loaded

---

"Permission denied" Error

Cause: Player lacks permission node

Fix: Add permission in your permission plugin

coder.run
coder.list

---

"Script not found" Error

Cause: Script file doesn't exist or wrong name

Fix:

1. Check exact filename: /coder list
2. Ensure file is in /plugins/Coder/scripts/
3. Use correct name without extension

---

Command Returns No Output

Cause: Command executed but no visual feedback

Fix: Enable debug mode

/coder debug on

---

🚀 Next Steps

• Learn Syntax: See Syntax Reference
• Create Scripts: Follow Quick Start
• Advanced Usage: Read Advanced Scripting

---

Command Reference Complete! You're ready to control Coder! 🎮