DANGER ZONE: This is intended for script writers or debugging, misuse can ruin your API config and break your scripts if you don't know what you're doing. modState v0.1.0 Code at GitHub Repo This is a pretty simple API script for grabbing keys from the sandbox state object, and modifying them. This can be handy for resetting versions while updating a script, or playing with the config in your script for keys which don't yet have a CLI listener attached, or... just breaking stuff if you're bored. Usage is simple: !modState --path <state object path> [ --write <value> --type <data type> ] --path the state object path must be forward slash separated instead of dot notation, without the 'state' reference itself, so state.myScript.config would become myScript/config path must always be supplied, and will perform a read unless --write and a value are specified key names are, obviously, case-sensitive for reading (default behaviour) you can target a specific key, or a whole object. You can even supply '/' if you hate your chat bar any keys nested further inside your target will have their sub-path flattened in the Key column the retrieved values can be clicked, which will prompt for a new value and perform a --write, unless you cancel the query --write you can only write to primitives, not objects, so there's no danger of overwriting an entire nested object full of keys I haven't given Arrays any special treatment. They'll just look like objects with the keys 0, 1, 2, 3 etc. values are automatically type checked - the strings 'true' and 'false' (not case-sensitive) will be cast to boolean, -.500 to a float, 3 to an integer use the --type command to override the auto type checking there is no provision for creating keys, as there's not much purpose in creating state keys with no script attached... --type you can use --type with --write to force the new value into a specified type. This is mostly useful when you want something like '500' or 'true' or 'undefined' to remain as a string. Currently, the only useful value is 'string', as the default auto-typing should cast to the correct type as long as you pass a legal value Example: !modState --path autoButtons/settings Provided autoButtons is installed, would show:
