Skip to content

collection

The collection array contains all of the titles in the DAT file.

In the following example, required properties are highlighted. The values are for example only.

"collection": [
  {
    "group": "Some Video Game",
    "id": "654321",
    "titles": [
      {
        ...
      }
    ],
    "addOns": [
      {
        ...
      }
    ],
    "updates": [
      {
        ...
      }
    ]
  }
]

Related titles are grouped together in a single object by naming a group and listing its titles. For example, the group Some Video Game might contain the following titles:

  • Some Video Game (Europe)
  • Some Video Game (Japan)
  • Some Video Game (USA)
  • Some Video Game (USA) (v1.1)
  • Some Video Game - Game of the Year Edition (Europe)

The following updates:

  • Some Video Game (Europe) (Update v1.2)
  • Some Video Game (Japan) (Update v1.1)

And the following add-ons:

  • Some Video Game - Expansion Pack (USA, Europe)
  • Some Video Game - Expansion Pack (Japan)

Grouping in this way helps with 1G1R calculations, and replaces the parent/clone relationships found in LogiqX DAT files.

Required properties

  • group string required

    The name of the group of related titles.

  • titles object array required.

    Contains objects that describe the details about each title that is associated with a group. Read more about the titles array.

Optional properties

  • addOns object array optional

    The add-ons associated with titles. This includes DLC. Add-ons are at this level of the structure as they might be compatible with many variants of the titles. Read more about the addOns array.

  • id string optional

    A globally unique ID for the group. Usually a database ID to ease lookups for DAT file maintainers. Might be referenced by a DAT application when matching compilations against individual titles using the contains array.

  • updates object array optional

    The updates associated with titles. Updates are at this level of the structure as they might be compatible with many variants of the titles. Read more about the updates array.