forked from KS-Presto/Wolf4SDL
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.TXT
200 lines (165 loc) · 8.3 KB
/
README.TXT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
NakedWolf3d is an open-source port of id Software's classic first-person shooter
Wolfenstein 3D (1992) by ID Software based on Wolf4SDL.
The objective is to:
aim to be vanilla accurate with nothing added and nothing taken away.
Exactly as it was in 1992, not for youngsters who cannot handle 320x200.
Main features:
--------------
- Cross-platform:
Supported operating systems are at least:
- Windows 98, Windows ME, Windows 2000, Windows XP, Windows Vista
(32 and 64 bit), Windows 7 (32 and 64 bit), Windows 10 (32 and 64 bit)
- Linux
- BSD variants
- Mac OS X (x86)
- KallistiOS (used for Dreamcast)
- AdLib sounds and music:
This port includes the OPL2 emulator from MAME, so you can not only
hear the AdLib sounds but also music without any AdLib-compatible
soundcard in near to perfect quality!
- Multichannel digitized sounds:
Digitized sounds play on 8 channels! So in a fire fight you will
always hear, when a guard opens the door behind you ;)
- Fully playable with only a game controller:
Wolf4SDL can be played completely without a keyboard. At least two
buttons are required (shoot/YES and open door/NO), but five or more
are recommended (run, strafe, ESC).
Additional features:
--------------------
- Two additional view sizes:
NakedWolf3d supports one view size using the full width of the screen
and showing the status bar, like in Mac-enstein, and one view size
filling the whole screen (press TAB to see the status bar).
- (Nearly) unlimited sound and song lengths:
Mod developers are not restricted to 64kB for digitized sounds and
IMF songs anymore, so longer songs and digitized sounds with better
quality are possible.
- Resuming ingame music:
When you come back to the game from the menu or load a save game, the
music will be resumed where it was suspended rather than started from
the beginning.
- Freely movable pushwalls:
Moving pushwalls can be viewed from all sides, allowing mod developers
to place them with fewer restrictions. The player can also follow the
pushwall directly instead of having to wait until the pushwall has left
a whole tile.
- Optional integrated features for mod developers:
Wolf4SDL already contains the shading, directional 3D sprites,
floor and ceiling textures, high resolution textures/sprites,
parallax sky, cloud sky and outside atmosphere features, which
can be easily activated in version.h.
The following versions of Wolfenstein 3D data files are currently supported
by the source code (choose the version by commenting/uncommenting lines in
version.h as described in that file):
- Wolfenstein 3D v1.1 full Apogee
- Wolfenstein 3D v1.4 full Apogee
- Wolfenstein 3D v1.4 full GT/ID/Activision
- Wolfenstein 3D v1.4 full Imagineer (Japanese)
- Wolfenstein 3D v1.0 shareware Apogee
- Wolfenstein 3D v1.1 shareware Apogee
- Wolfenstein 3D v1.2 shareware Apogee
- Wolfenstein 3D v1.4 shareware
- Spear of Destiny full
- Spear of Destiny demo
- Spear of Destiny - Mission 2: Return to Danger (not tested)
- Spear of Destiny - Mission 3: Ultimate Challenge (not tested)
How to play:
------------
To play Wolfenstein 3D with NakedWolf3D, you just have to copy the original data
files (e.g. *.WL6) into the same directory as the NakedWolf3D executable.
Please make sure, that you use the correct version of the executable with the
according data files version as the differences are hardcoded into the binary!
If you play in windowed mode (--windowed parameter), press SCROLLLOCK or F12
to grab the mouse. Press it again to release the mouse.
Usage:
------
NakedWolf3D supports the following command line options:
--help This help page
--tedlevel <level> Starts the game in the given level
--baby Sets the difficulty to baby for tedlevel
--easy Sets the difficulty to easy for tedlevel
--normal Sets the difficulty to normal for tedlevel
--hard Sets the difficulty to hard for tedlevel
--nowait Skips intro screens
--windowed[-mouse] Starts the game in a window [and grabs mouse]
--res <width> <height> Sets the screen resolution
(must be multiple of 320x200 or 320x240)
--resf <w> <h> Sets any screen resolution >= 320x200
(which may result in graphic errors)
--bits <b> Sets the screen color depth
(Use this when you have palette/fading problem
or perhaps to optimize speed on old systems.
Allowed: 8, 16, 24, 32, default: "best" depth)
--nodblbuf Don't use SDL's double buffering
--extravbls <vbls> Sets a delay after each frame, which may help to
reduce flickering (SDL does not support vsync...)
(unit is currently 8 ms, default: 0)
--joystick <index> Use the index-th joystick if available
--joystickhat <index> Enables movement with the given coolie hat
--samplerate <rate> Sets the sound sample rate (given in Hz)
--audiobuffer <size> Sets the size of the audio buffer (-> sound latency)
(given in bytes)
--ignorenumchunks Ignores the number of chunks in VGAHEAD.*
(may be useful for some broken mods)
--configdir <dir> Directory where config file and save games are stored
(Windows default: current directory,
others: $HOME/.wolf4sdl)
For Spear of Destiny the following additional options are available:
--mission <mission> Mission number to play (1-3)
--goodtimes Disable copy protection quiz
Compiling from source code:
---------------------------
The current version of the source code is available on GitHub at:
https://github.com/wolfysdl/NakedWolf3D
If you want to get the Wolf4SDL For the major improvents
and avoid the purpose of NakedWolf3d Find At:
https://github.com/Doom-modding-and-etc/Wolf4SDL
To compile the source code you need(For now) the development libraries of
- SDL (https://www.libsdl.org/download-1.2.php) and
- SDL_mixer (https://www.libsdl.org/projects/SDL_mixer/release-1.2.html)
and have to adjust the include and library paths in the projects accordingly.
- SDL2 2.0.22 Runtimes can be acquired at:
https://www.libsdl.org/download-2.0.php and download "SDL_mixer-2.0.22-win32.zip"
- SDL_mixer 2.0.4 Runtimes can be acquired at:
https://www.libsdl.org/projects/SDL_mixer/ and download "SDL_mixer-2.0.4-win32.zip"
! ATTENTION ! Do NOT download the x64 version of SDL or SDL_mixer. x86 binairies are required.
The following ways of compiling the source code are supported:
- Makefile (for Linux, BSD variants and MinGW/MSYS)
- Visual C++ 2022 (NakedWolf3d..sln and NakedWolf3D.vcproj)
- Xcode (for Mac OS X, macosx/Wolf4SDL.xcodeproj/project.pbxproj)
IMPORTANT: Do not forget to take care of version.h!
By default it compiles for "Wolfenstein 3D v1.4 full GT/ID/Activision"!
TODOs:
------
- Remove SDL
Known bugs:
-----------
- None! ;D
Troubleshooting:
----------------
- If your frame rate is low, consider using the original screen resolution
(--res 320 200) or lowering the sound quality (--samplerate 22050)
Credits:
--------
- Special thanks to id Software! Without the source code we would still have
to pelt Wolfenstein 3D with hex editors and disassemblers ;D
- Special thanks to the DOSBox team for providing a GPL'ed OPL2/3 emulator!
- Special thanks to the MAME developer team for providing the source code
of the OPL2 emulator!
- Many thanks to "Der Tron" for hosting the svn repository, making Wolf4SDL
FreeBSD compatible, testing, bugfixing and cleaning up the code!
- Thanks to Chris Chokan for his improvements on Wolf4GW (base of Wolf4SDL)
- Thanks to Pickle for the GP2X support and help on 320x240 support
- Thanks to fackue for the Dreamcast support
- Thanks to Chris Ballinger for the Mac OS X support
- Thanks to Xilinx, Inc. for providing a list of maximum-length LFSR counters
used for higher resolutions of fizzle fade
Licenses:
---------
- The original source code of Wolfenstein 3D:
At your choice:
- license-id.txt or
- license-gpl.txt
- The OPL2 emulator:
At your choice:
- license-mame.txt (fmopl.c)