Maphack Language - Revision history

LeoD: Examples and Conventions

2021-10-26T13:51:11Z

Examples and Conventions

@@ Line 44: / Line 44: @@
 sprite ''spriteid'' '''pitch''' ''value''
-Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Not yet implemented for kvx models.<br/>
+Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Does not work in conjunction with '''notmd'''. Not yet implemented for kvx models.<br/>
 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.
@@ Line 50: / Line 50: @@
 sprite ''spriteid'' '''roll''' ''value''
-Adjusts the model's '''[[roll]]''', i.e. tilting to the side. Not yet implemented for kvx models.
+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]]===
@@ Line 66: / Line 66: @@
 Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left).<br/>
-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.<br/>
+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.<br/>
 Be aware that the same ''value'' will result in 1/16 the translation for '''mdzoff''' compared to '''mdxoff''' and '''mdyoff'''.
@@ Line 73: / Line 73: @@
 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.)<br/>
-This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.
+This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.
 ===mdposyoff===
@@ Line 79: / Line 79: @@
 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.)<br/>
-This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.
+This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.
 ===mdposzoff===
@@ Line 97: / Line 97: @@
 Displays a spotlight using the '''Polymer''' renderer.

LeoD: Undo revision 14412 by LeoD (talk)

2021-10-26T13:49:26Z

Undo revision 14412 by LeoD (talk)

@@ Line 44: / Line 44: @@
 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.<br/>
+Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Not yet implemented for kvx models.<br/>
 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.
@@ Line 50: / Line 50: @@
 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.
+Adjusts the model's '''[[roll]]''', i.e. tilting to the side. Not yet implemented for kvx models.
 ===[[mdxoff]]===
@@ Line 66: / Line 66: @@
 Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left).<br/>
-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.<br/>
+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.<br/>
 Be aware that the same ''value'' will result in 1/16 the translation for '''mdzoff''' compared to '''mdxoff''' and '''mdyoff'''.
@@ Line 73: / Line 73: @@
 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.)<br/>
-This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.
+This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.
 ===mdposyoff===
@@ Line 79: / Line 79: @@
 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.)<br/>
-This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.
+This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.
 ===mdposzoff===
@@ Line 97: / Line 97: @@
 Displays a spotlight using the '''Polymer''' renderer.

LeoD at 13:45, 26 October 2021

2021-10-26T13:45:43Z

@@ Line 44: / Line 44: @@
 sprite ''spriteid'' '''pitch''' ''value''
-Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Not yet implemented for kvx models.<br/>
+Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Does not work in conjunction with '''notmd'''. Not yet implemented for kvx models.<br/>
 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.
@@ Line 50: / Line 50: @@
 sprite ''spriteid'' '''roll''' ''value''
-Adjusts the model's '''[[roll]]''', i.e. tilting to the side. Not yet implemented for kvx models.
+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]]===
@@ Line 66: / Line 66: @@
 Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left).<br/>
-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.<br/>
+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.<br/>
 Be aware that the same ''value'' will result in 1/16 the translation for '''mdzoff''' compared to '''mdxoff''' and '''mdyoff'''.
@@ Line 73: / Line 73: @@
 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.)<br/>
-This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.
+This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.
 ===mdposyoff===
@@ Line 79: / Line 79: @@
 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.)<br/>
-This is quite different from the way ''pitch/roll + md[x|y|z]off'' works. Do not confuse.
+This is quite different from the way (''pitch/roll + md[x|y|z]off'') works. Do not confuse.
 ===mdposzoff===
@@ Line 97: / Line 97: @@
 Displays a spotlight using the '''Polymer''' renderer.

LeoD: recent maphack tokens added

2021-10-26T12:39:23Z

recent maphack tokens added

← Older revision		Revision as of 05:39, 26 October 2021
Line 28:		Line 28:
	Freezes any model animation in place. This is achieved by altering the value of [[mdflags]].<br/>		Freezes any model animation in place. This is achieved by altering the value of [[mdflags]].<br/>
	There is no actual implementation for ''nomd2anim'' and ''nomd3anim''. They are mapped to ''nomdanim''.		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]].<br/>
			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]].<br/>
			It is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer.

	===[[pitch]]===		===[[pitch]]===
Line 54:		Line 66:

	Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left).<br/>		Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left).<br/>
	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'''.		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.<br/>
			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''

	===~~away1~~===		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.)<br/>
	sprite ''spriteid'' '''~~away1~~'''		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.)<br/>
			This is quite different from the way ''pitch/roll + md[x\|y\|z]off'' works. Do not confuse.

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

	~~Moves~~ the ~~sprite~~ forwards ~~by a small amount. This is achieved by altering~~ the ~~value of [[mdflags]]~~.<br/>		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).<br/>
	This is ~~mostly used~~ to ~~resolve flickering~~ (~~"z-fighting"~~) ~~of overlapping wall aligned sprites~~, ~~which is especially prevalent when using the Polymer renderer~~.		This is roughly equivalent to the way (''pitch + mdxoff'') or (''roll + mdyoff'') work, respectively.

	===~~away2~~===		===mhkreset===
	sprite ''spriteid'' '''~~away2~~'''		sprite ''spriteid'' '''mhkreset'''

	~~Moves the~~ sprite ~~backwards by a small amount. This is achieved by altering the value of [[mdflags]].<br/>~~		This development helper resets all previous maphacks for a sprite.
	~~This is mostly used to resolve flickering ("z-fighting") of overlapping wall aligned sprites, which is especially prevalent when using the Polymer renderer~~.

LeoD: more detailed information added

2021-10-26T11:47:04Z

more detailed information added

← Older revision		Revision as of 04:47, 26 October 2021
Line 1:		Line 1:
	Maphacks are used to edit the positioning of objects and other parts of a level in cases where the maps cannot be redistributed.		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==
Line 8:		Line 10:
	sprite ''spriteid'' '''angleoff''' ''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.		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===		===notmd===
Line 15:		Line 17:
	sprite ''spriteid'' '''notmd3'''		sprite ''spriteid'' '''notmd3'''

	Renders a tile as a ~~sprite~~ instead of a model. This is achieved by altering the value of [[mdflags]].<br/>		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]].<br/>
			It is mostly used to "flatten" wall aligned or floor aligned decorative objects.<br/>
	There is no actual implementation for ''notmd2'' and ''notmd3''. They are mapped to ''notmd''.		There is no actual implementation for ''notmd2'' and ''notmd3''. They are mapped to ''notmd''.

Line 29:		Line 32:
	sprite ''spriteid'' '''pitch''' ''value''		sprite ''spriteid'' '''pitch''' ''value''

	Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards.		Adjusts the model's '''[[pitch]]''', i.e. bowing or falling backwards. Not yet implemented for kvx models.<br/>
	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.		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]]===		===[[roll]]===
	sprite ''spriteid'' '''roll''' ''value''		sprite ''spriteid'' '''roll''' ''value''

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

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

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

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

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

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

	Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' and '''roll'''.		Offsets the '''z''' coordinate of the model's centerpoint, to be used in conjunction with '''pitch''' (forwards/backwards) and/or '''roll''' (right/left).<br/>
			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'''.

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

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

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

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


	==light==		==light==

LeoD: Comments on notmd2, notmd3, nomd2anim, nomd3anim

2021-10-26T10:19:47Z

Comments on notmd2, notmd3, nomd2anim, nomd3anim

← Older revision		Revision as of 03:19, 26 October 2021
Line 15:		Line 15:
	sprite ''spriteid'' '''notmd3'''		sprite ''spriteid'' '''notmd3'''

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

	===nomdanim===		===nomdanim===
Line 22:		Line 23:
	sprite ''spriteid'' '''nomd3anim'''		sprite ''spriteid'' '''nomd3anim'''

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

	===[[pitch]]===		===[[pitch]]===

LeoD: /* mdzoff */

2013-03-17T15:13:04Z

mdzoff

← Older revision		Revision as of 08:13, 17 March 2013
Line 48:		Line 48:
	sprite ''spriteid'' '''mdzoff''' ''value''		sprite ''spriteid'' '''mdzoff''' ''value''

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

	===away1===		===away1===

LeoD: /* angoff */

2013-03-17T15:07:46Z

angoff

← Older revision		Revision as of 08:07, 17 March 2013
Line 8:		Line 8:
	sprite ''spriteid'' '''angleoff''' ''value''		sprite ''spriteid'' '''angleoff''' ''value''

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

	===notmd===		===notmd===

LeoD: /* angoff */

2013-03-17T15:03:03Z

angoff

← Older revision		Revision as of 08:03, 17 March 2013
Line 5:		Line 5:

	===[[angoff]]===		===[[angoff]]===
	sprite ''spriteid'' '''angoff''' ''value''		sprite ''spriteid'' '''angoff''' ''value''<br/>
	sprite ''spriteid'' '''angleoff''' ''value''		sprite ''spriteid'' '''angleoff''' ''value''

Hendricks266: Created page with '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''
2009-06-17T23:44:14Z

Created page with '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> <no...'

New page
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'''<br/>
sprite ''spriteid'' '''notmd2'''<br/>
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'''<br/>
sprite ''spriteid'' '''nomd2anim'''<br/>
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.