Troubleshooting

Common issues and how to resolve them

Also see the frequently asked questions.

I can't connect

Here's a checklist:

• Do you have internet or local connection? (Trust me, even the smartest people can forget this)
• Is the host properly exposed? How to host outside your local network
• Are both of you authorized in the network?
• See if both of you can reach each other by running in your terminals/cmd: ping ip.address.here
• Are you connecting to the same port as the server is running on?

I'm stuck on "Waiting for host's approval"

This means the host hasn't manually approved your connection. Tell them to do that.

Otherwise this is a bug. Please report it.

The plugin doesn't appear in the plugins tab

Ensure the unpacked plugin folder is placed in the addons folder.

The file structure must look like this:

YourProject
|_ addons
  |_ GodotTogether
    |_ plugin.cfg

|_ project.godot

Exact names are important!

Godot crashes when enabling the plugin

This is a very common issue on Windows. Currently there is no fix available.

Simply try until it eventually works.

Godot freezes when reloading a scene

This is a very annoying bug that the solution for is still unknown.

It seems to most commonly happen when you reload a scene, while having nodes selected.
This is the Godot bug report: https://github.com/godotengine/godot/issues/114710

Remember to unselect all nodes before reloading scenes, and hope for the best.

Godot crashes when starting the plugin

This is a known issue on Windows. Its cause is unknown.

Simply try again.

TileMap doesn't sync

Use TileMapLayer instead.

The old TileMap is deprecated and implementing mode sync for it would create performance hell and would require a lot of effort. It's not worth it for something that's going to be removed.

"RPC checksum failed" error in the console

You and the host are using different versions of the plugin (likely a release and source code version). You both need to be using the exact same version.

My changes don't appear for other users

(First read the section above)

This is a bug. This is not your fault.

You can try restarting the plugin or rejoining. If the issue persists, report a bug.

Errors when enabling the plugin

If you see errors in the console and the plugin doesn't work (or only works partially), try restarting Godot.

If the issue persists, report it here and include all the errors.

"Connection lost" right after connecting

The host is running a newer (not yet officially released) source code version of the plugin.

New plugin versions reject old versions, but the old ones are unable to interpret the error message and just say "connection lost".

Simply you need to update to the host's version or they have to downgrade to yours.

I have a problem with something else

Feel free to Open an issue to submit a question or a bug report.
If you want immediate support, join the Discord server.

I'm happy to help you!