EDukeWiki - User contributions [en]

Maphack Language

2021-10-26T13:51:11Z

LeoD: Examples and Conventions

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.
This only affects the visual representation through the renderer and does ''not'' change the actual gameplay.
Additional information may be found in [http://svn.eduke32.com/duke3d_hrp/maphacks/MapHacks.txt MapHacks.txt].

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model (md3 or kvx) away from the starting angle of the sprite. A ''value'' of 2048 represents a full turn of 360 degrees. Practical ''values'' should be chosen between -1023 and 1024 (+- 180 degrees).

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a texture (original ART tile or highres image if available) instead of a model (md3 or kvx). This is achieved by altering the value of [[mdflags]]. 
It is mostly used to "flatten" wall aligned or floor aligned decorative objects. 
There is no actual implementation for ''notmd2'' and ''notmd3''. They are mapped to ''notmd''.

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]]. 
There is no actual implementation for ''nomd2anim'' and ''nomd3anim''. They are mapped to ''nomdanim''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite forwards by a small amount. This is achieved by altering the value of [[mdflags]]. 
It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite backwards by a small amount. This is achieved by altering the value of [[mdflags]]. 
It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Does not work in conjunction with '''notmd'''. Not yet implemented for kvx models. 
A hackish method can be used to move the model forwards/backwards from clipping into a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number (try 100000 for starters), and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side. Does not work in conjunction with '''notmd'''. Not yet implemented for kvx models.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint,(upwards/downwards in 3D view) to be used in conjunction with '''pitch'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint (upwards/downwards in 3D view), to be used in conjunction with '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left). 
The '''pitch''' and '''roll''' ''value'' can be used as scaling factors. With '''pitch 1''' and '''roll -2''', for example, the model is moved twice as far to the left as it gets moved forwards. Depending on the object's size, '''pitch'''/'''roll''' ''values'' above 4-8 may result in undesired visible rotation. 
Be aware that the same ''value'' will result in 1/16 the translation for '''mdzoff''' compared to '''mdxoff''' and '''mdyoff'''.

===mdposxoff===
sprite ''spriteid'' '''mdposxoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''x''' coordinate of the model's centerpoint is moved to the right/eastwards/angle 0. (The default placement lets sprites face northwards/angle 1536.) 
This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.

===mdposyoff===
sprite ''spriteid'' '''mdposyoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''y''' coordinate of the model's centerpoint is moved to down/southwards/angle 512. (The default placement lets sprites face northwards/angle 1536.) 
This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.

===mdposzoff===
sprite ''spriteid'' '''mdposzoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''z''' coordinate of the model's centerpoint is moved forwards to the viewer (upwards in 3D view). 
This is roughly equivalent to the way (''pitch + mdxoff'') or (''roll + mdyoff'') work, respectively.

===mhkreset===
sprite ''spriteid'' '''mhkreset'''

This development helper resets all previous maphacks for a sprite.

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.

 
==Examples==
This is a definition file (*.def) to declare available maphack (*.mhk) files:
<pre>
// This is a comment line.
mapinfo {
maptitle "Hollywood Holocaust"
//author "Allen H. Blum III"
mapfile "E1L1.map"
mapmd4 a1ce0037911b2625781a2623588c8b90 // 1996-12-11 (Atomic GRP)
mhkfile "maphacks/3drealms/E1L1.mhk"
}
/*
This is a multi-line comment.
*/
</pre>There is no '''author''' token yet, and no actual implementation of '''maptitle'''. 
 

This is an example maphack file (*.mhk): header and a couple of actual maphack lines:
<pre>
// Maphacks for the Duke Nukem 3D High Resolution Pack (HRP)

// Title : Hollywood Holocaust
// Author : Allen H. Blum III
// Filename : E1L1.MAP
// mapmd4 : a1ce0037911b2625781a2623588c8b90 // 1996-12-11 (Atomic GRP)

// Curr. HRP: r5.4.726

sprite 79 angoff 1024 // tile0026 heavyhbomb (multiplayer)
</pre> 

==Conventions==
Over the years of maphacking a couple of conventions have been established which you should follow. 

Order of tokens, if (as far as applicable) combined:
<pre>
sprite 1 notmd
sprite 1 away1
sprite 1 away2
sprite 1 nomdanim
sprite 1 angoff 512 // rotate right

//sprite 0 pitch -512 // tilt backwards
//sprite 0 roll 512 // tilt right
sprite 1 pitch -1 // small value when only moving (backwards)
sprite 1 roll 2 // factor 2 for mdyoff (up), mdzoff (right)
sprite 1 mdxoff -30000 // moves up, actually (pitch -1)
sprite 1 mdyoff 30000
sprite 1 mdzoff 480000

// Do NOT mix (pitch,roll,md<x|y|z>off) with mdpos<x|y|z>off !
sprite 16383 mdposxoff 1024 // 32.0 // eastwards in 2D view
sprite 16383 mdposyoff 1024 // 32.0 // southwards in 2D view
sprite 16383 mdposzoff -16384 // 32.0 // downwards in 3D
</pre>

More on this to come soon...

Maphack Language

2021-10-26T13:49:26Z

LeoD: Undo revision 14412 by LeoD (talk)

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.
This only affects the visual representation through the renderer and does ''not'' change the actual gameplay.
Additional information may be found in [http://svn.eduke32.com/duke3d_hrp/maphacks/MapHacks.txt MapHacks.txt].

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model (md3 or kvx) away from the starting angle of the sprite. A ''value'' of 2048 represents a full turn of 360 degrees. Practical ''values'' should be chosen between -1023 and 1024 (+- 180 degrees).

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a texture (original ART tile or highres image if available) instead of a model (md3 or kvx). This is achieved by altering the value of [[mdflags]]. 
It is mostly used to "flatten" wall aligned or floor aligned decorative objects. 
There is no actual implementation for ''notmd2'' and ''notmd3''. They are mapped to ''notmd''.

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]]. 
There is no actual implementation for ''nomd2anim'' and ''nomd3anim''. They are mapped to ''nomdanim''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite forwards by a small amount. This is achieved by altering the value of [[mdflags]]. 
It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite backwards by a small amount. This is achieved by altering the value of [[mdflags]]. 
It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Not yet implemented for kvx models. 
A hackish method can be used to move the model forwards/backwards from clipping into a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number (try 100000 for starters), and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side. Not yet implemented for kvx models.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint,(upwards/downwards in 3D view) to be used in conjunction with '''pitch'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint (upwards/downwards in 3D view), to be used in conjunction with '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left). 
The '''pitch''' and '''roll''' values can be used as scaling factors. With '''pitch 1''' and '''roll -2''', for example, the model is moved twice as far to the left as it gets moved forwards. 
Be aware that the same ''value'' will result in 1/16 the translation for '''mdzoff''' compared to '''mdxoff''' and '''mdyoff'''.

===mdposxoff===
sprite ''spriteid'' '''mdposxoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''x''' coordinate of the model's centerpoint is moved to the right/eastwards/angle 0. (The default placement lets sprites face northwards/angle 1536.) 
This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.

===mdposyoff===
sprite ''spriteid'' '''mdposyoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''y''' coordinate of the model's centerpoint is moved to down/southwards/angle 512. (The default placement lets sprites face northwards/angle 1536.) 
This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.

===mdposzoff===
sprite ''spriteid'' '''mdposzoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''z''' coordinate of the model's centerpoint is moved forwards to the viewer (upwards in 3D view). 
This is roughly equivalent to the way (''pitch + mdxoff'') or (''roll + mdyoff'') work, respectively.

===mhkreset===
sprite ''spriteid'' '''mhkreset'''

This development helper resets all previous maphacks for a sprite.

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.

Maphack Language

2021-10-26T13:45:43Z

LeoD:

Maphack Language

2021-10-26T12:39:23Z

LeoD: recent maphack tokens added

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.
This only affects the visual representation through the renderer and does ''not'' change the actual gameplay.
Additional information may be found in [http://svn.eduke32.com/duke3d_hrp/maphacks/MapHacks.txt MapHacks.txt].

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model (md3 or kvx) away from the starting angle of the sprite. A ''value'' of 2048 represents a full turn of 360 degrees. Practical ''values'' should be chosen between -1023 and 1024 (+- 180 degrees).

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a texture (original ART tile or highres image if available) instead of a model (md3 or kvx). This is achieved by altering the value of [[mdflags]]. 
It is mostly used to "flatten" wall aligned or floor aligned decorative objects. 
There is no actual implementation for ''notmd2'' and ''notmd3''. They are mapped to ''notmd''.

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]]. 
There is no actual implementation for ''nomd2anim'' and ''nomd3anim''. They are mapped to ''nomdanim''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite forwards by a small amount. This is achieved by altering the value of [[mdflags]]. 
It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite backwards by a small amount. This is achieved by altering the value of [[mdflags]]. 
It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Not yet implemented for kvx models. 
A hackish method can be used to move the model forwards/backwards from clipping into a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number (try 100000 for starters), and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side. Not yet implemented for kvx models.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint,(upwards/downwards in 3D view) to be used in conjunction with '''pitch'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint (upwards/downwards in 3D view), to be used in conjunction with '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left). 
The '''pitch''' and '''roll''' values can be used as scaling factors. With '''pitch 1''' and '''roll -2''', for example, the model is moved twice as far to the left as it gets moved forwards. 
Be aware that the same ''value'' will result in 1/16 the translation for '''mdzoff''' compared to '''mdxoff''' and '''mdyoff'''.

===mdposxoff===
sprite ''spriteid'' '''mdposxoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''x''' coordinate of the model's centerpoint is moved to the right/eastwards/angle 0. (The default placement lets sprites face northwards/angle 1536.) 
This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.

===mdposyoff===
sprite ''spriteid'' '''mdposyoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''y''' coordinate of the model's centerpoint is moved to down/southwards/angle 512. (The default placement lets sprites face northwards/angle 1536.) 
This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.

===mdposzoff===
sprite ''spriteid'' '''mdposzoff''' ''value''

Ported from NBlood. In Mapster32's 2D view the '''z''' coordinate of the model's centerpoint is moved forwards to the viewer (upwards in 3D view). 
This is roughly equivalent to the way (''pitch + mdxoff'') or (''roll + mdyoff'') work, respectively.

===mhkreset===
sprite ''spriteid'' '''mhkreset'''

This development helper resets all previous maphacks for a sprite.

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.

Maphack Language

2021-10-26T11:47:04Z

LeoD: more detailed information added

Maphack Language

2021-10-26T10:19:47Z

LeoD: Comments on notmd2, notmd3, nomd2anim, nomd3anim

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model away from the starting angle of the sprite. A ''value'' of 2048 represents a full turn of 360 degrees.

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a sprite instead of a model. This is achieved by altering the value of [[mdflags]]. 
There is no actual implementation for ''notmd2'' and ''notmd3''. They are mapped to ''notmd''.

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]]. 
There is no actual implementation for ''nomd2anim'' and ''nomd3anim''. They are mapped to ''nomdanim''.

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards.
A hackish method can be used to move the model away from clipping in a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number, and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.

Category:Editing Miscellaneous

2021-10-26T08:00:04Z

LeoD: move up "* 2556 = Shrinkers" by one line

{{Build Intro}}
NOTE: Much of information on this page is from around 1999. Some may be outdated, and some may be incorrect -- this page exists to get you started with the Level Editing and may not currently cover some of the additional features available in Mapster32.
__NOTOC__
==Glass==

Select the wall that you would like to turn into glass. It needs to be a dividing line between two sectors (a red line in 2D mode). Go to 3D mode and hover your mouse cursor on the floor or ceiling in front of this wall, and press 'M'. This causes the wall to be masked. Now select a glass texture for it (texture #503). If you like, you can hit 'T' once or twice to make it partially transparent. Now hit 'B' and 'H'. These make the glass wall ''blockable'' and ''hittable'' so that it both blocks the player and responds to being shot by breaking. It should look like a double pink line in 2D mode. That's all there is to it.

==Secret Areas==
Apply a lotag of 32767 to a sector to create a secret area. When the player walks over this sector, it counts as one secret area discovered. The game also totals the number of sectors assigned this lotag, so try to use only one secret sector for each secret area.

==Shooters==
''Map Name: [[Media:Tutorial.map|TUTORIAL.MAP]] (ROOM 7-E)''

A shooter is basically something that repeatedly shoots an object of your choice. A good example of a shooter is the one located in episode 1, level 4. When you unlock the red keypad, the pad lowers, revealing a shooter that shoots "shrinkers" (the projectiles that make you shrink in size).

STEP 1: Create a sector from which the shooter will shoot from.

STEP 2: In this newly created sector, place one sector effector sprite, one GPSpeed sprite, and one Masterswitch sprite.

STEP 3: Place a Switch or Touchplate somewhere in your level and give it a unique lotag.

STEP 4: Give the Masterswitch sprite a hitag of 50 and the same lotag value as the switch.

STEP 5: Place one sector effector sprite where you want the shots to originate from. Change the angle of this sprite to the direction you want the shooter to shoot. Give this sprite a lotag of 36.

STEP 6: Now you must decide what you want to shoot. Do this by giving the GPSpeed sprite a lotag of one of the following values:
* 1360 = Octabrain Blasts
* 1625 = Alien Lasers
* 1636 = Lizard Spit
* 1641 = Freezer Blasts (Auto-aims at player)
* 1650 = Mortars (Like the first boss throws)
* 2556 = Shrinkers
* 2605 = Rockets (Auto-aims at player)

==Turning Shooters Off==
See Section 'Shooters'. Simply replace the Masterswitch with an Activator. The Shooter can then be turned on/off with any Switch and/or Touchplate(s), in Mapster32.

==Difficulty Settings==
To assign difficulty levels to enemies, assign them with a lotag matching the desired skill level, such as 1 for ''Piece of Cake'' or 4 for ''Damn I'm Good''.

==Signs That Fall When Shot==
Simply take a flattened sprite and assign it a unique hitag and it will be vulnerable to explosions. Assign multiple objects the same hitag, such as the faces of a 3D bridge, and each sprite will collapse together as a structure.

==Lightning and Thunder (Version 1.4 or 1.5 Required)==
''Map Name: [[Media:Atomic.map|ATOMIC.MAP]] (ROOM 4)''

To make the lightning bolt engine work, follow these simple steps:

STEP 1: Place several lightning sprites (#4890) in an outside area, and give each sprite *the same* unique hitag. The sky should also be cloudy (not required, but makes it look realistic).

STEP 2: Place a sector effector in each sector that contains a lightning bolt sprite. Give each sector effector a lotag of 28, and a hitag equal to the lightning bolt sprite's hitag value.

==Making Rain==

To make a raining effect, place Waterdrip sprites (#660) where you want them to be, and raise them to the ceiling of the sector they are in. Give each sprite a hitag of 1 to eliminate the dripping sound. Place a Musicandsfx (#5) sprite somewhere in the raining sectors, give it a lotag of 358, and a hitag of the distance the sound should be heard.

NOTE: Giving the rain drops a palette number of 13 is recommended.

==Forcing Duke To Start Weaponless==
Simply put the starting place over a floor-tile that hurts. E.G. HURTRAIL(#859) - LAVA(#1082) - SLIME (#200)

You can make Duke start weaponless, without hurting him.
* STEP 1: Make a hole in the floor.
* STEP 2: Put the HURT-TILE on the hole floor.
* STEP 3: Place a sprite on the main floor, and make it flat (2 presses on [R] key)
* STEP 4: Select the same texture as the floor tile. ([V] Twice)
* STEP 5: Arrange the sprite, so it covers the hole.
NOTE: Make sure the sprite is "Hard" (purple in color) Point at the sprite, and press the [B] key

==Making a MiniBoss==

To include the boss from Episode 1 without the level ending when you kill him, give him a palette number of 21. He'll have less health than the Episode 1 boss. This also works for the bosses of episodes 2 and 3, but they will have only one health point. It does not work at all for the Episode 4 boss; she'll be as tough as always but she'll be coloured bright red.

Troubleshooting EDuke32

2021-09-27T14:51:37Z

LeoD: added the need of backtrace DLL

The first step in troubleshooting EDuke32 is testing [http://dukeworld.duke4.net/eduke32/synthesis/eduke32_latest.zip the most recent unstable version], automatically generated every 20 minutes if changes have been made to the source code.

==Basic Assistance==

If you have a problem with EDuke32 or Mapster32, [http://forums.duke4.net/forum/27-bug-reports-help-me-threads/ READ THE THREADS HERE FIRST], as well as [https://voidpoint.io/terminx/eduke32/-/issues THE ISSUES PAGE ON THE GITLAB] to see if anyone else has experienced the same issue. Do not post a new thread or a new issue if a similar problem has already been reported.

'''Always do a search for your problem before posting. Any new topics/issues should clearly describe the problem in the title/summary.'''

If you find no previous reports of your issue, prepare to submit a bug report to the forum. For general help, follow the instructions below in a new thread at the forum link above. For a problem with a particular TC or mod, it may be better to contact its author directly depending on the circumstances and the nature of the error.

'''Please add the following information to any bug report:'''

#You need to locate a file in your EDuke32 data called '''eduke32.log''' or '''mapster32.log''' depending on which program encountered the error. This file is overwritten every time the programs are run, so it is vital that the log file comes from an occasion when you encountered the problem and have not run the program again afterwards. Any log files should be posted as attachments or loaded on to http://pastebin.com/. '''Absolutely do NOT post logs as part of your post text itself!'''
#Your system specifications (OS, GPU, CPU, etc) may be helpful, especially with OpenGL graphics- or performance-related reports. [http://www.cpuid.com/softwares/cpu-z.html CPUID CPU-Z] is useful for details.
#What version of EDuke32 you are running.
#What you were doing at the time.
#Be ready to upload or private message any modified con/sound/art/maps etc related to the above in the event an easy solution cannot be found.
#Go to http://dukeworld.duke4.net/eduke32/synthesis and find the first build that exhibits the problem, and post the build numbers of the last working version and the first broken version. See [[#Bisecting|the Bisecting subsection below]] for how to do this efficiently.

===tips for quicker bug handling===

The following points will help us and help you find solutions '''much more quickly and effectively''', which should be in the interest of all parties involved.

* '''When in doubt whether a log is useful or not, attach it regardless.''' This means that time can be spent on actually fixing the bug instead of asking for the log and waiting... and waiting... and waiting...
* '''Show, don't merely tell.''' For example, if it is an editor bug, attach a small test map with the bug report or PM it in case you don't want it to be public.
* When reporting a bug for the first time, '''assume that you're the first to encounter it''', that is, don't leave out details just because you think they're "well known".
* '''Assume vanilla Duke unless known otherwise.''' For example, if developing a new mod containing new art and reporting an editor or game effect bug, load the map in a vanilla installation and replace all now-void tiles using [']+[F] -> replace invalid tiles. Similarly, when filing a CON bug, try to present it such that it can be loaded as a stand-alone module (-mx switch to EDuke32). Of course, for released mods, it's OK to do otherwise if it's known that the developer(s) have that particular mod installed.
* When referring to locations in a map, don't assume that the developers have played them unless it's a vanilla map or a classic "must play" plain user map (what constitutes such a map is somewhat subjective, of course). Instead, '''provide coordinates for the location''', obtainable by pressing LShift in Mapster32, or with the DNCOORDS cheat in the game. Feel free to round the numbers for prettier appearance, as long as it's reasonably clear what place is meant.

==Crashes==

If you encounter an actual program crash, try running the debug executables (eduke32.debug.exe or mapster32.debug.exe) included in the EDuke32 builds available from [http://dukeworld.duke4.net/eduke32/synthesis/ synthesis]. Put the according backtrace DLL (32/64 bit) alongside the debug executable. If you encounter the crash again, look for a file named '''eduke32.crash.log''' or '''mapster32.crash.log''' and include it when following the directions in the [[#Basic Assistance|Basic Assistance]] section.

If you cannot find this file, please proceed to the [[#Debugging|Debugging]] section.

==Bisecting==
A very useful piece of information when reporting a bug is the particular revision that introduced the bug, or at least range of revisions. Finding it '''does not''' require searching all revisions in sequence. First, a revision needs to be found that doesn't show the buggy behavior. Either you might have a suspicion when it occured, otherwise you can try the earliest revisions from [http://dukeworld.duke4.net/eduke32/synthesis/ synthesis], [http://dukeworld.duke4.net/eduke32/synthesis/old/ old synthesis], or [http://dukeworld.duke4.net/eduke32/old_versions/ snapshots prior to automated builds] for really ancient bugs. (For certain bugs, it may also be worthwhile to check whether the original Duke3D 1.5 exhibits it, too). At this point, it also helps to have constructed a small test case, so that one can decide "faulty/working" relatively quickly (for example by starting a map in a particular position and doing something). Having found this "base" bad revision -- let's call it ''N''bad --, the idea now is to search the one revision that introduced the bug by cutting the search space roughly by half with each step. Calling the current revision ''N''good, one would now proceed by testing the one that lies roughly between the two, ''N''test := round((''N''bad+''N''good)/2). After carrying out the test, one either lets ''N''bad:=''N''test or ''N''good:=''N''test, always such that the bug-introducing revision will be between these two "anchor" revisions. Finally, one repeats this procedure until arriving at a revision difference of one (or giving up early, which still leaves a revision range as a result).

It should be noted that this procedure should be best carried out in an isolated directory, because the generated configuration files of earlier revisions might produce conflicts or remove options from ones of newer builds.

Depending on the setup, this procedure takes about 15 to 30 minutes.

===example===
Here's a log of [http://dukeworld.duke4.net/eduke32/synthesis/ synthesis builds] tested when searching for the revision that introduced a certain [http://forums.duke4.net/topic/5542-lighting-and-security-screens/ bug] with viewscreens. For this, a test map was constructed that started near such a viewscreen.

0. (current revision) r2781 -- BAD 
1. (first guess) r2000 -- GOOD 

Now, we know that the bug must have been introduced between r2000 and r2781, so we pick one in between:

2. r2300 -- BAD 
(now, r2000 vs. r2300) 

3. r2155 -- GOOD 
(now, r2155 vs. r2300) 

4. r2239 -- BAD 
(now, r2155 vs. r2239) 

... and so on, until one arrives at the bug-introducing revision in around log2(''N''bad0-''N''good0) (for the current example, 10) steps.

==Debugging==
To help the developers in tracking down crashes, you could try running a debug version of the executable under GDB, the GNU debugger, until the crash happens.

If you are running Windows and do not already have GDB set up, follow the instructions to set up [[Building EDuke32 on Windows]] and it will be included. You do '''not''' have to compile EDuke32 yourself, instead you just have to install the compiler.

===running the debugger===

To debug the program, ([http://dukeworld.duke4.net/eduke32/synthesis/ synthesis build recommended]) open a [[Working with the Windows Command Prompt#Opening A Command Prompt Window|command prompt]] or terminal window and run this command, using Mapster32 as an example:
gdb --args mapster32.debug.exe ''[additional arguments...]''
and enter
r
(run) at the GDB prompt. When the program crashes, you will be taken back to the prompt. Enter
bt
(backtrace) there. This will print out the location where the crash occurred and serve as a first diagnostic to the developers.

===advanced debugging===

There are specific circumstances where you can use [http://sourceware.org/gdb/onlinedocs/gdb/Set-Breaks.html breakpoints] and [http://sourceware.org/gdb/onlinedocs/gdb/Set-Watchpoints.html watchpoints] if you know where they would be applicable.

===submitting the output===

[[Working with the Windows Command Prompt#How to Copy and Paste Text|Copy and paste the output gdb displays]] and send it to the developers so they can work on a fix. [http://www.pastebin.com Pastebin.com] is useful for this purpose.

Maphack Language

2013-03-17T15:13:04Z

LeoD: /* mdzoff */

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model away from the starting angle of the sprite. A ''value'' of 2048 represents a full turn of 360 degrees.

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a sprite instead of a model. This is achieved by altering the value of [[mdflags]].

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]].

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards.
A hackish method can be used to move the model away from clipping in a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number, and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.

Maphack Language

2013-03-17T15:07:46Z

LeoD: /* angoff */

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model away from the starting angle of the sprite. A ''value'' of 2048 represents a full turn of 360 degrees.

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a sprite instead of a model. This is achieved by altering the value of [[mdflags]].

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]].

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards.
A hackish method can be used to move the model away from clipping in a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number, and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.

Maphack Language

2013-03-17T15:03:03Z

LeoD: /* angoff */

Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.

==sprite==
'''sprite''' ''spriteid'' <token> <nowiki>[value]</nowiki>

===[[angoff]]===
sprite ''spriteid'' '''angoff''' ''value'' 
sprite ''spriteid'' '''angleoff''' ''value''

Rotates the model away from the starting angle of the sprite.

===notmd===
sprite ''spriteid'' '''notmd''' 
sprite ''spriteid'' '''notmd2''' 
sprite ''spriteid'' '''notmd3'''

Renders a tile as a sprite instead of a model. This is achieved by altering the value of [[mdflags]].

===nomdanim===
sprite ''spriteid'' '''nomdanim''' 
sprite ''spriteid'' '''nomd2anim''' 
sprite ''spriteid'' '''nomd3anim'''

Freezes any model animation in place. This is achieved by altering the value of [[mdflags]].

===[[pitch]]===
sprite ''spriteid'' '''pitch''' ''value''

Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards.
A hackish method can be used to move the model away from clipping in a wall, by setting the sprite's '''mdzoff''' to a grossly high (or low negative) number, and setting a '''pitch''' of 1.

===[[roll]]===
sprite ''spriteid'' '''roll''' ''value''

Adjusts the model's '''[[roll]]''', i.e. tilting to the side.

===[[mdxoff]]===
sprite ''spriteid'' '''mdxoff''' ''value''

Offsets the '''x''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdyoff]]===
sprite ''spriteid'' '''mdyoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===[[mdzoff]]===
sprite ''spriteid'' '''mdzoff''' ''value''

Offsets the '''y''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.

===away1===
sprite ''spriteid'' '''away1'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

===away2===
sprite ''spriteid'' '''away2'''

Moves the sprite away. (how?) This is achieved by altering the value of [[mdflags]].

==light==
'''light''' ''sector'' ''x'' ''y'' ''z'' ''range'' ''r'' ''g'' ''b'' ''radius'' ''faderadius'' ''angle'' ''horiz'' ''minshade'' ''maxshade'' ''priority'' ''tilenum''

Displays a spotlight using the '''Polymer''' renderer.