🔧Troubleshooting

Common errors and how to fix them

Having issues with RagnaSync? This page covers common errors you might see in your server console and how to resolve them.

---

Connection Errors

"You must set your ragnasync_discord_id value inside channels.conf"

What it means: Your Discord server ID is missing or empty.

How to fix:

1. Get your Discord server ID (right-click server icon → Copy Server ID)

2. Open conf/channels.conf

3. Set your Discord server ID:

ragnasync_discord_id: "1234567890123456789"

---

"Invalid ragnasync_discord_id value found inside channels.conf"

What it means: The Discord server ID you entered is not a valid format.

How to fix:

• Discord server IDs are 17-19 digit numbers

• Make sure it's wrapped in quotes: "1234567890123456789"

• Don't leave the default placeholder value

---

"You must set your ragnasync_discord_guid value inside channels.conf"

What it means: Your Discord GUID (security key) is missing.

How to fix:

1. Contact RagnaSync support to get your Discord GUID

2. Add it to your channels.conf:

ragnasync_discord_guid: "your-guid-here"

The Discord GUID is provided by RagnaSync during installation. If you don't have it, contact support.

---

"Invalid ragnasync_discord_guid value"

What it means: The GUID you entered doesn't match what's registered for your Discord server.

How to fix:

• Double-check you copied the GUID correctly (no extra spaces)

• Make sure you're using the GUID for the correct Discord server

• Contact RagnaSync support if the problem persists

---

"IP blocked due to too many failed connection attempts"

What it means: Your server's IP has been temporarily blocked after multiple failed authentication attempts.

How to fix:

• Wait for the block to expire (the error message shows remaining time)

• While waiting, verify your channels.conf settings are correct

• Once the block expires, your server will retry automatically

---

"GUID already connected. Use unique GUID."

What you'll see in console:

[Info]: RagnaSync Service: Connection accepted
[Status]: RagnaSync Service: Logging in to server...
[Error]: [RagnaSync] GUID already connected. Use unique GUID.
[Status]: RagnaSync service has disconnected.
[Status]: RagnaSync service: Will attempt reconnection in 5 minute(s)

What it means: Another server is already connected using the same client_guid in your channels.conf. This commonly happens when you have both a test server and live server using the same GUID.

How to fix:

1. Quick Fix: Disconnect your test server - Simply disconnect your test server until your live server connection is established. This is the easiest solution if you don't need both servers connected simultaneously.

2. For simultaneous connections: Use unique GUIDs - If you need both test and live servers connected at the same time, each server must have a different client_guid in their channels.conf file.

After making changes, use @ragnasync_restart in-game to restart the RagnaSync service.

If you recently restarted your server, wait a few minutes for the old connection to timeout before trying again.

---

"Missing client version information"

What it means: Your RagnaSync installation is outdated or incomplete.

How to fix:

• Contact RagnaSync support to update your installation

• Make sure you're using the files provided by our installation team

---

"Maximum reconnection attempts reached. Stopping."

What it means: Your server tried to connect multiple times but failed each time.

How to fix:

1. Check your channels.conf settings are correct

2. Verify your Discord server ID and GUIDs

3. Use @ragnasync_restart to try connecting again

4. If issues persist, contact support

---

Script Errors

"Script validation failed: Missing required fields"

What it means: A RagnaScript message is missing required data.

How to fix: Make sure your RagnaScript calls include all required fields:

// Required fields for most scripts:
ragnascript("[action: message][channel: 1234567890][name: " + strcharinfo(0) + "][message: Hello][account_id: " + getcharid(3) + "][char_id: " + getcharid(0) + "]");

Common missing fields:

• action - The script type

• channel - Discord channel ID

• account_id - Player's account ID

• char_id - Player's character ID

---

"Message is too long (max 2000 characters)"

What it means: The message you're trying to send exceeds Discord's limit.

How to fix:

• Shorten your message to under 2000 characters

• For NPC scripts, add length validation:

if (getstrlen(.@message$) > 1900) {
    mes "Message too long!";
    close;
}

---

"Discord server is not connected, message not queued"

What it means: Your server isn't connected to RagnaSync, so messages can't be sent.

How to fix:

1. Check connection status with @ragnasync_status

2. If disconnected, use @ragnasync_restart to reconnect

3. Verify your channels.conf settings

---

"Queue full, dropping message"

What it means: Too many messages are waiting to be sent. New messages are being dropped.

How to fix:

• This usually means your server is sending messages faster than they can be delivered

• Add rate limiting to your NPC scripts

• Check if your connection is stable

---

Channel Errors

"Invalid channel ID" / "Default channel ID detected"

What it means: The Discord channel ID is missing or still set to the placeholder value.

How to fix:

1. Get your Discord channel ID (right-click channel → Copy Channel ID)

2. Update your channel configuration:

{
    name: "#global"
    alias: "[Global]"
    discord_channel_id: "1234567890123456789"  // Your actual channel ID
}

Don't forget to uncomment the line by removing // if it's commented out.

---

GM Command Reference

Use these commands to manage RagnaSync:

Command	Description
@ragnasync_status	Check connection status
@ragnasync_restart	Restart the connection
@ragnasync_on	Start RagnaSync service
@ragnasync_off	Stop RagnaSync service

---

Still Having Issues?

If you've tried the solutions above and still have problems:

1. Check your server console for the exact error message

2. Verify all settings in channels.conf match what RagnaSync provided

3. Contact support with:

   • The exact error message

   • Your Discord server ID

   • When the problem started

Contact RagnaSync Support