Differences

This shows you the differences between two versions of the page.

--- systems:ecwolf [2022/04/28 20:54] – [Who to install games:] maioni
+++ systems:ecwolf [2025/03/04 13:29] (current) – Better format, links and some errors removed crcerror
@@ Line 25: / Line 25: @@
   * **Emulator:** [[#ecwolf|ecwolf]]
   * **Folder:** ''/userdata/roms/ecwolf''
+  * **Savegames:** ''/userdata/saves/ecwolf/[romname]/''
   * **Accepted ROM formats:** ''.ecwolf'', ''.pk3'', ''.squashfs''
@@ Line 33: / Line 34: @@
 ===== ROMs =====
-Install to ''roms/ecwolf/''. Supports the original DOS executables (''wolf3d.exe'', ''spear.exe'', etc.). Requires all supplementary files that were included with the original installation.
+Install to ''roms/ecwolf/''. The ecwolf binary offers same supports as the original DOS executables (''wolf3d.exe'', ''spear.exe'', etc.). Thus these executables are not needed - all supplementary data-files that were included with the original installation should be copied.
 ''1.x'' mods may not be compatible with ''2.x'', and vice versa. The philosophy on backwards mod compatibility going forward is TBA.
-  * Wolfeinstein 3D: [[https://store.steampowered.com/app/2270/Wolfenstein_3D/]]
+  * [[https://www.gog.com/game/wolfenstein_3d_and_spear_of_destiny|GOG: Wolfenstein 3D + Spear of Destiny]]
-  * Wolfweinstein 3D Shareware: [[http://maniacsvault.net/ecwolf/files/shareware/wolf3d14.zip]]
+  * [[https://store.steampowered.com/sub/418/|Steam: Wolf Pack]]
-  * Spear of Destiny: [[https://store.steampowered.com/app/9000/Spear_of_Destiny/]]
+  * [[https://store.steampowered.com/app/371180/Super_3D_Noahs_Ark/|Steam: Super 3D Noah's Ark]]
-  * Spear of Destiny Demo: [[http://maniacsvault.net/ecwolf/files/shareware/soddemo.zip]]
+  * [[https://3drealms.com/catalog/wolfenstein-3d_25/|3d Realms]]
-  * Super 3D Noah's Ark: [[https://wisdomtree.itch.io/s3dna]] / [[https://store.steampowered.com/app/1285050/Noahs_Ark/]]
+  * [[https://wisdomtree.itch.io/s3dna|itch.io: Wolfenstein 3D only]]
-==== Who to install games: ====
+  * [[http://maniacsvault.net/ecwolf/files/shareware/wolf3d14.zip|Wolfenstein 3D Shareware filedownload]]
+  * [[http://maniacsvault.net/ecwolf/files/shareware/soddemo.zip|Spear of Destiny Demo filedownload]]
-  - Put the game's folder in the ''/roms/ecwolf'' and add the extension ''.ecwolf''
+==== How to install games ====
-  - and inside that the appropriate files: ''.wl6'' or ''.wl1'' or ''.sod'' or ''.sdm''
+Put the game's folder in the ''/roms/ecwolf'' and add the extension ''.ecwolf'' and inside that, copy the appropriate files:
+  * ''.wl6'' (Wolfenstein 3D fullversion)
+  * ''.wl1'' (Wolfenstein 3D demo)
+  * ''.sod'' (Spear of Destiny fullversion)
+  * ''.sdm'' (Spear of Destiny demo)
+  * ''.sd2'' (Spear of Destiny - Mission Pack 2: Return to danger)
+  * ''.sd3'' (Spear of Destiny - Mission Pack 3: Ultimate Challenge)
+  * ''.n3d'' (Super Noah’s Ark 3D)
 For example: ''/roms/ecwolf/Wolfenstein 3D.ecwolf/<.wl6 game files>''
+More details at: http://maniacsvault.net/ecwolf/wiki/Game_data
+--> File allocation tree
 <code>
 /userdata/roms/ecwolf/Spear of Destiny.ecwolf/
@@ Line 68: / Line 81: @@
 /userdata/roms/ecwolf/Super 3D Noah's Ark.ecwolf/
-                                                ├── audiohed.wl6
+                                                ├── audiohed.n3d
-                                                ├── audiot.wl6
+                                                ├── audiot.n3d
-                                                ├── config.wl6
+                                                ├── config.n3d
-                                                ├── gamemaps.wl6
+                                                ├── gamemaps.n3d
-                                                ├── maphead.wl6
+                                                ├── maphead.n3d
-                                                ├── vgadict.wl6
+                                                ├── vgadict.n3d
-                                                ├── vgagraph.wl6
+                                                ├── vgagraph.n3d
-                                                ├── vgahead.wl6
+                                                ├── vgahead.n3d
-                                                └──  vswap.wl6
+                                                └──  vswap.n3d
 /userdata/roms/ecwolf/Wolfenstein 3D.ecwolf/
@@ Line 117: / Line 130: @@
 </code>
+<--
+==== Mods ====
+ECWolf can run total conversions, but only ones that have no significant changes in code.
+  - Rename the mode files extension to one compatible with ECWolf: ''.wl6'', ''.wl1'' or ''.sod''
+  - [[systems:ecwolf#how_to_install_games|Install the mod to a ROM.]]
+  - Enjoy!
+e.g.: for the MOD Conflict In The Fatherland (1999), rename the files from ''.bj2'' to ''.wl6'', add the game to ''/userdata/roms/ecworlf/Conflict In The Fatherland.ecwolf/'', launch the game in Batocera, and select Wolfenstein 3D due to ''.wl6'' be a extension be related to the base game Wolfenstein 3D. Enjoy your MOD!
+Mods: [[https://beta.wolf3d.net/engines/ECWolf/games]]
+Since Batocera 38 the support of ''.pk3'' and ''.ecwolf'' files was added. These files are packages that contain new sound (guard shouts, weapon noise), background music (MP3 or even FLAC), textures (from simple new reskinned textures to HD), weapons (yes B.J. can carry even more than 4 pieces) and of course completly new levelsets.
+A good collection of a HD total conversion and nice music/audio-sets can found [[https://forum.zdoom.org/viewtopic.php?f=19&t=48633|here (ZDOOM forum)]]. Download the linked pk3 files.
+As said the support of ''.ecwolf''-files was added since Batocera 38, as an example how these files are used
+  * Create a file **Wolfenstein 3D HD.ecwolf**
+  * Use a single line of arguments inside the file
+   * First argument: a path relative to ecwolf-rom dir
+   * Second argument: according ''ecwolf --help'' pages
+   * ...
+<code>
+.\wolf3d14 --data wl6 --file ../HD/ECWolf_hdpack.pk3 ../HD/ECWolf_hdmus_3DO.pk3
+^          ^          ^
+|          |          |
+|          |          └── file argument to load several pk3 files
+|          |
+|          └── which dataset to use (wl6, sod, sd1) needed if you put several datasets into one directory
+|
+└── path to gamesets (can be full or relative, basedir is /userdata/roms/ecwolf)
+</code>
+**Wolfenstein 3D - Spear of Destiny - Mission Pack2: Return to Danger.ecwolf**
+<code>
+"./Spear of Destiny (all missionpacks)" --data sd2
+</code>
+<WRAP center round tip>
+If you use whitespaces within the pathes or filenames, please use "quotes"! Before BATOCERA 42 avoid whitespaces and use scores or dashes.
+</WRAP>
+You can also try to load ''.pk3''-files direc within Emulationstation. Just copy the files next to your gameset. Remeber that this method allows only the loading of single files. The ''.ecwolf''-file method is the recommended way to use mods but needs some editing. The box down is the full help page, ecwolf offers. So you can also use your own config files for some special devices if needed for example.
+--> ecwolf --help page
+<code>
+[root@BATOCERA /etc/default]# ecwolf --help
+ReadConfig: Reading the Configuration.
+IWad: Selecting base game data.
+ECWolf 1.4.1 (<unknown version>)
+http://maniacsvault.net/ecwolf/
+Based on Wolf4SDL v1.7
+Ported by Chaos-Software (http://www.chaos-software.de.vu)
+Original Wolfenstein 3D by id Software
+Usage: ecwolf [options]
+Options:
+ --help                 This help page
+ --config <file>        Use an explicit location for the config file
+ --savedir <dir>        Use an explicit location for save games
+ --file <file>          Loads an extra data file
+ --data <extension>     Selects the given game data set skipping the dialog
+ --tedlevel <level>     Starts the game in the given level
+ --skill <#>            Sets the difficulty for tedlevel
+ --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
+ --fullscreen           Starts the game in fullscreen mode
+ --res <width> <height> Sets the screen resolution
+ --aspect <aspect>      Sets the aspect ratio.
+ --noadaptive           Disables adaptive tics.
+ --bits <b>             Sets the screen color depth
+                        (use this when you have palette/fading problems
+                        allowed: 8, 16, 24, 32, default: "best" depth)
+ --extravbls <vbls>     Sets a delay after each frame, which may help to
+                        reduce flickering (unit is currently 8 ms, default: 0)
+ --joystick <index>     Use the index-th joystick if available
+                        (-1 to disable joystick, default: 0)
+ --joystickhat <index>  Enables movement with the given coolie hat
+ --samplerate <rate>    Sets the sound sample rate (given in Hz, default: 44100)
+ --audiobuffer <size>   Sets the size of the audio buffer (-> sound latency)
+                        (given in bytes, default: 2048 / (44100 / samplerate))
+ --host <number>        Sets up a network game with the given number of players.
+ --join <address>       Joins a network game coordinated by the given host.
+ --port <number>        Port number to use for network communications.
+ --battle               Player vs. player battle
+ --debugnet             Enable network debugging messages.
+ --foreignsave          Disable save game validity checking.
+</code>
+<--
+==== Compatbility ====
+Supported:
+  * Wolfenstein 3D
+  * Spear of Destiny
+  * Spear of Destiny - Mission Pack 2 & 3
+  * Super Noah’s Ark 3D
+Mods:
+  * Super Noah’s Ark 3D
+  * Wolfenstein 3D + Spear of Destiny
+Unsuported (currently):
+  * Corridor 7- Alien Invasion
+  * Operation Body Count
 ===== Emulators =====
@@ Line 129: / Line 259: @@
 Here are the default ECWolf's controls shown on a [[:configure_a_controller|Batocera Retropad]]:
-{{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/ecwolf.png }}
+FIXME {{ https://raw.githubusercontent.com/batocera-linux/batocera-controller-overlays/master/solid-4k/ecwolf.png }}
 ===== Troubleshooting =====