生存日志 数据库English
模组管理器: 列出所有已安装的模组,可开启或关闭模组,并在游戏内修改它们的设置。

模组管理器

列出所有已安装的模组,可开启或关闭模组,并在游戏内修改它们的设置。

版本
0.8.2
游戏版本
1.1.19611
分类
工具
设置
3
快捷键
1
版本数
10
语言
English, 中文

Mod Manager 为 Survival Log 加入一个模组界面。它列出你安装的每个 BepInEx 模组,显示每个模组是否已加载,并让你修改设置、开启或关闭模组、安装更新,全程不用打开 .cfg 文件。按 F10,或点击 Esc 菜单或标题画面中的「模组」按钮即可打开。

亮点

所有模组一览

每个模组都显示图标、版本和 DLL;没有启动的模组单独列出,并附上 BepInEx 报告的加载错误。共用的前置库折叠在列表底部。

游戏内修改设置

开关、滑块、数字框、下拉列表、文本框,以及热键的按键录入。每次修改都会立即保存到模组的 .cfg 文件。

知道哪些需要重启

下次启动才生效的已修改设置会标记为「需要重启」。模组立即应用的设置没有标记。

物品选择器

保存游戏物品或物品类别的设置会显示可搜索的选择器,带有名称和图标,不用再输入编号。

搜索、重置、冲突

在所有模组中搜索任意设置,查看哪些与默认值不同并一键恢复,还能发现两个模组共用的热键。

「错误」页

这次游戏中记录的警告和错误会显示在产生它的模组下,列表中标出「错误」或「警告」,还可以用「错误」筛选。如果错误经过了另一个模组也修改的游戏代码,会写出那个模组。来自 BepInEx 或游戏本身的错误在顶部「MODS」旁的「错误」页中。

查看全部 14 项功能

全部功能 14

所有模组一览

每个模组都显示图标、版本和 DLL;没有启动的模组单独列出,并附上 BepInEx 报告的加载错误。共用的前置库折叠在列表底部。

游戏内修改设置

开关、滑块、数字框、下拉列表、文本框,以及热键的按键录入。每次修改都会立即保存到模组的 .cfg 文件。

知道哪些需要重启

下次启动才生效的已修改设置会标记为「需要重启」。模组立即应用的设置没有标记。

物品选择器

保存游戏物品或物品类别的设置会显示可搜索的选择器,带有名称和图标,不用再输入编号。

搜索、重置、冲突

在所有模组中搜索任意设置,查看哪些与默认值不同并一键恢复,还能发现两个模组共用的热键。

「错误」页

这次游戏中记录的警告和错误会显示在产生它的模组下,列表中标出「错误」或「警告」,还可以用「错误」筛选。如果错误经过了另一个模组也修改的游戏代码,会写出那个模组。来自 BepInEx 或游戏本身的错误在顶部「MODS」旁的「错误」页中。

复制模组列表

一个按钮即可复制所有模组及其版本和状态,以及这次游戏的错误,方便粘贴到问题反馈中。

开启或关闭模组

每个模组页面上都有开关,下次启动时生效。关闭模组时会提醒哪些模组需要它;一个按钮就能开启某个模组需要的模组。

依赖

每个模组页面会列出它需要的模组(及要求的版本)、可配合的模组、不兼容的模组,以及需要或使用它的模组。缺失、已关闭或版本不符的模组会标红。

检查并安装更新

每次启动时向 GitHub 查询哪些模组有新版本,并用一条消息告诉你有几个。「安装更新」会下载新版本,下次启动时生效,旧文件会保留。「安装全部更新」可一次更新所有模组,并标出它没有安装的更新,页面会显示你的版本之后每次发布的更新说明;如果新版本有问题,「退回」可以换回旧版本。每次更新都会先检查:必须是同一个模组、来自与之前相同的 GitHub 仓库、不含程序文件。新版本如果开始启动其他程序、加载其他代码或使用注册表,会被拒绝;如果能做到旧版本做不到的其他事(比如连接互联网),安装前会先询问你。

「冲突」页

每个模组的页面会列出修改了游戏相同部分的其他模组,并标出「很可能冲突」「可能冲突」或「大概无害」,两个模组一起出问题时可以先从这里查起。

「更新日志」页

链接了更新日志的模组会多出一个「更新日志」页,直接在模组页面上显示它。

其他模组的页签

模组可以在自己的条目中加入一个带有自己页面的页签。New Loop Plus 加入了「天赋」页签,用来编辑它的轮回奖励。

游戏版本提醒

尚未确认可在你的游戏版本上运行的模组会显示灰色标记;如果它记录了错误,标记会变红。模组作者无需发布新版本,即可列出模组可运行的新游戏版本。

Mod Manager 不会向存档添加任何内容,也不会修改游戏文件。它只会连接 GitHub 来检查和安装更新,不需要账号或密钥。

致模组作者

你的模组无需任何改动就会显示在列表中。如果想提供中英文名称、图标、横幅、分类、链接、物品选择器、实时生效的设置、一键安装更新等,只需在 .csproj 中加几行元数据,不需要引用 Mod Manager。完整说明见 README(英文)。

设置 3

保存在BepInEx\config\com.dev.survivallog.modmanager.cfg在 Mod Manager 的「模组」界面修改,或在游戏关闭时编辑这个文件。

Menu

[Menu]

While the Mods screen is open, the game's own hotkeys are paused, and Esc closes the screen. While you type in a box on the screen, keys go to the box instead.

OpenKey
按键
默认 F10
打开和关闭「模组」界面的按键。Esc 菜单和标题画面中的「模组」按钮也能打开它。默认 F10。
The key that opens and closes the Mods screen. The Mods button in the Esc menu and on the title screen opens it too. Set it to None to use only the buttons.

Updates

[Updates]
CheckForUpdates
开 / 关
默认 开
每次启动游戏时,向 GitHub 查询标明了 GitHub 仓库的模组是否有新版本。只会连接 GitHub,不需要账号或密钥。默认开启。
Each time the game starts, ask GitHub whether mods that name a GitHub repository have a newer release. Only GitHub is contacted, and no account or key is needed. Turning it off stops the checks at once.
ShowToast
开 / 关
默认 开
启动时检查更新后,显示一条消息,说明有多少个模组有更新。点击即可查看。默认开启。
After the update check at the start, show one message saying how many mods have updates. Click it to see them.

快捷键 1

F10

打开和关闭「模组」界面的按键。Esc 菜单和标题画面中的「模组」按钮也能打开它。默认 F10。

安装

  1. 安装 BepInEx (如果之前没有装过其他模组,先启动一次游戏,让 BepInEx 完成初始化,然后退出)。
  2. 安装 Exiled's Toolkit 0.4.0 或更高版本。
  3. 在 Nexus 的「文件」页下载压缩包。
  4. 把压缩包解压到游戏目录(SurvivalLog.exe 所在的文件夹)。压缩包里带有 BepInEx 文件夹,DLL 会自动放到正确位置。如果提示合并文件夹,选择合并。解压后应为:
    C:\Program Files (x86)\Steam\steamapps\common\Survival Log\BepInEx\plugins\ModManager.dll

文件位置

Survival Log\
├─ SurvivalLog.exe
└─ BepInEx\
   ├─ plugins\
   │  └─ ModManager.dll
   └─ config\
      └─ com.dev.survivallog.modmanager.cfg   (首次启动时生成)

卸载

从 BepInEx\plugins 文件夹中删除 ModManager.dll。用它修改过的设置会保留在其他模组的 .cfg 文件中。

设置

Mod Manager 自己的设置(打开界面的按键、检查更新、更新消息)可以在模组界面中修改,也可以在游戏关闭时编辑 BepInEx\config\com.dev.survivallog.modmanager.cfg。配置文件中每项设置都有中文说明,完整说明见 CONFIG.md(英文)。

更新日志 10 个版本

更新日志只有英文版。

  1. 0.8.2Nexus 页面游戏 1.1.19611
    • The Mods button in the Esc menu and on the title screen shows the moment the menu opens, instead of popping in up to a second later.
  2. 0.8.1游戏 1.1.19131游戏 1.1.19611
    • After INSTALL ALL UPDATES, an update that waits for INSTALL ANYWAY is marked ASK in the mod list, and a refused one is marked REFUSED. A line under the button says how many of each there are.
  3. 0.8.0游戏 1.1.19131
    • Updates are checked before they are installed:
      • The new DLL must be the same mod (the same BepInPlugin GUID) as the one installed. A zip that holds a program file (.exe, .bat, .ps1 and the like), or a file name Windows would change, is refused.
      • A mod's updates must keep coming from the GitHub repository its first install came from. A repository that was deleted and made again under the same name by someone else is not installed from; use GET UPDATE to install by hand if you trust it.
      • An update that starts doing something harmful code needs and a game mod does not (starting other programs, loading other code, using the Windows registry) is refused. A mod that already did it when installed keeps updating.
      • When an update can do something else the installed version could not (connect to the internet, call native code, open links or files in other programs, or add another DLL), its page says what, and it is installed only when you click INSTALL ANYWAY. INSTALL ALL UPDATES skips these.
      • A refused update says why on its page and is not offered again until the next start. GET UPDATE still lets you install it by hand.
  4. 0.7.0游戏 1.1.19131
    • Mods can add a tab of their own to their page on the Mods screen, with any page they like (New Loop Plus uses it to edit its loop rewards). See "Your own tab" under "For mod authors" in the README.
    • Text boxes with several lines take the keyboard the same way one-line boxes do.
    • A mod's author can list the game versions each version of the mod works on in a game-versions.txt in its GitHub repository, so a mod that still works after a game update is no longer marked. See "Game versions it works on" under "For mod authors" in the README.
    • A mod not known to work on this game version gets a grey VERSION mark and a note that it may still work. The mark turns red, and the note says it may need an update, once the mod logs errors this session.
  5. 0.6.0游戏 1.1.18902游戏 1.1.19131
    • INSTALL ALL UPDATES at the top of the "Updates" filter installs every available update at once.
    • ROLL BACK TO (version): after an update, put the files it replaced back for the next start.
    • A mod's page shows the release notes of every release since your version, not only the latest.
    • A mod's page has a CONFLICTS tab listing the other mods that change the same game code, which parts, and what each mod does there. Each is marked LIKELY TO CLASH (both rewrite the game code), MAY CLASH (one can skip or rewrite it) or PROBABLY HARMLESS, riskiest first.
    • Errors and warnings logged this session are listed under the mod they came from: an ERRORS tab on the mod's page (with the message, the stack, and how many times it happened), an ERROR or WARNING mark in the list, and an "Errors" filter. When an error went through game code that another mod also changes, the tab names that mod, which is evidence of a real clash. Errors that belong to no mod (BepInEx, the game itself) have their own ERRORS page beside MODS at the top. COPY MOD LIST includes them all.
    • A mod that links its changelog gets a CHANGELOG tab next to CONFLICTS, which shows the changelog on the mod's page.
    • A mod's page shows the version range of each mod it needs, and marks an installed version outside that range as wrong version.
    • A mod's page lists the mods that need it (NEEDED BY) and the ones that can use it (USED BY (OPTIONAL)). A mod that needs it turns red while it is off.
    • A mod with too many sections for one row of tabs lists them down the left side of its settings instead.
    • Changing the view redraws only what changed, so the screen no longer flashes and replays its fade-in on every click.
    • Fixed: a mod with an optional dependency lost its name, description, links and relations on the Mods screen, because its dependency could not be read.
    • Fixed: a mod could be turned off while its update was downloading, which left its old and new DLLs in different folders and blocked ROLL BACK. While an update downloads, and after an install or rollback until the next start, the mod's switch is locked.
    • Fixed: during a burst of errors too fast to read, the count of errors not shown left out the ones that were skipped.
    • Update checks and changelogs read at most 4 MB from a server, so a broken changelog link cannot fill the game's memory.
    • The Mod Manager's own entry shows its name in Chinese, the game version it was made for, and a link to this changelog.
    • The Chinese description of the open key names the 「模组」 button as the game shows it in Chinese.
  6. 0.5.0
    • Item pickers: settings that hold game items, lists of items, items with amounts, or item categories can ask for a picker with names and icons in the game's language, instead of a box for id numbers.
    • Mods can hide a setting until another setting has a given value, and fold rarely used settings into an "Advanced" group.
    • Mods can show a banner across the top of their page and a CHANGELOG link.
    • Mods can list fixed hotkeys they use. They show on the mod's page and count in the hotkey clash check.
    • COPY MOD LIST at the bottom of the screen copies every mod with its version and state, for bug reports.
  7. 0.4.0
    • Install updates: INSTALL UPDATE downloads the release's zip from GitHub and puts the new files in place for the next start. The old files are kept in BepInEx\mod-manager\backups, and a failed install puts them back.
    • One message at the start says how many mods have updates; click it to see them. Turn it off with Updates.ShowToast.
    • Settings show whether a change needs a restart: NEEDS RESTART, MAY NEED RESTART, or no mark for settings the mod applies at once. Mods built on Exiled's Toolkit 0.4.0 can apply settings live.
    • A mod's page lists the mods it needs, works with and does not work with. TURN ON WHAT IT NEEDS turns on the ones it needs for the next start.
    • Mods can give a name and description in English and Chinese, an icon, a category, a link for reporting problems, and the game version they were made for. A mod made for another game version is marked VERSION.
    • Shared libraries sit in a folded "Libraries" group at the bottom of the list.
    • Mods can opt out of update checks, and a mod's GitHub repository is found from its RepositoryUrl when it does not name one.
    • The title-screen button reads "Mods", to match the other buttons there.
    • Needs Exiled's Toolkit 0.4.0 or later.
  8. 0.3.0
    • Update checks: at each game start, mods that name a GitHub repository are checked for a newer release. Mods with an update are marked in the list and get an "Updates" filter, and their page shows the release notes and a GET UPDATE button that opens the release page. No account or key is needed. Turn it off with Updates.CheckForUpdates.
  9. 0.2.0
    • Turn mods on or off from a switch on each mod's page. The DLL moves to BepInEx\disabled-plugins (or back) and the change applies at the next start. Turned-off mods are listed under "Off". Turning a mod off names the mods that need it.
    • Mods can show a description, their author, and Nexus Mods, GitHub and website links. Mod authors set these with assembly metadata; see "For mod authors" in the README.
  10. 0.1.0
    • First release.
    • An in-game Mods screen lists every installed mod, shows whether it loaded, and changes its settings.
    • Open it with F10, or the MODS button in the Esc menu and on the title screen.
    • Needs Exiled's Toolkit 0.3.0 or later.

帮助

已知问题

  • 只显示模组注册到 BepInEx 的设置。
  • 很多模组只在游戏启动时读取设置。这类修改会立即保存,但要下次启动后才生效。
  • Mod Manager 和 Exiled's Toolkit 无法在界面中关闭。如需移除,请删除它们的 DLL。
  • 模组更新下载期间,以及安装或回滚之后直到下次启动前,它的开关会被锁定。
  • 只有标明了 GitHub 仓库的模组才会检查更新;「安装更新」需要发布版本附带包含该模组 DLL 的 .zip 文件,否则「获取更新」会打开发布页面。
  • 不登录时 GitHub 每小时只允许 60 次请求。超出后,更新说明和安装会提示稍后再试。

发现问题?

发现 bug 或有好点子?欢迎来 Core Directive Discord 打个招呼,或在这里留言。报告 bug 时,请附上 BepInEx\LogOutput.log 和 BepInEx\mod-manager.log。
想直接联系我,可以在 Discord 上给 exiled.dev 发消息,我在 Survival Log 官方 Discord 里。也可以在 X 上找我:@AnExiledDev。
也欢迎看看我做的 Survival Log 维基,收录物品、制作、地图等资料。