StackSizer - (无XML)无忧物品堆叠管理器

StackSizer - (无XML)无忧物品堆叠管理器

厌倦了不断修改XML,试图应对来自不同模组的不同堆叠?或者你只是想提高基础游戏的堆叠数量,让更多物品可堆叠?不用再找了,StackSizer来拯救你!Discord:https://discord.com/invite/6DDHYa7dV7

[center][font=Arial Black][b][color=#00ff00]Discord 已上线!服务器仍在建设中,但你可以加入并保持关注,在这里提出建议和报告问题:
[url=https://discord.com/invite/6DDHYa7dV7]https://discord.com/invite/6DDHYa7dV7[/url][/color]
[/b][/font][color=#ff0000][size=4][b][u]
由于 2.6 版本的使用越来越少,我认为为此进行向后移植和重复工作已无意义。从 StackSizer 1.3.1 版本起,2.6 将停止支持。[/u][/b][/size][/color][/center]
[center][/center]

在[单人游戏]和[专用服务器]中安全地增大和管理堆叠数量,配有简洁的游戏内 UI、服务器权威同步,且在专用服务器中[零客户端文件写入]!

[list=1]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#why]为什么?[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#whatitdoes]它做什么?[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#howitworks]它如何工作?[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#installation]安装[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#usingit]使用[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#leveledgear]关于等级装备的说明[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#configurationfile]配置文件示例[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#compatibility]兼容性[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#troubleshooting]故障排除[/url][/]
[][url=https://www.nexusmods.com/7daystodie/mods/10754#changelog]更新日志[/url][/]
[/list][heading][url=https://www.nexusmods.com/7daystodie/mods/10754#why]为什么?[/url][/heading]
就这么简单——我只是厌倦了在想要尝试一些包含物品的新模组时,不断翻找 XML、物品定义、一遍又一遍地检查所有内容。而且有些本应可以堆叠的物品,比如小型引擎,却不能堆叠,在几个人一起玩的时候,背包开始变得又大又乱,每种物品都要一个单独的箱子,这太累人了,即使有自动整理模组也一样。所以我产生了创建这样一个东西的想法。它简单、快速,允许在服务器上即时更新,无需更改客户端和服务器中的几十个 XML 或其他文件。

更详细的解释如下:

模组包会将物品定义分散在许多 XML 中。手动查找这些内容并保持堆叠数量一致既繁琐又容易出错,尤其是在安装了多个模组或模组更新时。

仅为调整堆叠大小而包含多个 XML 有时很痛苦,需要了解游戏物品及其本地化知识。此模组利用游戏内工具和代码,使其尽可能简单——一个集中管理所有物品堆叠的地方。
[b]StackSizer[/b] 为你提供了一个[简单、全局的工具]来提升所有物品的堆叠数量,并配有[直观的 UI]来按需添加例外:
[list]
[][一个地方]管理堆叠,无论你使用多少内容模组。[/]
[][一键]应用全局,而不是编辑几十个 XML。[/]
[]通过覆盖对棘手物品(弹药、资源、战利品等)进行[精细控制]。[/]
[/list]在多人游戏中,服务器保持控制权,因此每个人看到的堆叠都相同,不会出现冲突或不同步。
[line]
[color=#fafafa][size=4][url=#whatitdoes]它做什么[/url]?[/size][/color]
[list]
[]为(几乎)所有物品设置[全局]堆叠数量。[/]
[]或者使用[倍数](1-100,允许小数)来缩放所有物品——每个物品从其自身的基础数量增长。[/]
[]当你想要为特定物品设置不同值时,可以添加[逐物品覆盖]。[/]
[]可以[跳过]你希望保持正常堆叠数量的物品。[/]
[]可以将更改限制为[仅原版物品](同时读取 items.xml 和 item_modifiers.xml)。[/]
[]可以将[建筑方块]和[形状变体]排除在全局更改之外(除非明确覆盖)。[/]
[]"[仅增加]"模式可避免降低已有的上限。[/]
[]不处理[等级/品质装备](武器、工具、护甲),因此它们永远不会丢失等级条,同时仍允许普通物品和模组堆叠。[/]
[]可选的[堆叠等级装备]开关,如果你确实希望相同装备堆叠——只有完全相同的、无模组的、未使用的物品才会合并,因此不会丢失任何状态。[/]
[]附带[游戏内 UI](背包扳手按钮 + Esc 菜单按钮 + 控制台命令)。[/]
[]专用服务器中[服务器权威]:服务器推送设置;客户端在内存中应用。[/]
[/list][line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#howitworks]它如何工作[/url](高层概述)[/heading]
[list=1]
[][客户端加入]服务器 -> 发送一次性的“同步我”握手。[/]
[][服务器]在本地应用其配置,然后推送[标志、全局、覆盖]并命令[客户端应用]。[/]
[][客户端]在内存中应用并运行几次延迟处理以捕获延迟加载的物品。[/]
[][离开]服务器 -> 客户端[恢复]为其自己的本地 StackSizerConfig.xml。[/]
[/list][quote]在单人游戏/主机中,同一个 UI 在本地打开并写入你的本地配置。[/quote][line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#installation]安装[/url](如果计划在专用服务器上使用,请在服务器和客户端上都安装,禁用 EAC)[/heading]
在这两种情况下,如果你使用的是专用服务器或单人游戏,只需复制:

[code]ZZZZ_StackSizer[/code]
到你的 Mods 目录中。

[b]重要的是此模组必须最后加载,这样它才能获取游戏中和来自模组的所有必需文件和物品。[/b]
[line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#usingit]使用[/url][/heading]
打开 UI
[list]
[]点击背包标题栏上的[扳手按钮],或使用游戏内菜单按"[Esc]"按钮,或[/]
[]控制台:
[code]stacksizer ui[/code][/
]
[/list]进行更改
[list]
[]设置[全局默认值],或打开[使用倍数]来从每个物品自身的基础数量进行缩放。两者同时只使用一个。[/]
[]按需切换标志:
[list]
[
][i]仅原版[/i] 仅影响基础游戏物品。[/]
[
][i]仅增加[/i] 避免降低现有上限。[/]
[
][i]包含建筑方块[/i] 关闭以跳过方块(除非被覆盖)。[/]
[/list][/
]
[]添加覆盖:在左侧搜索物品(搜索支持游戏语言) -> 选择一个物品 -> 设置覆盖值 -> 点击“添加所选覆盖” -> 应用更改,搞定,完成。[/]
[]或点击“跳过物品”让某物保持正常大小。[/]
[/list]应用:
[list]
[]在单人游戏(本地)中,配置更新到 XML 中,并重新加载堆叠。[/]
[]在专用服务器上,服务器保存并推送到所有连接的客户端。[/]
[/list]控制台命令(供管理员使用)
[code]stacksizer ui
stacksizer apply
stacksizer set global <value>
stacksizer set multiplier <value> # 1-100,允许小数;当 'usemultiplier' 标志开启时使用
stacksizer flag <applytoall|vanilla|onlyincrease|includeblocks|includeshapes|stackleveled|beltsingle|usemultiplier|allowextendedstacks|beltsinglewear> <on|off>
stacksizer override <set <item> <value> [creative] | del <item> | clear> # 追加 'creative' 让被置空(值为 0)的物品仍可从创造菜单中获取
stacksizer exclude <add <item> | del <item> | clear>
stacksizer admin <level> # 仅限 perm-0
stacksizer diag [on|off|cap <n>|dump <itemName>][/code][line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#leveledgear]关于等级装备的说明[/url][/heading]
默认情况下,此模组不处理武器、工具和护甲,以保持其品质条。如果你真的希望它们堆叠,请打开[堆叠等级装备]开关——但只有完全相同的、无模组且无磨损的物品才会合并。一旦物品被使用或修改,它就会分离回自己的槽位,因此你永远不会丢失耐久度或已安装的模组。而且当装备被堆叠时,你无法在其上安装模组(修改按钮会变灰并显示提示)——先将一个物品从堆叠中取出,然后再安装模组。这是引擎的限制,不是偷懒:一个堆叠只存储一个共享的物品状态。
[line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#configurationfile]配置文件[/url][/heading]
[b]Mods\StackSizer\Config\StackSizerConfig.xml[/b](多人游戏中由服务器写入;单人游戏/主机中由本地游戏写入)。

示例:
[code]<stacksizer>
<globalDefault>10000</globalDefault>
<!-- stackMultiplier 在 useMultiplier 开启时缩放每个受影响物品的堆叠数量
(1 到 100,允许小数,例如 2.5)。它应用于与
globalDefault 相同的物品集合,从每个物品自身的基础堆叠数量进行乘法。
globalDefault 和倍数永远不会组合使用;结果始终向下取整为
整数,因此物品永远不会出现小数/半个数量。 -->
<stackMultiplier>2</stackMultiplier>
<!-- includeBlocks=true 表示包含建筑方块。
设为 false 以跳过方块(除非明确覆盖)。
includeShapes=true 表示包含方块/形状变体(名称如
'frameShapes:plate...')。设为 false 以跳过
形状(除非明确覆盖)。
useMultiplier=true 使 Stack Sizer 使用 stackMultiplier 而非
globalDefault 作为全局堆叠数量(两者永远不会组合使用)。
stackLeveled=true 允许品质/等级装备堆叠。
strictGearStats=true(与 stackLeveled 一起)仅堆叠属性匹配的装备。
allowExtendedStacks=true 保持超过 65534 的堆叠(否则会被限制)。
beltSingleWear=true 将可穿戴装备限制为每个腰带槽位一个。 -->
<flags applyToAll="true" vanillaOnly="true" onlyIncrease="false" includeBlocks="false" includeShapes="false" useMultiplier="false" stackLeveled="false" strictGearStats="false" allowExtendedStacks="false" beltSingleWear="false"/>
<adminLevel>0</adminLevel>
<overrides>
<entry key="9mmBullet" value="5000" />
<entry key="gunPowder" value="20000" />
<!-- 值为 0 会将物品置空,在整个游戏中禁用它;添加 allowCreative="true" 仍允许从创造菜单中获取 -->
<entry key="oldCash" value="0" allowCreative="true" />
</overrides>
<exclusions>
<!-- 排除示例,使用游戏中的物品名称
<name>questNote</name> -->
</exclusions>
<!-- 诊断 -->
<diagnostics enabled="false" cap="100"/>
</stacksizer>[/code][line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#compatibility]兼容性[/url][/heading]
[list]
[]与原版和大多数内容模组兼容。[/]
[][仅原版]模式较为保守:只影响基础游戏 XML 中存在的物品。[/]
[][建筑方块]可以通过一个开关全局排除(并通过覆盖逐物品重新包含)。[/]
[/list][line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#troubleshooting]故障排除[/url][/heading]
[list]
[][UI 不打开:] 确保模组已安装;在单人游戏/主机中尝试 [stacksizer ui]。检查所需的权限级别。[/]
[
][在专用服务器上非管理员玩家的设置不同步:] [stacksizer] 命令注册在最低玩家权限级别(1000),以便每个客户端都能运行加入时同步握手并接收服务器推送的配置。更改设置的子命令(ui、apply、flag、set、override、exclude、admin、diag)仍受 adminLevel 限制。如果你之前在 serveradmin.xml 中将 [stacksizer] 固定为更严格的级别,请将其恢复为 1000(或删除该条目)以使客户端同步正常工作。[/]
[
][日志太多:] 保持诊断关闭,或设置较低的诊断上限。[/]
[
][某些物品(例如手电筒)不堆叠:] 游戏中的某些物品是武器,不显示品质或等级。默认情况下,此模组不处理或不允许任何有品质或等级的物品堆叠。[/]
[
][我无法堆叠铁砧/风箱/坩埚等工具:] 工作站工具具有品质,因此默认像其他等级装备一样保持单个。打开[堆叠等级装备]开关(UI 切换或 [stacksizer flag stackleveled on]),它们就可以在你的背包/储物中堆叠。只有完全相同的工具(相同品质/耐久度,无模组)才会合并。它们放入的工作站工具槽位仍一次只能容纳一个物品。[/]
[
][我希望我的武器/工具/护甲堆叠:] 打开[堆叠等级装备]开关。这是一个高级的、默认关闭的选项。只有完全相同的、无模组或外观的装备才会堆叠——相同品质和耐久度。一旦物品被使用(耐久度变化)或安装了模组,它就会分离并保持在自己的槽位中。这是一个硬性的引擎限制:一个堆叠只存储一个共享的物品状态。[/]
[
][我无法在堆叠的武器/工具/护甲上安装模组:] 这是有意为之。一个堆叠共享单个物品状态,因此安装模组会将其应用于整个堆叠,而只消耗一个模组——导致物品复制/销毁。当[堆叠等级装备]开启时,对任何多于一个物品的堆叠,修改操作都会变灰。将一个单位从堆叠中拖到空槽位,然后在该单个物品上安装模组。[/]
[
][物品没有堆叠,尽管我希望它堆叠:] 使用诊断工具 [stacksizer diag dump itemName] 检查物品是否可以堆叠。如果不行,它可能被排除了;如果你仍然希望它可以堆叠,请添加覆盖。默认情况下这应该不是必需的,且是预期行为——模组利用游戏内机制来决定哪些物品可以堆叠,但你仍然可以覆盖任何你喜欢的物品。[/]
[/list]
[line]
[heading][url=https://www.nexusmods.com/7daystodie/mods/10754#changelog]更新日志[/url][/heading]
[b]1.3.1[/b]
[b]新增:[/b]
[list]
[
]逐覆盖的 allowCreative="true" 标志:以这种方式标记的被置空物品(覆盖值 0)仍可从创造菜单中获取,同时在其他所有地方保持置空状态。在配置文件中设置,或使用 stacksizer override set &lt;item&gt; 0 creative。[/
]
[]背包扳手按钮可以重新定位:按住约两秒钟,然后拖到你想要的位置;其位置按客户端保存。[/]
[/list]
[b]修复:[/b]
[list]
[]任务物品不再被强制堆叠或调整大小,修复了共享收集任务错误计算拾取物品数量的问题;现在也拒绝在任务物品上设置覆盖。[/]
[]不同品质的改装物品从武器中快速移出时不再合并为一个堆叠。[/]
[]整理背包或容器不再将已经大于配置堆叠数量的堆叠缩小回该数量(之前任何超过上限的多余部分可能会被推出或在现有世界中丢失);超大的堆叠现在保持不变。[/]
[]被置空的物品现在在所有之前可能泄漏的地方都被隐藏:战利品容器、掉落的战利品袋、世界掉落物和创造菜单;它们也不能通过 giveself/give 生成(控制台会解释原因)。[/]
[]被置空的物品不能再从任何槽位(创造菜单、战利品、储物、车辆等)通过任一点击拾取;开发/编辑模式对管理员仍正常运作。[/]
[]掉落在世界中的被置空物品,如果在物品操作运行期间(例如装弹)走过它,可能会重新掉到地上而不是消失;现在在这种情况下它也会消失。[/]
[/list]
[b]1.3.0[/b]
新增:
[list]
[][b]“允许超过 65534 的堆叠”选择加入,用于超过原版保存限制的堆叠。关闭时,全局默认值和覆盖上限为 65534,因此存档保持与原版兼容,永远不会悄悄丢失物品。开启后,超过 65534 的堆叠在存档、重新加载和网络同步中都会保留。此类存档需要 StackSizer 才能加载,并且每个多人游戏客户端和服务器都必须运行相同的构建。关闭该开关会将超大堆叠非破坏性地拆分为安全堆叠——跨空槽位分配而不是截断,当没有空间时保留剩余部分而不是丢弃。在多人游戏中,这适用于每个玩家,包括稍后加入的玩家。该开关在开启时提示一次:只要 StackSizer 仍安装,超大堆叠就会被保留;在关闭时提示一次:拆分它们。开启提示还警告:当你的腰带和背包已满时,关闭此选项可能会丢失不再适合的物品。[/b][/]
[]“腰带中单个耐久物品”选择加入(默认关闭):会磨损的物品(武器、工具等)限制为每个工具栏槽位一个。放置更大的堆叠时,在那里保留一个物品,其余的返回背包。[/]
[]拆分超大堆叠时会显示游戏内弹窗;如果没有空闲的腰带/背包槽位容纳溢出部分,会警告你在保存前腾出空间。[/]
[]降低堆叠数量永远不会重写你的实时背包:已经超过降低后上限的堆叠保持原样(不强制拆分,不丢失物品),弹窗只是告诉你它们存在。只有当你移动它们时,它们才会缩小到新限制。[/]
[]模组的 UI、工具提示和消息现在跟随游戏内语言;未翻译的文本回退到英语。[/]
[]等级改装现在遵循“堆叠等级装备”开关:只有在开启时才堆叠,且只与相同等级堆叠,就像等级装备一样。[/]
[]物品信息面板现在显示等级/品质装备的堆叠数量(显示为“等级/数量”),与背包格子一致。[/]
[/list]修复:
[list]
[]用模组、染料、等级或耐久度不同的同类型物品替换腰带物品时不再复制其模组/染料;两个物品现在交换,而不是用放置的物品副本覆盖原有物品。[/]
[]在主机的游戏内 UI 中更改选项现在立即应用于连接的多人游戏玩家,而不是仅在手动重新应用后。[/]
[]在同一会话中启动第二个世界会自动重新应用堆叠上限,而不是让物品保持原版大小直到点击“应用”。[/]
[]堆叠上限现在也在世界/预制编辑器内应用,因此等级/品质装备在那里也可以堆叠(仅运行时,永远不会烘焙到保存的预制中)。[/]
[]返回世界/预制编辑器不再让物品以原版大小不堆叠:StackSizer 检测到就地物品重新加载并自动重新应用上限。[/]
[]诊断现在是每台机器的本地设置——客户端打开或关闭自己的诊断不再改变服务器上的设置,保持服务器独立并对共享配置具有权威性。[/]
[]相同的等级装备(相同等级和耐久度)在移动或拆分后因隐藏的空元数据差异而停止堆叠的,现在会再次堆叠。[/]
[]修理堆叠的等级物品现在会被阻止,而不是销毁第一个之后的每个物品;阻止消息适用于修改和修理。[/]
[/list]
[b]1.2.0[/b]
新增:
3.0 稳定版来了!
[list]
[]翻译来了——请注意,所有翻译都是使用 AI 完成的,可能不准确。如果你想贡献,请在 Discord 或这里的讨论中留言。[/]
[]勾选仅原版时,应用到全部被禁用以避免混淆。[/]
[]在 3.0 中,一些物品现在有不同的属性——启用带等级堆叠此类物品的开关,启用时——相同等级的物品在属性相同之前不会堆叠。否则所有相同等级的物品将被堆叠,所有独特属性将合并为通用默认值。(不适用于 2.6,因为不同物品没有不同属性。)[/]
[/list]修复:
[list]
[]在 UI 中勾选选项或更改值时,除了覆盖之外,无需点击“应用”,所有其他选项都会自动应用并同步。
[/
]
[/list][b]1.1.1[/b]
修复:
[list]
[]允许同等级等级物品在工作站输出/组合网格中重新堆叠[/]
[]手持光源物品(如蜡烛)不再被视为建筑方块[/]
[]修复新制作的装备无法堆叠到已存在的相同输出堆叠上的问题[/]
[]硬性阻止在堆叠的等级物品上打开修改窗口[/]
[/list]
[b]1.1.0[/b]
新增:
[list]
[]倍数模式作为全局默认值的替代方案(1-100,接受小数如 2.7)。[/]
[]可选的“堆叠等级装备”开关——只有完全相同的、无模组的装备才会合并,一旦被使用或修改就会立即分离。[/]
[]该开关开启时,工作站工具在你的背包中可堆叠(工作站槽位仍只接受一个物品)。[/]
[]在堆叠物品上阻止修改,以免模组被复制或丢失。[/]
[/list]修复:
[list]
[]当背包已满时 shift 移除失败,镶嵌模组/染料不再被删除。[/]
[]从堆叠的镶嵌槽中移除时不再复制模组/染料。[/]
[]Shift+点击不再将不同等级或带模组的装备合并在一起。[/]
[]相同的同等级装备在交换时正确重新堆叠。[/]
[]关闭标志现在会正确恢复被增大的堆叠数量。[/]
[]延迟加载的物品和多人游戏设置现在能可靠地获得其堆叠数量。
[/
]
[/list][b]1.0.1[/b]
修复:
[list]
[]修复了无法为车辆添加模组的问题。[/]
[]燃烧瓶现在正确堆叠[/]
[]修复了服务器上的同步问题[/]
[]不同等级但可堆叠的物品不再互相吞并[/]
[]少量代码清理[/]
[/list]