Встановлення гри на Linux

Якщо ви не хочете вручну встановлювати гру, то ось декілька неофіційних, але, зручних та простих опцій:

• пакунок AUR (для Arch Linux)
• пакунок Flatpak (для Fedora, Linux Mint, Manjaro, PopOS!, Red Hat, CentOS, elementary OS, SteamOS, тощо.) Якщо ви досі не маєте Flatpak то ви можете встановити його.

Якщо ви встановили гру використовуючи будь-які з цих методів, ви можете запустити її натиснувши на Vintage Story в меню вашої операційної системи.

Дисклеймер: Пакунки, перераховані зверху підтримуються завдяки волонтерам. Anego Studios не несе відповідальності якщо гра не працює належним чином або взагалі не працює. У додаток, самі пакети не завжди оновлюються до останньої офіційної версії гри.

Ручне встановлення

Клієнт Vintage Story працює завдяки трьом компонентам: .NET Runtime, OpenAL та OpenGL. На сьогодення

Щоб вручну встановити гру, вам треба знати як відкрити термінал, який менеджер пакунків використовує ваш дистрибутив Linux, і, як користуватися командами search, list та install у вашому пакунковому менеджері.

Деякі більш популярні пакункові менеджери (apt, dnf, yum, та apk) мають доволі схожий формат команд, тож, приклади для apt можуть бути використані у більшості пакункових менеджерах. Звичайно є виключення, деякі пакункові менеджери можуть зовсім трохи відрізнятися, а інші - використовувати зовсім інший формат, як у випадку з pacman у Arch Linux.

Встановлюємо .NET

Найлегший шлях встановки .NET Runtime у вашу систему, це використати вже існуючий пакунковий менеджер вашої операційної системи (див. приклад нижче). Ось назви цього пакунка у деяких популярних дистрибутивах:

Зображення терміналу Ubuntu Linux з пошуком та встановленням .NET 7 Runtime з використанням пакункового менеджера apt. Використані команди та бажанний результат виділені.

• Alpine Linux: dotnet7-runtime
• Arch Linux: dotnet-runtime-7.0
• Fedora: dotnet-runtime-7.0
• Linux Mint: dotnet-runtime-7.0
• Ubuntu: dotnet-runtime-7.0

Якщо ваш дистрибутив не зазначений у цьому списку, або, якщо ви хочете перепровірити чи встановили ви бажаний пакунок то введіть dotnet.*runtime або dotnet runtime у вашому менеджері пакунків та скопіюйте назву пакунку відповідного до 7 версії .NET у команду для інсталяції.

Для досвідчених користувачів, Microsoft також пропонує офіційні репозиторії для деяких дистрибутивів Linux, а також гайд на ручне або автоматичне встановлення як альтернативу. Більш детальний опис доступний у GitHub репозиторії dotnet.

Ось наприклад, є декілька шляхів щоб знайти .NET Runtime в Ubuntu; Приклад використовує grep, який повільний, але, надає значно красивіший результат:
Пошук з Grep: sudo apt list | grep -E dotnet.*runtime
Нормальний пошук: sudo apt search dotnet.*runtime

Коли ми знайдемо .NET Runtime (у цьому випадку, dotnet-runtime-7.0), ми можемо розпочати встановлення:
Встановити: sudo apt install dotnet-runtime-7.0

Якщо ви вже раніше встановили .NET Runtime, то пошук у більшості випадків виведе вам на початку або прикінці текст [Installed].

Встановлюємо OpenAL

OpenAL це кросс-платформенна аудіо бібліотека, яка використовується для програвання звуків у Vintage Story. Нещодавні версії гри (починаючи з оновлення до .NET 7) включають у себе цю бібліотеку, тож ця секція може бути пропущена. Навіть з більш старішими версіями є можливість що OpenAL вже встановленний, або у систему, або як частина іншої гри або додатка.

Якщо у вас нема його до цього часу, OpenAL повинен бути у дистрибутиві вашого менеджера пакунків. Пошукайте openal, libopenal, libopenal-dev або будь що, що надає бібліотеку libopenal.so.

Як приклад, для пошуку та встановлення OpenAL з apt можуть бути використані ці команди (Ubuntu Linux); використовуйте grep для отримання більш розширених результатів:
Пошук з grep: sudo apt list | grep openal Звичайний пошук: sudo apt search openal
Встановити: sudo apt install libopenal-dev

Встановлюємо графічні драйвера

OpenGL це бібліотека яка відповідає за 3D графіку у цій грі, проте, ця бібліотека не існує окремо, а встановлюєтся разом з драйверами. Якщо у вас є відеокарта, але, не маєте драйверів, то, пошукайте в інтернеті інструкції для вашого комп'ютера, дистрибутива Linux та пакункового менеджера. Цей процесс буде схожий на встановлення .NET, проте, може зайняти трохи більше часу, аби додати неофіційні репозиторії у ваш пакунковий менеджер.

Відеокарти NVIDIA використовують пакунки драйверів nvidia, а у той ж самий час відеокарти від Intel та AMD використовують пакунки драйверів mesa. Ви можете використовувати наступні команди аби перевірити чи є у вас встановленні дайвера mesa або nvidia (для Ubuntu):
Пошук: sudo apt list --installed | grep -E "mesa|nvidia"

Запуск гри

Якщо ви виконали усі перелічені зверху пункти, то ви готові завантажити та запустити гру.

Sign in and find the client download for Linux in the Vintage Story website's client area. The Linux download is a tarball (.tar.gz archive) that will need to be extracted. Most desktop environments will allow you to right click the archive and extract it from the context menu, or double-click it to open an archive viewer with an "Extract" option.

If neither option is available, right click in empty space next to the archive to open a terminal in (or use the cd command to set the terminal's directory to) the directory containing the archive, then use the tar command to extract the contents of the archive:
Change Directory: cd /home/myusername/Downloads
Extract Archive: tar -xvf ./vintagestory_tarball.tar.gz

Be aware that path and file names are case-sensitive, but you can press TAB while typing to auto-complete them. Make sure to substitute the directory in the cd command and archive name in the tar command with the location and filename of your download.

Once the vintagestory directory has been fully extracted, you can enter it and double-click to execute the run.sh or Vintagestory files, or open a terminal in that directory (using the same process as above) and run one of them from the command line:
Run the Game: ./run.sh OR ./Vintagestory

The game files also contain a script, install.sh that is intended to install the game in ~/.local/share/vintagestory/ (prior to 1.19.2 ~/ApplicationData/vintagestory/) and create a shortcut on your desktop as well as add support for moddb 1 click install and connect via URL (vintagestoryjoin://ip:port). This install script may not work for everyone, so you may need to take these steps manually or create the target install folder before running the script (there may be a permissions issue?). For more details please refer to the Forum thread linked below.

Оновлення гри

To update the game you can run the install.sh from any location, it will move the old installation to a backup location and after that move the new files to the default installation directory and reinstall the desktop entries. At the end, it will ask you if you want to delete the old installation files.

You can also update the game by extracting game binary files from the tar.gz downloaded from vintagestory.at. That should work fine, except that it is a good idea to extract those files into an empty folder where possible. If that is not possible for some reason, then we strongly recommend that you at least delete the /assets/ folder from your previous Vintage Story installation. If you simply extract the archive into an existing game installation folder without deleting /assets/, some previous asset files will remain, leading to minor issues - e.g. unintended blocks or items in the game, duplicated guides in the Handbook Guides tab.

(To make things more complicated, some of the downloads with sizes around 50MB contain all the game files except for music. In that case, you shouldn't delete the whole of the /assets/ folder because you would lose the music you already have: instead delete everything in /assets/ except for the subfolders /assets/game/music and /assets/survival/music - keep those subfolders.)

Якщо ви використовуєте менеджер пакунків, то він може облегшити вам задачу у деяких випадках.

Усунення помилок

If you have any issues, the Forum thread on working linux setups might help you considerably. Please do share your own experiences there. You might also want to use the mesa_glthread optimization, which works well for some players.

Помилка потоків GL

Велика кількість користувачів скаржилися на проблеми з грою з ввімкненою поточністю OpenGL.

Поточна оптимізація OpenGL по замовчуванню ввімкнена у деяких версіях та може призводити до наступних проблем:

• Натискання не реєструються.
• Неможливо змінити розмір вікна
• Лаги, фрізи, тощо.

To disable OpenGL threading, you will need to create a mesa_glthread environment variable and set it to false. You can easily test it, by launching the command line, navigating to the directory where Vintage Story resides and running the mesa_glthread=false ./Vintagestory command. If you don't want to use the command, look up how to make Linux environment variables permanent and restart the system.

If you installed the game using Flatpak instead, try launching it with the command: flatpak run --env=mesa_glthread=false at.vintagestory.VintageStory vintagestory. You can make it permanent by typing: flatpak override --env=mesa_glthread=false at.vintagestory.VintageStory

Запуск через sudo у перший раз

Деякі гравці скаржилися на те, що їм треба запустити гру через sudo (sudo ./Vintagestory) на перший раз. Це може залежати від методу встановлення.

Графічні помилки

Some people report minor graphical issues which are platform and driver dependent. Vintage Story makes use of a large variety of GLSL shaders for its rendering effects including commonplace elements such as grass and leaf colors in different climates. Bugs in the GPU driver's implementation of GLSL may cause artifacts with some of these. There's a chance a driver update might improve the situation. The in-game Graphics settings give high level control over many of the effects, you can try different settings.

Відео гайд

Відео як вручну встановлювати гру.