Installation and Troubleshooting Guide

I. Windows

A. Installation

Method 1:

  1. The easiest way to install the game is through the Windows installer found here: Release Latest · duelists-unite/omega-releases · GitHub
  2. The game is portable so it means you can move the installation directory and it will still work.
  3. The installer opens the “Omegaupdater.exe” which downloads the game and all the updates. In addition, it checks for any other issues like lack of .NET updates or firewall exceptions.
  4. The folder in which YGO Omega is installed in, has to be writable or the omegaupdater will fail.

Method 2:

  1. Download the Omega Launcher.zip.
  2. Unzip it to any directory in a location that has write permissions.
  3. Run the omegaupdater.exe.
  4. This will download the entire game. If the omegaupdater fails, you will see an update.zip in the folder. This means it couldn’t extract the update.zip because the folder doesn’t have permissions.
  5. You can either right-click on the folder->properites->untick Read-only OR you can just use Method 1.

B. Troubleshooting

Case 1:

The most common case is that you run the omegaupdater and it is successfully able to download the update.zip but does not have permissions to extract and overwrite the files in the folder. This is because the folder is not writable.

To fix this, move the folder to the desktop or right-click → properties and untick the read only. Then press ok and re-run the omegaupdater.

If this still doesn’t work, then you should try the Windows Installer from the github link above.

Case 2:

You are on Windows 7 or 8. In this case, your OS is lacking updates which are required to execute the updater. The updater needs all the latest .NET updates but Microsoft no longer supports Windows 7 or 8 so you can no longer get automatic updates.

Upgrading to Windows 10 is free and increases the performance overall of the entire pc. You don’t lose any files by upgrading.

You can download the Windows10Upgrade program from Microsoft here: https://go.microsoft.com/fwlink/?LinkID=799445

Case 3:

You get a black screen when opening the game. This is because your system doesn’t have the proper codecs to play video backgrounds. There’s two options and I suggest the first.

  1. You download the codec so you can use animated backgrounds from:
    Download K-Lite Codec Pack Full

This will install all the necessary required codecs.

  1. You can open command prompt. Navigate to the folder where the YGO Omega folder is. Then type "YGO Omega.exe" --reset

This will just reset it to static backgrounds.

Case 4

If your game is freezing, it’s because you are using windowed mode. It’s an inherent issue with Windows / Unity. A fix will come but the workaround is to use Windows 8 compatibility. Also disable the full screen optimizations.

Case 5

If your game launches and immediately gets stuck on the background picture without downloading any bundles, it’s possible that you have something that is blocking gitlab.com. This will show up in the player.log in %userprofile%\appdata\locallow\duelists unite\ygo omega as an error resolving gitlab. If you use a custom DNS server or something like a Pi-Hole, you may need to make sure that gitlab is whitelisted or at least not on the blacklist and that you can access gitlab.com from your browser. Once you allow gitlab, restart YGO Omega and it should start downloading bundles.

II. Linux

Requirements for all distributions

All Linux Distros require an up-to-date Vulkan API. In addition some Distros require Sqlite3 development packages

Debian/Ubuntu: sudo apt install libsqlite3-dev

Fedora: sudo dnf install sqlite-devel

Arch currently does not have to worry about this

A. Installation on Linux

  1. The easiest and best way to install the game is through the Linux installer found here:

https://github.com/duelists-unite/omega-releases/releases/download/Latest/Omega_Launcher-Linux.zip
2. Make a directory in which to install YGO Omega into. This can be done by making a new folder in the Desktop interface or by mkdir in the terminal interface. (best practice is to name the folder something relatively simple I.E. ygomega)

  1. Extract the .zip into the file you had previously made. Be sure to make OmegaUpdater.x86_64 an executable file. (Right click → Properties → Permissions)

Screenshot from 2021-01-13 22-57-01

  1. Open the terminal, navigate to the same folder as OmegaUpdater.x86_64 and run:

./OmegaUpdater.x86_64 This will download the game for you on that same folder.

  1. After that is finished make the YGO Omega.x86_64 executable, this can be done by the right click method in the desktop or by opening the folder in the terminal and typing the command:
    chmod 755 -R.

When this is complete either run YGO\ Omega.x86_64 by a double click in the desktop or from the terminal by using this Bash command while in the YGOmega Folder:

./YGO\ Omega.x86_64

  1. You also need Discord installed and running to connect to the online servers. Make sure you install the version from their site https://discord.com/. No snap or flatpak, whose will not work. This is also covered in depth in “Discord for Linux”

B. Troubleshooting Linux

Case 1: My game does not start at all/ my game crashes as soon as it launches/ when I try to run the game from terminal it says Segmentation fault (Core Dumped) or something.

Screenshot from 2021-01-14 22-01-50

This is normally caused by improperly set up Vulkan drivers OR in case of AMD having the radeon kernel driver loaded instead of amdgpu.

How to check and fix kernel driver (AMD Only)

To check your kernel driver run lspci -nnk | grep -iA3 vga in terminal. (can be done with ctrl+alt+t)

if the result like the screen above shows radeon is in use but amdgpu is available do the following:


echo "blacklist radeon" | sudo tee --append /etc/modprobe.d/blacklist.conf

echo "options amdgpu si_support=1 cik_support=1" | sudo tee --append /etc/modprobe.d/amdgpu.conf

then depending on your distribution:

Debian/Ubuntu: sudo update-initramfs -u

Fedora: sudo dracut -v -f

Arch: sudo mkinitcpio -P

then reboot and rerun lspci -nnk | grep -iA3 vga to verify amdgpu is loaded.

If the above does not apply to you or the problem continues I will lay out the ways to set up various drivers, and if need the repositories, to ensure your Vulkan API is up to date.

Debian-based Distros

AMD

You will need to open the terminal (ctrl+alt+t) and enter this in the command line:
1

NVIDIA

Again you will need to enter these commands in the terminal
2

Ubuntu

AMD

On Ubuntu it is best to enable the repositories for AMD. Its actually a fairly simple command tree.
3

After you run these commands be sure to install the Vulkan drivers:
4

Nvidia

Nvidia is extremely simple as it has built in Vulkan Drivers and all we need to do is add the repository.
5

After the repository is downloaded be sure to add your drivers:

Fedora

AMD
Fedora comes out of the box with AMD drivers. If you need to do anything it would only be a simple update.
7

Nvidia
Nvida is going to be a repository add, but the good thing about repositories is they auto-update.

After you install the repository be sure to install the drivers.

Arch Linux

AMD
Arch has the latest AMD drivers out of the box on install. All you need to do is install Vulkan support.
Screenshot from 2021-01-15 04-30-14

Nvidia
All Nvidia owners need to do here is install the latest drivers. They include Vulkan support.
Screenshot from 2021-01-15 04-31-07

Is Vulkan working?

No matter your distro or your chosen installation method one thing remains important. Is Vulkan doing its job? There is a very simple command that is relatively the same across all distros to check and see if Vulkan is indeed doing its job.
Screenshot from 2021-01-15 04-36-00

if Vulkan is working you should get a reply similar to this, and yes it will be about 20 pages with less.

As long as you see some information then you know that Vulkan is working.

Case 2: 9999/9999 Decks Bug

Screenshot from 2021-04-28 22-32-51

This is caused by missing Sqlite3 dev pakages simply open a terminal install them as instructed above under Installation on Linux then reboot the system

Case 3: My game is stuck in a black screen and never shows the opening menu.

This happens from using animated backgrounds in a system where those are not supported. In case of Linux this is a flaw in Unity itself. For a quick fix run the game via terminal but add a ‘–reset’ parameter like this:
./YGO\ Omega.x86_64 --reset
This will revert your settings to default.

If you still want to use animated backgrounds in Linux you need to use specifically webm videos with VP8 codex. This type of videos use more cpu than the usual mp4, so try to use small videos around 5-10MB. Make sure you have a working video at the root of Backgrounds folder.

Case 4: I want to play Online, but my YGO Omega can not detect my Discord. (AKA Discord for Linux)

This is a very common occurrence with YGO Omega. YGO Omega will not detect Discord built from .snap files or flatpak files. It is best practice to remove these installations before installing a non sandbox version. Discord can be a bit tricky as it likes to install from .snap on its website if you are not paying close attention. First I will walk you through all the ways to install Discord from non snap files on most major Distros, then I will walk you through how to remove the snap version of Discord if you happen to be one of the unfortunate many who ended up with it.

Debian based Distros/Ubuntu

This can be done one of two ways. First we can go to Discord’s official website

https://discord.com/download

Once there you can easily download the deb file by picking it from options.
Screenshot from 2021-01-19 20-30-22

If you like a more terminal based approach you can download discord by performing the following command in the Terminal Interface.

Regardless of your chosen download preference both packages can be installed the same way. Open a terminal screen (Ctrl+Alt+T) and enter the following command:
Screenshot from 2021-01-19 20-37-27
Just replace /path/to/discord/ with the actual path to discord.deb
If all goes well, you should be able to link YGO Omega to your discord seamlessly after you log in to Discord.

Fedora
Discord can Installed on Fedora via RPM fusion same as the NVIDIA drivers

sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm

then

sudo dnf install discord

Arch Linux
To install discord from the terminal execute this simple command:
Screenshot from 2021-01-19 23-25-28

If simplicity is not your cup of tea follow the directions listed below:
First we will download Discord from the source as I do not like working things around in Arch Linux. We can do this by using curl. Open your terminal and perform the following command.


After Discord is downloaded the installation can be performed with the following command:
Screenshot from 2021-01-19 21-21-23
This command will make a directory and decompress all of discord files. You can run Discord from this file directly or if you so choose ( i hate looking through files every time I want to run a program) you can move it to the desktop by entering the following command:
Screenshot from 2021-01-19 21-20-45

After you log in to Discord, you can open YGO Omega, go online, and enjoy YGO Omega to the fullest.

How to remove Discord .Snap and Flatpak files.

Snap It Off (How to remove snap Discord)

Debian Based Distros/Ubuntu
First we need to find the snap (its normally just snap Discord, but I thought it better to show the whole process.)
Open the Terminal and follow these commands:
Screenshot from 2021-01-19 21-38-16
this will pull up a list of installed snap on your system. Locate the snap you wish to remove (in this case Discord) and enter the following command:
Screenshot from 2021-01-19 21-41-09

Arch Linux
Arch works much the same way as Ubuntu as far as snaps go.
Screenshot from 2021-01-19 21-38-16
will get you a list of all current snaps (again we only want the discord snap.)
then execute the following command to remove the snap:
Screenshot from 2021-01-19 21-45-19

Fedora
Fedora doesn’t natively use snaps so this shouldn’t be an issue.

How to remove Flatpaks

Flatpak is very simple to install and remove. I will not be going over flatpak installation of discord as flatpak discord does not work with YGO Omega. I will quickly go over how to remove flatpaks.
In order to remove a flatpak package, in this case Discord, open the terminal and execute the following command:
Screenshot from 2021-01-19 22-01-21
This will remove the discord flatpak.

III. Macintosh (Coming Soon)

IV. Android (Later)

V. iOS (Later)!