MVL

神麤詭末的复古物语启动器（MVL）是一个免费、开源、由社区驱动的复古物语启动器，支持Windows与Linux系统

项目使用Godot4与C#，围绕多版本管理 + 整合包管理 + 模组浏览下载 + 启动封装提供一体化桌面体验

MVL面向两类主要用户：

1. 玩家：快速导入或下载游戏版本、创建整合包、管理账号并启动游戏
2. 开发者：可在本地构建完整工程，或按 CI 工作流进行可复现打包

1. 在版本页面导入已有游戏目录，或在线下载并安装游戏版本
2. 在整合页面创建整合包，并为整合包选择目标游戏版本
3. 在主页确认当前整合包与对应版本信息
4. 点击右上角账号入口，选择在线登录或离线账号
5. 回到主页点击启动游戏。需要结束时可再次点击停止
6. 需要管理模组时，可在浏览页面搜索下载，或在整合包模组管理窗口执行更新与依赖处理

模块	主要功能
主页	选择当前整合包，启动/停止游戏，显示当前整合包绑定的版本信息
版本	导入本地已安装游戏；从版本列表下载并解压游戏；维护本地版本列表
整合	创建整合包、绑定游戏版本、调整启动命令与主程序集、管理图标与本地化字段
模组管理	扫描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	文件	渲染驱动等覆盖配置

1. 克隆仓库：git clone https://github.com/scgm0/MVL.git
2. 安装依赖（Python/SCons、平台工具链、.NET 8+.NET 10）
3. 准备VINTAGE_STORY目录（工作流中会下载并解压客户端后写入环境变量）
4. 克隆自定义Godot分支：https://github.com/scgm0/godot.git的MVL分支
5. 用SCons构建Godot C#编辑器（参考官方文档），构建template_release时可选应用MVL/GodotBuildProfile/custom.py与custom.build
6. 将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:

1. Players can import/download game releases, manage modpacks and accounts, then launch quickly
2. Contributors can build locally or follow CI-aligned reproducible packaging steps

1. Open Releases and import an existing game directory, or download one online
2. Open Modpacks and create a modpack
3. Bind the modpack to a game release version
4. Pick an account (online or offline) from the top-right account menu
5. Return to Home and click launch
6. Use Browse or 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

1. Clone the repository: git clone https://github.com/scgm0/MVL.git
2. Install dependencies (Python/SCons, platform toolchain, .NET 8 + .NET 10)
3. Prepare the VINTAGE_STORY directory (the workflow will download and extract the client, then write it to environment variables)
4. Clone the custom Godot branch: the MVL branch of https://github.com/scgm0/godot.git
5. Build the Godot C# Editor using SCons (refer to the official documentation). When building template_release, optionally apply MVL/GodotBuildProfile/custom.py and custom.build
6. Import mvl-repo/MVL/project.godot into 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