Update README.md to new API

This commit is contained in:
ShadowNinja 2014-07-06 18:48:12 -04:00
parent 9b3e1254c9
commit c5954e4f07

@ -4,17 +4,19 @@ datastorage
Helper mod to manage players data. Helper mod to manage players data.
All the mods can acces a single file (container) and easily have the data saved/loaded for them. All the mods can acces a single file (container) and easily have the data saved/loaded for them.
Usage
-----
Use: local data = datastorage.get(id, ...)
local container = datastorage.get_container (mod_name, player) Returns a reference to a data container. The id is normally a player name.
returns the table for given mod and a player. Following arguments are keys to recurse into, normally only one, a string
If container wasnt used before it will be created, otherwise it will contain all previously stored data. describing the type of data, is used. If the container doesn't exist it will
The table can store any data. be created, otherwise it will contain all previously stored data. The table
can store any data. Player's containers will be saved to disk when the player
Player's containers will be saved to disk on player leave. leaves, and all references to the player's data should be dropped. All of the
All the containers will be saved on server shutdown. containers will be saved on server shutdown. To forcibly save a container's
To force save all player's data, use: data use:
datastorage.save_container (player) datastorage.save(id)