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.

II. Linux

Requirements for all distributions

All Linux Distros require an up-to-date Vulkan API.

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: sudo update-initramfs -u

Fedora: sudo dracut -v -f

Arch: sudo mkinitcpio -P

OpenSuse sudo mkinitrd

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 dirvers:
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: 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 3: 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 seemlessly after you log in to Discord.

Fedora

Discord has officially released a Discord package for Fedora. The tar.gz can be downloaded here:
https://discordapp.com/api/download?platform=linux&format=tar.gz
Once downloaded create a directory for Discord and unpack the tar.gz file. After unpacking you should be able to lauch Discord and if you like you can create a .desktop shortcut to launch it from the GUI.

OpenSUSE

As of this writing Discord does not have an official package for OpenSUSE, but don’t be discouraged. I am here to help you work around that particular issue.
The first thing we need to do is Install alien from home:XOF. Alien converts .deb files into .rpm files that can be easily ran on OpenSUSE.

Tumbleweed

Open your terminal and as root user enter the following commands in order:


Screenshot from 2021-01-19 20-54-16
Screenshot from 2021-01-19 20-54-24

Leap 42.1

Open your Terminal and as root user enter the following commands in order:


Screenshot from 2021-01-19 20-54-16
Screenshot from 2021-01-19 20-54-24

Installing on Either

Now that Alien is installed we can download the .deb file and get to installing. Download the discord .deb file from the Terminal as follows:


we can then convert it to .rpm by using alien by using this command.
Screenshot from 2021-01-19 21-03-40
We can then install Discord with a simple yast command:
Screenshot from 2021-01-19 21-04-40

OpenSuse Leap 15.2

Leap 15.2 can circumvent all of the extras and just download and install directly from:
https://software.opensuse.org/package/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 shouldnt be an issue.

OpenSuse

Unless you directly installed snap on OpenSuse this shouldn’t be an issue for you.

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)![Screenshot from 2021-01-19 20-54-16|132x18]