dialogSet.schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "Dialog": {
      "description": "A dialog situation that a player can encounter in this dialogSet.\n\nPrinciple: NPC says something, user has options how to react.",
      "properties": {
        "addFacts": {
          "description": "Upon entering this dialog, register these facts for the user.\n\nFacts are texts and may unlock or block dialog options across the game.\nE.g. The fact \"acceptedMissionX\" could unlock a dialog option regarding Mission X with another NPC.",
          "items": {
            "additionalProperties": false,
            "description": "Allows manipulation and formatting of text strings and determination and location of substrings within strings.",
            "patternProperties": {
              "^[0-9]+$": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "imageUrl": {
          "description": "Can be used to overwrite imageUrl from DialogSet.\nE.g. when a different emotion should be shown for this dialog,",
          "type": "string"
        },
        "options": {
          "description": "Choices of what the user might say in this dialog and where those choices lead to.\nThe player should be given between 0 and 4 options.",
          "items": {
            "$ref": "#/definitions/DialogOption"
          },
          "type": "array"
        },
        "removeFacts": {
          "description": "Upon entering this dialog, remove these facts from the user.\n\nFacts are texts and may unlock or block dialog options across the game.\nE.g. The fact \"acceptedMissionX\" could unlock a dialog option regarding Mission X with another NPC.",
          "items": {
            "additionalProperties": false,
            "description": "Allows manipulation and formatting of text strings and determination and location of substrings within strings.",
            "patternProperties": {
              "^[0-9]+$": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "text": {
          "description": "What the characters says to the player.\nLine breaks (\\n) are rendered as paragraphs.\nYou may leave this empty or omit it completely.",
          "type": "string"
        },
        "title": {
          "description": "The title is displayed at the very top of the dialog screen\nand usually corresponds to the name of the NPC the player is speaking to.\n\nCan be used to overwrite title from DialogSet.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "DialogOption": {
      "properties": {
        "forbiddenFacts": {
          "description": "All facts in this array must *not* be registered for this player for this option to show up.\n\nFacts are texts and may unlock or block dialog options across the game.\nE.g. The fact \"acceptedMissionX\" could unlock a dialog option regarding Mission X with another NPC.",
          "items": {
            "additionalProperties": false,
            "description": "Allows manipulation and formatting of text strings and determination and location of substrings within strings.",
            "patternProperties": {
              "^[0-9]+$": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "linksToDialog": {
          "description": "Which dialog in this dialogSet to jump to if this option is chosen.",
          "type": "string"
        },
        "requiredFacts": {
          "description": "All facts in this array must be registered for this player for this option to show up.\n\nFacts are texts and may unlock or block dialog options across the game.\nE.g. The fact \"acceptedMissionX\" could unlock a dialog option regarding Mission X with another NPC.",
          "items": {
            "additionalProperties": false,
            "description": "Allows manipulation and formatting of text strings and determination and location of substrings within strings.",
            "patternProperties": {
              "^[0-9]+$": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "text": {
          "description": "Text on option button.\nShould be rather short and not have line breaks.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "description": "Set of dialogs, beginning with startDialogName.\nThis should be",
  "properties": {
    "dialogs": {
      "additionalProperties": {
        "$ref": "#/definitions/Dialog"
      },
      "description": "All dialogs in this dialogSet.",
      "type": "object"
    },
    "imageUrl": {
      "description": "Url of image.\n\nShould link to image in this repo, to avoid CORS errors.",
      "type": "string"
    },
    "startDialogName": {
      "description": "At which dialog to start when the dialogSet is first opened by the player.",
      "type": "string"
    },
    "title": {
      "description": "The title is displayed at the very top of the dialog screen\nand usually corresponds to the name of the NPC the player is speaking to.",
      "type": "string"
    }
  },
  "type": "object"
}