Documentation menu

Meta Uploads

The Creator Dashboard can create or update multiple metas from a JSON array. This is useful when descriptions are maintained outside the dashboard.

JSON format

[
  {
    "tagName": "Czechia-Bollard",
    "metaName": "Czech bollard",
    "note": "Look for the two black rectangular reflectors on the front.",
    "footer": "Descriptions support **Markdown**.",
    "levels": ["Beginner"],
    "images": ["https://example.com/czech-bollard.jpg"]
  },
  {
    "tagName": "Portugal-LicensePlate",
    "metaName": "Portuguese license plate",
    "note": "Older Portuguese plates have a yellow date band on the right."
  }
]

Required fields

FieldTypePurpose
tagNamestringMust match the location tag used in the uploaded map JSON.
metaNamestringThe readable clue name shown to players and creators.
notestringThe explanation shown after a guess. Markdown is supported.

Optional fields

FieldTypePurpose
footerstring or nullExtra Markdown content displayed after the main note.
levelsarray of strings or nullLevel names assigned to the meta.
imagesarray of strings or nullImage URLs assigned to the meta.

Omitted values and empty arrays

For levels and images:

  • Omitting the field or setting it to null preserves existing assignments.
  • Supplying an empty array ([]) removes all existing assignments for that field.

The current importer treats an omitted, null, or empty footer as a blank footer. Include the existing footer text when an upload should retain it.

Upload metas

  1. Open the relevant group in the Creator Dashboard.
  2. Choose Upload Metas.
  3. Leave Keep existing metas enabled for a partial upload, or disable it only when the file should fully replace the group’s metas.
  4. Choose whether missing level names should be created automatically.
  5. Select the JSON file. You can also paste the JSON into the open dialog.

When full replacement is selected, metas omitted from the uploaded file are deleted. Review the file before confirming that mode.