CurseForge · Minecraft mod
MerlinTools
A testing toolkit for Minecraft: editable test weapons, an item editor, a health editor, command macros and HUD readouts. Every part can be switched off, and the mod works on its own.
Quick answer
Which MerlinTools release should I use?
MerlinTools 1.0.4 (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 MerlinTools 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 MerlinTools 1.0.4 (Fabric 26.1-26.2) need?
MerlinTools 1.0.4 (Fabric 26.1-26.2). Change the file and its required mods may change too.
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 MerlinTools without breaking your instance.
Built for MerlinTools 1.0.4 (Fabric 26.1-26.2). Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use MerlinTools 1.0.4 (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 MerlinTools 1.0.4 (Fabric 26.1-26.2). It opens that exact file at the source.
About this project
What does MerlinTools add?
🧰 MerlinTools
English | 中文
English
A testing toolkit for Minecraft: editable test weapons, an item editor, a health editor, command macros and HUD readouts. Every part can be switched off, and the mod works on its own.
✨ What it does
| Part | What it does |
|---|---|
| Test weapons | Sword, axe, spear and trident built as editable variants of the vanilla ones — damage and enchantments are yours to set. |
| Item editor | Rewrites the held item: enchantments, custom name and base damage. |
| Health editor | Sets maximum and current health of a mob or a player. |
| Command macros | Stores command sequences and runs them from one screen. |
| HUD readouts | Damage of the weapon you just used near the crosshair, damage numbers over mobs, a folded health bar for huge health pools. |
| Switches | Every part has its own switch; the whole toolkit can be limited to operators. |
📥 Install
Drop the jar into mods/. Fabric needs Fabric API. Cloth Config is optional: with it installed the configuration opens in Cloth's screen, without it the mod edits its own files.
⚙️ Configuration
The mod writes config/MerlinTools/client.toml, config/MerlinTools/server.toml and config/MerlinTools/macros.json. The configuration screen opens from the mod list; changes apply on save, no restart. NeoForge uses its own configuration page, so both files are reachable from there.
| Section | Holds |
|---|---|
hud |
Crosshair damage and how long it stays, folded health bar, armour row placement. |
floating_text |
Damage numbers: on/off, duration, scale, colours, how many at once. |
editor |
Editor hotkey, value step for shift-click and for the mouse wheel. |
macros |
Master switch of the macro screen. |
security |
Operator-only mode, permission needed to open the item editor and the health editor. |
tools |
Damage and enchantment ceilings, which items the editor accepts, health editor requirements. |
🔗 Links
- Source and issue tracker: https://github.com/Huziyang520/MerlinTools
- Backup feedback address: https://issue.mengcai.online/
📜 Licence
CC0 1.0 Universal — do whatever you want with it. Copyright (c) 2026 Huziyang520.
中文
一款面向 Minecraft 的测试工具集:可编辑的测试武器、物品编辑、血量编辑、指令宏与 HUD 读数。每一项都能单独关闭,模组也可以独立安装使用。
✨ 功能
| 部件 | 作用 |
|---|---|
| 测试武器 | 剑 / 斧 / 长矛 / 三叉戟,原版武器的可编辑变体,伤害与附魔都可以自己设。 |
| 物品编辑 | 改写手持物品:附魔、自定义名称与基础伤害。 |
| 血量编辑 | 设置生物或玩家的最大生命值与当前生命值。 |
| 指令宏 | 保存一串指令,在一个界面里执行。 |
| HUD 读数 | 准心旁显示刚用过武器的伤害、生物头顶的伤害飘字、超高血量时的折叠血条。 |
| 开关 | 每个部件都有独立开关;整套工具可以限制为仅管理员可用。 |
📥 安装
把 jar 放进 mods/。Fabric 端需要 Fabric API;Cloth Config 是可选的,装了才用它的配置界面,不装就由模组自己读写配置文件。
⚙️ 配置
模组会生成 config/MerlinTools/client.toml、config/MerlinTools/server.toml 与 config/MerlinTools/macros.json。配置界面从模组列表打开,保存即生效、不用重启;NeoForge 用自带的配置页,两个文件都能在那一页里改。
| 分组 | 内容 |
|---|---|
hud |
准心伤害与其停留时长、折叠血条、护甲行位置。 |
floating_text |
伤害飘字:开关、时长、缩放、颜色、同时显示数量。 |
editor |
编辑热键、Shift 点击与滚轮的数值步长。 |
macros |
宏界面的总开关。 |
security |
仅管理员模式、打开物品编辑与血量编辑所需权限。 |
tools |
伤害与附魔等级上限、编辑器接受哪些物品、血量编辑的前置条件。 |
🔗 链接
📜 许可证
本项目以 CC0 1.0 协议开源,可自由使用。Copyright (c) 2026 Huziyang520.
Project description from CurseForge.
Pick your setup
MerlinTools 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
MerlinTools versions and loaders
MerlinTools 1.0.4 (Fabric 26.1-26.2)
merlintools-1.0.4.2612-fabric-26.1-26.2.jar
16 Nov 2026
MerlinTools 1.0.4 (NeoForge 26.1-26.2)
merlintools-1.0.4.2612-neoforge-26.1-26.2.jar
16 Nov 2026
MerlinTools 1.0.2 (Forge 1.20.1)
merlintools-1.0.2.1201-forge-1.20.1.jar
12 Nov 2026
MerlinTools 1.0.1 (Forge 1.20.1)
merlintools-1.0.1.1201-forge-1.20.1.jar
12 Nov 2026
MerlinTools 1.0 (Fabric 26.3)
merlintools-1.0.263-fabric-26.3.jar
11 Nov 2026
MerlinTools 1.0 (NeoForge 26.3)
merlintools-1.0.263-neoforge-26.3.jar
11 Nov 2026
MerlinTools 1.0 (Fabric 26.1-26.2)
merlintools-1.0.2612-fabric-26.1-26.2.jar
11 Nov 2026
MerlinTools 1.0 (NeoForge 26.1-26.2)
merlintools-1.0.2612-neoforge-26.1-26.2.jar
11 Nov 2026
MerlinTools 1.0 (NeoForge 1.21.1)
merlintools-1.0.1221-neoforge-1.21.1.jar
11 Nov 2026
MerlinTools 1.0 (Forge 1.20.1)
merlintools-1.0.1201-forge-1.20.1.jar
11 Nov 2026
Looking for an older file? The official CurseForge project page is in Resources.