Blocks ＆ Toukenranbu

Touken Ranbu Mod / 刀剑乱舞模组

A Minecraft Forge mod based on the game Touken Ranbu ONLINE. Summon legendary swords as companions — fight, farm, mine, and explore together, and explore the mysterious White Night Garden.

一款基于《刀剑乱舞ONLINE》的 Minecraft Forge 模组。召唤传说中的刀剑男士作为同伴，与你一同战斗、种田、采矿、探索，并踏入神秘的「白夜之庭」。 Current Features / 当前功能

刀剑男士 / Touken Danshi

Summon 6 types of Touken Danshi (Tachi, Uchigatana, Tantou, Wakizashi, Ootachi, Naginata, Yari) with individual leveling

Fatigue system with overhead emoji display

Formation system — captains can synchronize formations for nearby Danshi

Sparring system (two swords train together to increase stats)

Patrol & Cave Clearance AI, ore mining AI, farming duty AI

Signature blade system (equippable weapons with enchantment support)

Mount system (horse items for stat bonuses)

Auto-seal when critically wounded

实装6种刀剑男士（太刀、打刀、短刀、脇差、大太刀、薙刀、枪），拥有独立等级系统

疲劳度系统与头顶表情显示

阵型系统（队长可让附近刀男同步阵型）

手合系统（两把刀互相手合概率提升属性）

巡逻、清缴矿洞、采集矿石、畑当番等完整工作 AI

本体刀系统（可附魔的玩家武器，也可装备给刀男）

马匹系统（提供属性加成）

残血自动回收

NEW! 白夜之庭 / White Night Garden

A brand-new dimension with custom gradient sky and cool-toned lighting

Pink and blue cherry groves interleaved

Falling Tsukimi cherry petals and flickering moonlight particles

Only Touken Danshi and animals spawn; no vanilla monsters

全新维度，自定义渐变天空与冷色调光照

粉色与蓝色樱花林交错生成

漫天飘落的月见樱花瓣与忽明忽暗的月光光点

仅生成刀剑男士与动物，不生成原版怪物

NEW! Boss — 白三日月宗近 / White Mikazuki Munechika

A special boss with phase transitions, blocking & damage reflection, teleport pursuit, and minion summoning

Applies [Moon Reflection] on hit — five stacks kills the player instantly

Drops a unique one-use weapon that deals true damage and shatters after one strike

Note: Some mechanics are still incomplete. Do not summon unless fully prepared.

拥有阶段转换、格挡反伤、瞬移追击、召唤小兵等特殊机制

攻击玩家时叠加【月影】效果，五层后玩家立即死亡

掉落一把一次性真实伤害武器，用后即碎

注意：部分机制尚未完成，未做好充分准备时请勿随意召唤。

Items & Tools / 道具与工具

Ema — claim, bind, and summon your Touken Danshi

Group Capture Talisman — capture all owned Danshi within 32 blocks

Moon Phase — portal key to the White Night Garden

Captain Scroll, Amulet / Supreme Amulet, knife equipment (Gold / Silver / Bronze tiers)

Dice, Power of Attorney, Speed-up Potion, Small Koban, and more

绘马 — 认领、绑定、召唤刀剑男士

群体收容符 — 一次性收容周围 32 格内属于自己的刀剑男士

月相 — 通往白夜之庭的传送门钥匙

队长卷轴、御守 / 极御守、刀装（金 / 银 / 铜）

骰子、委托符、加速符、小判等特命道具

Commands / 命令

/tr locate — list the dimension, coordinates, and distance of all your summoned Touken Danshi

/tr count — show how many summoned Danshi you have

/tr ff — toggle friendly fire

/tr xp — toggle whether Danshi compete with you for experience

/tr locate — 列出你名下所有刀剑男士的维度、坐标与距离

/tr count — 查看已召唤刀剑男士数量

/tr ff — 开关友伤

/tr xp — 开关刀剑男士经验获取

Other / 其他

Full Chinese & English localization

Patchouli-driven in-game encyclopedia

Full source available on GitHub

完整的中英文本地化

帕秋莉驱动的游戏内百科全书

完整源代码已在 GitHub 开源

Important / 重要说明

This mod depends on LDLib2 (1.20.1 Forge community port). Due to the licensing terms of LDLib2, this mod does not bundle any of LDLib2's assets — only API references. The UI system will not work without the community port installed. Please make sure it is installed before playing.

本模组依赖 LDLib2 的 1.20.1 Forge 社区移植版。 由于 LDLib2 的许可证限制，本模组不会内置 LDLib2 的任何资源文件，仅引用 API。缺少该移植版时 UI 将无法正常工作，请在游玩前确认已安装。

Required dependencies / 必需前置：

Minecraft 1.20.1

Forge 47.4.0+

GeckoLib 4

LDLib2 (1.20.1 Forge community port)

Kotlin For Forge

Custom Portal API Reforged

Optional / 可选：

Patchouli — in-game guidebook

KubeJS — scripting support

Note / 注意

This mod is still in active development. Some features are in beta and may contain bugs. Compatibility with combinations of other mods is not guaranteed.

本模组仍在积极开发中，部分功能为测试版本，可能存在 Bug。与其他模组组合使用时的兼容性不作保证。 Links / 链接

GitHub: https://github.com/sitaliyaaoerjiaside-dot/Blocks-Toukenranbu

Issues / Bug 反馈: https://github.com/sitaliyaaoerjiaside-dot/Blocks-Toukenranbu/issues

LDLib2 (upstream): https://github.com/Low-Drag-MC/LDLib2

LDLib2 1.20.1 Forge Port: https://github.com/weiliangyan/LDLib2-1.20.1-Forge

Credits / 致谢

Thanks to the authors and maintainers of the following open-source projects:

LDLib2 (LGPL-3.0) — KilaBash / Low-Drag-MC

LDLib2 1.20.1 Forge Port — weiliangyan

GeckoLib — entity animations

Custom Portal API Reforged — custom portals

Kotlin For Forge — Kotlin runtime support

Patchouli — in-game guidebook

感谢以下开源项目的作者与维护者：

LDLib2（LGPL-3.0）— KilaBash / Low-Drag-MC

LDLib2 1.20.1 Forge 移植版 — weiliangyan

GeckoLib — 实体动画

Custom Portal API Reforged — 自定义传送门

Kotlin For Forge — Kotlin 运行支持

Patchouli — 游戏内手册

License / 许可证

See LICENSE.txt. This mod uses LDLib2 under LGPL-3.0; see LICENSE-LDLib2.txt.

详见 LICENSE.txt。本模组在 LGPL-3.0 协议下使用 LDLib2，详见 LICENSE-LDLib2.txt。