pyxen.storage
Persist data across play sessions. Save high scores, settings, progress, or any value that should survive when the game is closed and reopened.
storage.save("high_score", 9500)
storage.save("player_name", "Alice")
storage.save("sound_on", True)
score = storage.load("high_score") # 9500
name = storage.load("player_name") # "Alice"
missing = storage.load("no_key") # None
Values are stored as int, float, string, or bool. Other types (lists, dicts, objects) are not supported.
How it works
On iPad, Mac & Windows, storage is saved as storage.json inside the .pyxen project file. The data travels with the project — if you share the file, the saved data goes with it.
On the web player, storage uses the browser’s localStorage, keyed by game, and is written as soon as a value changes.
Storage is written when the game stops. You don’t need to flush manually.
Methods
| Method | Returns | Description |
|---|---|---|
save(key, value) | None | Save a value with the given key |
load(key) | value or None | Load a value, or None if the key doesn’t exist |
has(key) | bool | Check if a key exists |
delete(key) | None | Remove a key |
clear() | None | Remove all keys |
save(key, value)
storage.save("score", 100)
storage.save("name", "Alice")
storage.save("ratio", 3.14)
storage.save("completed", True)
Save a value with the given string key. If the key already exists, its value is overwritten.
Supported types:
| Type | Example |
|---|---|
int | storage.save("score", 100) |
float | storage.save("speed", 2.5) |
str | storage.save("name", "Alice") |
bool | storage.save("muted", False) |
Passing any other type (list, dict, etc.) raises a TypeError.
load(key)
score = storage.load("high_score")
Returns the value associated with the key, or None if the key doesn’t exist.
The returned value has the same type it was saved with — an int comes back as an int, a string as a string.
score = storage.load("high_score")
if score is None:
score = 0 # first time playing
has(key)
if storage.has("high_score"):
log("Welcome back!")
Returns True if the key exists, False otherwise.
delete(key)
storage.delete("old_setting")
Removes a key from storage. Does nothing if the key doesn’t exist.
clear()
storage.clear()
Removes all keys from storage. Use with care.
Examples
High score
from pyxen import *
def start():
board = world.spawn(name="board")
board.score = {"value": 0, "best": storage.load("best") or 0}
def update():
for board in world.all("score"):
board.score.value += 1
if board.score.value > board.score.best:
board.score.best = board.score.value
storage.save("best", board.score.best)
Settings
from pyxen import *
sound_on = storage.load("sound") is not False
def update():
global sound_on
if input.keyboard.m.pressed:
sound_on = not sound_on
storage.save("sound", sound_on)
Level progress
from pyxen import *
level = storage.load("level") or 1
def next_level():
global level
level += 1
storage.save("level", level)
Snippets
In Pyxen’s home, under Snippets:
- storage.save() / load() — Persist a value across runs by key.
- has() / delete() / clear() — Inspect and remove keys.