EN 7 Data and Storage

7 Data and Storage

中文版本 | English version

Config File

• Path: config/teleport_commands.json
• Created automatically on first startup
• Includes version field; auto-migrated on startup

Persistent Data

As of v2.0, NBT format is used, stored under TeleportCommands/ in the world save directory:

File	Contents
global.dat	Global warp data
player/<UUID>.dat	Per-player home data (loaded on demand)
recorded_locations.dat	Global death point and previous-teleport records

When upgrading from an older version for the first time, storage.json is automatically migrated to the new format above, and the old file is renamed to storage.json.bak.

Backup Recommendations

Before upgrading or making large config changes, stop the server cleanly and back up:

• config/teleport_commands.json
• TeleportCommands/ under the world save directory
• If legacy file still exists: TeleportCommands/storage.json under the world save directory

global.dat and player/<UUID>.dat are the primary home/warp data for the new TPC storage system and should be treated as most important. recorded_locations.dat stores death points and previous-teleport locations; it is runtime data too, but usually less critical than home/warp data.

If storage.json.bak appears after upgrade, it usually means legacy storage.json was migrated and archived. If migration fails, do not delete the old file or .bak; keep backups and check server logs first.

Non-Persistent Data

• Teleport cooldowns and pending teleports are cleared on server startup
• Shared-home publications, subscriptions, and personal map visibility are runtime state and are cleared on restart; the source home itself remains normal persistent home data
• Death points and previous-teleport locations are persisted in recorded_locations.dat, but only flushed on clean shutdown — a server crash may lose recent records

Cleanup Behavior

• With home.deleteInvalid=true, an invalid home is deleted only when a home teleport finds that its target world is unavailable
• With warp.deleteInvalid=true, an invalid warp is deleted only when a warp teleport finds that its target world is unavailable
• Expired temporary homes are cleaned during refresh
• If storage schema version is newer than supported by current mod, startup fails fast with error