Mods / MVL
- Tags:
- Author:
- MystiVaid
- Side:
- Client
- Created:
- Jan 19th 2025 at 12:19 PM
- Last modified:
- May 20th at 6:49 AM
- Downloads:
- 8329
-
For testers:
MVL-1.0.1-win.zip
神麤詭末的复古物语启动器(MVL)是一个免费、开源、由社区驱动的复古物语启动器,支持Windows与Linux系统
项目使用Godot4与C#,围绕多版本管理 + 整合包管理 + 模组浏览下载 + 启动封装提供一体化桌面体验
MVL面向两类主要用户:
- 玩家:快速导入或下载游戏版本、创建整合包、管理账号并启动游戏
- 开发者:可在本地构建完整工程,或按 CI 工作流进行可复现打包
- 在
版本页面导入已有游戏目录,或在线下载并安装游戏版本 - 在
整合页面创建整合包,并为整合包选择目标游戏版本 - 在
主页确认当前整合包与对应版本信息 - 点击右上角账号入口,选择在线登录或离线账号
- 回到
主页点击启动游戏。需要结束时可再次点击停止 - 需要管理模组时,可在
浏览页面搜索下载,或在整合包模组管理窗口执行更新与依赖处理
| 模块 | 主要功能 |
|---|---|
| 主页 | 选择当前整合包,启动/停止游戏,显示当前整合包绑定的版本信息 |
| 版本 | 导入本地已安装游戏;从版本列表下载并解压游戏;维护本地版本列表 |
| 整合 | 创建整合包、绑定游戏版本、调整启动命令与主程序集、管理图标与本地化字段 |
| 模组管理 | 扫描Mods目录(zip/dll/目录),比对ModDB版本,批量更新并处理依赖提示 |
| 浏览 | 对接ModDB API,按作者/标签/版本/安装状态筛选,查看并下载模组发布版本 |
| 账号 | 官方账号登录(含 TOTP 流程)与离线账号模式,切换当前启动账号 |
| 设置 | 语言、缩放、渲染驱动、代理、下载线程、最新版本、第三方游戏源等 |
| 关于 | 展示版本号、贡献者、赞助者、第三方许可证与项目外链 |
| 启动封装 | 使用VSRun传递运行参数、注入账号信息、处理离线补丁与模组路径修正 |
MVL 使用 Godot 用户目录(OS.GetUserDataDir()),并开启了use_custom_user_dir,目录名为MVL
常见路径示例:Windows通常在%APPDATA%\MVL,Linux通常在~/.local/share/MVL
| 路径 | 类型 | 用途 |
|---|---|---|
data.json |
文件 | 启动器主配置(语言、缩放、代理、账号、版本与整合包索引等) |
Modpack/ |
目录 | 默认整合包目录 |
Release/ |
目录 | 默认游戏版本目录 |
logs/ |
目录 | 日志目录,MVL.log自动轮转保留最近文件 |
.Cache/ |
目录 | 图标等缓存内容 |
Translation/ |
目录 | 本地翻译目录,可放置自定义.po并在设置中重载 |
override.cfg |
文件 | 渲染驱动等覆盖配置 |
- 克隆仓库:
git clone https://github.com/scgm0/MVL.git - 安装依赖(
Python/SCons、平台工具链、.NET 8+.NET 10) - 准备
VINTAGE_STORY目录(工作流中会下载并解压客户端后写入环境变量) - 克隆自定义
Godot分支:https://github.com/scgm0/godot.git的MVL分支 - 用
SCons构建Godot C#编辑器(参考官方文档),构建template_release时可选应用MVL/GodotBuildProfile/custom.py与custom.build - 将
mvl-repo/MVL/project.godot导入自构建的编辑器中
CI 参考文件:windows.yml、linux.yml
| 服务 | 用途 | 触发场景 | 可配置性 |
|---|---|---|---|
auth3.vintagestory.at |
账号登录、会话校验 | 在线账号登录与启动前校验 | 否 |
api.vintagestory.at |
获取游戏版本信息(如版本列表/最新信息) | 版本下载与登录流程 | 版本列表可改为第三方地址 |
mods.vintagestory.at |
模组列表、详情、发布版本下载 | 浏览与更新模组 | 否 |
api.github.com(scgm0/MVL) |
检查启动器最新发布版本 | 设置页版本检查与下载窗口 | 可选 GitHub 代理 |
gh-proxy.* |
GitHub API/下载代理 | 启用 GitHub 代理时 | 可在设置中切换 |
| 项目 | 链接 |
|---|---|
| 项目许可证 | MIT License |
| 贡献者名单 | AUTHORS.md |
| 赞助者名单 | DONORS.md |
项目内第三方组件许可证文件位于MVL/License/,并在应用关于页内动态展示。
| 名称 | 介绍 |
|---|---|
| VS Launcher | 另一个开源复古物语启动器 |
| 复古物语中文社区 | 非官方的复古物语中文论坛 |
| 名称 | 地址 |
|---|---|
| GitHub(上游) | https://github.com/scgm0/MVL |
| ModDB | https://mods.vintagestory.at/mvl |
| Weblate | https://hosted.weblate.org/engage/mvl |
| 复古物语 | https://www.vintagestory.at/ |
| QQ频道 | https://pd.qq.com/s/cgzpnm0lh |
| 赞助 | https://afdian.com/a/MystiVaid |
MystiVaid's VintageStory Launcher (MVL) is a free, open-source, community-driven launcher for Vintage Story, supports both Windows and Linux systems.
The project utilizes Godot4 and C# to deliver an integrated desktop experience centered around multi-version management, modpack management, mod browsing and downloading, and launch encapsulation
MVL serves both players and contributors:
- Players can import/download game releases, manage modpacks and accounts, then launch quickly
- Contributors can build locally or follow CI-aligned reproducible packaging steps
- Open
Releasesand import an existing game directory, or download one online - Open
Modpacksand create a modpack - Bind the modpack to a game release version
- Pick an account (online or offline) from the top-right account menu
- Return to
Homeand click launch - Use
Browseor mod management windows to install/update mods
| Area | What it does |
|---|---|
| Home | Select current modpack, launch/stop game, view bound release info |
| Releases | Import local installs, download and extract official releases |
| Modpacks | Create/manage modpacks, set startup command and main assembly |
| Mod Management | Scan the Mods directory (zip/dll/directories), compare versions with ModDB, batch update, and handle dependency prompts |
| Browser | Query ModDB API with filters, inspect releases, download mods |
| Account | Online login (with TOTP flow) and offline mode |
| Settings | Language, scale, renderer, proxy, download threads, latest version, custom game source |
| Info | Build info, contributors, donors, third-party license entries |
| Launch Runtime | VSRun wrapper injects run config, account/session data, and Harmony patches |
MVL uses the Godot user directory (OS.GetUserDataDir()) with use_custom_user_dir enabled, and the directory is named MVL
Common path examples: On Windows, it is typically located at %APPDATA%\MVL, and on Linux, it is usually at ~/.local/share/MVL
| Path | Type | Purpose |
|---|---|---|
data.json |
File | Launcher main configuration (language, scaling, proxy, accounts, version and modpack indexes, etc.) |
Modpack/ |
Directory | Default modpack directory |
Release/ |
Directory | Default game version directory |
logs/ |
Directory | Log directory, MVL.log automatically rotates to retain recent files |
.Cache/ |
Directory | Cache content such as icons |
Translation/ |
Directory | Local translation directory, where custom .po files can be placed and reloaded in settings |
override.cfg |
File | Override configurations such as rendering drivers |
- Clone the repository:
git clone https://github.com/scgm0/MVL.git - Install dependencies (
Python/SCons, platform toolchain,.NET 8+.NET 10) - Prepare the
VINTAGE_STORYdirectory (the workflow will download and extract the client, then write it to environment variables) - Clone the custom
Godotbranch: theMVLbranch ofhttps://github.com/scgm0/godot.git - Build the
Godot C# EditorusingSCons(refer to the official documentation). When buildingtemplate_release, optionally applyMVL/GodotBuildProfile/custom.pyandcustom.build - Import
mvl-repo/MVL/project.godotinto the self-built editor
CI reference files: windows.yml, linux.yml
| Service | Purpose |
|---|---|
auth3.vintagestory.at |
Login and session validation |
api.vintagestory.at |
Release/version metadata used by launcher flows |
mods.vintagestory.at |
Mod listing, mod metadata, and mod file downloads |
api.github.com/repos/scgm0/MVL/releases/latest |
Launcher update checks |
gh-proxy.* (optional) |
GitHub proxy endpoints |
| Item | Link |
|---|---|
| License | MIT |
| Contributors | AUTHORS.md |
| Donors | DONORS.md |
Third-party component license files within the project are located in MVL/License/ and are dynamically displayed on the app's Info page.
| Name | Introduction |
|---|---|
| VS Launcher | Another open-source Vintage Story launcher |
| Vintage Story Chinese Community | Unofficial Chinese forum for Vintage Story |
| Name | URL |
|---|---|
| GitHub (upstream) | https://github.com/scgm0/MVL |
| ModDB page | https://mods.vintagestory.at/mvl |
| Weblate | https://hosted.weblate.org/engage/mvl |
| Vintage Story | https://www.vintagestory.at/ |
| QQ Channel | https://pd.qq.com/s/cgzpnm0lh |
| Sponsorship | https://afdian.com/a/MystiVaid |
| Mod Version | Downloads | Released | Changelog | Download |
|---|---|---|---|---|
| 1.0.1 | 2530 | May 20th at 6:49 AM | MVL-1.0.1-win.zip | |
|
中文:
完整更新内容: English:
Full Changelog: | ||||
| 1.0.0 | 776 | Apr 4th at 1:01 PM | MVL-1.0.0-win.zip | |
|
中文:
完整更新内容: English:
Full Changelog: | ||||
| 0.5.3 | 1438 | Sep 7th 2025 at 7:13 AM | MVL-0.5.3-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.5.2 | 257 | Aug 3rd 2025 at 11:38 AM | MVL-0.5.2-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.5.1 | 123 | Jul 31st 2025 at 11:39 AM | MVL-0.5.1-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.5.0 | 675 | May 16th 2025 at 11:46 AM | MVL-0.5.0.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.4.5 | 313 | Apr 27th 2025 at 6:00 AM | MVL-0.4.5-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.4.4 | 170 | Apr 26th 2025 at 12:28 PM | MVL-0.4.4-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.4.3 | 161 | Apr 24th 2025 at 11:08 AM | MVL-0.4.3-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.4.2 | 190 | Apr 15th 2025 at 11:54 AM | MVL-0.4.2-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.4.1 | 199 | Apr 3rd 2025 at 12:11 PM | MVL-0.4.1-win.zip | |
|
中文:
完整更新内容:
English:
Full Changelog: | ||||
| 0.4.0 | 211 | Mar 20th 2025 at 11:25 AM | MVL-0.4.0-win.zip | |
|
中文:
完整更新内容: English:
Full Changelog: | ||||
| 0.3.1 | 185 | Mar 10th 2025 at 7:55 AM | MVL-0.3.1-win.zip | |
|
1.为账号添加了离线模式,离线账号无法连接到服务器,可以作为主机进行局域网联机。 完整更新内容: | ||||
| 0.3.0 | 151 | Mar 7th 2025 at 1:54 PM | MVL-0.3.0-win.zip | |
|
1.添加账号管理功能,切换整合包时不再需要重新登录了 完整更新内容: | ||||
| 0.2.2 | 153 | Feb 27th 2025 at 3:20 PM | MVL-0.2.2-win.zip | |
|
1.在主界面添加了快速启动功能 完整更新内容: | ||||
| 0.2.1 | 154 | Feb 19th 2025 at 9:11 AM | MVL-0.2.1-win.zip | |
|
1.改进游戏安装窗口与整合包添加窗口的文本提示 完整更新内容: | ||||
| 0.2.0 | 148 | Feb 18th 2025 at 1:06 PM | MVL-0.2.0-win.zip | |
|
1.添加了游戏本体的下载功能 完整更新内容: | ||||
| 0.1.2 | 164 | Feb 11th 2025 at 6:05 AM | MVL-0.1.2-win.zip | |
|
1.允许拖动排序整合包 完整更新内容: | ||||
| 0.1.1 | 204 | Jan 23rd 2025 at 11:50 AM | MVL-0.1.1-win.zip | |
|
Linux版和更新内容: | ||||





Does the "import installed game" button do nothing?
It should pop up the system folder selector. Could you check the log file for any error messages? You can also run the launcher in the terminal to view the logs.
Made a little vid for this.
Thanks!
I'm also using the Windows version to check out the code from older versions. It's simple to navigate and works great, thank you for developing this!
I've had a really good time with the windows version of the launcher, aside from a few missing/awkward translations its been working well. Using the AppImage on Fedora KDE though the launcher is freezing when hovering over text until the hint text appears or attempting to change the github proxy and the entire launcher window can become a glitchy artifact while moving it (I can't tell under what circumstances cause that), basically, could use some work. Really liking the project otherwise.
This is a known issue, but it should not occur. MVL uses features from my custom Godot branch. If you run MVL with the original Godot and switch to OpenGL, this problem will appear. What version are you using? Can you provide the logs for MVL and Godot?
The bug causing artifacts when moving the window may be an issue with Godot. I am using the API provided by Godot to invoke system window dragging, and it works fine on my Arch + KDE6 setup. In any case, could you create one (or two) issues on GitHub and provide logs?
I keep getting the error about not having .net runtime 10 installed even after installing it multiple times, any help?
If you have previously installed the `x86` version of dotnet, please uninstall the `x86` .NET runtime 10 and reinstall the `x64` version. Its environment variables will override the `x64` ones, causing it to be unrecognized.
That worked. thanks!
is there way to import following mod from vs mod site to mvl?
Manually place the mod files into the Mods folder of the modpack, and that's all you need to do.
The best Vintage Story launcher! Thank you for making this, and for translating it to English! :)
最棒的 Vintage Story 启动器!感谢你制作了它,并将其翻译成了英文!:)
You're welcome.
Please include an English description.
Janeator The latest version adds support for English, Spanish, and French
Janeator Sorry, only Chinese, because I am the only one developing, and my English is poor, so the priority of multilingual features is low
You can use it by downloading the game version from the top to the 5th bottom button on the left side (or dragging it into your local 'vintagestory' folder), then adding the game modpack on the 4th button, and you're ready to launch the game
Is this only available in chinese? I downloaded it, but the settings button did nothing.
I'll test it when I log into Windows ^^
XurxoMF The game can now be downloaded from within the launcher! Can you experience it?
XurxoMF thanks man
Mendall you can download multiple vintage story versions from the Client Area, install them and then add them to MVL to easily manage them.
Then you can create multiple data paths on those versions and run them with a play button.
It's for people that plays on multiple versions of the game.
XurxoMF can you post what this does if you have tried it. Google Translate didn't work here and the included video didn't enplane much for me. thnks
XurxoMF Thanks!
The UI is amazing and the animations are pretty clean! I love the design 💯
阿巴阿巴