🐛 Troubleshooting

Common Issues

Discord Integration Not Working

Symptoms: Roles/avatars not showing

Solutions:

1. Verify bot token in server.cfg

2. Check bot has "Server Members Intent" enabled

3. Ensure bot is in Discord server

4. Check server console for API errors

5. Verify Guild ID is correct (or let it auto-detect)

6. Check Discord API status: https://discordstatus.com/

Console Output:

[daphne_chat] Discord integration enabled. Fetching roles...
[daphne_chat] Loaded X Discord roles
[daphne_chat] Discord role cache initialized successfully

Admin Editor Won't Open

Symptoms: /chatconfig does nothing

Solutions:

1. Check ACE permission: daphne_chat.admin

2. Verify permission in server.cfg

3. Restart server after adding permission

4. Check server console for errors

Console Output:

[daphne_chat] Player JohnDoe (1) used /chatconfig
[daphne_chat] Opening config editor for JohnDoe

Messages Not Showing

Symptoms: Messages not appearing in chat

Solutions:

1. Check if chat mode is enabled

2. Verify distance for proximity modes

3. Check permission requirements

4. Verify cooldown hasn't expired

5. Check server console for errors

Config Not Saving

Symptoms: Changes don't persist

Solutions:

1. Verify chat_config.json is writable

2. Check server console for save errors

3. Ensure JSON is valid (use JSON validator)

4. Check file permissions

Console Output:

[daphne_chat] Configuration saved successfully

Commands Not Working

Symptoms: Commands not recognized

Solutions:

1. Verify command name (case-insensitive)

2. Check cooldown timer

3. Verify you have required permission

4. Check server console for errors

Console Output:

[daphne_chat] Registered X client-side commands

Debug Mode

Enable debug prints in src/client/main.lua:

local DEBUG = true  -- Set to true

local function debugPrint(...)
    if DEBUG then
        print('[daphne_chat:client]', ...)
    end
end

Server Console Logs

Check for these important messages:

Initialization:

[daphne_chat] Initializing chat system...
[daphne_chat] ConfigManager loaded, loading configuration...
[daphne_chat] Configuration loaded with X chat modes
[daphne_chat] Chat commands will be registered client-side
[daphne_chat] Chat system initialized successfully!

Discord Integration:

[daphne_chat] Discord integration enabled. Fetching roles...
[daphne_chat] Loaded X Discord roles
[daphne_chat] Discord role cache initialized successfully

Player Join:

[daphne_chat] PlayerName is connecting...
[daphne_chat] Cached Discord data for PlayerName
[daphne_chat] PlayerName joined

Message:

[daphne_chat] PlayerName (local): Hello everyone!
[daphne_chat] Broadcasting message: Type=local, Author=PlayerName, Roles=2