Skip to content
UMO logo UMO Knowledge Base

Install on PC (Windows/Linux)

Requirement

Section titled “Requirement”

Installation

Section titled “Installation”
  1. Clone git the project or extract the release zip (If you extract the zip on a older installation, remove the Unity directory before doing so).
  2. Extract the game data dump UtaMacrossDataArchive.zip.
  3. Extract UtaMacrossDataArchivePCPatch.zip an copy the db directory into the data directory of the game datadump, so you have android and db directory like that :
    image
  4. For automatic game data detection, you can copy android and db directory from the game dump into the Tools/Data/ directory of the project. But don’t delete it when you update the version.
  5. Launch Unity Hub and add the Project : Open > Add Project From Disk. Browse to the Unity Directory.
    image
  6. Click on the Unity Project line which was added to launch the editor and load the project. Accept the upgrade version popup if it is displayed.
  7. Start the game using the menu UMO > Start Game.
    image
  8. The game will search game data in Tools/Data or Data directory (default directories when using python script to download from game server). If you put your game data elsewhere, select the directory containing “android” and “db” directories in the next popup. For advanced configuration, you can check the options.

PC specials options

Section titled “PC specials options”
Section titled “Menu UMO”
  • Start Game : Start the game.
  • Start Auto SLive Viewer : Start the game in automatic mode, randomply selecting songs and diva costumes.
  • Options : Open a window with UMO specific options
    • Profile
      • Force tuto skip : Unused actually
    • Live
      • Force Live Valkyrie Mode : Force going in valkyrie mode even if gauge is not filled
      • Force Live Diva Mode : Force going in standard diva mode
      • Force Live Awaken Diva Mode : Force going on awaken diva mode
      • Touch* : Select the key to use for each lane and the active skill button.
    • S-Live
      • Disable Movies : Disable playing movies
    • Data Directory : Local directory where game data was downloaded.
    • Data Web server URL : URL Where to download data (this require uploading the data somewhere accessible on a web server)
    • Debug : Debug options for dev.
  • Copy song setup for bug report : Allow to generate the song infos to help doing the report.
  • Create song notes data : Allow to generate a log of a song play to help doing a bug report when tapping note is broken.
  • (Linux user) Convert all movies. Allow to convert all movies at once.

Unity under linux troubleshooting

Section titled “Unity under linux troubleshooting”

If you try to run Unity under Ubuntu 24.04+, you’ll need to do this :

Fix Unity hub launch

Section titled “Fix Unity hub launch”

For this error :

Terminal window
[24264:0108/135404.052965:FATAL:content/browser/zygote_host/zygote_host_impl_linux.cc:132] No usable sandbox! If you are running on Ubuntu 23.10+ or another Linux distro that has disabled unprivileged user namespaces with AppArmor, see https://chromium.googlesource.com/chromium/src/+/main/docs/security/apparmor-userns-restrictions.md. Otherwise see https://chromium.googlesource.com/chromium/src/+/main/docs/linux/suid_sandbox_development.md for more information on developing with the (older) SUID sandbox. If you want to live dangerously and need an immediate workaround, you can try using --no-sandbox.

  1. Create a file /etc/apparmor.d/unityhub

    Terminal window
    sudo nano /etc/apparmor.d/unityhub

  2. Write in it :

    abi <abi/4.0>,
    include <tunables/global>
    profile unityhub /opt/unityhub/unityhub-bin flags=(unconfined) {
    userns,
    # Site-specific additions and overrides. See local/README for details.
    include if exists <local/unityhub>
    }

  3. Restart apparmor service

    Terminal window
    sudo systemctl restart apparmor.service

Fix Unity 2018 lauch

Section titled “Fix Unity 2018 lauch”

Unity will then throw an error on lauch :

Terminal window
Editor/Unity: error while loading shared libraries: libgconf-2.so.4: cannot open shared object file: No such file or directory

  1. Install manually libgconf :

    Terminal window
    wget http://kr.archive.ubuntu.com/ubuntu/pool/universe/g/gconf/libgconf-2-4_3.2.6-6ubuntu1_amd64.deb
    wget http://kr.archive.ubuntu.com/ubuntu/pool/universe/g/gconf/gconf2-common_3.2.6-6ubuntu1_all.deb
    sudo dpkg -i gconf2-common_3.2.6-6ubuntu1_all.deb
    sudo dpkg -i libgconf-2-4_3.2.6-6ubuntu1_amd64.deb