/** Client graphics preferences (persisted in localStorage). */ export const ViewDistance = Object.freeze({ long: "long", short: "short" }); export const LightingMode = Object.freeze({ soft: "soft", simple: "simple" }); export const BloomMode = Object.freeze({ on: "on", off: "off" }); /** Soft edge blend between blendable ground tiles (grass, dirt, …). */ export const SoftTerrainMode = Object.freeze({ on: "on", off: "off" }); export const DEFAULT_GRAPHICS_SETTINGS = Object.freeze({ viewDistance: ViewDistance.long, lighting: LightingMode.soft, bloom: BloomMode.on, softTerrain: SoftTerrainMode.on }); const STORAGE_KEY = "questward-graphics-settings"; export function normalizeGraphicsSettings (value) { const raw = value && typeof value === "object" ? value : {}; const viewDistance = raw.viewDistance === ViewDistance.short ? ViewDistance.short : ViewDistance.long; const lighting = raw.lighting === LightingMode.simple ? LightingMode.simple : LightingMode.soft; const bloom = raw.bloom === BloomMode.off ? BloomMode.off : BloomMode.on; const softTerrain = raw.softTerrain === SoftTerrainMode.off ? SoftTerrainMode.off : SoftTerrainMode.on; return { viewDistance, lighting, bloom, softTerrain }; } export function loadGraphicsSettings () { try { const text = localStorage.getItem(STORAGE_KEY); if (!text) { return { ...DEFAULT_GRAPHICS_SETTINGS }; } return normalizeGraphicsSettings(JSON.parse(text)); } catch { return { ...DEFAULT_GRAPHICS_SETTINGS }; } } export function saveGraphicsSettings (settings) { const next = normalizeGraphicsSettings(settings); try { localStorage.setItem(STORAGE_KEY, JSON.stringify(next)); } catch { /* ignore quota / private mode */ } return next; } /** Map-ring Chebyshev radius for chunk subscriptions (entities always use VISIBLE_CHUNK_RADIUS). */ export function staticChunkRadiusForViewDistance (viewDistance, longRadius, shortRadius) { return viewDistance === ViewDistance.short ? shortRadius : longRadius; }