JSON is simply a particular format for storing information, similar to XML or CSV. In the case of the API repository, the file script.json stores information about the script, and that information is used for the One-Click Installation feature. If you're copying the script manually, you can safely ignore it (the "description" field might contain useful information for you, though). When it comes to API code itself, some data for game objects is stored as JSON. For example, the turn order is accessed with Campaign().get('turnorder') , but the result is a (JSON) string. In order to get a useful structure, it has to be parsed. Fortunately, there is a built-in function to do that, so a script author trying to get the current turn order would use JSON.parse(Campaign().get('turnorder')) . In order to change the turn order, you'd have to do the reverse: Campaign().set('turnorder', JSON.stringify( myNewTurnOrder)) .
