Installing the game on Linux/uk: Difference between revisions

From Vintage Story Wiki
(Created page with "Встановлення гри на Linux")
 
(Created page with "Якщо у вас є якісь проблеми, то, спробуйте передивитися [https://www.vintagestory.at/forums/topic/520-linux-distrosconfigurations-under-which-vs-is-known-to-run/ цей тред] котрий може суттєво вам допомогти. Ви також можете розказувати про те як ви встановлювали гру у тому ж треді. Якщо тред вище вам не допомі...")
 
(56 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>
<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ви не хочете вручну встановлювати гру, то ось декілька неофіційних, але, зручних та простих опцій:
If you do not wish to perform a manual install, here are the options for unofficial, but easy and convenient install:
* [https://aur.archlinux.org/packages/vintagestory пакунок AUR] (для Arch Linux)
* An [https://aur.archlinux.org/packages/vintagestory AUR package] (for Arch Linux)
* [https://flathub.org/apps/at.vintagestory.VintageStory пакунок Flatpak] (для Fedora, Linux Mint, Manjaro, PopOS!, Red Hat, CentOS, elementary OS, SteamOS, тощо.) Якщо ви досі не маєте Flatpak то ви можете [https://flatpak.org/setup/ встановити його].
* A [https://flathub.org/apps/at.vintagestory.VintageStory Flatpak package] (for Fedora, Linux Mint, Manjaro, PopOS!, Red Hat, CentOS, elementary OS, SteamOS etc.) If not already installed, you can [https://flatpak.org/setup/ install Flatpak] itself as well.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ви встановили гру використовуючи будь-які з цих методів, ви можете запустити її натиснувши на <code>Vintage Story</code> в меню вашої операційної системи.
If you install the game using any of these methods, you can start it by clicking the <code>Vintage Story</code> menu entry in your desktop environment's application launcher.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
'''Дисклеймер:''' Пакунки, перераховані зверху підтримуються завдяки волонтерам. Anego Studios не несе відповідальності якщо гра не працює належним чином або взагалі не працює. У додаток, самі пакети не завжди оновлюються до останньої офіційної версії гри.
'''Disclaimer:''' Packages above are maintained by volunteers to the open-source community. Anego Studios can't held responsible if they don't work as intended or don't work at all. In addition, the game itself may not be always up to date with the latest stable version that's released officially.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
=Ручне встановлення=
=Manual installation=
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Клієнт Vintage Story працює завдяки трьом компонентам: .NET Runtime, OpenAL та OpenGL.
The Vintage Story game client relies on three main components: the .NET Runtime, OpenAL, and OpenGL. As of recent
На сьогодення
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Щоб вручну встановити гру, вам треба знати ''як відкрити термінал'', ''який менеджер пакунків використовує ваш дистрибутив Linux'', і, як користуватися ''командами <code>search</code>, <code>list</code> та <code>install</code> у вашому пакунковому менеджері''.
To perform a manual installation, you are expected to know ''how to open a terminal'', ''what package manager your Linux distribution uses'', and how to use ''your package manager's <code>search</code>, <code>list</code>, and <code>install</code> commands or command flags''.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Деякі більш популярні пакункові менеджери (<code>apt</code>, <code>dnf</code>, <code>yum</code>, та <code>apk</code>) мають доволі схожий формат команд, тож, приклади для <code>apt</code> можуть бути використані у більшості пакункових менеджерах. Звичайно є виключення, деякі пакункові менеджери можуть зовсім трохи відрізнятися, а інші - використовувати зовсім інший формат, як у випадку з <code>pacman</code> у Arch Linux.
Some common package managers (<code>apt</code>, <code>dnf</code>, <code>yum</code>, and <code>apk</code>) share a similar command format, so the following <code>apt</code> examples can be used by substituting <code>apt</code> with a near-equivalent command. Other package managers may stray slightly from the above four or use a completely different format, as is the case with <code>pacman</code> in Arch.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Встановлюємо .NET==
==Installing .NET==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Найлегший шлях встановки .NET Runtime у вашу систему, це використати вже існуючий пакунковий менеджер вашої операційної системи (див. приклад нижче). Ось назви цього пакунка у деяких популярних дистрибутивах:
The easiest way to install the .NET Runtime on your Linux system is to use a package available in your distribution's official package repository (see example below). Package names for some popular distributions are as follows:
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
[[File:InstallingDotnetApt.png|400px|thumb|floatright|alt=Зображення терміналу з пошуком та встановленням .NET 7.|Зображення терміналу Ubuntu Linux з пошуком та встановленням .NET 7 Runtime з використанням пакункового менеджера <code>apt</code>. Використані команди та бажанний результат виділені.]]
[[File:InstallingDotnetApt.png|400px|thumb|floatright|alt=A screenshot of a terminal searching for and installing .NET 7.|A screenshot of the process of searching for and installing the .NET 7 Runtime in Ubuntu with <code>apt</code>. The commands used and desired search results are highlighted.]]
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
* [https://pkgs.alpinelinux.org/packages?name=dotnet* Alpine Linux]: dotnet7-runtime
* [https://pkgs.alpinelinux.org/packages?name=dotnet* Alpine Linux]: dotnet7-runtime
* [https://archlinux.org/packages/?q=dotnet Arch Linux]: dotnet-runtime-7.0
* [https://archlinux.org/packages/?q=dotnet Arch Linux]: dotnet-runtime-7.0
Line 48: Line 28:
* [https://community.linuxmint.com/software/view/dotnet-runtime-7.0 Linux Mint]: dotnet-runtime-7.0
* [https://community.linuxmint.com/software/view/dotnet-runtime-7.0 Linux Mint]: dotnet-runtime-7.0
* [https://packages.ubuntu.com/search?keywords=dotnet Ubuntu]: dotnet-runtime-7.0
* [https://packages.ubuntu.com/search?keywords=dotnet Ubuntu]: dotnet-runtime-7.0
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ваш дистрибутив не зазначений у цьому списку, або, якщо ви хочете перепровірити чи встановили ви бажаний пакунок то введіть <code>dotnet.*runtime</code> або <code>dotnet runtime</code> у вашому менеджері пакунків та скопіюйте назву пакунку відповідного до 7 версії .NET у команду для інсталяції.
If your distribution isn't listed or if you want to check whether the package is installed, you can search for <code>dotnet.*runtime</code> or <code>dotnet runtime</code> in your package manager and copy the name for version 7 into an install command (see example below).
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Для досвідчених користувачів, Microsoft також пропонує [https://packages.microsoft.com/ офіційні репозиторії] для деяких дистрибутивів Linux, а також [https://learn.microsoft.com/en-us/dotnet/core/install/linux гайд на ручне або автоматичне встановлення] як альтернативу. Більш детальний опис доступний у [https://github.com/dotnet/core/blob/main/linux.md GitHub репозиторії dotnet].
For advanced users, Microsoft also offers [https://packages.microsoft.com/ official package repositories] for several Linux distributions and [https://learn.microsoft.com/en-us/dotnet/core/install/linux guides for manual or scripted installations] as alternatives. An overview of these options is available [https://github.com/dotnet/core/blob/main/linux.md on dotnet's GitHub].
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Ось наприклад, є декілька шляхів щоб знайти .NET Runtime в Ubuntu; Приклад використовує <code>grep</code>, який повільний, але, надає значно красивіший результат:<br>
As an example, these are two ways to search for the .NET Runtime with <code>apt</code> (in Ubuntu); the example using <code>grep</code> is slower but provides a cleaner output:<br>
Пошук з Grep: <code>sudo apt list | grep -E dotnet.*runtime</code><br>
Search with Grep: <code>sudo apt list | grep -E dotnet.*runtime</code><br>
Нормальний пошук: <code>sudo apt search dotnet.*runtime</code>
Normal Search: <code>sudo apt search dotnet.*runtime</code>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Коли ми знайдемо .NET Runtime (у цьому випадку, <code>dotnet-runtime-7.0</code>), ми можемо розпочати встановлення:<br>
Once the .NET Runtime's package name is found (in this case, <code>dotnet-runtime-7.0</code>), the package can be installed:<br>
Встановити: <code>sudo apt install dotnet-runtime-7.0</code><br>
Install: <code>sudo apt install dotnet-runtime-7.0</code><br>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ви вже раніше встановили .NET Runtime, то пошук у більшості випадків виведе вам на початку або прикінці текст '''<code>[Installed]</code>'''.
If it is already installed, the search list entry will have some text indicating so near the beginning or end of the line, usually '''<code>[Installed]</code>'''.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Встановлюємо OpenAL==
==Installing OpenAL==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
OpenAL це кросс-платформенна аудіо бібліотека, яка використовується для програвання звуків у Vintage Story. Нещодавні версії гри (починаючи з оновлення до .NET 7) включають у себе цю бібліотеку, тож ця секція може бути пропущена. Навіть з більш старішими версіями є можливість що OpenAL вже встановленний, або у систему, або як частина іншої гри або додатка.
OpenAL is a cross-platform audio library, needed to play game sounds in Vintage Story. Recent versions of the game (since the update to .NET 7) include the library, so this section may be skipped. Even with older versions however, OpenAL may already be installed, either by default as part of another game's or application's installation.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо у вас нема його до цього часу, OpenAL повинен бути у дистрибутиві вашого менеджера пакунків. Пошукайте <code>openal</code>, <code>libopenal</code>, <code>libopenal-dev</code> або будь що, що надає бібліотеку <code>libopenal.so</code>.
If you don't have it already, the OpenAL library should be present in your distribution's package repository. Search for <code>openal</code>, <code>libopenal</code>, <code>libopenal-dev</code> or anything that provides the required <code>libopenal.so</code> library.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Як приклад, для пошуку та встановлення OpenAL з <code>apt</code> можуть бути використані ці команди (Ubuntu Linux); використовуйте <code>grep</code> для отримання більш розширених результатів:<br>
As an example, searching for and installing OpenAL with <code>apt</code> might be done with these commands (in Ubuntu); prefer the <code>grep</code> variant here as there are many more extraneous results:<br>
Пошук з grep: <code>sudo apt list | grep openal</code>
Search: <code>sudo apt list | grep openal</code> OR <code>sudo apt search openal</code><br>
Звичайний пошук: <code>sudo apt search openal</code><br>
Install: <code>sudo apt install libopenal-dev</code>
Встановити: <code>sudo apt install libopenal-dev</code>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Встановлюємо графічні драйвера==
==Installing Graphics Drivers==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
OpenGL це бібліотека яка відповідає за 3D графіку у цій грі, проте, ця бібліотека не існує окремо, а встановлюєтся разом з драйверами. Якщо у вас є відеокарта, але, не маєте драйверів, то, пошукайте в інтернеті інструкції для вашого комп'ютера, дистрибутива Linux та пакункового менеджера. Цей процесс буде схожий на встановлення .NET, проте, може зайняти трохи більше часу, аби додати неофіційні репозиторії у ваш пакунковий менеджер.
OpenGL is the 3D graphics library the game uses, which needs to be supported by a graphics driver. If you have a graphics card (integrated or dedicated) but do not have drivers installed, you will need to search online for installation instructions for your specific hardware, Linux distribution, and package manager. The process will be similar to the installation of .NET above, but may include additional steps to add third-party repositories to your package manager.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Відеокарти NVIDIA використовують пакунки драйверів <code>nvidia</code>, а у той ж самий час відеокарти від Intel та AMD використовують пакунки драйверів <code>mesa</code>. Ви можете використовувати наступні команди аби перевірити чи є у вас встановленні дайвера mesa або nvidia (для Ubuntu):<br>
NVIDIA graphics cards can make use of <code>nvidia</code> driver packages, while Intel and AMD graphics will need to use <code>mesa</code> driver packages. You can use the following command to check if parts of the mesa or nvidia packages are installed (in Ubuntu):<br>
Пошук: <code>sudo apt list --installed | grep -E "mesa|nvidia"</code>
Search Installed: <code>sudo apt list --installed | grep -E "mesa|nvidia"</code>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Запуск гри==
==Launching the game==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ви виконали усі перелічені зверху пункти, то ви готові завантажити та запустити гру.
Once you have its dependencies installed, you're ready to download and run the game.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Увійдіть та знайдіть клієнт для Linux-а у [https://account.vintagestory.at/downloads клієнтській панелі]. Ви завантажите tarball (архів .tar.gz), і саму гру треба розпакувати з цього архіву. Більшість графічних оболочок дозволяють у розпакувати архів з контекстного меню, або, розпакувати архів з-за допомоги архіватора.
Sign in and find the client download for Linux in the Vintage Story website's [https://account.vintagestory.at/downloads 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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо жоден з варіантів вам не підходить, то, відкрийте командне середовище, та, перейдіть до теки робочого стола, потім, використайте команду <code>tar</code> аби розпакувати усі файли з архіва:<br>
If neither option is available, right click in empty space next to the archive to open a terminal in (or use the <code>cd</code> command to set the terminal's directory to) the directory containing the archive, then use the <code>tar</code> command to extract the contents of the archive:<br>
Змінити теку: <code>cd /home/pes_patron/Downloads</code><br>
Change Directory: <code>cd /home/myusername/Downloads</code><br>
Розпакувати архів: <code>tar -xvf ./vintagestory_tarball.tar.gz</code><br>
Extract Archive: <code>tar -xvf ./vintagestory_tarball.tar.gz</code><br>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Майте на увазі, що усі шляхи та файли чутливі до реєстру, але, ви можете натиснути на ТАВ щоб заповнити команду автоматичну.
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 <code>cd</code> command and archive name in the <code>tar</code> command with the location and filename of your download.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Коли ви нарешті розпакували усі файли у теку <code>vintagestory</code>, ви можете відкрити теку та натиснути два рази по <code>run.sh</code> або <code>Vintagestory</code> щоб відкрити гру, або, відкрийте командне середовище у цій ж теці та запустіть гру з-за допомоги наступних команд:<br>
Once the <code>vintagestory</code> directory has been fully extracted, you can enter it and double-click to execute the <code>run.sh</code> or <code>Vintagestory</code> files, or open a terminal in that directory (using the same process as above) and run one of them from the command line:<br>
Запустити гру: <code>./run.sh</code> або <code>./Vintagestory</code>
Run the Game: <code>./run.sh</code> OR <code>./Vintagestory</code>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Гра також містить скріпт <code>install.sh</code>, котрий придназначений для встановлення гри у <code>~/.local/share/vintagestory/</code> (до 1.19.2 <code>~/ApplicationData/vintagestory/</code>), створення ярлику на вашому робочому столі, додавання підтримки для moddb аби можна було встановлювати моди легше, та, підключення до серверів через посилання (<code>vintagestoryjoin://ip:port</code>). Проте, цей скріпт може не працювати з будь-ким, тож, якщо у вас цей скріпт не спрацював - спробуйте виконати усі пункти вручну або створити папку <code>~/.local/share/vintagestory/</code> перед тим як запускати скріпт (через можливу проблему з правами). Для більших деталей посилайтеся у тред форума нижче.
The game files also contain a script, <code>install.sh</code> that is intended to install the game in <code>~/.local/share/vintagestory/</code> (prior to 1.19.2 <code>~/ApplicationData/vintagestory/</code>) and create a shortcut on your desktop as well as add support for moddb 1 click install and connect via URL (<code>vintagestoryjoin://ip:port</code>). 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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Оновлення гри==
==Updating the game==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Щоб оновити гру, ви можете запустити <code>install.sh</code> з будь-якого місцезнаходження, цей скрипт перенесе застарілу інсталяцію гри у резервну теку, і після цього завантаже нові файли у стандартну теку гри, та, перезавантажить усі ярлики на робочому столі. В кінці, скрипт спитає у вас, чи хочете ви видалити стару інсталяцію.
To update the game you can run the <code>install.sh</code> 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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Ви можете також оновити гру розпакувавши гру з архіву встановленого з [vintagestory.at офіційного сайту Vintage Story]. Загалом, цей метод працює, але, було б непогано розпаковувати файли у '''пусту теку''', якщо можливо. Якщо це не є можливим з якойсь причини, тоді ми '''рекомендуємо''' що ви хочаб видалите усі під-теки з теки <code>/assets/</code> вашої минулої інсталяції Vintage Story. Якщо ви просто розпакуєте архів у папку з грою без видалення теки <code>/assets/</code>, то, деякі минулі файли залишаться, що, може у свою чергу призвести до деяких помилок - наприклад, застарілі блоки та/або предмети, подвоєні посібники у відповідній вкладці, тощо.
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 <code>/assets/</code> folder from your previous Vintage Story installation.   If you simply extract the archive into an existing game installation folder without deleting <code>/assets/</code>, 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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
(Щоб все зробити ще більш заплутанішим, деякі з завантажень розміром у 50 мегабайт мають у собі всі ігрові файли, окрім музики. У цьому випадку, вам не треба видаляти усю теку <code>/assets/</code>, тому що ви втратите усю музику яка вже була встановлена: замість цього видаліть усе у <code>/assets/</code> окрім під-тек code>/assets/game/music</code> та <code>/assets/survival/music</code> - їх не треба видаляти.)
(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 <code>/assets/</code> folder because you would lose the music you already have: instead delete everything in <code>/assets/</code> except for the subfolders <code>/assets/game/music</code> and <code>/assets/survival/music</code> - keep those subfolders.)
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ви використовуєте менеджер пакунків, то він може облегшити вам задачу у деяких випадках.
If you use a package manager, that may take care of some of this for you.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
=Усунення помилок=
=Troubleshooting=
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо у вас є якісь проблеми, то, спробуйте передивитися [https://www.vintagestory.at/forums/topic/520-linux-distrosconfigurations-under-which-vs-is-known-to-run/ цей тред] котрий може суттєво вам допомогти. Ви також можете розказувати про те як ви встановлювали гру у тому ж треді. Якщо тред вище вам не допоміг, то, спробуйте передивитися [https://www.vintagestory.at/forums/topic/10479-linux-beginner-guide-mesa_glthread-boost-your-performance-today/ тред про оптимізацію mesa_glthread], який може допомогти деяким гравцям.  
If you have any issues, the Forum thread on [https://www.vintagestory.at/forums/topic/520-linux-distrosconfigurations-under-which-vs-is-known-to-run/ working linux setups] might help you considerably. Please do share your own experiences there. You might also want to use the [https://www.vintagestory.at/forums/topic/10479-linux-beginner-guide-mesa_glthread-boost-your-performance-today/ mesa_glthread optimization], which works well for some players.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Помилка потоків GL==
==GL threading issues==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Велика кількість користувачів скаржилися на проблеми з грою з ввімкненою поточністю OpenGL.
However, many users have reported problems with the game with OpenGL threading enabled.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Поточна оптимізація OpenGL по замовчуванню ввімкнена у деяких версіях та може призводити до наступних проблем:
OpenGL threading optimization is enabled by default in some configurations and can lead to the following problems:
* Натискання не реєструються.
* Mouse cursor not registering clicks properly
* Неможливо змінити розмір вікна
* Inability to resize the game window
* Лаги, фрізи, тощо.
* Hanging, freezing, etc.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Щоб вимкнути потоковість OpenGL, вам треба буде створити перемінну середовища <code>mesa_glthread</code> й зробити її <code>false</code>. Ви можете дуже легко перевірити це, запустивши командне середовище, перейти у теку Vintage Story та запустити команду <code>mesa_glthread=false ./Vintagestory</code>. Якщо ви не хочете використувати команди, тоді пошукайте в інтернеті як зробити перемінну середовища постійною у Linux.
To disable OpenGL threading, you will need to create a <code>mesa_glthread</code> environment variable and set it to <code>false</code>. You can easily test it, by launching the command line, navigating to the directory where Vintage Story resides and running the <code>mesa_glthread=false ./Vintagestory</code> command. If you don't want to use the command, look up how to make Linux environment variables permanent and restart the system.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Якщо ви встановили гру через Flatpak, спробуйте запустити її з-за допомоги команди <code>flatpak run --env=mesa_glthread=false at.vintagestory.VintageStory vintagestory</code>. Ви можете зробити ці налаштування постійними написавши: <code>flatpak override --env=mesa_glthread=false at.vintagestory.VintageStory</code>
If you installed the game using Flatpak instead, try launching it with the command: <code>flatpak run --env=mesa_glthread=false at.vintagestory.VintageStory vintagestory</code>. You can make it permanent by typing: <code>flatpak override --env=mesa_glthread=false at.vintagestory.VintageStory</code>
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Запуск через sudo у перший раз==
==sudo for first time run==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Деякі гравці скаржилися на те, що їм треба запустити гру через sudo (<code>sudo ./Vintagestory</code>) на перший раз. Це може залежати від методу встановлення.
Some players have reported needing to run <code>sudo ./Vintagestory</code> to launch the game the first time: this may depend on how it was installed.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
==Графічні помилки==
==Graphical glitches==
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Деякі гравці скаржаться на графічні помилки, які залежать від дистрибутиву та встановлених драйверів. Vintage Story використовує велику кількість GLSL шейдерів для рендерингу ефектів, включаючи зміни кольорів у різних кліматах. Баги у GLSL втстановленим разом з драйверами відеокарти можуть провокувати деякі помилки у графіці. Є невеликий шанс що оновлення драйверів поліпше ситуацію. Загалом, налаштування графіки у грі надають гравцю контроль над купою ефектів, тож, спробуйте налаштувати ефекти відповідно до своїх проблем.
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.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
=Відео гайд=
=Video Walkthrough=
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
Відео як вручну встановлювати гру.
Manual installation walkthrough.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
<youtube>xvkO913BKv8</youtube>
<youtube>xvkO913BKv8</youtube>
</div>


{{Game navbox}}
{{Game navbox}}

Latest revision as of 14:32, 24 July 2024

Other languages:

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

Якщо ви встановили гру використовуючи будь-які з цих методів, ви можете запустити її натиснувши на 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 у вашу систему, це використати вже існуючий пакунковий менеджер вашої операційної системи (див. приклад нижче). Ось назви цього пакунка у деяких популярних дистрибутивах:

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

Якщо ваш дистрибутив не зазначений у цьому списку, або, якщо ви хочете перепровірити чи встановили ви бажаний пакунок то введіть 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"

Запуск гри

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

Увійдіть та знайдіть клієнт для Linux-а у клієнтській панелі. Ви завантажите tarball (архів .tar.gz), і саму гру треба розпакувати з цього архіву. Більшість графічних оболочок дозволяють у розпакувати архів з контекстного меню, або, розпакувати архів з-за допомоги архіватора.

Якщо жоден з варіантів вам не підходить, то, відкрийте командне середовище, та, перейдіть до теки робочого стола, потім, використайте команду tar аби розпакувати усі файли з архіва:
Змінити теку: cd /home/pes_patron/Downloads
Розпакувати архів: tar -xvf ./vintagestory_tarball.tar.gz

Майте на увазі, що усі шляхи та файли чутливі до реєстру, але, ви можете натиснути на ТАВ щоб заповнити команду автоматичну.

Коли ви нарешті розпакували усі файли у теку vintagestory, ви можете відкрити теку та натиснути два рази по run.sh або Vintagestory щоб відкрити гру, або, відкрийте командне середовище у цій ж теці та запустіть гру з-за допомоги наступних команд:
Запустити гру: ./run.sh або ./Vintagestory

Гра також містить скріпт install.sh, котрий придназначений для встановлення гри у ~/.local/share/vintagestory/ (до 1.19.2 ~/ApplicationData/vintagestory/), створення ярлику на вашому робочому столі, додавання підтримки для moddb аби можна було встановлювати моди легше, та, підключення до серверів через посилання (vintagestoryjoin://ip:port). Проте, цей скріпт може не працювати з будь-ким, тож, якщо у вас цей скріпт не спрацював - спробуйте виконати усі пункти вручну або створити папку ~/.local/share/vintagestory/ перед тим як запускати скріпт (через можливу проблему з правами). Для більших деталей посилайтеся у тред форума нижче.

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

Щоб оновити гру, ви можете запустити install.sh з будь-якого місцезнаходження, цей скрипт перенесе застарілу інсталяцію гри у резервну теку, і після цього завантаже нові файли у стандартну теку гри, та, перезавантажить усі ярлики на робочому столі. В кінці, скрипт спитає у вас, чи хочете ви видалити стару інсталяцію.

Ви можете також оновити гру розпакувавши гру з архіву встановленого з [vintagestory.at офіційного сайту Vintage Story]. Загалом, цей метод працює, але, було б непогано розпаковувати файли у пусту теку, якщо можливо. Якщо це не є можливим з якойсь причини, тоді ми рекомендуємо що ви хочаб видалите усі під-теки з теки /assets/ вашої минулої інсталяції Vintage Story. Якщо ви просто розпакуєте архів у папку з грою без видалення теки /assets/, то, деякі минулі файли залишаться, що, може у свою чергу призвести до деяких помилок - наприклад, застарілі блоки та/або предмети, подвоєні посібники у відповідній вкладці, тощо.

(Щоб все зробити ще більш заплутанішим, деякі з завантажень розміром у 50 мегабайт мають у собі всі ігрові файли, окрім музики. У цьому випадку, вам не треба видаляти усю теку /assets/, тому що ви втратите усю музику яка вже була встановлена: замість цього видаліть усе у /assets/ окрім під-тек code>/assets/game/music та /assets/survival/music - їх не треба видаляти.)

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

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

Якщо у вас є якісь проблеми, то, спробуйте передивитися цей тред котрий може суттєво вам допомогти. Ви також можете розказувати про те як ви встановлювали гру у тому ж треді. Якщо тред вище вам не допоміг, то, спробуйте передивитися тред про оптимізацію mesa_glthread, який може допомогти деяким гравцям.

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

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

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

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

Щоб вимкнути потоковість OpenGL, вам треба буде створити перемінну середовища mesa_glthread й зробити її false. Ви можете дуже легко перевірити це, запустивши командне середовище, перейти у теку Vintage Story та запустити команду mesa_glthread=false ./Vintagestory. Якщо ви не хочете використувати команди, тоді пошукайте в інтернеті як зробити перемінну середовища постійною у Linux.

Якщо ви встановили гру через Flatpak, спробуйте запустити її з-за допомоги команди flatpak run --env=mesa_glthread=false at.vintagestory.VintageStory vintagestory. Ви можете зробити ці налаштування постійними написавши: flatpak override --env=mesa_glthread=false at.vintagestory.VintageStory

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

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

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

Деякі гравці скаржаться на графічні помилки, які залежать від дистрибутиву та встановлених драйверів. Vintage Story використовує велику кількість GLSL шейдерів для рендерингу ефектів, включаючи зміни кольорів у різних кліматах. Баги у GLSL втстановленим разом з драйверами відеокарти можуть провокувати деякі помилки у графіці. Є невеликий шанс що оновлення драйверів поліпше ситуацію. Загалом, налаштування графіки у грі надають гравцю контроль над купою ефектів, тож, спробуйте налаштувати ефекти відповідно до своїх проблем.

Відео гайд

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


Навігація по вікі
Vintage Story Керівництва[[::Category:Guides| ]]Питання, що часто задаються (FAQ) Vintage Story Original Soundtrack Версії Управління
Ігрові механіки Крафт Оббивка Гончарство Металооброква Приготування Температура Голод Шахтарство Темпоральна стабільність Механізми Торгівля Фермерство Тваринництво
Світ Генерація світу Біоми Погода Темпоральні шторми
Предмети Інструменти Зброя Броня Одяг Сумки Матеріали Їжа
Блоки Ландшафт Рослини Декорації Світло Функціональні Руди
Істоти Агресивні істоти Тварини Неігрові персонажі Гравці
Miscellaneous List of client commands Перелік серверних команд Creative Starter Guide Bot System How_to_use_WorldEdit Cinematic Camera Adjustable FPS Video Recording ServerBlockTicking