Persistence & Data

Persistence & Data Storage

Storage Systems

The API uses various storage methods:

JSON Files

• Warps: data/warps.json
• Bans: data/bans.json
• Mutes: data/mutes.json
• Whitelist: data/whitelist.json
• Deaths: data/deaths.json
• Memories: data/memories.json

Configuration

• config.yml: Main configuration in YAML format

Runtime Data

• Player status: In memory (not persisted)
• TPS/Performance: Live calculation
• Chat: Not stored (send only)

Backup Format

Backups are ZIP archives of the entire world folder:

backups/
├── backup_2025-01-15_14-30-00.zip
├── backup_2025-01-15_12-00-00.zip
└── backup_2025-01-14_18-00-00.zip

Data Integrity

• Write operations are atomic (temp file → rename)
• Read access does not block
• All JSON files are loaded on server start