雀魂Plus v2.1.0-alpha.1

Not tested!

雀魂Plus v2.0.1

警告

• Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

请注意

有关于「雀魂 Plus」2.0 版本更新的更多信息，请访问这里 「雀魂Plus v2.0.0」

新特性

• Ko-KR Support, Thanks to @rishubil ece0dee

Bug 修复

• 修正了「老板键」无法正确使游戏静音的问题。 8a1aa8d
• 修正了自带插件「解锁所有语音」不对契约后角色生效的问题（v3.0.1） 62cdd14 8cd5219
• 修正了导出拓展资源时文件扩展名显示不正确的问题（仅在Windows端进行过测试） fcd774f
• zh-Hant 现在也可以在多语言通用扩张中被识别了 721a7f6

开发者

• 自带插件「解锁所有语音」已经被重写，现在使用 Proxy 来实现有关功能，您可以参照这两个 Comiit 查看详细信息 62cdd14 8cd5219
• 设置游戏窗口 UserAgent 的 API 已经被更新到了推荐使用的新 API dc0569b
• 资源包新增新资源替换模式，可以用于仅替换原版资源，加快加载速度，详情请浏览 8199694

杂项

• 移除了已经没有存在意义的跳过实名认证扩展 05720ab

版本选择说明

以下仅对 Windows 的版本选择进行解释, 其他平台不存在歧义. 下文中的 ${version} 代表雀魂 Plus 的版本, 如2.0.0

• 32 位 / 64 位 (安装版): Majsoul_Plus-${version}-win32-Setup.exe
• 64 位 (便携版): Majsoul_Plus-${version}-win32-x64.zip
• 32 位 (便携版): Majsoul_Plus-${version}-win32-ia32.zip
  注：Windows Arm 用户请下载 32 位版使用。

雀魂Plus v2.0.0

前言

经过近一年的测试，雀魂 Plus 2 已经基本稳定，故借国际中文版上线之际发布 2.0.0 的正式版。

雀魂 Plus v2.0 将会是未来的长期维护版本，在雀魂Plus 重写计划完成之前都将持续维护。

版本选择说明

以下仅对 Windows 的版本选择进行解释, 其他平台不存在歧义. 下文中的 ${version} 代表雀魂 Plus 的版本, 如2.0.0

• 32 位 / 64 位 (安装版): Majsoul_Plus-${version}-win32-Setup.exe
• 64 位 (便携版): Majsoul_Plus-${version}-win32-x64.zip
• 32 位 (便携版): Majsoul_Plus-${version}-win32-ia32.zip
  注：arm 用户请下载 32 位版。

破坏性更新

• 原“模组”系统更新为“资源包”系统，二者功能有重合之处。不再提供模组的支持。
• 原“插件”系统更新为“扩展”系统，二者功能大致相同，但在代码结构上存在变化。原插件系统将不能识别，请原插件作者尽快更新到当前的扩展系统。
• 原“工具”系统现加入了 electron 沙箱，现在只能调用特定的 API。允许调用的 API 参见 Wiki 对应篇目的介绍。
  如果你有无法在现有沙箱条件下实现的工具功能，请通过 issue 手段提出。我们将在评估其安全性后在沙箱中暴露确认安全的接口。
• 修改了部分快捷键的键位, 如开发者工具修改为 F12 / Ctrl+Shift+I, 具体见菜单
• 对游戏窗口的 UserAgent 进行了覆盖, 现在 is-electron 会判定你不在使用 Electron 了

安全性

• 现在默认启用 asar 打包，这意味着现在你不能以任何形式修改 雀魂 Plus 的源代码了。
  值得注意的是，可能有人之前是为了删除 雀魂 Plus 自带的某些 模组 / 插件 / 工具而修改其自带的源码。现在，雀魂 Plus 自带的内容会在第一次启动时复制到用户目录（appData）。在雀魂 Plus 资源管理器的界面内即可删除，不需要修改原目录了。
  此举大大增加了雀魂 Plus 的安全性。在破坏性更新中也有这一方面的内容。

新特性

• 强制指定代理服务器，若代理服务器留空则强制直接连接,若填入 system-proxy 则采用系统代理 (#54)
• 一定程度的移动端支持 (#63)
• 多服务器支持 (#65, #67, #92)
• 多开, 现在玩家可以通过多开功能实现多个帐号同时游玩, 快捷键为 Ctrl+Shift+N. 除第一个窗口之外, 其余的多开窗口标题会显示多开序号, 并且需要重新登录(帐号信息不会缓存, 每次使用都要重新登录)
• 内置拓展自动更新, 现在当内置的扩展比你安装的拓展版本新时会自动更新这部分扩展(对你删除的拓展不会做任何处理)
• 扩展版本显示, 现在扩展的版本会显示在卡片的右上角
• 打开文件夹, 现在用户可以通过点击拓展列表右上角的文件夹图标打开对于扩展存放的目录

开发者特性

• 全项目以 TypeScript 重构 (#60)
• 扩展的代码现在会在匿名函数中执行
• 扩展的 console 会显示扩展 ID
• 可以通过 fetchSelf 函数快速获取扩展自身的资源
• 扩展的代码会在 try-catch 中运行
• 资源包的 replace 数组/扩展的 resourcepack 数组现在可以声明新的资源了
• 重载资源, 现在开发者可以直接重载修改后的拓展资源, 这一步骤也会重载全部窗口
• 自动对 zip 打包启用 portable mode, 现在你下载到的 zip 格式的雀魂 Plus 都已经自带 data 目录了
• 导出后缀名识别, 现在在导出时,会加上与拓展相对应的文件拓展名. 特别地, 如果扩展的目录中存在 execute.json 或 mod.json, 会自动选择扩展名为 mspe / mspm

雀魂Plus v2.0.0-beta.8

警告

Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

更详细的说明请参考 Wiki！

Bug 修复

• 修复返回管理器界面后无法再次返回管理器界面的问题(#81)
• 修复 GameMgr is not defined (#83 #84)
• 修复 extensionConsole 无法正确输出的问题
• 限制缩放比率，修复缩放比率过大导致的卡死问题(#80)

删除特性

• 删除意义不明的帐号注入功能

实现修改

• 扩展脚本文件的执行方式由原本的 eval 修改为添加 <script>

内置扩展升级

• 报菜名(v2.0.2) 无功能变化

版本选择说明

以下仅对 Windows 的版本选择进行解释, 其他平台不存在歧义. 下文中的 ${version} 代表雀魂 Plus 的版本, 如2.0.0-beta.8

• 32 位 / 64 位 (安装版): Majsoul_Plus-${version}-win32-Setup.exe
• 64 位 (便携版): Majsoul_Plus-${version}-win32-x64.zip
• 32 位 (便携版): Majsoul_Plus-${version}-win32-ia32.zip
• 注：arm 用户请下载 32 位版。

雀魂Plus v2.0.0-beta.7

警告

Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

更详细的说明请参考 Wiki！

破坏性更新

• 现在所有的游戏内容代码，包括原 code.js 的代码、扩展代码，都会交由 eval 执行
• 现在 window 中不会存在雀魂声明的变量了

Bug 修复

• 修复外服无法正常游戏的 bug

新特性

• 新的扩展类型：启动器

启动器是雀魂 Plus 抽象出的概念，用以在游戏执行之前扩展功能。如果一个扩展的 id 以 _launcher 结尾，那么它会被认为是一个启动器扩展。

根据定义，雀魂默认的启动器为 new GameMgr();。当雀魂 Plus 检测到启动器扩展时，这一行代码将不会执行（被移除）。你需要在启动器代码中手动执行类似这样的代码。

典型的启动器扩展是 Majsoul Event API (WIP)，它通过继承雀魂的类实现了简单的游戏内事件系统。

版本选择说明

以下仅对 Windows 的版本选择进行解释, 其他平台不存在歧义. 下文中的 ${version} 代表雀魂 Plus 的版本, 如2.0.0-beta.7

• 32 位 / 64 位 (安装版): Majsoul_Plus-${version}-win32-Setup.exe
• 64 位 (便携版): Majsoul_Plus-${version}-win32-x64.zip
• 32 位 (便携版): Majsoul_Plus-${version}-win32-ia32.zip
• 注：arm 用户请下载 32 位版。

雀魂Plus v1.12.2

欢迎

  由于开发者目前主要方向转向了 2.x 的开发，因此没有及时解决 1.x 的黑屏问题，只给出了不算方便的临时解决方案，深表抱歉！
  随着 2.x 生态与稳定性的不断上升，如果没有其他原因导致 2.x 搁浅，这个版本将是 1.x 的最后一个发布版本。

修正

• 修复了因雀魂域名变动导致的黑屏问题(#76)

已知问题

• 微信登录失效，无法使用微信登录

雀魂Plus v2.0.0-beta.6

警告

Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

更详细的说明请参考 Wiki！

该版本之前存在未知的 bug，在最近的构建中已经修复！

说明

该版本对 electron 进行了升级, 更新后的各版本号如下:

• Electron 6.0.3
• Node 12.4.0
• Chromium 76.0.3809.126

破坏性更新

• 修改了部分快捷键的键位, 如开发者工具修改为 F12 / Ctrl+Shift+I, 具体见菜单
• 对游戏窗口的 UserAgent 进行了覆盖, 现在 is-electron 会判定你不在使用 Electron 了

Bug 修复

• 修复 window.open 的窗口再 close 导致的游戏黑屏 bug
• 修复之前版本无法正常使用的老板键
• 修复管理器窗口左下角 Ping 的显示错误

新特性

• 多开, 现在玩家可以通过多开功能实现多个帐号同时游玩, 快捷键为 Ctrl+Shift+N. 除第一个窗口之外, 其余的多开窗口标题会显示多开序号, 并且需要重新登录(帐号信息不会缓存, 每次使用都要重新登录)
• 重载窗口, 现在玩家可以直接重载游戏窗口, 不需要退出了
• 重载全部窗口, 可以一次性重载所有的多开窗口
• 重载资源, 现在开发者可以直接重载修改后的拓展资源, 这一步骤也会重载全部窗口
• macOS 毛玻璃特效(没有 mac 设备, 暂无法测试, 欢迎 issue)
• 扩展版本显示, 现在扩展的版本会显示在卡片的右上角
• 内置拓展自动更新, 现在当内置的扩展比你安装的拓展版本新时会自动更新这部分扩展(对你删除的拓展不会做任何处理)
• 自动对 zip 打包启用 portable mode, 现在你下载到的 zip 格式的雀魂 Plus 都已经自带 data 目录了
• 打开文件夹, 现在用户可以通过点击拓展列表右上角的文件夹图标打开对于扩展存放的目录
• 导出后缀名识别, 现在在导出时,会加上与拓展相对应的文件拓展名. 特别地, 如果扩展的目录中存在 execute.json 或 mod.json, 会自动选择扩展名为 mspe / mspm

版本选择说明

以下仅对 Windows 的版本选择进行解释, 其他平台不存在歧义. 下文中的 ${version} 代表雀魂 Plus 的版本, 如2.0.0-beta.6

• 32 位 / 64 位 (安装版): Majsoul_Plus-${version}-win32-Setup.exe
• 64 位 (便携版): Majsoul_Plus-${version}-win32-x64.zip
• 32 位 (便携版): Majsoul_Plus-${version}-win32-ia32.zip

雀魂Plus v2.0.0-beta.5

警告

Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

更详细的说明请参考 Wiki！

说明

经过 beta.4 之后的 bug 修复，该版本目前尚且稳定，可以开始尝试使用。

Bug 修复

• [重要] 修复扩展在多次启用后会多次加载的问题
• 修复截图功能无法使用的问题
• 修复截图音效无法正常播放的问题
• 修复导出拓展时的文件后缀名问题

新特性

• 扩展的代码现在会在 try-catch 中运行了
• 资源包的 replace 数组/扩展的 resourcepack 数组现在可以声明新的资源了,详细见下文
• 对代理服务器进行了优化,现在若代理服务器留空则强制直接连接,若填入 system-proxy 则采用系统代理
• 修改了帐号注入机制,现在用户需要手动在菜单中保存帐号信息,而不是原来的最大化最小化自动了

---

声明新资源

资源包的 replace 数组/扩展的 resourcepack 数组现在可以声明新的资源了,如下例所示:

replace: [
  "new_asset_folder/rua"
]

这一项原本不存在,但这样声明后会加入 resversion.json 中,游戏中如果尝试获取该资源的话会从对应拓展的 assets/new_asset_folder/rua 尝试读取.

雀魂Plus v2.0.0-beta.4

警告

Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

更详细的说明请参考 Wiki！

说明

本版本紧急修复了雀魂更换域名的问题,之前版本的扩展/资源包将无法导入,请 2.x 用户尽快更新到该版本.

雀魂Plus v2.0.0-beta.3

警告

Pre-release 版本并未经过充分测试，使用 Pre-release 版本导致的任何后果请自行承担，如果您希望使用稳定版本，请访问 「最新稳定版」

更详细的说明请参考 Wiki！

说明

经过 beta.2 之后的 bug 修复，该版本目前尚且稳定，可以开始尝试使用。

更改

• 现在只能启动一个雀魂 Plus 实例! 如果要多开,请使用浏览器直接打开 http(s,取决于设置)://localhost:对应端口
• 交换了管理器中资源包和扩展的位置,现在扩展位于最上方(但是加载优先级还是资源包覆盖扩展)

Bug 修复

• 修复扩展无法获取自身描述 JSON 的问题
• 修复导出资源包与导入资源包扩展名不一致的问题
• 修复语言文件与新版不一致的问题

新特性

• 现在桌布制作工具新制作的桌布可以覆盖仓库内显示的名称和说明了
  (由此,制作出的成品也从资源包变成了扩展)
• 增加 mspm 为扩展的导入格式,(但目前只能导出 .mspe),可以制作跨大版本的模组/扩展了
• 增加了文件扩展名的关联,现在可以直接双击安装拓展了
• 增加了拖拽安装拓展的功能
• 加入仅服务器模式,该模式下不会启动游戏窗口,需要通过手动设置环境变量 SERVER_ONLY 进行启动(暂不提供简便的启动方式)