@2bttns/objects NPM

Format & Get Ready Data

Convert JSON data into a format readable by the 2bttns Console.

Usage

npx @2bttns/objects

Format data for 2bttns Console will guide you through mapping your JSON and generating a ready to upload file.

Get ready-to-upload json data will download already formatted Game Objects available in the formatter.

# Ready to upload json data
? Select the JSON file you want to output from the /formatted-data folder: … 
❯ ready-car-considerations.json
  ready-chords.json
  ready-indoorActivities.json
  ready-outdoorActivities.json

Data Model
Usage
Example
Upload to Console
License

Warnin

The Tags section at the bottom of the output JSON is currently set to have empty strings for id, name, and description fields. As a result, a new Tag object will be generated in the Console.

Game Objects Model

The script converts any size JSON into the data model below.

Your JSON must contain a name equivalent field. These values are loaded as choices within your Game buttons.
Fields not represented in the Game Objects model are ignored. See Example for more information.

const outputShape: OutputShape = {
  gameObjects: [
    {
      id: '',
      name: '',
      description: '',
      tagIds: []
    }
  ],
  tags: [
    {
      id: '',
      name: '',
      description: ''
    }
  ]
};

Interface Type

interface GameObject {
  id: string;
  name: string;
  description: string;
  tagIds: string[];
  [key: string]: any;
}

Example

Here's an example of the input JSON:

{
    "chords": [
      {
        "name": "C Major",
        "notes": ["C", "E", "G"]
      },
      {
        "name": "C Minor",
        "notes": ["C", "Eb", "G"]
      },
      {
        "name": "D Major",
        "notes": ["D", "F#", "A"]
      },
      ...
    ]
}

And here's the resulting output JSON:

{
  "gameObjects": [
    {
      "id": "cljgvm1w00000679s2l9a5zql",
      "name": "C Major",
      "description": "",
      "tagIds": []
    },
    {
      "id": "cljgvm1w10001679sdppzbk1p",
      "name": "C Minor",
      "description": "",
      "tagIds": []
    },
    {
      "id": "cljgvm1w10002679sda2j6i75",
      "name": "D Major",
      "description": "",
      "tagIds": []
    },
    ...
  ],
  "tags": [
    {
      "id": "",
      "name": "",
      "description": ""
    }
  ]
}