pyxen.storage
Persiste datos entre sesiones de juego. Guarda puntuaciones altas, ajustes, progreso, o cualquier valor que deba sobrevivir cuando el juego se cierra y se vuelve a abrir.
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
Los valores se almacenan como int, float, string o bool. Otros tipos (listas, diccionarios, objetos) no son compatibles.
Cómo funciona
En iPad, Mac y Windows, el almacenamiento se guarda como storage.json dentro del archivo de proyecto .pyxen. Los datos viajan con el proyecto — si compartes el archivo, los datos guardados van con él.
En el reproductor web, el almacenamiento usa el localStorage del navegador, indexado por juego, y se escribe en cuanto cambia un valor.
El almacenamiento se escribe cuando el juego se detiene. No necesitas vaciar manualmente.
Métodos
| Método | Retorna | Descripción |
|---|---|---|
save(key, value) | None | Guarda un valor con la clave dada |
load(key) | valor o None | Carga un valor, o None si la clave no existe |
has(key) | bool | Comprueba si una clave existe |
delete(key) | None | Elimina una clave |
clear() | None | Elimina todas las claves |
save(key, value)
storage.save("score", 100)
storage.save("name", "Alice")
storage.save("ratio", 3.14)
storage.save("completed", True)
Guarda un valor con la clave de texto dada. Si la clave ya existe, su valor se sobrescribe.
Tipos soportados:
| Tipo | Ejemplo |
|---|---|
int | storage.save("score", 100) |
float | storage.save("speed", 2.5) |
str | storage.save("name", "Alice") |
bool | storage.save("muted", False) |
Pasar cualquier otro tipo (lista, diccionario, etc.) genera un TypeError.
load(key)
score = storage.load("high_score")
Retorna el valor asociado con la clave, o None si la clave no existe.
El valor retornado tiene el mismo tipo con el que fue guardado — un int regresa como int, un string como string.
score = storage.load("high_score")
if score is None:
score = 0 # primera vez jugando
has(key)
if storage.has("high_score"):
log("Welcome back!")
Retorna True si la clave existe, False en caso contrario.
delete(key)
storage.delete("old_setting")
Elimina una clave del almacenamiento. No hace nada si la clave no existe.
clear()
storage.clear()
Elimina todas las claves del almacenamiento. Usar con precaución.
Ejemplos
Puntuación alta
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)
Ajustes
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)
Progreso de nivel
from pyxen import *
level = storage.load("level") or 1
def next_level():
global level
level += 1
storage.save("level", level)