CurseForge · Minecraft mod
MerlinLib
A Minecraft library mod: it gives mod authors three registration lines - enchantments, effects and potions - and ships a ready-to-use testing toolkit on top of them.
Quick answer
Which MerlinLib release matches 26.1.2?
MerlinLib 1.2.0 (Fabric 26.1-26.2) targets 26.1, 26.1.1, 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is MerlinLib required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does MerlinLib 1.2.0 (Fabric 26.1-26.2) need?
MerlinLib 1.2.0 (Fabric 26.1-26.2) on 26.1.2. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add MerlinLib without breaking your instance.
Built for MerlinLib 1.2.0 (Fabric 26.1-26.2) on 26.1.2. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use MerlinLib 1.2.0 (Fabric 26.1-26.2). It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside MerlinLib 1.2.0 (Fabric 26.1-26.2). It opens that exact file at the source.
About this project
What does MerlinLib add?
📚 MerlinLib
English | 中文
English
A library mod for mod authors: three registration lines — enchantments, effects and potions — plus the parts a content mod ends up needing anyway: enchantment events, loot injection, join notices, a server lifecycle and mob behaviour hooks.
✨ What you get
Everything is reached through one entry point, com.huziyang520.merlinlib.api.MerlinApi:
| Capability | What it is for |
|---|---|
| Enchantments | Register one from code, or describe it in config/MerlinLib/*.json and let the library register it. |
| Effects | Register a mob effect; recolour or disable an existing one from the config. |
| Potions | Register potions, including the normal / long / strong variants of one effect. |
| Enchantment events | Eight event types with the equipment scan done for you, matched by enchantment id. |
| Loot injection | Put enchanted books or items into vanilla chests and mob drops. |
| Join notices | A chat message shown when a player arrives, with the per-mod switch handled for you. |
| Server lifecycle | Starting / started / stopping and player join, the two start moments kept distinct. |
| Mob behaviour hooks | Veto a mob's target or make it keep its distance — ordinary mobs and brain mobs such as the piglin family. |
| Interface animation | Opening curves and an intro a mod can drive its own screens with. |
| Colours and helpers | Colour parsing and gradients, grant counters, smelting lookups. |
📥 Install
Add the jar as a dependency and call MerlinApi. It must be present on both sides: the library is client side too — its configuration screen and the join notice page ship in the same file — so a mod that only wants the registration API still installs one jar.
⚙️ Configuration
Content is described in config/MerlinLib/*.json and registered at startup; the client switches live in config/MerlinLib/client.toml. The configuration screen opens from the mod list and applies on save.
🔗 Links
- Source and issue tracker: https://github.com/Huziyang520/Merlin
- Backup feedback address: https://issue.mengcai.online/
📜 Licence
CC0 1.0 Universal — do whatever you want with it. Copyright (c) 2026 Huziyang520.
中文
面向模组开发者的前置库:附魔 / 效果 / 药水三条注册主线,外加内容模组迟早都要用到的部分——附魔事件、战利品注入、进服提示、服务器生命周期与生物行为挂钩。
✨ 提供什么
统一入口是 com.huziyang520.merlinlib.api.MerlinApi:
| 能力 | 用途 |
|---|---|
| 附魔 | 代码注册,或在 config/MerlinLib/*.json 里写一份定义、由库完成注册。 |
| 效果 | 注册状态效果;已有效果可以改色或禁用。 |
| 药水 | 注册药水,含单一效果的普通 / 长效 / 强力三连。 |
| 附魔事件 | 八种事件类型,装备扫描由库完成,按附魔 id 匹配。 |
| 战利品注入 | 往原版箱子与生物掉落里塞附魔书或物品。 |
| 进服提示 | 玩家进入世界时的聊天消息,逐模组开关由库处理。 |
| 服务器生命周期 | 启动中 / 已启动 / 停止与玩家进入,两个"启动"时机严格区分。 |
| 生物行为挂钩 | 否决生物的寻敌目标、让它主动远离——普通生物与 Brain 生物(如猪灵族)都覆盖。 |
| 界面动画 | 库自己的界面带动画,任何模组都能拿到同一套曲线与入场动画。 |
| 颜色与工具 | 颜色解析与渐变、授予记账、熔炼查询。 |
📥 安装
把 jar 作为依赖引入并调用 MerlinApi。两端都必须安装:本库同时也是客户端模组,配置界面与进服提示页都在同一个 jar 里,所以只想要注册 API 的模组也只装一个文件。
⚙️ 配置
内容写在 config/MerlinLib/*.json 里,启动时注册;客户端开关在 config/MerlinLib/client.toml。配置界面从模组列表打开,保存即生效。
🔗 链接
📜 许可证
本项目以 CC0 1.0 协议开源,可自由使用。Copyright (c) 2026 Huziyang520.
Project description from CurseForge.
Pick your setup
MerlinLib by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
2 loader builds26.2
2 loader builds26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.1
1 loader build1.20.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
MerlinLib versions and loaders
MerlinLib 1.2.0 (Fabric 26.1-26.2)
merlinlib-1.2.0.2612-fabric-26.1-26.2.jar
11 Nov 2026
MerlinLib 1.2.0 (NeoForge 26.1-26.2)
merlinlib-1.2.0.2612-neoforge-26.1-26.2.jar
11 Nov 2026
MerlinLib 1.1.0 (NeoForge 26.1-26.2)
merlinlib-1.1.0-neoforge-26.1-26.2.jar
6 Nov 2026
MerlinLib 1.1.0 (Fabric 26.1-26.2)
merlinlib-1.1.0-fabric-26.1-26.2.jar
6 Nov 2026
merlinlib-1.0.0-fabric-26.1-26.2.jar
28 Oct 2026
merlinlib-1.0.0-neoforge-26.1-26.2.jar
28 Oct 2026
MerlinLib 0.9.2 (Fabric 26.1-26.2)
merlinlib-0.9.2-fabric-26.1-26.2.jar
24 Oct 2026
MerlinLib 0.9.2 (NeoForge 26.1-26.2)
merlinlib-0.9.2-neoforge-26.1-26.2.jar
24 Oct 2026
MerlinLib 0.9.1 (Fabric 26.1-26.2)
merlinlib-0.9.1-fabric-26.1-26.2.jar
24 Oct 2026
MerlinLib 0.9.1 (NeoForge 26.1-26.2)
merlinlib-0.9.1-neoforge-26.1-26.2.jar
24 Oct 2026
MerlinLib 0.9.0 (Fabric 26.1-26.2)
merlinlib-0.9.0-fabric-26.1-26.2.jar
22 Oct 2026
MerlinLib 0.9.0 (NeoForge 26.1-26.2)
merlinlib-0.9.0-neoforge-26.1-26.2.jar
22 Oct 2026
Looking for an older file? The official CurseForge project page is in Resources.