<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-GB">
	<id>https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=Search_and_organize_large_mod_settings%2Fzh</id>
	<title>Search and organize large mod settings/zh - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.shroudforge.net/index.php?action=history&amp;feed=atom&amp;title=Search_and_organize_large_mod_settings%2Fzh"/>
	<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=Search_and_organize_large_mod_settings/zh&amp;action=history"/>
	<updated>2026-11-21T15:21:08Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.46.2</generator>
	<entry>
		<id>https://wiki.shroudforge.net/index.php?title=Search_and_organize_large_mod_settings/zh&amp;diff=2929&amp;oldid=prev</id>
		<title>Bonsaibauer: Importing a new version from external source</title>
		<link rel="alternate" type="text/html" href="https://wiki.shroudforge.net/index.php?title=Search_and_organize_large_mod_settings/zh&amp;diff=2929&amp;oldid=prev"/>
		<updated>2026-11-08T22:14:33Z</updated>

		<summary type="html">&lt;p&gt;Importing a new version from external source&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;languages /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;lt;!-- ShroudForge Modloader Wiki Post&lt;br /&gt;
title: Search and organize large mod settings&lt;br /&gt;
description: Use the Modloader&amp;#039;s existing setting groups to organize a mod page into tabs, and make long multi-select lists searchable with optional categories. The controls are opt-in, keep saved values unchanged unless the player changes a choice, and use the mod&amp;#039;s existing locale files.&lt;br /&gt;
language: en-GB&lt;br /&gt;
picture:ShroudForge-Wiki-mod-settings-search.svg&lt;br /&gt;
creator: Bonsaibauer&lt;br /&gt;
--&amp;gt;&lt;br /&gt;
&lt;br /&gt;
[[File:ShroudForge-Wiki-mod-settings-search.svg|thumb|left|600px|Search and organize large mod settings]]&lt;br /&gt;
&lt;br /&gt;
&amp;lt;br style=&amp;quot;clear:both;&amp;quot; /&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
使用 Modloader 现有的设置分组，将模组页面整理为多个标签页，并为较长的多选列表添加搜索和可选分类。这些功能均为可选。只有玩家更改选项时，已保存的值才会改变。模组继续使用现有的本地化文件。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;What_changes_in_a_large_mod_page&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 大型模组页面有哪些变化 ==&lt;br /&gt;
&lt;br /&gt;
此功能适用于模组在 &amp;lt;code&amp;gt;extended.mod.json&amp;lt;/code&amp;gt; 中声明的设置。它使用现有的模组设置页面、已保存的设置值和模组本地化文件，不会新增另一套设置存储。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Organize_a_large_multi-select&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 整理较长的多选列表 ==&lt;br /&gt;
&lt;br /&gt;
对于 &amp;lt;code&amp;gt;multiselect&amp;lt;/code&amp;gt;，&amp;lt;code&amp;gt;value&amp;lt;/code&amp;gt; 仍然是数组，可选项仍在 &amp;lt;code&amp;gt;options&amp;lt;/code&amp;gt; 中声明。选项超过 12 个时会自动显示搜索控件。示例还对选项进行分组，并将设置组放到独立的页面标签页中。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;schemaVersion&amp;quot;: 1,&lt;br /&gt;
  &amp;quot;enabled&amp;quot;: true,&lt;br /&gt;
  &amp;quot;settings&amp;quot;: {&lt;br /&gt;
    &amp;quot;showEffects&amp;quot;: {&lt;br /&gt;
      &amp;quot;value&amp;quot;: true,&lt;br /&gt;
      &amp;quot;label&amp;quot;: &amp;quot;Show effects&amp;quot;,&lt;br /&gt;
      &amp;quot;control&amp;quot;: &amp;quot;toggle&amp;quot;&lt;br /&gt;
    },&lt;br /&gt;
    &amp;quot;excludeItems&amp;quot;: {&lt;br /&gt;
      &amp;quot;value&amp;quot;: [],&lt;br /&gt;
      &amp;quot;label&amp;quot;: &amp;quot;Excluded items&amp;quot;,&lt;br /&gt;
      &amp;quot;description&amp;quot;: &amp;quot;Choose items this mod should ignore.&amp;quot;,&lt;br /&gt;
      &amp;quot;control&amp;quot;: &amp;quot;multiselect&amp;quot;,&lt;br /&gt;
      &amp;quot;options&amp;quot;: {&lt;br /&gt;
        &amp;quot;Twigs&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Twigs&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Stone&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Stone&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Resin&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Resin&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Plant Fiber&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Plant Fiber&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Shroud Wood&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Shroud Wood&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Fossilized Bone&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Fossilized Bone&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Metal Scraps&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Metal Scraps&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Materials&amp;quot; },&lt;br /&gt;
        &amp;quot;Fire Fly&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Fire Fly&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Creatures&amp;quot; },&lt;br /&gt;
        &amp;quot;Fell Wispwyvern&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Fell Wispwyvern&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Creatures&amp;quot; },&lt;br /&gt;
        &amp;quot;Hollow Halls&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Hollow Halls&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Creatures&amp;quot; },&lt;br /&gt;
        &amp;quot;Bronze Arrows&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Bronze Arrows&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Ammunition&amp;quot; },&lt;br /&gt;
        &amp;quot;Explosive Arrows&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Explosive Arrows&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Ammunition&amp;quot; },&lt;br /&gt;
        &amp;quot;Poison Arrows&amp;quot;: { &amp;quot;label&amp;quot;: &amp;quot;Poison Arrows&amp;quot;, &amp;quot;group&amp;quot;: &amp;quot;Ammunition&amp;quot; }&lt;br /&gt;
      }&lt;br /&gt;
    }&lt;br /&gt;
  },&lt;br /&gt;
  &amp;quot;groups&amp;quot;: [&lt;br /&gt;
    { &amp;quot;label&amp;quot;: &amp;quot;General&amp;quot;, &amp;quot;settings&amp;quot;: [&amp;quot;showEffects&amp;quot;] },&lt;br /&gt;
    { &amp;quot;label&amp;quot;: &amp;quot;Excluded items&amp;quot;, &amp;quot;settings&amp;quot;: [&amp;quot;excludeItems&amp;quot;], &amp;quot;tab&amp;quot;: true }&lt;br /&gt;
  ]&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
例如 &amp;lt;code&amp;gt;Twigs&amp;lt;/code&amp;gt; 这样的选项键就是为模组保存的值。&amp;lt;code&amp;gt;&amp;quot;Twigs&amp;quot;: &amp;quot;Twigs&amp;quot;&amp;lt;/code&amp;gt; 这样的字符串标签仍然可用。对象形式可以增加显示用的 &amp;lt;code&amp;gt;label&amp;lt;/code&amp;gt; 和可选的 &amp;lt;code&amp;gt;group&amp;lt;/code&amp;gt;。分类标签页用于划分多选列表中的选项。搜索会在所有分类中同时匹配显示标签和已保存的值。计数会显示当前可见、总数和已选项数。“仅显示已选项”只隐藏未选项，不会取消选择。勾选状态变化时仍更新原来的已保存数组，较长列表则在设置区域内滚动。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Translate_mod_labels_and_tabs&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 翻译模组标签和页面标签 ==&lt;br /&gt;
&lt;br /&gt;
模组编写的标签放在现有的 &amp;lt;code&amp;gt;locales/&amp;amp;lt;code&amp;amp;gt;.json&amp;lt;/code&amp;gt; 文件中。Search、Only selected 和 All 等共享控件使用玩家选择的 Modloader 通用语言。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
{&lt;br /&gt;
  &amp;quot;settings&amp;quot;: {&lt;br /&gt;
    &amp;quot;excludeItems&amp;quot;: {&lt;br /&gt;
      &amp;quot;options&amp;quot;: {&lt;br /&gt;
        &amp;quot;Twigs&amp;quot;: &amp;quot;Twigs&amp;quot;,&lt;br /&gt;
        &amp;quot;Stone&amp;quot;: &amp;quot;Stone&amp;quot;,&lt;br /&gt;
        &amp;quot;Fire Fly&amp;quot;: &amp;quot;Fire Fly&amp;quot;,&lt;br /&gt;
        &amp;quot;Bronze Arrows&amp;quot;: &amp;quot;Bronze Arrows&amp;quot;&lt;br /&gt;
      },&lt;br /&gt;
      &amp;quot;optionGroups&amp;quot;: {&lt;br /&gt;
        &amp;quot;Materials&amp;quot;: &amp;quot;Materials&amp;quot;,&lt;br /&gt;
        &amp;quot;Creatures&amp;quot;: &amp;quot;Creatures&amp;quot;,&lt;br /&gt;
        &amp;quot;Ammunition&amp;quot;: &amp;quot;Ammunition&amp;quot;&lt;br /&gt;
      }&lt;br /&gt;
    }&lt;br /&gt;
  },&lt;br /&gt;
  &amp;quot;groups&amp;quot;: [&lt;br /&gt;
    { &amp;quot;label&amp;quot;: &amp;quot;General&amp;quot; },&lt;br /&gt;
    { &amp;quot;label&amp;quot;: &amp;quot;Excluded items&amp;quot; }&lt;br /&gt;
  ]&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
现有格式请参阅[[Translate mod text (en)|模组本地化指南]]。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Put_a_setting_group_in_its_own_tab&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 将设置组放到独立标签页 ==&lt;br /&gt;
&lt;br /&gt;
实际示例可见 [ShroudForge World Editor 的 extended.mod.json](https://github.com/bonsaibauer/shroudforge/blob/1.8.0/mods/world-editor/extended.mod.json)，其中 Keyboard shortcuts、Blueprint placement 和 Native entity operations 分组均使用 tab: true。&lt;br /&gt;
&lt;br /&gt;
&amp;lt;span id=&amp;quot;Saved_values_and_compatibility&amp;quot;&amp;gt;&amp;lt;/span&amp;gt;&lt;br /&gt;
== 已保存值和兼容性 ==&lt;br /&gt;
&lt;br /&gt;
现有字符串选项标签、已保存数组、未设置 &amp;lt;code&amp;gt;tab&amp;lt;/code&amp;gt; 的分组以及未使用 &amp;lt;code&amp;gt;optionGroups&amp;lt;/code&amp;gt; 的本地化文件无需迁移即可继续使用。只有选项超过 12 个的多选列表才显示搜索控件。分组选项对象、&amp;lt;code&amp;gt;tab: true&amp;lt;/code&amp;gt; 和本地化文件中的 &amp;lt;code&amp;gt;optionGroups&amp;lt;/code&amp;gt; 需要 ShroudForge 1.8.0 或更新版本。旧版本会拒绝无法识别的字段。&lt;br /&gt;
&lt;br /&gt;
[[Category:Modding:Shroudforge]]&lt;br /&gt;
&lt;br /&gt;
[[Category:Mod-extended-json]]&lt;/div&gt;</summary>
		<author><name>Bonsaibauer</name></author>
	</entry>
</feed>