Upstack
一款开源模组,允许配置常见物品的最大堆叠数量。
修复了部分物品被设为可堆叠时出现的漏洞。
免责声明: 本模组为个人兴趣项目,因此不保证对任何特定版本或功能的支持。欢迎提供反馈和功能请求(无需期待回应)。
兼容性
Upstack 必须在_客户端和服务器端_同时安装才能正常运行(其补丁为双端生效)。
版本支持
| MC |
NeoForge |
Fabric |
| 1.21.1 |
✅ |
✅ |
依赖项
模组集成
- Vanilla Backport
- Pastel
- Farmer's Delight
- Cobblemon
配置
可以通过游戏中的模组按钮(Fabric 需要 Mod Menu)或手动编辑 config/upstack-common.toml 来配置 Upstack。
最大堆叠数量
可以为配置文件中列出的物品和物品标签设置最大堆叠数量。
更改在服务器重启后生效。
默认配置增加了几个常用物品的最大堆叠数量,包括水桶
(1 → 16) 和音乐唱片 (1 → 64)。将物品的最大堆叠数量设置为 0 可保留其原始值。
单个物品设置的值会覆盖其所属标签的值。
例如,物品 minecraft:bucket 的堆叠数量(默认:64)会覆盖其标签 #c:buckets 的值
(默认:16)。
如果一个物品通过数据包包含在两个不同值的标签中,其中一个值将优先生效,
但具体是哪个值优先则未定义。
使用冷却时间
可以为配置文件中列出的物品设置使用冷却时间。
更改立即生效。
默认配置为雪球(5 刻)和投掷药水(10 刻)添加了适度的冷却时间,以平衡
它们增加的堆叠数量。将物品的使用冷却时间设置为 0 可完全移除其冷却时间。
Upstack 是如何工作的?
在服务器启动时,Upstack 会修改每个已配置物品的最大堆叠数量组件。设置为超出范围
[1, 99] 的物品不会被修改。
在大多数情况下,修改物品的堆叠数量不会改变其预期行为。
然而,有几个已知的例外情况,会导致不同的问题:
- 一匹马/驴/骡子可以装备多个鞍(冗余)。
- 可以在织布机上同时放置多个旗帜图案,尽管旗帜图案是非消耗性的(冗余)。
- 放置一个粉雪桶会删除堆叠中的所有剩余物品(漏洞)。
- 在铁砧中将 X 个物品的堆叠与 Y 本附魔书的堆叠结合,违反了物品守恒(漏洞,利用)。
- 即使附魔书不足(Y < X),也会为所有 X 个物品附魔。
- 即使要附魔的物品较少(X < Y),也会消耗所有 Y 本附魔书。
- 经验消耗为附魔一个物品经验的 Y 倍,即使实际附魔的物品数量不同(X /=
Y)。
- 投掷溅射药水、滞留药水、鸡蛋和雪球没有冷却时间,尽管这可能导致平衡
问题(平衡性问题)。
Upstack 注入以下补丁来解决这些问题:
- 将马/驴/骡子的鞍槽的最大堆叠数量设置为 1。
- 将织布机的旗帜图案槽的最大堆叠数量设置为 1。
- 当放置粉雪桶时,减少堆叠数量而不是删除整个堆叠。
- 当将 X 个物品的堆叠与 Y 本附魔书的堆叠结合时:
- 每次只附魔 1 个物品。
- 每次只消耗 1 本附魔书。
- 经验消耗为附魔一个物品的经验。
- 为溅射药水、滞留药水、鸡蛋和雪球添加可选的、可配置的冷却时间。
功能路线图
计划中
- 使最大堆叠数量漏洞修复可切换,以防与其他模组发生不可预见的冲突。
- 当未在服务器上安装时禁用模组功能。
- 确保模组配置从服务器同步下来,特别是冷却时间。
- 使最大堆叠数量修改数据驱动,同时保留通过配置文件修改常见物品/标签的能力。
考虑中
- 添加与允许最大堆叠数量超过 99(原版上限)的流行模组的兼容性。
不计划
- 使最大堆叠数量能够超过 99(原版上限)。提高原版的最大堆叠数量限制并解决随之而来的漏洞和模组冲突不在本模组的范围内。
Upstack
An open-source mod which makes the max stack size of common items configurable.
Patches bugs that occur when some items are made stackable.
Disclaimer: This mod is a passion project, so support for any particular version or feature
is not guaranteed. Feedback and feature requests (without expectation) are welcome.
Compatibility
Upstack must be installed on both the client and the server to function properly (its patches are dual-side).
Version Support
| MC |
NeoForge |
Fabric |
| 1.21.1 |
✅ |
✅ |
Dependencies
Mod Integration
- Vanilla Backport
- Pastel
- Farmer's Delight
- Cobblemon
Configuration
Upstack can be configured in-game through the mods button (requires Mod Menu on
Fabric) or by manually editing config/upstack-common.toml.
Max Stack Size
Max stack sizes can be configured for items and item tags listed in the config.
Changes do not apply until the server is restarted.
The default configuration increases the max stack size of several commonly desired items, including water buckets
(1 → 16) and music discs (1 → 64). Set an item's max stack size to 0 to preserve its original value.
The value set for an individual item overrides the value set for any of its tags.
For instance, the stack size of item minecraft:bucket (default: 64) overrides the value of its tag #c:buckets
(default: 16).
If one item is included in two different-valued tags using a datapack, one of the values will take precedence,
but which one does so is undefined.
Use Cooldown
Use cooldowns can be configured for items listed in the config.
Changes apply immediately.
The default configuration adds modest cooldowns to snowballs (5 ticks) and throwable potions (10 ticks) to balance
their increased stack sizes. Set an item's use cooldown to 0 to remove its cooldown completely.
How does Upstack work?
On server startup, Upstack modifies the max stack size component of each configured item. Items set to values outside
[1, 99] are not modified.
In most cases, modifying an item's stack size doesn't change its expected behavior.
However, there are several known exceptions, each resulting in different issues:
- Multiple saddles can be equipped to one horse/donkey/mule (redundant).
- Multiple banner patterns can be placed in a loom at a time, even though banner patterns non-consumable (redundant).
- Placing one powder snow bucket deletes all remaining items in the stack (bug).
- Combining a stack of X items with a stack of Y enchanted books in an anvil violates item conservation (bug, exploit).
- Enchants all X items, even if there aren't enough enchanted books to do so (Y < X).
- Consumes all Y enchanted books, even if there are fewer items to enchant (X < Y).
- Costs Y times the experience of enchanting one item, even if the actual number of items enchanted differs (X /=
Y).
- Throwing splash potions, lingering potions, eggs, and snowballs has no cooldown, even though this could cause balance
issues (balance issue).
Upstack injects the following patches to address these issues:
- Set the max stack size of the horse/donkey/mule's saddle slot to 1.
- Set the max stack size of the loom's banner pattern slot to 1.
- When a powder snow bucket is placed, decrement the stack size instead of deleting the stack.
- When a stack of X items is combined with a stack of Y enchanted books:
- Enchant only 1 item at a time.
- Consume only 1 enchanted book at a time.
- Cost the experience of enchanting one item.
- Add optional, configurable cooldowns to splash potions, lingering potions, eggs, and snowballs.
Feature Roadmap
Planned
- Make max stack size bug fixes toggleable, in case of unforeseen conflicts with other mods.
- Disable mod features when not also installed on the server.
- Ensure mod configs are synced down from the server, especially cooldowns.
- Make max stack size modification data-driven, while retaining the ability to modify common items/tags through the
config.
Considering
- Add compatibility with popular mods which make max stack sizes able to exceed 99 (the Vanilla limit).
Not Planned
- Make max stack sizes able to exceed 99 (the Vanilla limit). Increasing Vanilla's max stack size limit and resolving
consequent bugs and mod conflicts is out of the scope of this mod.
评论 0
登录后参与评分
还没有评论,来抢沙发吧