diff --git a/extras/blanudmf/Includes/BlanKart_common.cfg b/extras/blanudmf/Includes/BlanKart_common.cfg index 26677b515..646fa2f4c 100644 --- a/extras/blanudmf/Includes/BlanKart_common.cfg +++ b/extras/blanudmf/Includes/BlanKart_common.cfg @@ -85,7 +85,7 @@ mapformat_udmf // Determines the textmap namespace engine = "blankart"; - version = 2; + version = 3; maplumpnames { diff --git a/extras/udmf-spec.txt b/extras/udmf-spec.txt new file mode 100644 index 000000000..52e6ff41e --- /dev/null +++ b/extras/udmf-spec.txt @@ -0,0 +1,293 @@ +=============================================================================== +Universal Doom Map Format - BlanKart extensions v1.0 - 20.09.2024 + + Copyright (c) 2024 Sally Cochenour. + Copyright (c) 2024 Kart Krew Dev. + Copyright (c) 2025 NepDisk. + + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + +=============================================================================== + +This document serves to only specify changes that "BlanKart" +makes to the base UDMF specification. + +This document is based on the original from Ring Racers with extensions to account for BlanKart's differences. + +======================================= +I. Grammar / Syntax +======================================= + +No changes were made. + +======================================= +II. Implementation Semantics +======================================= + +------------------------------------ +II.A : Storage and Retrieval of Data +------------------------------------ + +No changes were made. + +----------------------------------- +II.B : Storage Within Archive Files +----------------------------------- + +Between the TEXTMAP and ENDMAP lumps, BlanKart supports the following +additional lumps: + + BEHAVIOR = Compiled ACS code. + ZNODES = Compiled extended / GL friendly nodes. These are required. + PICTURE = A Doom graphic lump, expected to be 320x200. Intended to be a + screenshot of the map itself. This is used by the game for level + select menus. + MINIMAP = A Doom graphic lump, expected to be 100x100. Intended to be a + an overview of the map. This is used by the game for the minimap + on-screen HUD. + ENCORE = A Doom flat lump, expected to be 16x16. Describes a color remap + palette to use in Encore Mode. + TWEAKMAP = A Doom flat lump, expected to be 16x16. Describes a color remap + palette to use outside of Encore Mode. + +Any lumps not listed or specified in the original document will be ignored by +the game. In particular, the "SCRIPTS" lump is considered to be ACS source +code, and is guaranteed to be ignored by the engine. + +-------------------------------- +II.C : Implementation Dependence +-------------------------------- + +BlanKart does not aspire for Doom backwards compatibility, thus it does not +support any of the namespaces in the original document, and only implements +its own: "blankart". It also supports "srb2", "srb2kart", "blankart" or "ringracers" namespaces as well. +Any maps not using the mentioned namespaces are considered unsupported. + +======================================= +III. Standardized Fields +======================================= + +BlanKart's namespace implements the following additional fields: + + version = ; // Specifies the map format version. + // This is used for resolving backwards compatibility issues. + + // Note that this doesn't map directly to specification version; + // it means behavior of an already existing field or action special + // was changed. + + // 0 / default - RR indev + // 1 - RR v2.0, RR spec v1.0 + // 2 - RR v2.4, RR spec v1.0 + // 3 - BlanKart indev, BK spec v1.0 + + linedef + { + moreids = ; // Additional IDs, specified as a space separated list of numbers (e.g. "2 666 1003 4505") + + arg5 = ; // Argument 5. Default = 0. + arg6 = ; // Argument 6. Default = 0. + arg7 = ; // Argument 7. Default = 0. + arg8 = ; // Argument 8. Default = 0. + arg9 = ; // Argument 9. Default = 0. + + stringarg0 = ; // String argument 0. This replaces usage of 'arg0' when specified. + stringarg1 = ; // String argument 1. This replaces usage of 'arg1' when specified. + + alpha = ; // Transparency value of the mid-textures. Default = 1.0. + renderstyle = ; // The rendering mode to use for the mid-textures. + // Can be "translucent", "add", "subtract", "reversesubtract", "modulate", or "fog". + // Default = "translucent". + + // The following flags default to false. + blockplayers = ; // true = line blocks players. + skewtd = ; // true = upper and lower textures are skewed to match slopes. + noskew = ; // true = mid-textures are not skewed to match slopes. + midpeg = ; // true = invert mid-texture unpegged behavior. + midsolid = ; // true = mid-texture has collision. + wrapmidtex = ; // true = mid-textures are wrapped. + nonet = ; // true = special is disabled in networked multiplayer games. + netonly = ; // true = special is only enabled in networked multiplayer games. + notbouncy = ; // true = disable bouncing collision. + transfer = ; // true = use FOF transfer properties effect. + tripwire = ; // true = mark linedef as tripwire line. + } + + sidedef + { + repeatcnt = ; // Number of times to mid-texture wrap. Default = 0. + } + + vertex + { + zfloor = ; // The floor height at this vertex, for vertex slopes. + zceiling = ; // The ceiling height at this vertex, for vertex slopes + } + + sector + { + lightfloor = ; // The floor's light level. Default is 0. + lightceiling = ; // The ceiling's light level. Default is 0. + + lightfloorabsolute = ; // true = 'lightfloor' is an absolute value. Default is + // relative to the owning sector's light level. + lightceilingabsolute = ; // true = 'lightceiling' is an absolute value. Default is + // relative to the owning sector's light level. + + moreids = ; // Additional IDs, specified as a space separated list of numbers (e.g. "2 666 1003 4505") + + xpanningfloor = ; // X texture offset of floor texture, Default = 0.0. + ypanningfloor = ; // Y texture offset of floor texture, Default = 0.0. + + xpanningceiling = ; // X texture offset of ceiling texture, Default = 0.0. + ypanningceiling = ; // Y texture offset of ceiling texture, Default = 0.0. + + rotationfloor = ; // Rotation of floor texture in degrees, Default = 0.0. + rotationceiling = ; // Rotation of ceiling texture in degrees, Default = 0.0. + + floorplane_a = ; // Define the plane equation for the sector's floor. Default is a horizontal plane at 'heightfloor'. + floorplane_b = ; // 'heightfloor' will still be used to calculate texture alignment. + floorplane_c = ; // The plane equation will only be used if all 4 values are given. + floorplane_d = ; + + ceilingplane_a = ; // Define the plane equation for the sector's ceiling. Default is a horizontal plane at 'heightceiling'. + ceilingplane_b = ; // 'heightceiling' will still be used to calculate texture alignment. + ceilingplane_c = ; // The plane equation will only be used if all 4 values are given. + ceilingplane_d = ; + + friction = ; // Sector's friction. Default = 0.90625. + gravity = ; // Sector's gravity multiplier. Default = 1.0. + offroad = ; // Sector's offroad multiplier. Default = 0.0. + damagetype = ; // Damage inflicted by the sector. + // Can be "None", "Generic", "Lava", "DeathPit", "Instakill", or "Stumble". + // Default = "None". + + action = ; // Sector action, same as line special. Default = 0. + arg0 = ; // Argument 0. Default = 0. + arg1 = ; // Argument 1. Default = 0. + arg2 = ; // Argument 2. Default = 0. + arg3 = ; // Argument 3. Default = 0. + arg4 = ; // Argument 4. Default = 0. + arg5 = ; // Argument 5. Default = 0. + arg6 = ; // Argument 6. Default = 0. + arg7 = ; // Argument 7. Default = 0. + arg8 = ; // Argument 8. Default = 0. + arg9 = ; // Argument 9. Default = 0. + stringarg0 = ; // String argument 0. This replaces usage of 'arg0' when specified. + stringarg1 = ; // String argument 1. This replaces usage of 'arg1' when specified. + + lightcolor = ; // Sector's light color as RRGGBB value. Default = 0x000000. + lightalpha = ; // Sector's light color alpha value. Default = 25. + fadecolor = ; // Sector's fog color as RRGGBB value. Default = 0x000000. + fadealpha = ; // Sector's fog color alpha value. Default = 25. + fadestart = ; // Sector's fog start distance. Default = 0. + fadeend = ; // Sector's fog end distance. Default = 31. + + // The following flags default to false. + colormapfog = ; // true = render transparent planes at light level instead of fullbright. + colormapfadesprites = ; // true = fog color affects fullbright sprites. + colormapprotected = ; // true = colormap cannot be changed at run-time. + + flipspecial_nofloor = ; // true = plane touch specials aren't ran when on the floor. + flipspecial_ceiling = ; // true = plane touch specials are ran when on the ceiling. + triggerspecial_touch = ; // true = specials are ran when touching edges of sector. + triggerspecial_headbump = ; // true = plane touch specials are ran when touching the opposite plane than gravity. + invertprecip = ; // true = precipitation spawning rules are inverted.. + gravityflip = ; // true = flip gravity of objects in this sector. + heatwave = ; // true = add heat wave screen effect. + ripple_floor = ; // true = add ripple effect to floor. + ripple_ceiling = ; // true = add ripple effect to ceiling. + invertencore = ; // true = encore remap rules are inverted. + flatlighting = ; // true = directional lighting is forced off. + forcedirectionallighting = ; // true = directional lighting is forced on. + nostepup = ; // true = objects can't step up. + doublestepup = ; // true = objects have increased step up. + nostepdown = ; // true = objects can't step down. + cheatcheckactivator = ; // true = players activate cheat checks when in this sector. + exit = ; // true = players finish match when entering sector. + deleteitems = ; // true = items instantly explode when entering sector. + fan = ; // true = players are propelled upwards in this sector. + zoomtubestart = ; // true = sector is start of a zoom tube. + zoomtubeend = ; // true = sector is end of a zoom tube. + + speedpad = ; // true = players are launched forward by this sector. + finishline = l // true = players gain a lap or finish the race in this sector. Used for legacy support. + sneakerpanel = ; // true = players are speed boosted forward by this sector. + waterpanel = ; // true = players are speed boosted forward by this sector and are able to drive on water. + redpogospring = ; // true = players are bounced into the air by this sector. + yellowpogospring = ; // true = players are bounced into the air and then speedcapped by this sector. + + repeatspecial = ; // true = repeatable action. + continuousspecial = ; // true = action is executed every game tick. + playerenter = ; // true = player activates when entering. + playerfloor = ; // true = player activates when touching floor. + playerceiling = ; // true = player activates when touching ceiling. + monsterenter = ; // true = enemy activates when entering. + monsterfloor = ; // true = enemy activates when touching floor. + monsterceiling = ; // true = enemy activates when touching ceiling. + missileenter = ; // true = items / projectiles activate when entering. + missilefloor = ; // true = items / projectiles activate when touching floor. + missileceiling = ; // true = items / projectiles activate when touching ceiling. + } + + thing + { + pitch = ; // Pitch of thing in degrees. Default = 0 (horizontal). + roll = ; // Pitch of thing in degrees. Default = 0 (horizontal). + + scalex = ; // Vertical visual scale on thing. Default = 1.0. + scaley = ; // Horizontal visual scale on thing. Default = 1.0. + scale = ; // Vertical and horizontal visual scale on thing. Default = 1.0. + + mobjscale = ; // Physical scale on thing. Default = 1.0. + + foflayer = ; // Which FOF is treated as the base floor/ceiling. + // This changes what 'height' is relative to. + // Default = 0, for no FOF. + + // These arguments modify object behavior on a per-type basis. + arg0 = ; // Argument 0. Default = 0. + arg1 = ; // Argument 1. Default = 0. + arg2 = ; // Argument 2. Default = 0. + arg3 = ; // Argument 3. Default = 0. + arg4 = ; // Argument 4. Default = 0. + arg5 = ; // Argument 5. Default = 0. + arg6 = ; // Argument 6. Default = 0. + arg7 = ; // Argument 7. Default = 0. + arg8 = ; // Argument 8. Default = 0. + arg9 = ; // Argument 9. Default = 0. + + stringarg0 = ; // String argument 0. This replaces usage of 'arg0' when specified. + stringarg1 = ; // String argument 1. This replaces usage of 'arg1' when specified. + + + // Action special arguments. + scriptarg0 = ; // Argument 0. Default = 0. + scriptarg1 = ; // Argument 1. Default = 0. + scriptarg2 = ; // Argument 2. Default = 0. + scriptarg3 = ; // Argument 3. Default = 0. + scriptarg4 = ; // Argument 4. Default = 0. + scriptarg5 = ; // Argument 5. Default = 0. + scriptarg6 = ; // Argument 6. Default = 0. + scriptarg7 = ; // Argument 7. Default = 0. + scriptarg8 = ; // Argument 8. Default = 0. + scriptarg9 = ; // Argument 9. Default = 0. + scriptstringarg0 = ; // String argument 0. This replaces usage of 'scriptarg0' when specified. + scriptstringarg1 = ; // String argument 1. This replaces usage of 'scriptarg1' when specified. + + // Following flags default to false. + flip = ; // true = object has reversed gravity + } + +======================================= +Changelog +======================================= + +RR 1.0: 20.09.2024 +- Initial document created. + +BK 1.0: 08.09.2025 +- Document spec updated to account for BlanKart differnces.