SEKA Player Persistence System

▌ OVERVIEW A drop-in, server-side player persistence framework that saves and restores the full player state across disconnects, crashes and server restarts. No more losing your loadout to a random kick. No more re-grinding gear after a server reboot. ▌ WHAT IT SAVES • Position & rotation (per-world, never cross-contaminates maps) • Health (relative to max HP) • Faction affiliation • Full loadout — weapons, attachments, magazines, ammo counts, clothing, backpack, vest contents, and active weapon in hand (powered by native SCR_PlayerArsenalLoadout — same engine API used by the official Arsenal system) ▌ KEY FEATURES • Auto-save every X minutes (default 3 min, configurable) • Saves on graceful disconnect • Mass-save on server shutdown / mission end • Per-world save namespace — playing a different map will NOT overwrite your main-server character • Vehicle-aware — if you log out inside a vehicle, your last valid ground position is preserved instead of stranding you • Anti-exploit: dies + leaves immediately = save deleted (no "die then alt-F4 to reset" abuse) • Terrain snap — prevents loading underground or floating • Faction is re-applied BEFORE the GameMode spawn, so your character spawns correctly aligned ▌ ADMIN COMMAND #savenow — Force-save your own character (admin only) ▌ INSTALLATION 1. Add this mod to your server's modlist 2. Open your GameMode entity in Workbench 3. Attach the component SEKA_PlayerSaveManagerComponent 4. (Optional) Adjust AUTO_SAVE_INTERVAL_MIN 5. Files are stored at $profile:/SEKA_PlayerSave/<world>/<pid> ▌ COMPATIBILITY • Works on any GameMode based on SCR_BaseGameMode • Server-side only — no client install required • Tested with manual-spawn and Game Master modes • Does NOT skip the deploy menu (avoids the v4 invincible-NPC race condition with SCR_AutoSpawnLogic) ▌ TECHNICAL N...