Collective

作者：Serilum

🎓 Collective 是 Serilum 所有模组共用的前置库，包含通用代码。

模组 Fabric Forge NeoForge Quilt 前置库

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

Collective 是一个共享前置库模组，包含 Serilum 所有模组的通用代码。

它将数据和函数集中在一个地方。Collective 在维护所有 Fabric、Forge 和 NeoForge 模组加载器版本方面提供了极大帮助。

访问该前置库的代码环境为当前和未来的项目功能创造了可能性。当某个与许多其他模组相关的函数得到改进时，更新过程也会变得更加容易。例如，这意味着只需更新一个项目，而不是六个。这节省了时间，也让我更开心一些。

功能：

管理所有依赖模组的配置文件和游戏内菜单。¹
提供变量以增强与其他项目的兼容性。
大量实用函数，防止代码重复。²
用于替换和重新生成实体的事件。
允许切换捆绑模组的功能。 ³
包含用于访问私有字段的访问转换器/拓宽器。 ⁴
网络代码，可通过 Common 源集发送数据包。
集中管理主要版本变更的向后兼容性。
为依赖模组提供可选的异步更新检查器，并将结果输出到控制台。
Collective 管理所有依赖模组的翻译文件。
使用 /collective config 命令查看和更改每个依赖模组的配置。
以及更多！ ⁵

所有可用的配置选项：

显示剧透

enableUpdateChecker 默认 true
Collective 是否应在依赖模组有可用更新时在控制台显示消息。更新检查是可选的且为异步。

transferItemsBetweenReplacedEntities 默认 true
启用后，从任何依赖 Collective 的实体生成模组所替换的实体处转移其手持物品和盔甲。

loopsAmountUsedToGetAllEntityDrops 默认 100，最小 1，最大 500
Collective 为程序化获取所有可能的生物掉落物而循环的次数。仅当依赖模组使用掉落物时才会生成。降低此值可加快世界加载时间，但会降低准确性。

findABlockCheckAroundEntitiesDelayMs 默认 30000，最小 0，最大 3600000
实体周围是否存在方块的检查延迟，单位为毫秒。用于依赖世界中特定方块状态的模组。如有需要，增加此数值可提高 TPS。

enablePatronPets 默认 true
为赞助者启用宠物。将在未来版本中添加。

downloadNonEnglishTranslations 默认 true
当客户端语言设置为非英语时，Collective 是否应尝试下载翻译。使用来自 https://github.com/Serilum/.translations 的文件，通过 https://translations.serilum.com/ 下载。由 CloudFlare Pages 托管。

pushTranslationResourcePack 默认 false
在服务器上，向未安装 Collective 的加入玩家发送资源包，以便服务端 Serilum 模组的自定义物品名称以其自身语言显示。默认关闭；关闭时他们将看到服务器语言（参见 serverLanguage）。

requireTranslationResourcePack 默认 true
将资源包标记为必需，这样意外拒绝只会踢出玩家并在下次加入时再次询问，而不是被永久记住。关闭此项可使其变为可选。

serverLanguage 默认 en_us
未安装 Collective 且未被发送资源包的玩家所看到的 Serilum 模组文本语言。使用如 en_us 或 de_de 之类的区域代码。

itemNameTranslationMode 默认 auto
当资源包关闭时，未安装 Collective 的玩家看到的自定义物品名称显示方式。’auto’ 复制第一个加入的玩家并记住它；’server’ 始终使用服务器语言；’client’ 使用每个玩家自己的语言，但未安装 Collective 的玩家将看到原始键名。

configScreenGuiScale 默认 0，最小 0，最大 10
Serilum 模组配置界面的 GUI 缩放比例，也可通过这些界面上 ? 旁边的按钮设置。0 使用游戏自身的 GUI 缩放。

updateMinecraftWindowTitleInDevMode 默认 false
用于我的本地开发流程。在生产环境中无效，仅在安装了 Collective 并从 IDE 运行时生效。

Collective 配置命令适用于所有使用配置的 Serilum 依赖模组。编辑这些配置需要作弊权限。

/collective – 显示命令用法。
/collective config – 列出带有配置的模组。
/collective config <modid> – 显示某个模组的所有设置及其值。
/collective config <modid> get <setting> – 显示某项设置的值、描述和默认值。
/collective config <modid> set <setting> <value> – 修改某项设置。
/collective config <modid> reset <setting> – 将某项设置重置为默认值。
/collective config <modid> add <setting> <id> – 将方块、物品、实体或维度添加到列表设置中。
/collective config <modid> remove <setting> <id> – 从列表设置中移除方块、物品、实体或维度。
/collective config <modid> reload – 重新加载对模组配置文件的所有手动更改。
/collective reset headcache – 重置缓存的玩家头颅数据，例如用于更新皮肤。

1 | 因为我所有的模组都使用 Multiloader 模板，所以在 Common 代码中无法使用内置配置。Collective 包含一套配置代码，所有依赖模组都会使用它。这会添加一个游戏内配置菜单，并在 ‘.minecraft/config/serilum/‘ 中生成文件。
< Common 的 配置代码 >