Quick Start

Quick Start

Create your first Coder script in just 5 minutes. No Java knowledge required!

🎯 What You'll Learn

By the end of this guide, you'll be able to:

✅ Create a basic script file
✅ Use broadcast and send commands
✅ Execute your script on the server
✅ Understand basic Coder syntax

Time Required: 5 minutes
Difficulty: ⭐ Beginner

---

Step 1: Create Your First Script (1 min)

Location

Scripts go in /plugins/Coder/scripts/ folder

File Name

Create a new file called: hello.cd

Note: .cd extension stands for "Coder DSL"

Content

Copy this into hello.cd:

# My first Coder script!
 
# Broadcast a message to all players
broadcast "Hello everyone! Coder is working!"
 
# Send a message to the console
console.log "Script executed successfully!"

Step 2: Execute Your Script (30 sec)

In-Game

1. Join your server
2. Type in chat: /coder run hello
3. Press Enter You should see:

• Message in chat: Hello everyone! Coder is working!
• Message in console: Script executed successfully!

Via Console

Or from server console, type:

coder run hello

Step 3: Try More Commands (2 min)

Example 1: Send to Specific Player

Create greet.cd:

send "Welcome to the server!" to Steve
send "Hello Admin!" to Admin

Run: /coder run greet

Example 2: Multiple Messages

Create announcer.cd:

broadcast "────────────────────────────"
broadcast "Welcome to MyAwesomeServer!"
broadcast "Website: example.com"
broadcast "Discord: discord.gg/invite"
broadcast "────────────────────────────"

Run: /coder run announcer

Example 3: Variables

Create counter.cd:

var playerCount = 5
var serverName = "Creative Server"
 
broadcast "Server: {serverName}"
broadcast "Current players: {playerCount}"
broadcast "Max players: 20"

Run: /coder run counter

Step 4: Understanding the Basics (1.5 min)

Comments

Lines starting with # are comments (ignored by Coder):

# This is a comment
broadcast "This runs!"  # And this line runs too

Broadcast Command

Send message to ALL players:

broadcast "Message here"

Shows in chat for everyone on the server.

Send Command

Send message to SPECIFIC player:

send "Message here" to PlayerName

Variables

Store information:

var myVariable = 42
var serverName = "MyServer"
 
broadcast "The answer is {myVariable}"
broadcast "Server: {serverName}"

Console Logging

Log to server console:

console.log "Debug message"

📋 Basic Syntax Cheat Sheet

# Comments - use # for single line
broadcast "Message"              # Send to all players
send "Message" to PlayerName     # Send to specific player
console.log "Message"            # Log to console
 
var name = "value"               # Create variable
var count = 42                   # Numbers work too
var enabled = true               # Booleans work too
 
broadcast "Value is {variable}"  # Use variables with {}

🎮 Practical Examples

Auto-Restart Message

Create restart-alert.cd:

broadcast "────────────────────────────"
broadcast "⚠️  SERVER RESTARTING SOON!"
broadcast "────────────────────────────"
broadcast "Time remaining: 5 minutes"
broadcast "Save your work!"
broadcast "────────────────────────────"

Daily Rewards Notice

Create daily-rewards.cd:

broadcast "✨ Daily Rewards Available!"
broadcast "Type /rewards to claim your gift"
broadcast "Check back tomorrow for more!"

Server Rules

Create rules.cd:

broadcast "📜 SERVER RULES"
broadcast "1. Be respectful to all players"
broadcast "2. No griefing or stealing"
broadcast "3. No offensive language"
broadcast "4. Have fun!"
send "Rules acknowledged!" to Admin

✅ Verification

Your script worked if you see:

1. ✅ Message appears in game chat
2. ✅ Message appears in server console
3. ✅ No error messages
4. ✅ /coder list shows your script file

🚀 Next Steps

Now that you understand the basics:

1. Learn More: Read Syntax Reference for all commands
2. Explore: Check Examples & Tutorials for real use cases
3. Master: Study Advanced Scripting techniques
4. Integrate: Learn about Addons like CodeDSL and CoderJSLoader

💡 Tips

File Naming

• Use descriptive names: announcer.cd, welcome.cd, reminder.cd
• Use lowercase with hyphens: daily-rewards.cd (not DailyRewards.cd)
• One script per file is best practice

Debugging

• Check server console for error messages
• Use console.log to debug script flow
• Run /coder list to verify your script is recognized

Performance

• Keep scripts short and focused
• Use memory loading for frequently-run scripts: /coder load scriptname
• Monitor execution time in logs

❌ Common Mistakes

Mistake	Fix
broadcast Hello (no quotes)	Use quotes: broadcast "Hello"
Script in wrong folder	Place in /plugins/Coder/scripts/
Wrong file extension	Use .cd not .txt or .java
Typo in player name	Double-check capitalization and spelling
Script doesn't reload	Restart server or use /coder reload

🆘 Troubleshooting

Script Not Found

Error: Script 'hello' not found

Fix: Ensure hello.cd is in /plugins/Coder/scripts/ folder

Syntax Error

Error: Invalid syntax on line 2

Fix: Check quotes, brackets, and spelling on that line

Permission Denied

Error: You don't have permission

Fix: Ensure player has coder.run permission or is OP

Script Not Executing

Script runs but no output

Fix: Check if commands are spelled correctly (case-sensitive)

📚 Resources

• Full Reference: Syntax Reference
• More Examples: Examples & Tutorials
• All Commands: Commands
• Troubleshooting: Troubleshooting

---

Congratulations! 🎉 You've created your first Coder script!

Want to learn more? Check out the Syntax Reference for the complete list of commands and features.