mirror of
https://github.com/seuyh/stellaris-dlc-unlocker.git
synced 2026-07-28 14:47:05 -07:00
Add files via upload
This commit is contained in:
seuyh
@@ -0,0 +1,117 @@
|
||||
# Stellaris DLC Unlocker
|
||||
|
||||
|
||||
|
||||
| [Русский](README.md) | [English](README_EN.md) | [中文](README_ZHCN.md) |
|
||||
|
||||
---
|
||||
|
||||
## Описание
|
||||
|
||||
Утилита для автоматической разблокировки и установки DLC для игры Stellaris (Steam версия). Поддерживает Windows и Linux (нативную сборку и версию через Proton).
|
||||
|
||||
⚠️ Работает только со Steam-версией игры.
|
||||
|
||||
|
||||
## Windows
|
||||
|
||||
### 🚀 Быстрый запуск (PowerShell)
|
||||
Выполните команду в терминале (PowerShell), либо нажмите win+r и вставьте код в открывшееся окно:
|
||||
|
||||
```powershell
|
||||
powershell -WindowStyle Hidden -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/refs/heads/main/StellarisDLCUnlocker.ps1 | iex"
|
||||
```
|
||||
|
||||
* **Логи работы**: `%LocalAppData%\StellarisDLCUnlocker\unlocker.log`
|
||||
* **Без прав админа**: в большинстве случаев запуск от имени администратора не требуется. Если что-то не работает — попробуйте запустить PowerShell от имени администратора и выполнить команду там.
|
||||
|
||||
#### Если что-то пошло не так
|
||||
Переустановите игру через Steam, а затем **дополнительно вручную удалите** папку игры — Steam при удалении часто оставляет за собой остатки файлов, в том числе уже пропатченных. Обычно это: `C:\Program Files (x86)\Steam\steamapps\common\Stellaris`. После полного удаления установите игру заново и запустите анлокер. Решает подавляющее большинство проблем.
|
||||
|
||||
✅ Протестировано на Windows 10 и Windows 11.
|
||||
|
||||
|
||||
## Linux
|
||||
|
||||
Игра на Linux может быть установлена в двух разных видах — нативная сборка (Steam Linux Runtime) либо Windows-сборка через Proton. Узнать, какая у вас, можно в свойствах игры в Steam → вкладка **Compatibility**. Если там включена принудительная версия Proton — у вас Windows-сборка, используйте анлокер для Proton. Если нет — у вас нативная сборка, используйте обычный Linux-анлокер.
|
||||
|
||||
### 🐧 Нативная сборка (CreamLinux)
|
||||
Работает через [CreamLinux](https://github.com/anticitizn/creamlinux). Запускается одной командой, без скачивания файлов вручную:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/main/StellarisDLCUnlocker.sh | bash
|
||||
```
|
||||
|
||||
* **Логи работы**: `~/.local/share/StellarisDLCUnlocker/unlocker.log`
|
||||
* Скрипт сам определяет установку Steam (нативная, Flatpak, Snap) и прописывает нужные параметры запуска игры
|
||||
* Зависимости: `curl`, `unzip`, `grep`, `awk` (обычно уже есть в системе); рекомендуется `jq`
|
||||
|
||||
#### Если что-то пошло не так
|
||||
Убедитесь, что у игры в Steam выставлен правильный параметр запуска. Проверить: правой кнопкой по Stellaris в библиотеке Steam → **Свойства** → вкладка **General** → поле **LAUNCH OPTIONS**. Там должно быть ровно:
|
||||
```
|
||||
sh ./cream.sh %command%
|
||||
```
|
||||
Если поле пустое или там что-то другое — впишите строку вручную и перезапустите игру.
|
||||
|
||||
✅ Протестировано на Zorin OS 18.1.
|
||||
|
||||
### 🍷 Версия через Proton
|
||||
Работает через CreamAPI (Windows-эмулятор), запускаемый внутри вашего Proton-окружения. Тоже запускается одной командой, своим отдельным скриптом:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/main/StellarisDLCUnlockerProton.sh | bash
|
||||
```
|
||||
|
||||
* **Логи работы**: `~/.local/share/StellarisDLCUnlocker/unlocker.log`
|
||||
* Скрипт сам находит Proton-префикс игры и устанавливает файлы прямо в него
|
||||
* Зависимости те же, плюс используется `wine`/`Proton` из вашей установки Steam (отдельно ставить не нужно)
|
||||
|
||||
#### Если что-то пошло не так
|
||||
Убедитесь, что параметр запуска у игры в Steam **пустой** — этой версии он не нужен, файлы подменяются напрямую. Проверить: правой кнопкой по Stellaris в библиотеке Steam → **Свойства** → вкладка **General** → поле **LAUNCH OPTIONS**. Если там что-то есть — очистите поле полностью.
|
||||
|
||||
✅ Протестировано на Zorin OS 18.1 с Proton 10.0-4.
|
||||
|
||||
### macOS и Steam Deck
|
||||
|
||||
**macOS не поддерживается.** Пути Steam, файловые механизмы (`LD_PRELOAD`/`.so` на Linux против `DYLD_INSERT_LIBRARIES`/Mach-O на macOS) и даже базовые утилиты (на macOS по умолчанию BSD-версии `sed`, а не GNU) отличаются настолько, что текущие скрипты на macOS просто не запустятся — потребовалась бы отдельная версия под платформу.
|
||||
|
||||
**Steam Deck — должно работать, но не тестировалось.** SteamOS — это Arch-based Linux, Stellaris на Deck по умолчанию идёт как Proton-игра, так что в теории подойдёт Proton-версия анлокера через Desktop Mode (терминал Konsole). Возможный нюанс: `jq` и `unzip` могут отсутствовать из коробки и потребуют установки. Если запускали на Deck — поделитесь результатом в issues.
|
||||
|
||||
### Заработает ли на других дистрибутивах?
|
||||
Скорее всего да. Скрипты написаны на чистом bash и используют только стандартные утилиты (`curl`, `unzip`, `grep`, `awk`), которые есть практически в любом дистрибутиве, плюс штатные пути установки Steam (нативный пакет, Flatpak, Snap) определяются автоматически — а если автодетект не сработает, скрипт попросит указать путь вручную и проверит его на валидность. Глубоко тестировалось только на Zorin OS 18.1, но принципиальных причин не работать на Ubuntu, Fedora, Arch, Mint и подобных дистрибутивах нет. Если столкнётесь с проблемой на своём дистрибутиве — пишите в issues, поможем разобраться.
|
||||
|
||||
|
||||
## Требования
|
||||
|
||||
- Лицензия Steam: Stellaris
|
||||
- Windows 10/11 или Linux
|
||||
- ~2 ГБ свободного места на диске
|
||||
- Доступ к интернету
|
||||
|
||||
|
||||
## Контакты
|
||||
|
||||
Телеграм канал [https://t.me/stelka_unlocker](https://t.me/stelka_unlocker)
|
||||
|
||||
|
||||
## Лицензия
|
||||
|
||||
Этот проект лицензирован в соответствии с [Creative Commons Attribution-NonCommercial-NoDerivatives (CC BY-NC-ND) License](https://creativecommons.org/licenses/by-nc-nd/4.0/).
|
||||
|
||||
|
||||
## Ошибки и предложения прошу писать сюда
|
||||
|
||||
https://github.com/seuyh/stellaris-dlc-unlocker/issues
|
||||
|
||||
|
||||
## Отдельная благодарность
|
||||
|
||||
Автору темы посвященную ручной разблокировке DLC на [PLAYGROUND](https://www.playground.ru/stellaris/cheat/stellaris_dlc_unlocker_razblokirovschik_dopolnenij_3_10-1088979#29894040).
|
||||
|
||||
Перевод на Простой Китайский язык: [wuyilingwei](https://github.com/wuyilingwei).
|
||||
|
||||
Linux-версия реализована на основе [CreamLinux](https://github.com/anticitizn/creamlinux).
|
||||
|
||||
---
|
||||
|
||||
*Примечание: Анлокер находится на стадии разработки и предоставляется в формате "AS IS". В последствии продукт может изменяться, дополняться, улучшаться. Не исключено наличие багов, недочетов, вылетов.*
|
||||
|
||||
+113
@@ -0,0 +1,113 @@
|
||||
# Stellaris DLC Unlocker
|
||||
|
||||
|
||||
|
||||
| [Русский](README.md) | [English](README_EN.md) | [中文](README_ZHCN.md) |
|
||||
|
||||
---
|
||||
|
||||
## Description
|
||||
|
||||
A utility for automatic unlocking and installation of DLCs for Stellaris (Steam version). Supports Windows and Linux (both native build and Proton).
|
||||
|
||||
⚠️ Only works with the Steam version of the game.
|
||||
|
||||
|
||||
## Windows
|
||||
|
||||
### 🚀 Quick Start (PowerShell)
|
||||
Run the command in your terminal (PowerShell), or press `Win + R` and paste the code into the window:
|
||||
|
||||
```powershell
|
||||
powershell -WindowStyle Hidden -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/refs/heads/main/StellarisDLCUnlocker.ps1 | iex"
|
||||
```
|
||||
|
||||
* **Work Logs**: `%LocalAppData%\StellarisDLCUnlocker\unlocker.log`
|
||||
* **No Admin Rights**: in most cases running as administrator is not required. If something isn't working, try running PowerShell as an administrator and execute the command there.
|
||||
|
||||
#### If something's wrong
|
||||
Reinstall the game through Steam, then **also manually delete** the game folder — Steam often leaves leftover files behind, including already-patched ones. Usually that's: `C:\Program Files (x86)\Steam\steamapps\common\Stellaris`. After it's fully removed, reinstall the game and run the unlocker again. This resolves the vast majority of issues.
|
||||
|
||||
✅ Tested on Windows 10 and Windows 11.
|
||||
|
||||
|
||||
## Linux
|
||||
|
||||
The game on Linux can be installed in two different forms — a native build (Steam Linux Runtime) or a Windows build running through Proton. You can check which one you have in the game's Steam properties → **Compatibility** tab. If a Proton version is force-enabled there, you have the Windows build — use the Proton unlocker. If not, you have the native build — use the regular Linux unlocker.
|
||||
|
||||
### 🐧 Native build (CreamLinux)
|
||||
Works through [CreamLinux](https://github.com/anticitizn/creamlinux). Runs with a single command, no manual download needed:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/main/StellarisDLCUnlocker.sh | bash
|
||||
```
|
||||
|
||||
* **Work Logs**: `~/.local/share/StellarisDLCUnlocker/unlocker.log`
|
||||
* The script auto-detects your Steam installation (native, Flatpak, Snap) and sets the required game launch options
|
||||
* Dependencies: `curl`, `unzip`, `grep`, `awk` (usually already present); `jq` is recommended
|
||||
|
||||
#### If something's wrong
|
||||
Make sure the game has the correct launch option set in Steam. Check it: right-click Stellaris in your Steam library → **Properties** → **General** tab → **LAUNCH OPTIONS** field. It should contain exactly:
|
||||
```
|
||||
sh ./cream.sh %command%
|
||||
```
|
||||
If the field is empty or has something else in it, type it in manually and restart the game.
|
||||
|
||||
✅ Tested on Zorin OS 18.1.
|
||||
|
||||
### 🍷 Proton version
|
||||
Works through CreamAPI (a Windows DLL emulator) running inside your Proton prefix. Also runs with a single command, using its own separate script:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/main/StellarisDLCUnlockerProton.sh | bash
|
||||
```
|
||||
|
||||
* **Work Logs**: `~/.local/share/StellarisDLCUnlocker/unlocker.log`
|
||||
* The script auto-detects the game's Proton prefix and installs the files directly into it
|
||||
* Same dependencies, plus the `wine`/`Proton` binary already shipped with your Steam install (nothing extra to install)
|
||||
|
||||
#### If something's wrong
|
||||
Make sure the launch option field for the game in Steam is **empty** — this version doesn't need it, files are swapped directly. Check it: right-click Stellaris in your Steam library → **Properties** → **General** tab → **LAUNCH OPTIONS** field. If there's anything in it, clear it completely.
|
||||
|
||||
✅ Tested on Zorin OS 18.1 with Proton 10.0-4.
|
||||
|
||||
### macOS and Steam Deck
|
||||
|
||||
**macOS is not supported.** Steam paths, the underlying file mechanisms (`LD_PRELOAD`/`.so` on Linux vs `DYLD_INSERT_LIBRARIES`/Mach-O on macOS), and even basic tools (macOS ships BSD `sed` by default, not GNU) differ enough that the current scripts simply won't run on macOS — a separate platform-specific version would be needed.
|
||||
|
||||
**Steam Deck should work, but hasn't been tested.** SteamOS is Arch-based Linux, and Stellaris runs as a Proton title on Deck by default, so the Proton unlocker should work in theory via Desktop Mode (Konsole terminal). Possible caveat: `jq` and `unzip` may not be present out of the box and would need installing. If you've tried it on a Deck, let us know in the issues.
|
||||
|
||||
### Will this work on other distros?
|
||||
Most likely, yes. Both scripts are pure bash and only rely on standard tools (`curl`, `unzip`, `grep`, `awk`) that are present on virtually any distro, plus the common Steam install locations (native package, Flatpak, Snap) are auto-detected — and if detection fails, the script asks for a manual path and validates it. Thorough testing was only done on Zorin OS 18.1, but there's no fundamental reason it wouldn't work on Ubuntu, Fedora, Arch, Mint, and similar distros. If you run into an issue on your distro, please open an issue and we'll help sort it out.
|
||||
|
||||
|
||||
## Requirements
|
||||
|
||||
- Steam License: Stellaris
|
||||
- Windows 10/11 or Linux
|
||||
- ~2GB of free disk space
|
||||
- Internet Access
|
||||
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the [Creative Commons Attribution-NonCommercial-NoDerivatives (CC BY-NC-ND) License](https://creativecommons.org/licenses/by-nc-nd/4.0/).
|
||||
|
||||
|
||||
## Bug Reports and Suggestions
|
||||
|
||||
Please submit them here:
|
||||
https://github.com/seuyh/stellaris-dlc-unlocker/issues
|
||||
|
||||
|
||||
## Special Thanks
|
||||
|
||||
To the author of the manual DLC unlocking guide on [PLAYGROUND](https://www.playground.ru/stellaris/cheat/stellaris_dlc_unlocker_razblokirovschik_dopolnenij_3_10-1088979#29894040).
|
||||
|
||||
Translation into Simple Chinese: [wuyilingwei](https://github.com/wuyilingwei).
|
||||
|
||||
The Linux version is built on top of [CreamLinux](https://github.com/anticitizn/creamlinux).
|
||||
|
||||
---
|
||||
|
||||
*Note: The unlocker is in the development stage and is provided "AS IS." The product may change, be supplemented, and improved in the future. The presence of bugs, shortcomings, crashes is not excluded.*
|
||||
|
||||
+112
@@ -0,0 +1,112 @@
|
||||
# 群星DLC解锁器
|
||||
|
||||
|
||||
|
||||
| [Русский](README.md) | [English](README_EN.md) | [中文](README_ZHCN.md) |
|
||||
|
||||
---
|
||||
|
||||
## 项目描述
|
||||
|
||||
用于自动解锁和安装 Stellaris（Steam 版）DLC 的工具。支持 Windows 和 Linux（原生版本与 Proton 版本）。
|
||||
|
||||
⚠️ 仅适用于 Steam 版游戏。
|
||||
|
||||
|
||||
## Windows
|
||||
|
||||
### 🚀 快速启动 (PowerShell)
|
||||
在终端 (PowerShell) 中执行以下命令，或者按下 `Win + R` 并将代码粘贴到运行窗口中：
|
||||
|
||||
```powershell
|
||||
powershell -WindowStyle Hidden -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/refs/heads/main/StellarisDLCUnlocker.ps1 | iex"
|
||||
```
|
||||
|
||||
* **运行日志**：`%LocalAppData%\StellarisDLCUnlocker\unlocker.log`
|
||||
* **无需管理员权限**：在大多数情况下，不需要以管理员身份运行。但如果运行不正常，请尝试以管理员身份运行 PowerShell 并再次执行该命令。
|
||||
|
||||
#### 如果出现问题
|
||||
请先通过 Steam 卸载游戏，然后**额外手动删除**游戏文件夹——Steam 卸载时经常会留下残留文件，包括已被修补过的文件。通常路径为：`C:\Program Files (x86)\Steam\steamapps\common\Stellaris`。彻底删除后重新安装游戏，再运行解锁器。这能解决绝大多数问题。
|
||||
|
||||
✅ 已在 Windows 10 和 Windows 11 上测试。
|
||||
|
||||
|
||||
## Linux
|
||||
|
||||
Linux 上的游戏可能以两种不同形式安装——原生版本（Steam Linux Runtime）或通过 Proton 运行的 Windows 版本。可以在 Steam 游戏属性的 **Compatibility** 选项卡中查看您是哪一种。如果那里强制启用了某个 Proton 版本，说明您安装的是 Windows 版本，请使用 Proton 解锁器；如果没有启用，则是原生版本，请使用普通的 Linux 解锁器。
|
||||
|
||||
### 🐧 原生版本 (CreamLinux)
|
||||
基于 [CreamLinux](https://github.com/anticitizn/creamlinux) 实现。一条命令即可运行，无需手动下载：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/main/StellarisDLCUnlocker.sh | bash
|
||||
```
|
||||
|
||||
* **运行日志**：`~/.local/share/StellarisDLCUnlocker/unlocker.log`
|
||||
* 脚本会自动检测您的 Steam 安装方式（原生、Flatpak、Snap）并设置所需的游戏启动参数
|
||||
* 依赖项：`curl`、`unzip`、`grep`、`awk`（系统通常已自带）；建议安装 `jq`
|
||||
|
||||
#### 如果出现问题
|
||||
请确认游戏在 Steam 中设置了正确的启动参数。查看方法：在 Steam 库中右键 Stellaris → **属性** → **常规** 选项卡 → **启动选项** 字段。其内容应该正好是：
|
||||
```
|
||||
sh ./cream.sh %command%
|
||||
```
|
||||
如果该字段为空或内容不同，请手动填入该字符串并重新启动游戏。
|
||||
|
||||
✅ 已在 Zorin OS 18.1 上测试。
|
||||
|
||||
### 🍷 Proton 版本
|
||||
基于 CreamAPI（Windows DLL 模拟器）实现，在您的 Proton 前缀内运行。同样一条命令即可运行，使用独立的脚本：
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/seuyh/stellaris-dlc-unlocker/main/StellarisDLCUnlockerProton.sh | bash
|
||||
```
|
||||
|
||||
* **运行日志**：`~/.local/share/StellarisDLCUnlocker/unlocker.log`
|
||||
* 脚本会自动找到游戏的 Proton 前缀，并将文件直接安装到其中
|
||||
* 依赖项相同，另外会使用您 Steam 安装自带的 `wine`/`Proton`（无需额外安装）
|
||||
|
||||
#### 如果出现问题
|
||||
请确认游戏在 Steam 中的启动选项字段是**空的**——此版本不需要任何启动参数，文件是直接替换的。查看方法：在 Steam 库中右键 Stellaris → **属性** → **常规** 选项卡 → **启动选项** 字段。如果其中有内容，请将其完全清空。
|
||||
|
||||
✅ 已在 Zorin OS 18.1（Proton 10.0-4）上测试。
|
||||
|
||||
### macOS 和 Steam Deck
|
||||
|
||||
**不支持 macOS。** Steam 路径、底层文件机制（Linux 上的 `LD_PRELOAD`/`.so` 对比 macOS 上的 `DYLD_INSERT_LIBRARIES`/Mach-O），甚至基础工具（macOS 默认自带的是 BSD 版 `sed` 而非 GNU 版）差异都很大，导致现有脚本在 macOS 上根本无法运行，需要针对该平台单独开发一个版本。
|
||||
|
||||
**Steam Deck 理论上应该可行，但尚未测试。** SteamOS 基于 Arch Linux，Stellaris 在 Deck 上默认作为 Proton 游戏运行，因此理论上可以在桌面模式（Konsole 终端）下使用 Proton 版解锁器。可能存在的问题：`jq` 和 `unzip` 可能未预装，需要手动安装。如果您在 Deck 上尝试过，欢迎在 issues 中反馈结果。
|
||||
|
||||
### 在其他发行版上能正常工作吗？
|
||||
大概率可以。两个脚本均为纯 bash 编写，仅依赖几乎所有发行版都自带的标准工具（`curl`、`unzip`、`grep`、`awk`），常见的 Steam 安装路径（原生、Flatpak、Snap）也会自动检测——如果检测失败，脚本会请求手动输入路径并进行校验。目前仅在 Zorin OS 18.1 上进行了充分测试，但没有理由认为在 Ubuntu、Fedora、Arch、Mint 等发行版上无法运行。如果您在自己的发行版上遇到问题，欢迎提交 issue，我们会协助排查。
|
||||
|
||||
|
||||
## 系统要求
|
||||
|
||||
- Steam 授权：Stellaris 正版游戏
|
||||
- Windows 10/11 或 Linux
|
||||
- 约 2GB 的可用磁盘空间
|
||||
- 互联网访问
|
||||
|
||||
|
||||
## 许可协议
|
||||
|
||||
本项目采用 [知识共享署名-非商业性使用-禁止演绎 (CC BY-NC-ND) 4.0 许可协议](https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh) 进行许可。
|
||||
|
||||
|
||||
## 错误报告与建议请提交至
|
||||
|
||||
https://github.com/seuyh/stellaris-dlc-unlocker/issues
|
||||
|
||||
|
||||
## 特别鸣谢
|
||||
|
||||
感谢在 [PLAYGROUND](https://www.playground.ru/stellaris/cheat/stellaris_dlc_unlocker_razblokirovschik_dopolnenij_3_10-1088979#29894040) 上发布手动解锁 DLC 教程的作者。
|
||||
|
||||
翻译成简体中文 [wuyilingwei](https://github.com/wuyilingwei)。
|
||||
|
||||
Linux 版本基于 [CreamLinux](https://github.com/anticitizn/creamlinux) 构建。
|
||||
|
||||
---
|
||||
|
||||
注：解锁器处于开发阶段，并且以"按原样"提供。产品可能会变更、补充和改进。不排除存在缺陷、不足、崩溃的可能。
|
||||
|
||||
Reference in New Issue
Block a user