Namespaces

Every key lives in a namespace. A namespace has its own TTL and size limit, and belongs to one network.

network: my-network
namespaces:
  player-state:
    ttl: 24h
  leaderboards:
    ttl: 1h
    max-keys: 50000

Plugins create the namespaces they need on first use with the defaults below; configure one in config.yml only to change them.

Setting	Default	Notes
ttl	24h	Per key, refreshed on write
max-keys	100000	Oldest keys are evicted first
max-value-size	64KB	Larger writes fail

Player state

The player-state namespace is special: values under player:<uuid>:* are loaded before the player joins and saved when they quit, so other plugins can read them in PlayerJoinEvent without waiting.

Limits

Current limits per network are listed at /api/v1/limits on the SaunaCache backend. /saunacache stats shows how close each namespace is to its limits.