GAMEVERS

From DoomWiki.org

GAMEVERS is a text lump extension of the COMPLVL lump to further specify a vanilla compatibility level automatically without having to enter a manual argument.

In Nyan Doom, the lump can also be used to enable limit-removing functionality[1] (disabling vanilla overflows such as spechits overflow and all-ghosts effect for demo playback / recording).

Like the COMPLVL lump, it is similar in behavior to MBF's OPTIONS lump, except that it does not allow/require the user to set the individual compatibility options; instead only up to two keywords are used, simplifying the process. The lump shares similarities to Chocolate Doom's -gameversion parameter.

History[edit]

The GAMEVERS lump was one of the first features of the Nyan Doom source port.[2]

Features[edit]

In order for GAMEVERS to take effect, a WAD must also have a COMPLVL lump set with the value of vanilla. The GAMEVERS lump can contain up to two values, each separated by a space.

The first value can define a specific vanilla compatibility level:

  • 1.2: corresponds to PrBoom's complevel 0, activating Doom 1.2 compatibility
  • 1.666: corresponds to PrBoom's complevel 1, activating Doom 1.666 compatibility
  • 1.9: corresponds to PrBoom's complevel 2, activating Doom 1.9 compatibility
  • ultimate: corresponds to PrBoom's complevel 3, activating Ultimate Doom compatibility
  • final: corresponds to PrBoom's complevel 4, activating Final Doom compatibility

The optional second value can define whether to enable limit-removing functionality:

  • nolimits: activates limit-removing functionality

The first value can be omitted, with just the nolimits value, and the COMPLVL functionality will auto-detect the complevel based on the IWAD.

The order of precedence is highest to lowest: parameter > lump > config. This means that if a complevel and/or limit-removing is set through a parameter, that will take precedence over the contents of GAMEVERS, while GAMEVERS will in turn take precedence over whatever is set in the menu as the default compatibility (which is stored inside the configuration file).

Supported ports[edit]

GAMEVERS is supported by the following ports:

Examples[edit]

The following are examples of WADs that utilize the GAMEVERS lump:

See also[edit]

External links[edit]

References[edit]

  1. Arsinikk (14 January 2025). https://github.com/andrikpowell/nyan-doom/blob/master/docs/limit_removing.md. Documentation in Nyan Doom GitHub repository. Retrieved 17 January 2025.
  2. Arsinikk (27 October 2024). https://github.com/andrikpowell/nyan-doom/blob/master/patch_notes/v1.1.md#v110. Patch Notes in Nyan Doom GitHub repository. Retrieved 17 January 2025.