Editing ExtraData

From Eternity Wiki
Jump to navigationJump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
With support of [[Universal Doom Map Format]] in releases of Eternity, ExtraData is now considered {{Deprecated}}. In the future new features introduced into UDMF will not be supported by ExtraData. ExtraData maps will still work, but new projects should use UDMF due to its greatly streamlined mapping experience, especially if using editors such as [https://www.doomworld.com/forum/topic/96943 Doom Builder X] or [https://forum.zdoom.org/viewtopic.php?t=54957 GZDoomBuilder-Bugfix] are used (the former including specific improvements for Eternity's UDMF, such as for [[linked portals]]).
ExtraData is a new data specification language for the [[Eternity Engine]] that allows arbitrary extension of mapthings, lines, and sectors with any number of new fields, with data provided in more or less any format. The use of a textual input language forever removes any future problems caused by binary format limitations. The ExtraData parser is based on the libConfuse configuration file parser library by Martin Hedenfalk, which is also used by GFS and EDF.  


ExtraData is a new data specification language for the [[Eternity Engine]] that allows arbitrary extension of mapthings, lines, and sectors with any number of new fields, with data provided in more or less any format. The use of a textual input language forever removes any future problems caused by binary format limitations. The ExtraData parser is based on the libConfuse configuration file parser library by Martin Hedenfalk, which is also used by GFS and EDF.  
Each section in this document deals with one of the ExtraData constructs, as well as how to embed ExtraData in a WAD and how to associate it with a given map.  
 
ExtraData will continue to be supported in future versions of Eternity, even though it will soon be superceded by support for the [[Universal Doom Map Format]].


Each section in this document deals with one of the ExtraData constructs, as well as how to embed ExtraData in a WAD and how to associate it with a given map.
{{Backto|Eternity Engine}}
{{editref}}
=General Syntax=
=General Syntax=
''See [[EDF#Syntax|EDF Syntax]], as it is the same.''
''See [[EDF#Syntax|EDF Syntax]], as it is the same.''
Line 50: Line 49:
   // These fields are ExtraData extensions
   // These fields are ExtraData extensions
   tid      <number>
   tid      <number>
  special  <number>
   args      { <special field>, ... }
   args      { <special field>, ... }
   height    <number>
   height    <number>
Line 64: Line 62:


This field can also accept EDF thingtype mnemonics. EDF thingtype mnemonics must be prefixed with ''thing:'' -- this allows the parser to know it is dealing with a string instead of a number. EDF thingtypes must have a unique doomednum to be specified in an ExtraData mapthing record. If the specified EDF thingtype doesn't exist or has a doomednum of -1, an Unknown object will be spawned instead.  
This field can also accept EDF thingtype mnemonics. EDF thingtype mnemonics must be prefixed with ''thing:'' -- this allows the parser to know it is dealing with a string instead of a number. EDF thingtypes must have a unique doomednum to be specified in an ExtraData mapthing record. If the specified EDF thingtype doesn't exist or has a doomednum of -1, an Unknown object will be spawned instead.  
See [[Thing types]] for a list of potentially useful types, new to Eternity, to use here.


Example:  
Example:  
Line 71: Line 67:
      
      
     mapthing { type DoomImp } // This record specifies an Imp by its EDF mnemonic
     mapthing { type DoomImp } // This record specifies an Imp by its EDF mnemonic
 
   
====options====
====options====
Default: No flags are set by default.  
Default: No flags are set by default.  
Line 91: Line 87:
     FRIEND      Thing uses MBF friendly logic
     FRIEND      Thing uses MBF friendly logic
     DORMANT    Thing is dormant at map startup (script feature)
     DORMANT    Thing is dormant at map startup (script feature)
    STANDING    Currently only used for [[Thing_types#Sector_actions|sector actions]].
     ------------------------------------------------------------------------------
     ------------------------------------------------------------------------------
      
      
Line 114: Line 109:
Default: 0  
Default: 0  


The TID, or "Thing ID", is a tag for mapthings which is used for identification in [[ACS]] scripts. TID values must be positive numbers between 1 and 65535. The TID value zero means no TID. Negative TID values are reserved and are used to indicate special things within the engine. TIDs are not required to be unique, and most ACS functions that accept TIDs will perform an action on all mapthings which bear the same TID.
The TID, or "Thing ID", is a tag for mapthings which is used for identification in [[Small]] scripts. TID values must be positive numbers between 1 and 65535. The TID value zero means no TID. Negative TID values are reserved and are used to indicate special things within the engine. TIDs are not required to be unique, and most Small functions that accept TIDs will perform an action on all mapthings which bear the same TID. Things spawned within Small scripts can also be given TIDs.  
 
====special====
Default: 0
 
The thing special field, which will execute when thing dies if it's a monster or picked up if it's an item. Use '''args''' to control the parameters.


====args====
====args====
Line 129: Line 119:
     mapthing { args { 0, 1, 2, 3, 4 } }
     mapthing { args { 0, 1, 2, 3, 4 } }
      
      
====height====
Superbly illuminating data here, tanhks!
Default: 0
 
For normal objects, this field indicates a distance above the floor that the thing will spawn at level start. For objects with the SPAWNCEILING flag, this field indicates a distance below the ceiling instead. This field will have no effect on objects which spawn at a randomized height.


=Linedefs =
=Linedefs =
Line 166: Line 153:
   extflags <extended line flags list>
   extflags <extended line flags list>
   args { <special field>, ... }
   args { <special field>, ... }
  id <number>
   alpha <number>
   alpha <number>
  }
  }
Line 195: Line 181:
     Flag name  Meaning
     Flag name  Meaning
     ---------------------------------------------------------------------------------------
     ---------------------------------------------------------------------------------------
     CROSS         Linedef can be activated by being crossed.
     CROSS       Linedef can be activated by being crossed.
     USE           Linedef can be activated by being used.
     USE         Linedef can be activated by being used.
     IMPACT       Linedef can be activated by being shot.
     IMPACT     Linedef can be activated by being shot.
     PUSH         Linedef can be activated by being pushed.
     PUSH       Linedef can be activated by being pushed.
     PLAYER       Linedef can be activated by players.
     PLAYER     Linedef can be activated by players.
     MONSTER       Linedef can be activated by objects with SPACMONSTER flag.
     MONSTER     Linedef can be activated by objects with SPACMONSTER flag.
     MISSILE       Linedef can be activated by objects with SPACMISSILE flag.
     MISSILE     Linedef can be activated by objects with SPACMISSILE flag.
    POLYOBJECT    Linedef can be activated by polyobjects (only works with CROSS)
     REPEAT     Linedef action is repeatable.
     REPEAT       Linedef action is repeatable.
     1SONLY     Linedef can only be activated from first side.
     1SONLY       Linedef can only be activated from first side.
     ADDITIVE   Linedef's midtexture is drawn with additive blending.
     ADDITIVE     Linedef's midtexture is drawn with additive blending.
     BLOCKALL   Linedef will block everything that can be clipped.
     BLOCKALL     Linedef will block everything that can be clipped.
    ZONEBOUNDARY  Linedef will work as a reverb effect boundary. Not needed for one-sided lines.
    CLIPMIDTEX    Linedef middle texture will not "bleed" on floor and ceiling.
    LOWERPORTAL  Linedef copies floor portal from its backside to its lower visible edge
    UPPERPORTAL  Linedef copies ceiling portal from its backside to its upper visible edge
     ---------------------------------------------------------------------------------------
     ---------------------------------------------------------------------------------------
      
      
Notes: IMPACT is currently only implemented for bullet weapons.
Notes: IMPACT is currently only implemented for bullet weapons. The ability to use IMPACT with MISSILE will be added in the near future. The PUSH style of activation is not implemented at all yet, so this flag currently does nothing.  
 
LOWERPORTAL and UPPERPORTAL are used to enable portals on the front side's upper and/or lower edges of a linedef, if the sector in front of the linedef is tall enough compared to the back sector to expose them. It is the only way to enable such portals, which will copy the sector portal(s) from the backside, if any.


Example flags fields -- All of these are equivalent:  
Example flags fields -- All of these are equivalent:  
Line 239: Line 218:
Example args list:  
Example args list:  
     linedef { args { 0, 1, 2, 3, 4 } }
     linedef { args { 0, 1, 2, 3, 4 } }
====id====
:''Default: 0''
This field is equivalent to '''tag'''. It will only have effect if '''tag''' is not already set.


====alpha====
====alpha====
:''Default: Alpha defaults to 1.0.''
:"Default: Alpha defaults to 1.0."


The alpha field takes a value from 0.0 to 1.0 to set the opacity at which this linedef's midtexture is drawn. When combined with the ADDITIVE extflag, this can be used for additive-blended translucency as well.
The alpha field takes a value from 0.0 to 1.0 to set the opacity at which this linedef's midtexture is drawn. When combined with the ADDITIVE extflag, this can be used for additive-blended translucency as well.
Line 286: Line 261:
   flooroffsetx <float>
   flooroffsetx <float>
   flooroffsety <float>
   flooroffsety <float>
  floorscalex <float>
  floorscaley <float>
   ceilingterrain <terrain name>
   ceilingterrain <terrain name>
   ceilingangle <float>
   ceilingangle <float>
   ceilingoffsetx <float>
   ceilingoffsetx <float>
   ceilingoffsety <float>
   ceilingoffsety <float>
  ceilingscalex <float>
  ceilingscaley <float>
   colormaptop <lump name>
   colormaptop <lump name>
   colormapmid <lump name>
   colormapmid <lump name>
Line 301: Line 272:
   overlayalpha.floor <percentage or value from 0 to 255>
   overlayalpha.floor <percentage or value from 0 to 255>
   overlayalpha.ceiling <percentage or value from 0 to 255>
   overlayalpha.ceiling <percentage or value from 0 to 255>
  portalid.floor <number>
  portalid.ceiling <number>
  }
  }
===Explanation of fields: ===
===Explanation of fields: ===
Line 322: Line 291:
     KILLSOUND    Objects in sector cannot make sounds.
     KILLSOUND    Objects in sector cannot make sounds.
     KILLMOVESOUND Sector makes no movement sounds, even if it has a special sound sequence
     KILLMOVESOUND Sector makes no movement sounds, even if it has a special sound sequence
    PHASEDLIGHT  Sector is phased light sequence start
    LIGHTSEQUENCE Sector is phased light sequence step (alternates with below flag)
    LIGHTSEQALT  Sector is phased light sequence alternate step (alternates with above flag)
     ---------------------------------------------------------------------------------------
     ---------------------------------------------------------------------------------------
      
      
Line 407: Line 373:


Specifies the x and y offsets of the floor flat, relative to the normal floor grid, in floating point units.
Specifies the x and y offsets of the floor flat, relative to the normal floor grid, in floating point units.
====floorscalex/floorscaley====
:''Default: 1.0''
Specifies the x and y offsets of the floor flat. A higher number means a smaller texture.


====ceilingterrain====
====ceilingterrain====
Line 423: Line 384:
Specifies the angle of the ceiling flat in floating-point degrees from 0 to 359. Note that for compatibility with ZDoom, the angle specified advances in a '''clockwise''' fashion, contrary to most other angles in the DOOM engine.
Specifies the angle of the ceiling flat in floating-point degrees from 0 to 359. Note that for compatibility with ZDoom, the angle specified advances in a '''clockwise''' fashion, contrary to most other angles in the DOOM engine.


====ceilingoffsetx/ceilingoffsety====
====flooroffsetx/flooroffsety====
:''Default: 0''
:''Default: 0''


Specifies the x and y offsets of the ceiling flat, relative to the normal ceiling grid, in floating point units.
Specifies the x and y offsets of the ceiling flat, relative to the normal ceiling grid, in floating point units.
====ceilingscalex/ceilingscaley====
:''Default: 1.0''
Specifies the x and y offsets of the ceiling flat. A higher number means a smaller texture.


====colormaptop====
====colormaptop====
Line 448: Line 404:
Specifies the colormap lump to use when a player's viewpoint is below the fake floor of a BOOM 242 "deep water" effect applying to this sector. If left to default, the global colormap from MapInfo will be used as normal, unless one is specified by the 242 effect.
Specifies the colormap lump to use when a player's viewpoint is below the fake floor of a BOOM 242 "deep water" effect applying to this sector. If left to default, the global colormap from MapInfo will be used as normal, unless one is specified by the 242 effect.


====portalflags.floor/portalflags.ceiling====
====portalflags====
:''Default: No flags are set by default.''
:''Default: No flags are set by default.''


Line 457: Line 413:
     Flag name    Meaning
     Flag name    Meaning
     ---------------------------------------------------------------------------------------
     ---------------------------------------------------------------------------------------
     DISABLED       Portal is completely disabled
     DISABLED     Portal is completely disabled
     NORENDER       Portal will not be rendered, but may still be interactive
     NORENDER     Portal will not be rendered, but may still be interactive
     NOPASS         Objects cannot pass through the portal even if it is a linked portal
     NOPASS       Objects cannot pass through the portal even if it is a linked portal
     BLOCKSOUND     Sound will not traverse through a linked portal
     BLOCKSOUND   Sound will not traverse through a linked portal
     OVERLAY         The portal will render the sector's flat as a blended overlay
     OVERLAY       The portal will render the sector's flat as a blended overlay
     ADDITIVE       If OVERLAY is also specified, the overlay will use additive blending
     ADDITIVE     If OVERLAY is also specified, the overlay will use additive blending
     USEGLOBALTEX   Reserved for future per-portal texture specification
     USEGLOBALTEX Reserved for future per-portal texture specification
    ATTACHEDPORTAL  If a linked portal is on the respective floor or ceiling, move it along
                    with the surface. Useful for vertically moving platforms.
     ---------------------------------------------------------------------------------------
     ---------------------------------------------------------------------------------------


====overlayalpha.floor/overlayalpha.ceiling====
====overlayalpha====
:''Default'': 100%
:''Default'': 100%


These two fields (overlayalpha.floor and overlayalpha.ceiling) specify the opacity of the corresponding portal overlay, if any exists. You can specify either a percentage value from 0% to 100%, or a plain integer number from 0 to 255. 100%/255 are completely solid, while 0% is invisible.
These two fields (overlayalpha.floor and overlayalpha.ceiling) specify the opacity of the corresponding portal overlay, if any exists. You can specify either a percentage value from 0% to 100%, or a plain integer number from 0 to 255. 100%/255 are completely solid, while 0% is invisible.
====portalid.floor/portalid.ceiling====
:''Default'': 0
These two fields control the placement of portals defined by [[Portal_Define]] on the floor or ceiling of this sector. Values can be positive (in which case the direct portal will be used) or negative (in which case the opposite direction portal will be used, ''if'' applicable).
Please note that all contributions to Eternity Wiki are considered to be released under the GNU Free Documentation License 1.2 (see Eternity Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!
Cancel Editing help (opens in new window)