mirror of
https://github.com/minetest-technic/datastorage.git
synced 2024-12-21 01:05:39 +01:00
Update README.md to new API
This commit is contained in:
parent
9b3e1254c9
commit
c5954e4f07
22
README.md
22
README.md
@ -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
|
||||||
|
leaves, and all references to the player's data should be dropped. All of the
|
||||||
|
containers will be saved on server shutdown. To forcibly save a container's
|
||||||
|
data use:
|
||||||
|
|
||||||
Player's containers will be saved to disk on player leave.
|
datastorage.save(id)
|
||||||
All the containers will be saved on server shutdown.
|
|
||||||
To force save all player's data, use:
|
|
||||||
|
|
||||||
datastorage.save_container (player)
|
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user