Difference between revisions of "LaunchBox Platform XML"
Line 19: | Line 19: | ||
* [[#Notes\Description]] | * [[#Notes\Description]] | ||
* [[#Alternate Names]] | * [[#Alternate Names]] | ||
* [[Manuals]] | * [[#Manuals]] | ||
* [[#Extras]] | * [[#Extras]] | ||
* [[Music]] | * [[#Music]] | ||
* [[#Images]] | * [[#Images]] | ||
* [[Video Snaps]] | * [[#Video Snaps]] | ||
* [[#Application Path]] | * [[#Application Path]] | ||
* [[#Configuration Application Path]] | * [[#Configuration Application Path]] | ||
Line 136: | Line 136: | ||
=== Music === | === Music === | ||
[[Music]] linked to the game will auto play (if the settings are allowed) while browsing. Music files currently in the eXoDOS project were primarily located and donated by erebus44, a member of the eXoDOS Discord. | |||
=== Images === | === Images === | ||
[[Images]] for a game include box scans, 3D boxes, media scans (flopopy\CD), title screens, game play screens, banners, clear logos, and more. Please check the[[Images]] page for more detail on how this project sources and assigns imagery. | |||
=== Video Snaps === | === Video Snaps === |
Revision as of 13:28, 9 November 2021
The XML file used by LaunchBox is the local copy of all textual metadata, supported by LaunchBox, exported from our Master Database.
Data Types
The following data is stored within the XML for each game and viewable via the front-end
- #Game Title
- #Release Date (Year)
- #Release Type
- #Max Players
- #Genre
- #Platform
- #Developer
- #Publisher
- #Series
- #Region
- #Play Mode
- #Source
- #Notes\Description
- #Alternate Names
- #Manuals
- #Extras
- #Music
- #Images
- #Video Snaps
- #Application Path
- #Configuration Application Path
Unused Data Types
The XML file is capable of tracking the following data, however it is unused within the eXo project.
- Controller Support
- Sort Order (used by a handful of games)
- Status
- Version
- Video URL
- Wikipedia URL
- DOSBox (eXo Projects use their own DOSBox versions.
- Mounts
- ScummVM (eXo Projects use their own ScummVM version)
- Emulation
- Startup/Pause
Metadata Description
Game Title
Game title is derived from the actual title screen of the game. This is important, as there are instances where the box, manual, and actual title screen disagree with each other. For identical games that were released under different regional names, the U.S. name is chosen for the metadata. Often however, upon starting the game the user is given the choice to launch the version of their choice.
Release Date (Year)
As specific release dates were not very well documented (and quit often it was a slow roll-out as shipments arrived across the country in various store sat different times), the release date is primarily just the year the release year. A handful of well documented games have specific dates which are noted. When a games release date is unknown, the order of inspection (in order of priority) is:
- a date on any scanned printed materials
- a copyright date within the game
- the actual file date
A couple of games have none of the above and have been marked as 198x or 199x to indicate the decade they are from.
Release Type
Within launchbox, Release Type typically denotes
- DLC
- Homebrew
- Released
- ROM Hack
- Unlicensed
- Unreleased
For the purpose of the eXo projects, only Released, Unlicensed, and Unreleased are used.
Max Players
Max players is the total number of players a game supports. This is calculated by comparing the max local, max offline, max online, and max co-op player fields from the Master Database. The highest number of all of these fields is then assigned to the Max Players field in the XML.
Genre
eXoDOS uses the following genres
- Action
- Adventure
- Application
- Arcade
- Beat 'em Up
- Board / Party Game
- Casino
- Construction and Management Simulation
- Education
- Fighting
- First Person Shooter
- Flight Simulator
- Game Show
- Interactive Fiction
- Interactive Movie
- Paddle / Pong
- Pinball
- Platform
- Puzzle
- Quiz
- Racing / Driving
- Role-Playing
- Shooter
- Simulation
- Sports
- Strategy
- Text-Based
- Vehicle Simulation
While the genres may seem non-traditional my current standards, they are reflective of the types of games released for these platforms. Many games are cross genre, in which case multiple genres have been assigned to them. The #Series field further delineates the game type.
Platform
The operating system or platform the game was released on.
Developer
The developer of the game. This may be a company or the name of an individual. Values have been normalized to make it easier for cross referencing. eg: Sierra, Sierra OnLine, Sierra On-Line, and On-Line Systems would all be listed as just Sierra On-Line, Inc.
Publisher
For games that were released commercially, this contains the game's publisher. Self published games are often listed the same as the developer. Freeware games are simply listed as 'Freeware' within this field. Like #Developer, this field has been normalized to a common name for publishers that released under multiple names.
Series
Region
This is not often used by the primary eXo projects, except in cases where a game is not in English. The Language Packs (Main_Page#Language Packs) however use this field to help denote the country of origin.
Play Mode
Cooperative, Multiplayer, or Single Player are the potential options for this field.
Source
Source is also used to denote the Business Model. Commercial is a catch all for any game that was "sold". This includes boxed games sitting on store shelves or games that had a nagging address at the end asking you to send them $20 (such as the shareware concept). Freeware denotes games that were released either totally free, or under the "Donorware" model, in which the software solicited donations but did not nag or lock content behind them.
Notes\Description
Quite simply, a description of the game. The descriptions are composed of a combination of original descriptions and those sourced\editted from websites such as Mobygames and old-games.ru.
Alternate Names
Some games were released under various names that either changed over time or by release region. This had led to confusion in the past, such as a user searching for Broken Sword and not finding it under it's U.S. release name, Circle of Blood. Alternate names have been integrated in order to alleviate this issue. It includes both alternate names in English, as well as foreign language spellings of games (when known).
Manuals
The manuals are a massive project in and of itself. The Manuals page details this, however the short of it is any scanned manual for a game will be linked here.
Extras
Music
Music linked to the game will auto play (if the settings are allowed) while browsing. Music files currently in the eXoDOS project were primarily located and donated by erebus44, a member of the eXoDOS Discord.
Images
Images for a game include box scans, 3D boxes, media scans (flopopy\CD), title screens, game play screens, banners, clear logos, and more. Please check theImages page for more detail on how this project sources and assigns imagery.
Video Snaps
If a video snap exists for the game, it will be linked here. Details on the Video Snaps project can be found at it's link.
Application Path
A link to the games Launcher.
Configuration Application Path
This links to the games Installer.