Цей посібник допоможе встановити Vintage Story і запустити гру вперше. Тут ви знайдете інструкції із завантаження гри з особистого кабінету, вибору потрібної версії .NET та встановлення на Windows, Linux, macOS і Steam Deck.
Щоб Vintage Story запустилася, потрібна сумісна версія Runtime. Номер версії однаковий для Windows, Linux і macOS. На Windows потрібен Desktop Runtime, на Linux і macOS — звичайний Runtime. На Mac із процесором Apple Silicon потрібно завантажити збірку macOS x64, яка працює через Rosetta. Версії гри 1.22.x і новіші потребують .NET 10, версія 1.21.x — .NET 8, а версії 1.20.x–1.18.8 — .NET 7. Версії 1.18.7 і старіші використовують .NET Framework 4 або Mono.
Примітка: Актуальна версія інсталятора гри на Windows автоматично завантажує потрібну версію .NET Desktop Runtime.
Завантажити потрібну версію можна на сайті Microsoft: .NET 10, .NET 8 або .NET 7. Щоб перевірити, які версії Runtime вже встановлено, виконайте в терміналі команду:
dotnet --list-runtimesУ Windows знайдіть у списку рядок Microsoft.WindowsDesktop.App із потрібним номером версії: 10, 8 або 7. У Linux і macOS перевірте номер версії в рядку Microsoft.NETCore.App.
Де завантажити гру
Завантажити Vintage Story можна з особистого кабінету на сторінці account.vintagestory.at/downloads. Для входу потрібен обліковий запис із придбаною ліцензією на гру. Під час першого запуску Vintage Story попросить ввести ті самі логін і пароль, тому знадобиться підключення до інтернету.
Інструкцію про те, як отримати ліцензійний ключ і зареєструвати обліковий запис, наведено в окремому посібнику: https://vintagestory.info/uk/play/
Якщо ви встановлюєте гру на Windows уперше, виберіть Full Installer. Якщо Vintage Story вже встановлено й ви використовуєте версію 1.18 або новішу, для оновлення можна скористатися кнопкою Update. Для Linux завантажте архів, назва якого починається з vs_client_linux-x64. Для macOS потрібен файл Mac OS App.
Windows
Браузер може попередити про завантаження інсталятора. Це звичайна позначка невідомого видавця, а не ознака вірусу. Натисніть «Докладніше», а потім «Усе одно запустити». В актуальних інсталяторах для Windows .NET завантажується і встановлюється сам. Якщо гру ставили з архіву або ярлик нічого не робить, Desktop Runtime для Windows завантажують зі сторінки Microsoft.
Якщо інсталятор запропонує видалити попередню версію гри, можна погодитися. Світи та збереження зберігаються окремо від папки з грою, тому їх не буде видалено.
Linux
Встановлення через Flatpak
Пакет з офіційного сайту Vintage Story уже містить потрібний Runtime. Цей пакет випускає Anego Studios. Версію на Flathub також збирає ця команда, але оновлення там може з'явитися на кілька годин або навіть на день пізніше.
flatpak --user install https://flatpak.vintagestory.at/VintageStory.flatpakrefПісля встановлення Vintage Story з'явиться в меню програм. Якщо команда flatpak недоступна, спочатку встановіть Flatpak зі сховища вашого дистрибутива, а потім повторіть команду вище.
Встановлення з архіву
Щоб встановити гру з архіву, розпакуйте файл tar.gz і запустіть скрипт run.sh. Якщо завантажений архів має іншу назву, замініть назву файлу в команді на фактичну.
cd ~/Downloads
tar -xvf vs_client_linux-x64.tar.gz
cd vintagestory
./run.shУ разі встановлення з архіву Runtime потрібно встановити окремо через менеджер пакетів дистрибутива. В Ubuntu та похідних від неї системах для Vintage Story 1.22.x і новіших виконайте:
sudo apt install dotnet-runtime-10.0Для версії 1.21.x потрібен пакет dotnet-runtime-8.0, а для версій 1.20.x–1.18.8 — dotnet-runtime-7.0. В Alpine Linux відповідні пакети називаються dotnet10-runtime, dotnet8-runtime і dotnet7-runtime.
Зверніть увагу: для запуску клієнта, встановленого вручну з архіву, потрібна GLIBC версії 2.34 або новішої. Перевірити встановлену версію можна командою ldd --version.
Якщо потрібного пакета більше немає у сховищі, Runtime можна встановити безпосередньо в домашню теку за допомогою інсталяційного скрипту Microsoft. Для .NET 10 використовуйте канал 10.0, для .NET 8 — 8.0, а для .NET 7 — 7.0.
wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x ./dotnet-install.sh
./dotnet-install.sh --channel 10.0Далі додайте два наведені нижче рядки в кінець файлу ~/.bashrc. Якщо ви використовуєте оболонку zsh, додайте їх у ~/.zshrc. Після цього вийдіть із системи та увійдіть знову, щоб зміни набули чинності.
export DOTNET_ROOT=$HOME/.dotnet
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/toolsПісля повторного входу виконайте команду echo $DOTNET_ROOT. Вона має вивести шлях до теки $HOME/.dotnet.
Під час оновлення розпаковуйте нову версію гри в порожню теку. Якщо ви встановлюєте її поверх попередньої версії, спочатку видаліть теку assets. Інакше старі файли можуть залишитися, через що на вкладці з посібниками деякі сторінки відображатимуться двічі.
У файлі run.sh є рядок # export DRI_PRIME=1. Якщо комп'ютер має вбудовану графіку й окрему відеокарту, приберіть символ решітки на початку цього рядка, щоб увімкнути відповідне налаштування.
Якщо курсор натискає не на ті кнопки або вікно гри не вдається змінити за розміром, спробуйте запустити гру так:
mesa_glthread=false ./VintagestoryЩоб постійно застосовувати це налаштування для Flatpak, виконайте команду:
flatpak override --user --env=mesa_glthread=false at.vintagestory.VintageStorymacOS
Спочатку встановіть Runtime, потрібний для вашої версії гри. На Mac із процесором Apple Silicon використовуйте збірку x64, яка працює через Rosetta. Потім двічі клацніть архів Mac OS App, щоб розпакувати його. Отриману програму можна перенести до теки «Програми».
Щоб запустити гру вперше, утримуйте клавішу Command, клацніть програму та виберіть Open. Якщо з'явиться повторний запит, ще раз натисніть Open. Звичайне подвійне клацання на цьому етапі може запропонувати лише видалити файл або скасувати дію.
У macOS іноді з'являється повідомлення, що програму пошкоджено й потрібно перемістити її до кошика. Файл при цьому цілий: так спрацьовує карантин macOS. Зняти його можна через Термінал.
cd ~/Downloads/
sudo xattr -rd com.apple.quarantine "Vintage Story.app"Примітка: назва в лапках має точно збігатися з назвою програми після розпакування. У наведеній команді використано назву з поточної збірки.
Починаючи з версії 1.21, папка з даними гри розташована за шляхом ~/Library/Application Support/VintagestoryData. Якщо після оновлення світи зникли з меню, перевірте стару теку ~/.config/VintagestoryData — можливо, збереження залишилися там.
Steam Deck
На Steam Deck можна встановити той самий Linux-архів, що й на звичайному комп'ютері з Linux. Усі дії потрібно виконувати в режимі Desktop Mode. Щоб перейти до нього, натисніть кнопку живлення та виберіть Switch to Desktop. Повернутися до ігрового режиму можна за допомогою значка Return to Gaming Mode.
У Desktop Mode лівий курок працює як клацання лівою кнопкою миші, а правий — як клацання правою. Правий тачпад дає змогу рухати курсор, а комбінація Steam+X відкриває екранну клавіатуру.
Найпростіше встановити гру через офіційний Flatpak. Відкрийте Konsole та виконайте ту саму команду, що й у розділі Linux. Runtime уже входить до пакета й залишається доступним після оновлення SteamOS.
Також гру можна встановити через Discover. Знайдіть Vintage Story, у розділі Sources виберіть Flathub (user) і натисніть Install. Зверніть увагу: оновлення у Flathub може з'явитися трохи пізніше, ніж в офіційному пакеті.
Ручне встановлення стане в пригоді, якщо вам потрібна конкретна або тестова версія гри. Завантажте архів Linux tar.gz через Firefox, відкрийте його в Dolphin за допомогою Arc і розпакуйте в теку /home/deck/.local/share. У результаті має з'явитися папка гри /home/deck/.local/share/vintagestory.
SteamOS видаляє пакети .NET, установлені через pacman, під час оновлення системи. Тому для ручного встановлення краще розмістити Runtime в домашній теці за допомогою того самого скрипту, що й у Linux, вибравши канал відповідно до версії гри.
Ігровий режим Gaming Mode не використовує налаштування з файлу ~/.bashrc. Тому додайте два рядки з DOTNET_ROOT і PATH на початок файлу run.sh, одразу після рядка #!/bin/bash.
Не виходячи з Desktop Mode, відкрийте Steam і перейдіть до Library → Add a Game → Add a Non-Steam Game → Browse. Знайдіть файл run.sh у теці гри та додайте його до бібліотеки. Після повернення в Gaming Mode ви зможете запускати Vintage Story так само, як інші ігри в Steam.
У разі ручного встановлення світи зберігаються в теці /home/deck/.config/VintagestoryData. Якщо використовується Flatpak, вони розташовані тут: /home/deck/.var/app/at.vintagestory.VintageStory/config/VintagestoryData.
Докладні сторінки вікі: Installing the game on Windows, Installing the game on Linux, Installing the game on MacOS, Installing the game on Steam Deck.