DiskApi

Allows you to persistently store and retrieve data for players or general use

Overview:

Functions:
DiskApi.loadFile(fileName, async, global)
DiskApi.saveFile(fileName, async, global)
DiskApi.getVar(fileName, key, fallback, global) ⇒ value
DiskApi.setVar(fileName, key, value, global)

API Reference

loadFile()

Loads a file into memory.

DiskApi.loadFile("data.json", true, false)

Parameters:

• fileName (String)

• async (Boolean)

• global (Boolean)

---

saveFile()

Writes the current file data to disk.

DiskApi.saveFile("data.json", true, false)

Parameters: Same as loadFile.

---

getVar()

Retrieves a stored value.

let count = DiskApi.getVar("data.json", "count", 0, false)

Parameters:

• fileName (String)

• key (String)

• fallback (Any)

• global (Boolean)

Returns:

• value (Any)

---

setVar()

Stores a value.

DiskApi.setVar("data.json", "count", 5, false)

Parameters:

• fileName (String)

• key (String)

• value (Any)

• global (Boolean)

---

Example:

Save and load amount of blocks a player has destroyed

var ValueName = "destroyedBlocks"

function getFileName(player) {
    return player.getUniqueId() + "_data"
}

registerEvent("org.bukkit.event.player.PlayerJoinEvent", function(event) {
    task.spawn(function() {
        var player = event.getPlayer();
        var fileName = getFileName(player);
        DiskApi.loadFile(fileName, false, false);
        var destroyedBlocks = DiskApi.getVar(fileName, ValueName, 0, false);
        player.sendMessage("You destroyed "+destroyedBlocks+" blocks!")
    });
})

registerEvent("org.bukkit.event.player.PlayerQuitEvent", function(event) {
    task.spawn(function() {
        var player = event.getPlayer();
        var fileName = getFileName(player);
        log.info("Saving player data...")
        DiskApi.saveFile(fileName, false, false);
        log.info("Data saved!")
    })
})

registerEvent("org.bukkit.event.block.BlockBreakEvent", function(event) {
    var player = event.getPlayer()
    var fileName = getFileName(player);
    var destroyedBlocks = DiskApi.getVar(fileName, ValueName, 0, false) + 1
    DiskApi.setVar(fileName, "destroyedBlocks", destroyedBlocks, false)
    event.getPlayer().sendMessage("You destroyed " + destroyedBlocks + " blocks!");
});

Tips

• Always load the file before using getVar() or setVar()

• For frequent access, store fileName in a variable to avoid recalculating

• For large data sets or many players, prefer async = true and threading logic using task.spawn()