|Want to be an editor? Request an account by joining the Mizuumi Discord and follow the instructions in the welcome message.|
Eternal Fighter Zero/Linux Support
Although EFZ (and Revival) only supports Windows officially, it's possible to use Wine to play it on other operating systems, including full netplay support. The setup process for full compatibility is fairly complicated, so this page is here to provide a guide.
Some important notes before you start:
- Any recent version (4.0+) of Wine should work for basic play, so you can skip #Wine versions for now to get started, and revisit it later if needed.
- This guide is mostly adaptable to Mac as well, the only Linux-specific parts are #Building Wine and some of the tweaks in #Troubleshooting.
- 1 Introduction
- 2 Wine versions
- 3 Setting up EFZ
- 4 Troubleshooting
- 4.1 EFZ crashes on startup with a DirectDraw error
- 4.2 EFZ crashes on round start, menus work fine
- 4.3 EFZ doesn't respond to keyboard in fullscreen mode
- 4.4 "Sticky" keyboard inputs
- 4.5 Constant 100% CPU use
- 4.6 Visual stuttering
- 4.7 Stuttering when a lot of text is rendered (especially training mode)
- 4.8 Text is garbled in config.exe and pal_edit.exe
- 4.9 Ugly / inconsistent fonts with Revival
- 5 Example scripts
This guide assumes you are comfortable with using a terminal, have a basic understanding of environment variables and are already somewhat familiar with using and configuring Wine for your needs, including setting up custom wineprefixes to avoid causing issues for your other games. You'll need to be able to compile Wine yourself, though this guide has step-by-step instructions for 64-bit Ubuntu 18.04. If you use a different distribution, the steps are slightly different but should be adaptable.
In this tutorial, EFZ and the manually compiled Wine will be installed under under the directory
You may of course install it wherever you wish, but make sure to change the paths used accordingly.
New versions of Wine bring many improvements, but occasionally they come with regressions as well. One regression that causes netplay desynchronization with EFZ Revival was introduced in Wine 1.7.55, and is still present in newer versions (4.2 is the newest version at the time of writing this). It's therefore recommended to stick with a known working version for EFZ, rather than using the one supplied by your distribution. The best options are:
- Wine 4.0 with a custom patch
- Wine 1.7.54 (not recommended due to text rendering issues)
This guide will help you set up Wine 4.0, which requires you to compile it yourself. If you'd rather use an older version to avoid compiling, you can use eg. PlayOnLinux to download and install it.
- Note that if you're only intending to play locally, any recent version should work and this step can be skipped, or done later if you wish to start playing online.
There is a detailed guide to compiling Wine on Ubuntu on the WineHQ wiki. However, since you won't need this build for anything besides EFZ and we don't need 64-bit support for that, things are a bit simpler. We also don't want to install it system-wide as is described there, because our patch could cause issues for other games.
First of all, you need to install Wine's runtime dependencies. This is most easily done by installing Wine from your distribution's repository if you haven't already done so.
sudo apt install wine-stable
Setting up LXC
Compiling 32-bit Wine on 64-bit Ubuntu is complicated. We'll use LXC to create a 32-bit container to build it in. If you're actually using a 32-bit Ubuntu installation, you can skip LXC and compile it natively.
First you need to install LXC and the relevant templates.
sudo apt install lxc lxctl lxc-templates
Next, set up the LXC container and bind your home directory so you can access the existing files.
sudo lxc-create -t ubuntu -n winebuildbox -- --bindhome $LOGNAME -a i386 sudo cp -R /etc/apt /var/lib/lxc/winebuildbox/rootfs/etc sudo lxc-start -n winebuildbox sudo lxc-attach -n winebuildbox
You should now have a root terminal in the new container. Make sure the hostname is winebuildbox (the prompt says eg. root@winebuildbox:~# )
Wine build dependencies
Next, edit the apt lists to include source repositories using nano for example. Since the container is very minimal, you'll need to install nano first.
apt update apt install nano nano /etc/apt/sources.list
Below the lines starting with deb, uncomment the corresponding lines with deb-src (remove the preceding #). You can ignore pairs where both deb and deb-src are commented out.
Now you can install the Wine build dependencies. Remember to run apt update again after editing the lists.
apt update apt build-dep wine
Finally, we want to perform the compilation with our usual user account, not root.
Keep this terminal open for later.
Download the Wine 4.0 sources and extract them to ~/EFZ/winebuild/ or where you think is most convenient. Now navigate to the source directory and open up the file dlls/dinput/dinput_main.c, then find the function check_dinput_events(void) and within it, delete the line starting with MsgWaitForMultipleObjectsEx, which should leave the function empty besides the big comment block. Save the file. Now use the LXC container terminal to navigate into the source directory, and type in the following as your normal user, not root:
./configure --prefix="$HOME/EFZ/wine" make && make install
Make sure you include the --prefix parameter to have Wine installed into our EFZ directory. The compilation will take a long time.
You should now have a full installation of Wine in ~/EFZ/wine.
Shut down the LXC container. In the container terminal window, type in as root:
If you don't plan to recompile Wine in the future, you can also destroy the whole container.
sudo lxc-destroy winebuildbox
Feel free to also delete the Wine sources in ~/EFZ/winebuild now, if you wish.
Setting up EFZ
First of all, you need to create the wineprefix. Open a terminal in our EFZ directory, and type in
export WINEPREFIX="$HOME/EFZ/prefix" wine/bin/wineboot
Wine might complain about missing Mono and Gecko packages, these are safe to ignore. Now, copy an existing EFZ installation over to the new wineprefix, for example into ~/EFZ/prefix/drive_c/EFZ, and extract EFZ Revival on top of it like you would on Windows.
Open up winecfg with
and choose Add application, then find and select efz.exe. Now highlight efz.exe in the Applications tab, move over to Libraries and add in the libraries ddraw and d3dx9_43 (ddraw is not in the dropdown list but you can type it in, Wine will warn you about it but it's ok to ignore the warning). EFZ Revival supplies the custom ddraw.dll, but you need to acquire d3dx9_43.dll manually from Microsoft (DirectX End-User Runtimes June 2010). Use cabextract (install with Apt if needed) to extract this .exe rather than running it, and then again on the resulting Jun2010_d3dx9_43_x86.cab to get to the required DLL. Place it in the game's installation folder.
- Note: Newest versions of Wine (4.12.1 tested) can now handle the text rendering without native d3dx9_43.dll. It's also possible to use D9VK instead of Wine's DirectX9 implementation if you have a Vulkan-capable graphics card, however, it's not stable and has some other issues, so it's not recommended at this time. Additionally, if you are using a beta version of Revival with extended features, these will not work without native d3dx9_43.dll.
By now you should have a fully working EFZ installation. Edit your EfzRevival.ini, set up your buttons with config.exe like you would on Windows and try it out. You can use
to make opening different executables a bit simpler.
- Important: EfzRevival.ini is an UTF-16 little-endian encoded text file. Some of the simplest text editors might not be able to open it, while some others might silently save it as UTF-8 and make it unreadable for Revival. Make sure you save it with the correct encoding, and if you have issues use a text editor such as Kate, Geany, Notepadqq or Vim. Wine's notepad.exe should also work.
If you've followed the guide so far, the game should be playable but there might be some issues.
EFZ crashes on startup with a DirectDraw error
Most likely a driver issue. This is known to happen on some very old Nvidia cards, using the free Nouveau driver, as well as some virtual graphics controllers of VirtualBox and such. You could force software rendering with the environment variable LIBGL_ALWAYS_SOFTWARE=1 to see if it starts up, though this is likely to be too slow to play. If it does work, consider using Nvidia's official drivers if possible, or getting a new graphics card. Note that Revival wraps the original DirectX 7 calls to DirectX 9, so hardware that can run vanilla EFZ might not be able to run it with Revival. Your GPU should be able to support at least OpenGL 2.1 to avoid issues (if in doubt, use glxinfo from the mesa-utils package in Ubuntu to find out what is supported: glxinfo | grep "OpenGL version string")
May be caused by driver incompatibilities (using OpenGL core profile with a version that doesn't play well with d3dx9_43, which is used by revival to render text). As a workaround you need to edit the registry of your wineprefix; with regedit, add a DWORD "MaxVersionGL" = 0x00030000 in HKEY_CURRENT_USER\Software\Wine\Direct3D (create the Direct3D key first if needed)
EFZ doesn't respond to keyboard in fullscreen mode
This issue seems to happen sometimes with Gnome (or Gnome-based desktops). The simplest solution is to just avoid using fullscreen and instead setting a sufficiently large window size in EfzRevival.ini. You can also fix it by disabling Allow the window manager to control the windows in winecfg, under the Graphics tab, but this will make the window of EfzRevival.exe unresponsive if started in Wine's command prompt (for example, when opened from Wine's explorer or launched with wine start efzrevival.exe).
"Sticky" keyboard inputs
This is especially apparent when pressing esc, for example when pressing it in character select screen quits the game. Caused by Fcitx, or maybe some other input method framework. As a workaround, you should
before launching the game (add this in your launch script if you're using one).
Constant 100% CPU use
Disable CSMT for your wineprefix using Wine's regedit, in HKEY_CURRENT_USER\Software\Wine\Direct3D (create the Direct3D key first if needed) add DWORD csmt = 0x0
EFZ runs at 64FPS, which can cause issues if you're using desktop compositing or otherwise forcing vsync. It's highly recommended to disable all compositing effects if possible, and additionally make sure vsync is off. You can use the environment variable vblank_mode=0 with Mesa-based drivers for that.
Stuttering when a lot of text is rendered (especially training mode)
The text rendering done by Revival is surprisingly taxing on your system. On a very old PC this might mean that it's simply not powerful enough, even though the game runs fine otherwise. If you have a new CPU however (especially modern Intel CPUs), this could be caused by an aggressive power saving policy. You can check this with the cpupower tool (on Ubuntu, install packages linux-tools-common and linux-tools-generic), using the command
Check the output for current policy, if it says the current governor is powersave, especially with the intel_pstate driver, you should change this. The list of available governors should be shown above this section (usually at least performance and powersave are available). You will need root privileges to change this, so use
sudo cpupower frequency-set -g performance
to change the performance policy.
- Note: This change does not persist between reboots.
- Note2: There are a lot of tools for managing the performance policy, including GUI applications and extensions for Gnome, KDE Plasma etc. You can also use GameMode to apply tweaks only when playing EFZ (or other games) and return to powersave mode when you're finished, which could be helpful especially on a laptop when you wish to save battery.
Text is garbled in config.exe and pal_edit.exe
Just like in Windows, you need to run these executables with Japanese locale to avoid garbled text. Look up how to install Japanese language support for your distribution, then use the environment variable LANG=ja_JP.UTF-8 when launching these.
Ugly / inconsistent fonts with Revival
If the training mode text doesn't align properly, or the player names look off in netplay, you need to add a font replacement to the registry (and install a fitting font if you don't have any). EFZ Revival is made to use MS Gothic, so a similar font is preferred, such as IPA Gothic. In Ubuntu, this font is found in the fonts-ipafont package. After installing the font, using Wine regedit, add "MS Gothic"="IPAGothic" and "ＭＳゴシック"="IPAGothic" in HKEY_CURRENT_USER\Software\Wine\Fonts\Replacements.
- Note: if you have MS Gothic installed and want to use it, you can add "ＭＳゴシック"="MS Gothic" instead.
You might end up with a lot of different environment variables you need to use, so making a launcher script for EFZ might be wise. Here's an example efzrev.sh to be placed in our base EFZ directory:
#!/bin/sh export WINEPREFIX="$(pwd)/prefix" export WINEDEBUG="-all" export vblank_mode="0" unset XMODIFIERS cd prefix/drive_c/EFZ ../../../wine/bin/wine start "EfzRevival.exe"
- Using $(pwd) for the prefix makes it possible to move your whole EFZ setup around, prefix and Wine and all, without any issues.
To make config.exe display text correctly, you need to use Japanese locale. Here's an example script (you can also adapt it for pal_edit):
#!/bin/sh export WINEPREFIX="$(pwd)/prefix" export WINEDEBUG="-all" export LANG="ja_JP.UTF-8" cd prefix/drive_c/EFZ ../../../wine/bin/wine start "config.exe"