How to Fix the "session.lock" Error
If you're trying to start your server and see an error in the console mentioning "failed to synchronize" or referencing a "session.lock" file, don't worry! This is a very common and simple issue to fix. It's a safety feature that prevents a world from being corrupted if the server didn't shut down correctly.
Resolving the Error in 4 Steps
IMPORTANT: You must ensure your server is fully stopped before following these steps. Use the Stop button in your panel and wait for the server status to show as "Offline". If it's stuck, you may need to use the Kill button.
- Go to the File Manager: Log into your Game Panel and navigate to the File Manager from the menu on the left.
- Open Your World Folder: Click on your main world folder. By default, this folder is named
world
. - Find and Delete session.lock: Inside the world folder, you will see a file named exactly
session.lock
. Select this file and click the Delete button.
- Start Your Server: Return to the Console page and start your server. The error will now be gone and your server will boot up normally!
How to Prevent This Error
The session.lock
file is created every time the server starts and is automatically deleted when it shuts down cleanly. The error only occurs when the server crashes or is closed improperly, which leaves the file behind.
To prevent this from happening in the future, always try to use the main Stop button on your control panel. This allows the server to perform a graceful shutdown, saving all data correctly and removing the lock file on its own.