Skip to main content

​
MySQL Extension

Enterprise-grade storage backend for high-traffic networks.

The MySQL/Redis Extension replaces the default local file storage with a robust remote database system. It enables real-time synchronization of player data (Facts) and world states (Assets) across multiple servers.

Relational Storage

Stores data in optimized SQL tables.

Redis Caching

Instant data retrieval and pub/sub messaging.

​
Features

  • Cross-Server Sync: Player progress (quests, facts, profiles) is instantly available on all servers in the network.
  • High Performance: Offloads I/O operations to external database servers, reducing main thread lag.
  • Redis Integration: Uses Redis for ultra-fast caching and inter-server communication.
  • Auto-Migration: Automatically imports existing local .json or .bin data on first startup.

​
Configuration

This extension functions as a backend driver and is configured via mysql-config.yml in the plugin folder.

​
Key Settings

SettingDescription
host, port, databaseConnection details for the SQL database.
redis.host, redis.portConnection details for the Redis cache (optional).
migrate-from-filesSet to true to import local data on startup.