Description
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 in the mysterious White Night Garden.
一款基于《刀剑乱舞ONLINE》的 Minecraft Forge 模组。召唤传说中的刀剑男士作为同伴,与你一同战斗、种田、采矿、探索,并踏入神秘的「白夜之庭」。
Current Features / 当前功能
Touken Danshi / 刀剑男士
- Summon over 20 types of Touken Danshi (Mikazuki Munechika, Yamanbagiri Kunihiro, Kashuu Kiyomitsu, and more).
- Each Danshi has its own six-stat growth, leveling, fatigue system, and custom UI interface.
- Follow by default: Newly summoned Danshi will follow you immediately.
- Bubble Dialogue System: Danshi will chat with you, complain about fatigue, and react to environments via overhead speech bubbles.
- Formation system — captains can synchronize formations for nearby Danshi.
- Sparring system, Patrol AI, Cave Clearance AI, Ore Mining AI, and Farming duty AI.
- Signature blade system, mount system, and auto-seal when critically wounded.
- 实装数十位刀剑男士(三日月宗近、山姥切国广、加州清光等)。
- 每位刀男拥有独立的六维属性、等级成长、疲劳度系统与全新重做的 UI 界面。
- 默认跟随:召唤出来的刀剑男士会直接切换为跟随状态。
- 气泡对话系统:刀男会根据环境、时间与状态,在头顶冒出气泡与你闲聊、抱怨疲劳或发出警戒。
- 阵型系统(队长可让附近刀男同步阵型)、手合系统、巡逻、清缴矿洞、采集矿石、畑当番等完整工作 AI。
- 本体刀系统、马匹系统以及残血自动回收机制。
Editable Dialogue / 自由编辑文本
- All bubble dialogue can be customized using Resource Packs or KubeJS.
- Supports specific Danshi-to-Danshi unique dialogues.
- (Note: Server-side custom text editing is not currently supported; single-player only)
- 所有气泡台词均支持使用资源包或 KubeJS 自由修改。
- 支持特定刀男对特定刀男的专属对话。
- (注:服务器暂不支持自由改文本,想改自己的请在单人环境下操作)
NEW! White Night Garden / 白夜之庭
- A brand-new dimension with a custom gradient sky and cool-toned lighting.
- Pink and blue cherry groves interleaved with falling petals and moonlight particles.
- Only Touken Danshi, animals, and villagers spawn; no vanilla monsters.
- 全新维度,拥有自定义渐变天空与冷色调光照。
- 粉色与蓝色樱花林交错生成,漫天飘落的月见樱花瓣与忽明忽暗的月光光点。
- 仅生成刀剑男士、动物与村民,不生成原版怪物。
UPDATED! Abandoned History / 废弃的历史
- A wasteland of tampered history.
- Now includes vanilla biomes like deserts and badlands, and features custom loot chests from the Government Branch.
- 被篡改历史后的荒芜战场。
- 现已加入原版生物群系(如沙漠、恶地等),并包含政府分部的专属奖励箱。
Boss — White Mikazuki Munechika / 白三日月宗近
- A special boss with phase transitions, blocking, damage reflection, teleport pursuit, and minion summoning. HP is now set to 2,000,000.
- Applies [Moon Reflection] on hit — five stacks trigger instant death (can be negated by Totems or Amulets).
- Drops a unique one-use weapon dealing true damage.
- 拥有阶段转换、格挡反伤、瞬移追击、召唤小兵等特殊机制,血量提升至 200 万。
- 攻击时叠加【月影】效果,五层后触发即死(可被不死图腾或模组御守抵消)。
- 掉落一把一次性真实伤害武器。(机制已大幅完善,现在可以当 BOSS 斗蛐蛐了)
Items & Economy / 道具与经济
- Ema, Group Capture Talisman, Moon Phase, Captain Scroll, Amulet / Supreme Amulet.
- Knife equipment (Gold / Silver / Bronze), Mount items.
- Villager Trading: More trade branches for Small Koban with villagers and wandering traders.
- 绘马、群体收容符、月相、队长卷轴、御守 / 极御守、刀装与马匹。
- 村民与流浪商人交易:加入了更多可用小判兑换的村民/流浪商人货品分支。
⚠️ Server Play Notice / 服务器游玩说明
Servers can now use this mod. If you find any bugs, please report them to the author. Please note, the author will NOT respond to the following server issues:
- Data loss or rollbacks caused by improper server shutdowns (e.g., force-killing the process).
- Data loss caused by the server not saving data in time.
It is highly recommended to use
/stopor/save-allregularly.
从此版本开始服务器可以使用本模组。如果有相关 Bug 请报告作者。 注意,作者不会对以下服务器问题作出回应:
- 因为不当操作导致服务器没有被正常关闭(如直接叉掉进程)导致的数据丢失、操作回滚。
- 因为服务器没有及时保存数据导致的数据丢失等。
如果要在服务器上游玩,请注意正确开关服务器以及保存数据,定期
/save-all。
Commands / 命令
/tr locate— list the dimension, coordinates, and distance of all your summoned 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.
- Removed integration with the Kaleidoscope Cookery mod.
- Full source available on GitHub.
- 完整的中英文本地化。
- 帕秋莉驱动的游戏内百科全书。
- 移除了与模组《森罗物语》的相关联动机制。
- 完整源代码已在 GitHub 开源。
Requirements / 前置要求
Required dependencies / 必需前置:
- Minecraft 1.20.1
- Forge 47.4.0+
- GeckoLib 4
- Kotlin For Forge
- Custom Portal API Reforged
Optional / 可选:
- Patchouli — in-game guidebook / 游戏内手册
- KubeJS — scripting & dialogue customization support / 脚本与气泡自定义支持
Links / 链接
- GitHub: https://github.com/sitaliyaaoerjiaside-dot/Blocks-Toukenranbu
- Issues / Bug 反馈: https://github.com/sitaliyaaoerjiaside-dot/Blocks-Toukenranbu/issues
Credits / 致谢
Thanks to the authors and maintainers of the following open-source projects:
- GeckoLib — Entity animations
- Custom Portal API Reforged — Custom portals
- Kotlin For Forge — Kotlin runtime support
- Patchouli — In-game guidebook
License / 许可证
See LICENSE.txt.


