Changes between Version 14 and Version 15 of PMP_File_Format


Ignore:
Timestamp:
Feb 4, 2024, 10:27:58 PM (3 months ago)
Author:
Ralph Sennhauser
Comment:

r24653

Legend:

Unmodified
Added
Removed
Modified
  • PMP_File_Format

    v14 v15  
    11= Scenario file formats =
    2 
    32A scenario consists of an XML data file and, optionally, a PMP data file. The XML format is text and may be viewed in any text editor, while the PMP is a proprietary binary format. Most scenarios are created with [wiki:Atlas_Manual Atlas scenario editor], which generates one of each file per map.
    43
     
    65
    76== PMP format ==
    8 
    9 The following describes version 6 of the PMP file format with C-like syntax.
     7The following describes version 7 of the PMP file format with C-like syntax.
    108
    119Basic types:
     10
    1211 * char = 8-bit character
    1312 * u32 = 32-bit unsigned int
     
    2120     // FILE HEADER
    2221     char magic[4]; // == "PSMP"
    23      u32 version; // == 6
     22     u32 version; // == 7
    2423     u32 data_size; // == filesize-12
    2524 
     
    5049 }
    5150}}}
    52 
    5351== Scenario XML format ==
    54 
    5552The following outlines version 5 of the scenario XML format.
    5653
     
    135132</Scenario>
    136133}}}
    137 
    138134=== Environment ===
    139 
    140135These elements correspond to settings on the [wiki:Atlas_Manual_Environment_Tab environment tab] in Atlas. They affect renderer behavior.
    141136
    142137=== Camera ===
    143 
    144138Currently unused?
    145139
     
    147141
    148142=== !ScriptSettings ===
    149 
    150 A special element containing a [wiki:JSON JSON] object. This object gets parsed during game setup to display information about the map such as its name, description, number of players and their civilizations. It's a flexible format which gets updated as we add new map settings.
     143A special element containing a [wiki:JSON] object. This object gets parsed during game setup to display information about the map such as its name, description, number of players and their civilizations. It's a flexible format which gets updated as we add new map settings.
    151144
    152145This data mostly corresponds to the [wiki:Atlas_Manual_Map_Tab map] and [wiki:Atlas_Manual_Player_Tab player] settings tabs in Atlas.
     
    155148
    156149=== Entities ===
     150This is a list of Entity elements that define all the objects on the map. Each Entity consists of:
    157151
    158 This is a list of Entity elements that define all the objects on the map. Each Entity consists of:
    159152 * unique [wiki:Entity entity] ID of type u32. Players are also considered entities, so these don't necessarily start with 1. 0 is reserved for `INVALID_ENTITY`.
    160153 * entity template filename. For [wiki:Actors actors], these are a reference to the actor template instead, prefixed with '''actor|'''
     
    164157
    165158=== Paths ===
    166 
    167159Currently unused.