Lost Character Restoration
DANGER
Servers that use Remote Database are not affected by this issue. This guide is specifically for servers using Local Database.
Players may occasionally lose their characters due to server issues, bugs, or other factors. This guide provides detailed steps to restore lost characters, using both automated and manual methods. You can find the related blog post here. Even with these solutions, it is recommended to back up your server data regularly to prevent data loss.
Automatic Restoration
For Players
The players can use the /RestoreMyCharacters command to automatically restore their lost characters. This command will find as much data about the characters as possible and send a request to the server. The server will then attempt to restore the characters based on the data found. Follow these steps to restore your character:
- Log in to the game and connect to the server where your character was lost.
- Create a new character and join the server.
- In the chat, type the command
/RestoreMyCharactersand press Enter. - Check your character list to confirm restoration.
TIP
If the automatic restoration does not work, please contact the server admin for further assistance.
For Admins
For server admins, an admin-only command called /RestoreCharacter is available to restore characters for specific players. The command will attempt to find a character with a certain name, and add it to an account of a certain id. Follow these steps to restore a player's character:
- Log in to an admin alderon account for the server.
- Use the command
/RestoreCharacter [AlderonId] [CharacterName]to restore the character for a specific player with a lost character named[CharacterName].
Details
EXAMPLE: /RestoreCharacter 123-456-789 RedShark
This command will attempt to find a character named RedShark and link it to the account with the AlderonId 123-456-789.
- Confirm with the player that their character has been restored.
Manual Restoration
If the automatic commands do not successfully restore the character, as a server admin with server host access, you can follow these detailed steps:
1. Access the Server Database
- Log in to the server management panel where your server is hosted.
- Navigate to the database section where player data is stored. This is usually located within the
DatabaseCachefolder in your server directory.
2. Backup the Server Database
- Before making any changes, create a backup of the server database to prevent any data loss.
- Copy or zip the entire
DatabaseCachefolder located in{ServerDirectory}/PathOfTitans/Saved/DatabaseCache. - Ensure that this backup includes the most recent character data.
3. Locate the Player's Account Data
- Find the player’s Alderon ID: Accounts are saved under their Alderon ID as a JSON file. For example, a player with ID
123-456-789will have a file named123456789.json. - Navigate to the account file at
{ServerDirectory}/PathOfTitans/Saved/DatabaseCache/Account/123456789.json.
4. Locate the Lost Character
- Search for the lost character: Characters are stored in the
Characterdirectory as individual JSON files. - Use a tool like Notepad++ to search for the character’s name. Go to
Search -> Find In Files..., set the directory to{ServerDirectory}/PathOfTitans/Saved/DatabaseCache/Character, and search for the character’s name (e.g.,TitanJaw). - Identify the character file: Once found, the file name (e.g.,
35FB3F52419143E347089789CDB6D84C.json) is the ID of the character. Copy this file name without the.jsonextension (e.g.,35FB3F52419143E347089789CDB6D84C).
5. Restore the Character
- Open the player’s account file found in step 3.
- Locate the "Characters" section within the JSON file:
"characters":[]. - Add the character ID found in step 4 into this section, ensuring it’s enclosed in quotation marks and separated by commas if multiple characters are being added.
- Example for a single character:
"characters":["35FB3F52419143E347089789CDB6D84C"] - Example for multiple characters:
"characters":["35FB3F52419143E347089789CDB6D84C","E734FBA52148451F8748D97798A73DB3"]
- Example for a single character:
- Save the changes to the JSON file.
6. Verify the Restoration
- Restart the server if necessary to apply the changes.
- Ask the player to log in and check their character list to confirm the restoration was successful.
Other Commands
Furthermore, the following command can be used by server owners to quickly create characters that are pre-grown of a certain dinosaur, dinosaur name, marks, and growth level. This can be useful for quickly creating characters for players who have lost their characters and are unable to restore them:
DANGER
This command currently does not support Remote Database servers and should only be used on Local Database servers. The support for Remote Database servers will be added in a future update.
Preventative Measures
To minimize the risk of losing characters in the future, the development team is working on several features to enhance server stability and data protection:
- New Tool - AlderonDatabaseUploader: We are adding in a new tool called AlderonDatabaseUploader which will let you upload characters from a local database to the remote database, which will let them be automatically backed up by our managed database service.
- New Local Server Backup Feature: We are adding a automatic local backups and automatically backs up the database when updating to a new patch. The reality is most server owners don't backup their data because they don't know how or it's too complicated. We are solving this.
- New Offsite Server Backup Feature: We are adding a feature to the game to upload character data backups to a S3 bucket so if your server hard drive dies you still have regular backups.
- Improved Testing Process when releasing updates / patches: We are improving our testing process to make sure this doesn't happen again.
Additional Support and Rewards
We are giving out server owners with some bugtracker skin keys to give to their Admins / Staff / Communities / Game Server Providers who ran into this issue. This can be given out to staff who have extra work now to help restore people's characters. It can also be given out to players who character data can't be restored.
Server owners and players are encouraged to reach out to the support team for assistance with any issues not covered by the above steps.
For more detailed guidance or other information, please refer to the official blog post.
