Subversion Repositories duke3d_hrp

Compare Revisions

Ignore whitespace Rev 726 → Rev 727

/maphacks/MapHacks.txt
1,218 → 1,218
==========================================
| Duke Nukem 3D |
| Maphacks for the EDuke32 |
| High Resolution Pack (HRP) |
| or |
| Voxel Pack |
| |
==========================================
 
 
 
 
=======================
CONTENTS OF THIS README
=======================
 
1) About
2) Installation
3) Notes
4) Support for NightFright's Addon Compilation
5) License
6) Contact/Links
7) Credits
 
 
 
1) ABOUT
========
Maphacks are used to edit the positioning of objects and other parts of a level
in cases where the maps cannot be redistributed. These maphacks' goal is to
improve the compatibility of user created maps with the HRP or the Voxel Pack.
Since there is no central site for map downloads, patching the maps directly
would lead to quite some confusion among players about their respective
versions. By distributing separated maphacks the original map download archives
can be kept unchanged. The maphacks are now part of the HRP, but this pack is
updated more frequently.
 
What maphacks can do:
- prevent objects from clipping into walls or each other
- by rotating them (models + voxels)
- by moving their visible representation (not yet implemented for voxels)
- turn the front side of objects to the most likely player position
- prevent wall/floor aligned decorations from showing up as models/voxels
- turn off unintended model animations
- tilt objects to align to sloped floors (not yet implemented for voxels)
- prevent wall-aligned sprites from flickering (mostly a Polymer issue)
 
 
2) INSTALLATION
===============
Technically this is like an HRP update pack with maphack additions and
updates only - therefore, if your current HRP's (or regular HRP update pack's)
version number is greater than ours, don't use this pack.
 
Drop this pack into the autoload folder alongside your HRP (5.4 or later) and
you should be done.
(Standalone invocation: eduke32 -g UserMapHacks.zip -mh maphacks/maphacks.def)
 
You need a recent EDuke32 executable which has UserMapHacks support
implemented - at least r4886 (source r4884). (HRP 5.4 comes with r5267.)
 
Currently users are reporting various issues with recent EDuke32 builds. If you
should encounter problems as well, try the r4495 version with backported
UserMapHack support from the "Other Stuff" link below.
 
Your eduke32.log should contain one or more lines similar to this after playing:
Loaded map hack file "maphacks/usermaps/foobar.mhk"
 
 
3) NOTES
========
The main goal is to get rid of the most annoying HRP-related problems of
popular (highly rated by reviewers) and recently released user maps.
Since the introduction of the Poymer renderer in 2009 and the big HRP model
rotation in early 2012 (r5.1.295), even maps which were designed with the HRP
in mind need some adjustments.
Do not expect a maphack quality comparable to what has been done for the
original game's levels, though. No additional Polymer lighting for example.
 
A few older maps make use of tricks which can't be reproduced (yet?) using the
modern OpenGL renderers. Some recent maps' README files explicitly state that
the respective map is meant to be played without fancy renderers, or the HRP.
Remember that these maphacks do not claim to make those maps look as intended
if you are using the HRP anyway, but try to fix the obvious glitches as far as
it is technically possible. Do not complain to mappers, do not ask them to
'fix' their map if it looks bad when HRPlaying it.
 
Some other maps and episodes come with custom textures. Tiles014.art,
tiles15.art, tiles20.art and up, will technically never interfere with the HRP,
whereas extensive use of custom textures may look off when combined with
the HRP. In case of conflicting ART I may have added a README and/or a ZIP file
to explain or improve compatibility. But even if a maphack and further
compatibility improvements exist, it's still your decision to HRPlay or not.
 
This Pack is suitable for the Voxel Pack as well, although only the 'angoff'
directive (model rotation) works currently on voxels (EDuke32 r8784).
But that's the most commonly used correction anyway.
 
 
You can help:
 
- If you find anything you consider worthy correcting in an already maphacked
level, don't hesitate to report it (DNCOORDS!), and which renderer/HRP version
you are using. Some models (like the 0603 hangbabe) might need different
maphacks and some floor/ceiling aligned sprites may show up different
(or not at all) in either Polymost or Polymer renderer/HRP.
 
- You can contribute your own maphacks. Basic information is available at:
https://wiki.eduke32.com/wiki/Maphack_Language
 
- If you have a newer version of an already maphacked level, please let LeoD
know. (But compare the checksums first.)
 
 
4) Support for NightFright's Addon Compilation 3.1
==================================================
A full set of maphacks is available for each of the following GRPs (244):
adg.grp (5)
aqua.grp (3)
battlefield3.grp (3)
bobsp.grp (5)
bravenworld.grp (5) - Check out HRP-BNW-compatibility.zip
castlequest.grp (7)
chronic.grp (5) - Check out HRP-TheChronic-compatibility.zip
commbuild.grp (8)
crucialconflict.grp (3)
daikarin.grp (7) - Check out HRP-DaikariN-compatibility.zip
darkplace.grp (5)
deathdrive.grp (5)
dn64revisited.grp (3)
dreamtrilogy_grp (3)
dukehard.grp (17) - Check out HrpDukePlus-DukeHard-compatibility.zip
duketen.grp (3)
fbsp.grp (3)
glavic.grp (10)
kaiserland.grp (3)
lorch.grp (3)
losthighway.grp (7)
mathpak.grp (5)
metromayhem.grp (15)
milltown.grp (2)
mssp.grp (8)
opblitzkrieg.grp (5)
plugpray.grp (7)
prequel2time.grp (4)
red.grp (7)
redrum.grp (1)
roch.grp (9)
showdown.grp (21) - Check out HRP-NuclearShowdown-compatibility.zip ???
spcmissn.grp (2)
spiegul.grp (3)
stranger.grp (6)
sunburn.grp (2)
taivo.grp (5)
undertaker.grp (5)
v_series.grp (4)
verminclear.grp (12)
wgspace.grp (8)
 
Maphacks for the following GRPs are not yet completed (128/209):
c3po.grp : 2/4
escape.grp : 2/5
fm3x.grp : 34/42 - FM1X-FM3X done
jungletour.grp : 1/3
kucera.grp : 4/15
pinxten.grp ; 5/9
pipeline.grp ; 2/7
quakis.grp : 6/8
space.grp : 23/38
urban.grp : 49/78
 
Some GRPs' high resolution contents have been left out from the Addon Pack:
infestation.grp : 39/39 - Check out IITTC-HRP-compatibility.zip
moonbase.grp : 9/9
wgrealms.grp : 6/6
They will probably get recompiled for HRP with the Addon's maps included (54).
They'll become available at the "Other Stuff" link below.
 
Most other GRPs included in the Addon Pack are probably not compatible with the
HRP, but they need to be actually checked out, though.
 
 
5) LICENSE
==========
Maphacks for original game's maps and official addon maps (Caribbean/Vacation,
Duke in D.C., Nuclear Winter, World Tour) are covered by the High Resolution
Pack [HRP] Art License or Voxel Pack Art License, respectively.
You are free to copy, alter, reproduce, and redistribute all other maphack files
as long as their original author[s] are credited in each *.mhk, respectively.
 
 
6) CONTACT/LINKS
================
You can check the related EDuke32 forum thread over at Duke4.net:
https://forums.duke4.net/index.php?showtopic=6070
 
Contact:
--------
https://forums.duke4.net/index.php?showuser=1299
 
Related Links:
--------------
Duke4.net ................................... https://duke4.net
Duke Nukem 3D High-Resolution Pack .......... https://hrp.duke4.net
NightFright's Addon Pack .................... https://hrp.duke4.net
EDuke32 port ................................ https://eduke32.com
RHash checksum generator ......... https://sourceforge.net/projects/rhash
Maphacks in the HRP repository ... https://svn.eduke32.com/duke3d_hrp/maphacks
Maphack Wiki entry ............ https://wiki.eduke32.com/wiki/Maphack_Language
 
Advertisement:
--------------
Other Stuff by LeoD ........ https://forums.duke4.net/index.php?showtopic=3513
 
 
7) CREDITS
==========
Anyone who has contributed to EDuke32, the HRP, or the user maps listed herein
==========================================
| Duke Nukem 3D |
| Maphacks for the EDuke32 |
| High Resolution Pack (HRP) |
| or |
| Voxel Pack |
| |
==========================================
 
 
 
 
=======================
CONTENTS OF THIS README
=======================
 
1) About
2) Installation
3) Notes
4) Support for NightFright's Addon Compilation
5) License
6) Contact/Links
7) Credits
 
 
 
1) ABOUT
========
Maphacks are used to edit the positioning of objects and other parts of a level
in cases where the maps cannot be redistributed. These maphacks' goal is to
improve the compatibility of user created maps with the HRP or the Voxel Pack.
Since there is no central site for map downloads, patching the maps directly
would lead to quite some confusion among players about their respective
versions. By distributing separated maphacks the original map download archives
can be kept unchanged. The maphacks are now part of the HRP, but this pack is
updated more frequently.
 
What maphacks can do:
- prevent objects from clipping into walls or each other
- by rotating them (models + voxels)
- by moving their visible representation (not yet implemented for voxels)
- turn the front side of objects to the most likely player position
- prevent wall/floor aligned decorations from showing up as models/voxels
- turn off unintended model animations
- tilt objects to align to sloped floors (not yet implemented for voxels)
- prevent wall-aligned sprites from flickering (mostly a Polymer issue)
 
 
2) INSTALLATION
===============
Technically this is like an HRP update pack with maphack additions and
updates only - therefore, if your current HRP's (or regular HRP update pack's)
version number is greater than ours, don't use this pack.
 
Drop this pack into the autoload folder alongside your HRP (5.4 or later) and
you should be done.
(Standalone invocation: eduke32 -g UserMapHacks.zip -mh maphacks/maphacks.def)
 
You need a recent EDuke32 executable which has UserMapHacks support
implemented - at least r4886 (source r4884). (HRP 5.4 comes with r5267.)
 
Currently users are reporting various issues with recent EDuke32 builds. If you
should encounter problems as well, try the r4495 version with backported
UserMapHack support from the "Other Stuff" link below.
 
Your eduke32.log should contain one or more lines similar to this after playing:
Loaded map hack file "maphacks/usermaps/foobar.mhk"
 
 
3) NOTES
========
The main goal is to get rid of the most annoying HRP-related problems of
popular (highly rated by reviewers) and recently released user maps.
Since the introduction of the Poymer renderer in 2009 and the big HRP model
rotation in early 2012 (r5.1.295), even maps which were designed with the HRP
in mind need some adjustments.
Do not expect a maphack quality comparable to what has been done for the
original game's levels, though. No additional Polymer lighting for example.
 
A few older maps make use of tricks which can't be reproduced (yet?) using the
modern OpenGL renderers. Some recent maps' README files explicitly state that
the respective map is meant to be played without fancy renderers, or the HRP.
Remember that these maphacks do not claim to make those maps look as intended
if you are using the HRP anyway, but try to fix the obvious glitches as far as
it is technically possible. Do not complain to mappers, do not ask them to
'fix' their map if it looks bad when HRPlaying it.
 
Some other maps and episodes come with custom textures. Tiles014.art,
tiles15.art, tiles20.art and up, will technically never interfere with the HRP,
whereas extensive use of custom textures may look off when combined with
the HRP. In case of conflicting ART I may have added a README and/or a ZIP file
to explain or improve compatibility. But even if a maphack and further
compatibility improvements exist, it's still your decision to HRPlay or not.
 
This Pack is suitable for the Voxel Pack as well, although only the 'angoff'
directive (model rotation) works currently on voxels (EDuke32 r8784).
But that's the most commonly used correction anyway.
 
 
You can help:
 
- If you find anything you consider worthy correcting in an already maphacked
level, don't hesitate to report it (DNCOORDS!), and which renderer/HRP version
you are using. Some models (like the 0603 hangbabe) might need different
maphacks and some floor/ceiling aligned sprites may show up different
(or not at all) in either Polymost or Polymer renderer/HRP.
 
- You can contribute your own maphacks. Basic information is available at:
https://wiki.eduke32.com/wiki/Maphack_Language
 
- If you have a newer version of an already maphacked level, please let LeoD
know. (But compare the checksums first.)
 
 
4) Support for NightFright's Addon Compilation 3.1
==================================================
A full set of maphacks is available for each of the following GRPs (244):
adg.grp (5)
aqua.grp (3)
battlefield3.grp (3)
bobsp.grp (5)
bravenworld.grp (5) - Check out HRP-BNW-compatibility.zip
castlequest.grp (7)
chronic.grp (5) - Check out HRP-TheChronic-compatibility.zip
commbuild.grp (8)
crucialconflict.grp (3)
daikarin.grp (7) - Check out HRP-DaikariN-compatibility.zip
darkplace.grp (5)
deathdrive.grp (5)
dn64revisited.grp (3)
dreamtrilogy_grp (3)
dukehard.grp (17) - Check out HrpDukePlus-DukeHard-compatibility.zip
duketen.grp (3)
fbsp.grp (3)
glavic.grp (10)
kaiserland.grp (3)
lorch.grp (3)
losthighway.grp (7)
mathpak.grp (5)
metromayhem.grp (15)
milltown.grp (2)
mssp.grp (8)
opblitzkrieg.grp (5)
plugpray.grp (7)
prequel2time.grp (4)
red.grp (7)
redrum.grp (1)
roch.grp (9)
showdown.grp (21) - Check out HRP-NuclearShowdown-compatibility.zip ???
spcmissn.grp (2)
spiegul.grp (3)
stranger.grp (6)
sunburn.grp (2)
taivo.grp (5)
undertaker.grp (5)
v_series.grp (4)
verminclear.grp (12)
wgspace.grp (8)
 
Maphacks for the following GRPs are not yet completed (128/209):
c3po.grp : 2/4
escape.grp : 2/5
fm3x.grp : 34/42 - FM1X-FM3X done
jungletour.grp : 1/3
kucera.grp : 4/15
pinxten.grp ; 5/9
pipeline.grp ; 2/7
quakis.grp : 6/8
space.grp : 23/38
urban.grp : 49/78
 
Some GRPs' high resolution contents have been left out from the Addon Pack:
infestation.grp : 39/39 - Check out IITTC-HRP-compatibility.zip
moonbase.grp : 9/9
wgrealms.grp : 6/6
They will probably get recompiled for HRP with the Addon's maps included (54).
They'll become available at the "Other Stuff" link below.
 
Most other GRPs included in the Addon Pack are probably not compatible with the
HRP, but they need to be actually checked out, though.
 
 
5) LICENSE
==========
Maphacks for original game's maps and official addon maps (Caribbean/Vacation,
Duke in D.C., Nuclear Winter, World Tour) are covered by the High Resolution
Pack [HRP] Art License or Voxel Pack Art License, respectively.
You are free to copy, alter, reproduce, and redistribute all other maphack files
as long as their original author[s] are credited in each *.mhk, respectively.
 
 
6) CONTACT/LINKS
================
You can check the related EDuke32 forum thread over at Duke4.net:
https://forums.duke4.net/index.php?showtopic=6070
 
Contact:
--------
https://forums.duke4.net/index.php?showuser=1299
 
Related Links:
--------------
Duke4.net ................................... https://duke4.net
Duke Nukem 3D High-Resolution Pack .......... https://hrp.duke4.net
NightFright's Addon Pack .................... https://hrp.duke4.net
EDuke32 port ................................ https://eduke32.com
RHash checksum generator ......... https://sourceforge.net/projects/rhash
Maphacks in the HRP repository ... https://svn.eduke32.com/duke3d_hrp/maphacks
Maphack Wiki entry ............ https://wiki.eduke32.com/wiki/Maphack_Language
 
Advertisement:
--------------
Other Stuff by LeoD ........ https://forums.duke4.net/index.php?showtopic=3513
 
 
7) CREDITS
==========
Anyone who has contributed to EDuke32, the HRP, or the user maps listed herein