Mod storage

One JSON document per name in Data/modsdata/<name>.json, through __SFCodeObj.modStorage.

Names are 1 to 64 characters of lowercase letters, digits, ., _ or -. They start with a letter or digit, do not end with ., and the part before the first . is not a Windows device name (con, nul, com1 and so on). Documents are non-empty, valid UTF-8 JSON, at most 5 MiB.

save validates the document and queues the write on xScal's file worker; it returns true once the write is queued. The file is replaced atomically when the worker runs. While a saved document is queued or being written, load returns it from memory; otherwise load reads the file, so edits made outside the game are picked up.

Names give organization, not access control. Any SWF can read or write any name. Storage does not write to xscal.log.

__SFCodeObj.modStorage.save(name:String, document:String):Boolean

__SFCodeObj.modStorage.save(document:String):Boolean

data.settings.bars.health.scale = 1.25;
var saved:Boolean = __SFCodeObj.modStorage.save(
    "improvedbars", JSON.stringify(data));

__SFCodeObj.modStorage.load(name:String):*

__SFCodeObj.modStorage.load():*

var stored:* = __SFCodeObj.modStorage.load("improvedbars");
if (stored !== false) {
    data = JSON.parse(String(stored));
}

__SFCodeObj.modStorage.register(name:String):Boolean