Skip to main content

Game Config Schema

The game.json file defines the full structure of a smart home simulation used in our game-based studies. It coordinates all key components that drive user experience, system behavior, and experimental logic.

This configuration includes:

  • The environment context (e.g., current time, temprature, weather, etc. within the simulated smart home)
  • The rules that govern smart home automation
  • A set of tasks players must complete
  • Definitions for rooms, walls, and doors
  • Interactive devices with properties and states

Game Config

Loading ....
JSON Schema Code

Game Schema

{
"type": "object",
"title": "Game Configuration File",
"description": "Configuration File of the game",
"properties": {
"environment": {
"$ref": "environmentSchema.json"
},
"rules": {
"type": "array",
"items": {
"$ref": "ruleSchema.json"
}
},
"tasks": {
"type": "object",
"description": "Tasks configuration with metadata and task list",
"properties": {
"ordered": {
"type": "string",
"description": "Whether tasks must be completed in order",
"enum": [
"true",
"false"
]
},
"timer": {
"type": "number",
"description": "Global timer for all tasks in seconds"
},
"abortable": {
"type": "boolean",
"description": "Whether tasks can be aborted globally"
},
"tasks": {
"type": "array",
"description": "Array of individual tasks",
"items": {
"$ref": "taskSchema.json"
},
"minItems": 1
}
},
"required": [
"tasks"
]
},
"rooms": {
"type": "array",
"items": {
"$ref": "roomSchema.json"
}
}
}
}

Each section is defined as a modular schema and can be validated independently. For detailed documentation, refer to the dedicated pages for each section below:

SectionDescriptionDetails
EnvironmentContextual variables that may influence rulesEnvironment Schema
RulesAutomation logic that reacts to environment and devicesRules Schema
TasksExperimental tasks with goals, device resets, and timersTasks Schema
Rooms & WallsVisual and navigational layout of the houseWalls & Rooms Schema
DevicesSmart home devices with states and propertiesDevices Schema
Device InteractionDevice action/state schemas (numerical, boolean, etc.)Interaction Schema