
CoolCatLib 现在提供的所有功能都整合在单个文件中:从版本 5 开始,适用于 Minecraft 26.1 – 26.1.2、1.21.1 上的 2100.3.0.0 以及 1.20.1 上的 2001.3.0.0。
✨ 简介
一次编写,处处运行。 CoolCatLib 是多加载器模组(multi-loader mods)的完美基础:只需在通用代码中编写一次你的模组,即可在 Fabric、NeoForge 和 Forge 上运行。
📦 玩家请注意:这是一个库。它本身不添加任何内容;当其他模组要求安装时再安装它。
🐾 一套代码,适配所有加载器
只需配置一次你的模组,然后在通用代码中注册内容、监听事件并发送数据包。无需维护针对各加载器的独立类,也无需编写数据包编解码器:一条记录即为完整的数据载荷。
⚙️ 以代码形式配置
声明设置项一次,包含其默认值、范围及注释。CoolCatLib 负责处理配置文件、验证、实时重载、将服务器设置同步给玩家,以及用于更改设置的命令。
🎨 内置视觉效果
屏幕特效、自定义天空、世界特效和过场动画,仅需一两行调用即可实现,且可由服务器控制,此外还包含用于打造精致界面的小部件。
📚 了解更多

Everything CoolCatLib offers now ships in a single file: from version 5 on Minecraft 26.1 – 26.1.2, 2100.3.0.0 on 1.21.1 and 2001.3.0.0 on 1.20.1.
✨ About
Write it once, run it everywhere. CoolCatLib is the purr-fect foundation for multi-loader mods: write your mod once in common code, and it runs on Fabric, NeoForge and Forge.
📦 Players: this is a library. It adds nothing by itself; install it when another mod asks for it.
🐾 One codebase, every loader
Set your mod up once, then register content, listen to events and send packets from common code. There are no per-loader classes to keep in step and no packet codecs to write: a record is the whole payload.
⚙️ Configs as code
Declare a setting once, with its default, range and comment. CoolCatLib takes care of the file, validation, live reloading, syncing server settings to players, and the commands to change them.
🎨 Visuals built in
Screen effects, custom skies, world effects and cutscenes, each a call or two away and controllable from the server, plus the widgets for polished screens.
📚 Learn more
- 🧩 Full feature list: everything else in the box
- 📖 Documentation: guides and the API reference
- 🐛 Issues: bug reports and ideas
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoolCatLib
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
v9.0.0 发布 | 2026年11月16日
✨ 新功能
ModCommands(api.command):将模组的服务器命令与其模组 ID 及命令名称注册在一起,第一个为命令本名,其余为具有相同功能的别名,例如ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...))。如果某个名称已被其他命令占用(原版/tm或其他模组的命令),则会跳过并记录警告日志。ModCommands.registerClient(modId, names, (root, context) -> ...)对客户端命令执行相同操作。除了指定名称外,客户端命令还可以使用其服务器命令的名称:ClientNames.MERGED共享它们(玩家只有一个/folios:客户端部分能运行的保留在客户端,其余发送到服务器),ClientNames.SUFFIXED添加后缀_client(在/ua旁增加/ua_client)。- 每个拥有 CoolCatLib 配置的模组都会在其自身的命令下获得一个配置命令:
/<command> config打开模组的配置界面,/<command> config <config>打开其中一个(例如/folios config client)。任何人都可以打开这些界面;具体能修改哪些内容仍取决于各个配置的编辑权限。 /<command> config reload [config]:在手动手动编辑配置文件后重新读取模组的配置文件,无需重启游戏(供管理员使用):服务器的配置文件在服务端读取,玩家的客户端配置文件在各自的游戏中读取。/coolcatlib config [mod] [config]和/coolcatlib config reload [mod] [config]对所有模组执行相同操作;在没有 CoolCatLib 的服务器上,由玩家自己的游戏处理。- 方块实体渲染器支持 1.20.1,API 与 26.1 版本相同(
coolcatcanvas.api.client.blockentity):BlockRenderer支持基于边界的剔除、基于距离的细节调整、朝向和图层(ItemLayer、LabelLayer、ChildLayer);render和图层的submit方法接受MultiBufferSource和Camera。此外还有coolcatcanvas.api.client.registry中的EntityRendererRegistry和ItemRendererRegistry,以及ObjModel。 - 骨架动画支持 1.20.1,API 与 26.1 版本相同(
api.client.armature、api.armature):Armature、Animator、ArmatureMobRenderer、ArmatureEntityRenderer、ArmatureBlockRenderer、ArmatureItems、VanillaModels和ArmatureControl。由于 1.20.1 没有专门的物品模型类型,骨架物品的模型文件(models/item/<item>.json)需通过设置"parent": "builtin/entity"和"coolcatcanvas:armature": {...}来指定其骨架名称。
🔧 更改
- 破坏性更新:Canvas 的 GUI 和渲染辅助类已移至更整洁的包中,位于
net.ixdarklord.coolcatcanvas.api.client下:gui.components和gui.components.widgets移至gui.widget,gui.components.widgets.panel移至gui.panel,gui.components.animations移至gui.animation,utils.ScreenAnchor移至gui.placement,utils.TextEffects移至text,以及utils.RenderUtils、Outline和NineSliceInfo移至render。类名保持不变;使用这些类的模组需更新其导入语句。 - CoolCatLib 的视觉效果再次成为一个独立的模组 CoolCatLib Canvas(
coolcatcanvas),它包含在 CoolCatLib 的 jar 文件中:无需额外安装。基于其 API 构建的模组需要同时依赖net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader>和coolcatlib-<loader>(CoolCatLib 的 POM 文件已命名此依赖)。 /coolcatlib_client已移除:客户端配置命令已成为/coolcatlib的一部分(在没有 CoolCatLib 的服务器上)。- 配置命令不再从聊天中获取、设置或重置值,也不应用预设(
/coolcatlib config <id> get|set|reset|preset):它们现在打开配置界面,所有相关操作均在界面内完成。 /coolcatlib_client config open [mod]现已改为/coolcatlib config [mod] [config]。/coolcatcanvas_client effects现已改为/coolcatcanvas effects。CommandEvents.REGISTER和ClientCommandEvents.REGISTER已弃用:请使用ModCommands(register和registerClient)。通过旧方式注册的命令仍可正常工作,并且仍会获得配置命令:它们会被匹配到其配置构建在相同包中的模组。- 渲染器注册表已移至 Canvas:
BlockEntityRendererRegistry和ItemRendererRegistry位于net.ixdarklord.coolcatcanvas.api.client.registry中。位于net.ixdarklord.coolcatcore.api.client.registry中的注册表仍可工作,但已弃用。
🐛 错误修复
- 当模组同时拥有同名服务器命令和客户端命令时(例如客户端的
/folios guide旁的/folios config),服务器命令不再失效:现在只有服务器命令能执行的操作会正确发送到服务器,而不会像以前那样在客户端因参数错误而失败。
v9.0.0 发布 | 未发布
✨ 新功能
ModCommands(api.command): 将模组的服务器命令与其模组 ID 和命令名称注册,包括其自身名称和其他具有相同功能的别名,例如ModCommands.register("ftbultimineaddition", List.of("ultimine_addition", "ua"), (root, context, selection) -> root.then(...))。如果某个名称已被其他命令占用(原版命令如/tm或其他模组的命令),则会被跳过,并在日志中发出警告。ModCommands.registerClient(modId, names, (root, context) -> ...)对客户端命令执行相同的操作。除了指定名称外,客户端命令还可以使用其服务器命令的名称:ClientNames.MERGED共享它们(对于玩家而言只有一个/folios:客户端部分可以运行的内容保留在客户端,其余部分发送到服务器),ClientNames.SUFFIXED添加_client(在/ua旁边添加/ua_client)。- 每个拥有 CoolCatLib 配置的模组都会在其自己的命令下提供一个配置命令:
/<command> config打开模组的配置界面,/<command> config <config>打开其中一个(例如/folios config client)。任何人都可以打开这些界面;但具体能修改什么仍取决于每个配置的编辑权限。 /<command> config reload [config]允许在手动编辑配置文件后重新读取模组的配置文件,而无需重启游戏(适用于操作员):服务器的配置文件在服务器上重新加载,玩家的客户端配置文件在其本地游戏中重新加载。/coolcatlib config [mod] [config]和/coolcatlib config reload [mod] [config]对所有模组执行相同操作,并且在没有安装 CoolCatLib 的服务器上,玩家可以在自己的游戏中直接执行此操作。
🔧 更改
- 破坏性变更: Canvas 的 GUI 和渲染助手已移至更整洁的软件包下,位于
net.ixdarklord.coolcatcanvas.api.client中:gui.components和gui.components.widgets改为gui.widget,gui.components.widgets.panel改为gui.panel,gui.components.animations改为gui.animation,utils.ScreenAnchor改为gui.placement,utils.TextEffects改为text,以及utils.RenderUtils、Outline和NineSliceInfo改为render。类名保持不变;使用这些类的模组需要更新其导入语句。
coolcatcanvas),它包含在 CoolCatLib 的 jar 文件中:无需额外安装。基于其 API 构建的模组除了 coolcatlib-<loader> 外,还需要 net.ixdarklord.coolcatlib:coolcatlib-canvas-<loader>(CoolCatLib 的 POM 文件中的命名)。coolcatcanvas:包括其着色器和包含文件(#moj_import <coolcatcanvas:screen_effect.glsl>)、文本效果(coolcatcanvas:rainbow、coolcatcanvas:gradient/...)、骨架物品模型类型(coolcatcanvas:armature)、内置效果(coolcatcanvas:tint、coolcatcanvas:bloom)、语言键、按键绑定和载荷 ID。使用 coolcatlib: 命名这些内容的资源包和模组需要改用新名称。效果屏幕的选择和保存的过场动画已移至 config/coolcatcanvas-screen-effects.json 和 config/coolcatcanvas/cutscenes/,并从原位置迁移过来。ConfigEffect 和 ConfigEffects 已移至 net.ixdarklord.coolcatcore.api.config.client,深色或浅色选择保存在 config/coolcatlib-style.json 中。/coolcatlib_client 已被移除:客户端的配置命令现在是 /coolcatlib 的一部分(在没有 CoolCatLib 的服务器上),而视觉效果的命令是 /coolcatcanvas effects 和 /coolcatcanvas cutscene ...。/coolcatlib config <id> get|set|reset|preset):它们会打开配置屏幕,所有操作都在那里完成。CommandEvents.REGISTER 和 ClientCommandEvents.REGISTER 已弃用:请使用 ModCommands(register 和 registerClient)。通过它注册的命令仍然有效,并且仍然会获得配置命令:它们会与配置构建在同一包中的模组匹配。net.ixdarklord.coolcatcanvas.api.client.registry 包下:BlockEntityRendererRegistry、EntityRendererRegistry 和 ItemRendererRegistry(原为 SpecialModelRendererRegistry;用于注册由代码绘制的物品模型类型)。位于 net.ixdarklord.coolcatcore.api.client.registry 中的旧注册表仍可正常使用,但已被弃用。ArmatureBlockRenderer 的工作方式与其他 BlockRenderer 类似:它通过 facing(Facing) 确定朝向(默认为 Facing.ALL;facing(boolean) 以及重写 facing(blockEntity, state) 已被弃用,请改为重写 direction)。每个 BlockRenderer 的设置都会链式调用其自身的方法(如 .detail(...).animate(...)),bounds 基于骨架自身进行扩展而非替换,offScreen 状态会被正确识别,且其图层会随之旋转。子类则采用更偏向 BlockRenderer 的方式绘制,通过 newState、extract 和 render 实现状态的复用。🐛 错误修复
- 当某个模组同时拥有同名客户端命令和服务端命令时(例如客户端的
/folios guide与服务端的/folios config),服务端命令不再失效:现在只有服务端命令可执行的操作将正确路由至服务端,而不会在客户端因参数错误而失败。
v8.2.1 发布 | 2026年11月12日
🐛 修复了以下问题
- 不再与 Citadel(或任何更改锻造台配方查找的模组)一起导致游戏崩溃:8.2.0 版本中添加的 CoolCatLib 钩子(包括锻造台配方、商人的交易、BlockViews 的区块数据,以及 Fabric 和 Forge 上破损方块的掉落物)现在改为包裹游戏的调用而非替换它们,因此其他模组也可以更改相同的调用。
v8.2.0 版本发布 | 2026年11月10日
✨ 新功能
- 更多通用事件(
api.event.v2.common),在所有加载器上触发方式相同:EntityEvents.SPAWN:一个新生物即将加入世界(自然生成、随新区块生成、由刷怪笼生成、使用刷新蛋生成、通过命令生成、繁殖或转换),并附带游戏判定其生成的原因;可中断以阻止其生成,连同其乘客一起。EntityEvents.MOUNT:一个实体即将骑乘另一个实体(可中断以阻止骑乘),或从某个实体上下来。PlayerEvents.OPEN_MENU:玩家即将打开一个菜单:来自方块、实体、物品,或其他模组附加额外数据打开的菜单;可中断以阻止其打开。RecipeEvents.MATCH:配方匹配成功,发生在游戏查找配方的位置(熔炉、营火、锻造台、切石机、合成网格、其他模组的机器),并附带请求匹配的方块实体或玩家;可中断以跳过此配方,交由下一个匹配的配方处理。PlayerEvents.ADVANCEMENT_EARNED(玩家完成了进度)、CommandEvents.EXECUTE(命令即将执行;可中断以阻止执行)和LivingEvents.EFFECT_APPLICABLE(效果即将施加;可中断以阻止生效)。BlockEvents.DROPS:一个被破坏的方块即将掉落物品和经验值;可修改掉落列表和数量。PlayerEvents.BREAK_SPEED和HARVEST_CHECK:玩家破坏方块的速度,以及其工具是否适用(若不适用则无掉落),在客户端和服务端均生效。MerchantEvents.OFFERS:玩家看到的交易列表,作为其专属列表;移除交易以隐藏它们(它们也无法进行这些交易)。EnchantEvents.TABLE_OPTIONS(附魔台提供的附魔选项)和ANVIL_RESULT(铁砧的结果;可用另一堆物品或无物品中断)。LootEvents.MODIFY:任何战利品表在投骰时的战利品(箱子、方块掉落、怪物、钓鱼),并附带表的 ID;可修改掉落列表。LivingEvents.DAMAGE(护甲计算前;中断则不受到伤害)和DEATH(中断以阻止实体死亡),与 26.1.2 版本一致。
- 对部分玩家显示为其他方块的方块(
api.block.BlockViews):BlockViews.register(id, view)添加一个BlockView,它根据键将玩家分组(拥有相同键的玩家看到相同的视觉效果,而 null 键则让他们保持原有外观),并指定该方块对他们而言的外观。服务器发送给他们的内容(区块、方块更新、方块实体的数据)会用该虚拟方块替换真实方块,因此他们的客户端永远不会知道真实的方块是什么,而服务器仍保留真实方块用于其他所有用途。BlockViews.refresh(player)在他们应该看到的内容发生变化时重新发送区块给他们。 BlockEntityRendererRegistry(api.client.registry):注册方块实体渲染器,在所有加载器上行为一致,与 26.x 版本相同。BlockRenderLayers(api.client.registry):register(block, RenderType.translucent())(或cutout()、cutoutMipped())将方块的模型绘制在该渲染层中,适用于具有透明或部分透明像素的纹理,在所有加载器上行为一致。
v8.0.0 发布 | 2026年10月26日
✨ 新功能
更通用的事件 (
api.event.v2.common),在 Fabric 和 Forge 上触发方式相同:BlockEvents.PLACE:一个方块即将被放置,由任何方块物品(玩家、发射器、其他模组的机器)或末影人执行;中断则不会放置,且物品不会被消耗。PlayerEvents.PICKUP_ITEM(中断可将物品留在地上)、TRAVEL_TO_DIMENSION(在任何传送到其他维度之前:传送门、指令、其他模组的传送器;中断则停留原地)、CRAFTED和SMELTED(从合成台或熔炉结果槽中取出的物品)。PlayerEvents.CLONE(死亡或进入末路之地后的新玩家对象,用于携带数据)、RESPAWN和CHANGE_DIMENSION。LivingEvents.EQUIPMENT_CHANGE:实体在某槽位穿戴或手持的物品发生变化时触发。RecipeEvents.CRAFT_RESULT:合成网格的合成配方结果;可通过替换为其他物品堆叠或空堆叠来中断,从而阻止合成。在此版本中,它获取游戏的Recipe和CraftingContainer(没有合成台方块)。
来自通用代码的游戏测试 (
api.gametest),与 26.1.2 版本一致,且在 Fabric 和 Forge 上相同:GameTests.register(modId, SomeTests.class)注册每个@GameTest方法(格式为<modid>:<class>/<method>),而GameTests.register(id, options, helper -> ...)用于手动注册单个测试。GameTestOptions设置结构、时间限制、设置刻数、旋转、重试次数和批次(默认每个模组一个;此版本没有专用的测试环境);如果没有自己的结构,测试将在 CoolCatLib 的coolcatlib:gametest/platform上运行,这是一个石地板上的 8 × 6 × 8 的空旷空间。位置计数从结构的角落开始,如同较新版本一样。测试可以在开发环境中添加,或使用-Dcoolcatlib.gametest=true(或加载器自带的游戏测试开关)启用,然后通过/test run <modid>.<class>.<method>、/test runall <modid>或在游戏测试服务器上运行。层级和服务器的附件:
get、set、update、modify、has和reset接受Level或MinecraftServer,保存在层级的数据文件夹中(服务器的保存在主世界的文件夹中),并同步(SyncPolicy.ALL)到该层级中的玩家,或所有人。getGlobal(level)读取服务器端任意一侧的值。离线玩家的附件:
getOffline、setOffline、updateOffline和resetOffline读取和写入玩家的保存值,无论其是否在线(离线玩家的数据文件会立即写入)。声音过滤器 (
api.client.sound):对游戏的声音进行模糊化、粗糙化和回声处理,模拟穿墙、受法术影响或在洞穴中听到的效果。SoundFilter决定了声音保持多大的响度、保留多少高频部分,以及有多少声音经过失真处理并进入混响。muffled、quieter、distorted和echoing生成常用的过滤器;then组合两个过滤器,lerp实现部分过渡,用于淡入淡出。SoundFilters.register(provider)添加一个SoundFilterProvider,在每个声音开始时和移动时被询问,并提供一个SoundContext:播放位置、具体的声音事件、类别以及相对于听众(音乐、菜单;此版本的菜单点击被视为相对的 MASTER 声音,因为没有 UI 类别)。SoundFilterProvider.inWorld仅根据位置为世界内的声音创建一个过滤器。register返回一个Registration以便通过remove()移除它。- 一次性为所有声音设置命名过滤器(但排除菜单点击):
SoundFilters.set(id, filter, fadeTicks)淡入一个过滤器,clear(id, fadeTicks)淡出;isSet(id)检查状态。从服务器端,SoundFilterControl.set和clear(api.sound)为玩家执行相同的操作。 - 当提供者的答案发生变化时,
SoundFilters.refresh()重新过滤正在播放的声音。 - 通过 OpenAL 的 EFX 扩展实现(每个声音的低通滤波器,发送至失真和混响效果);如果不可用,声音将保持原样。
GUI 中以不透明度绘制的物品 (
api.client.gui.ItemOpacityRenderer),无论是平面还是实心物品,在游戏仅完全不透明地绘制它们的地方:render和renderWithDecorations(带有数量条和耐久度条)以指定不透明度或OpacityTween(in、out、between,随刻数平滑过渡,在任何帧率下均流畅),以及withOpacity(opacity, draw)用于任何绘制物品的组件,同时淡化与其一起绘制的文本和条形图。在着色器颜色的 alpha 低于 1 时绘制的任何物品都会随之褪色,包括游戏自身的物品。
将 GUI 元素放置在其它内容之外(api.client.gui.placement):GuiAreas.hud() 和 screen() 返回上一帧绘制的 HUD(包括每个模组的 HUD 层级:小地图、方块提示框、Boss 条等)和打开的屏幕的边界框,包含屏幕的小部件但不包含背景或鼠标下方的提示框;GuiAreas.unrecorded(draw) 绘制你自己的元素且不将其计入记录。GuiPlacement.hud() / screen() 接受一个尺寸、你希望放置的位置(at)、间隙(gap)、需要保持在其内的边界(within)以及可以滑动的方向(directions),排除覆盖层和你忽略的内容(ignore),并find()出最近的空白位置。
世界效果层级:frame.draw(material, VfxLayer.of(n)) 在特定层级中绘制,从低到高排列,因此较高层级总是覆盖较低层级。VfxLayer.sorted(n) 层级以前到后的顺序绘制每种材质上被覆盖的形状,使得不同纹理的形状根据其距离相互覆盖。层级中的材质现在按照每帧首次使用的顺序绘制,而在此之前它们的绘制顺序是不确定的。
? 变更
- 配置屏幕按其自身的名称(“Client”、“Server”)调用配置,并在必要时加上模组名称(例如 “Testing Mod › Client”),而不是使用基于模组 ID 生成的标题(例如 “Testingmod Client”):这适用于配置的屏幕、其类别弹窗、配置卡片的提示框和搜索结果,以及已保存的通知。可通过
config.<modid>.<name>.label翻译配置的名称。 - 新版本号格式:
<version>+<minecraft>,当前为8.0.0+1.20.1,适用于所有 Minecraft 版本和加载器。版本号接续自 2001.4.0.1;+之前的部分是启动器和加载器进行比较的部分,之后的 Minecraft 版本仅作为标签。如需依赖 CoolCatLib,请请求>=8.0.0,Maven 工件为coolcatlib-<loader>:8.0.0+1.20.1。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧