promotional bannermobile promotional banner

Blocks & Toukenranbu

A fan-made mod that brings Touken Ranbu content into Minecraft.
2026-08-11_16.07.03.png

2026-08-11_16.07.03.png

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 /stop or /save-all regularly.

从此版本开始服务器可以使用本模组。如果有相关 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 / 链接

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.

Blocks & Toukenranbu Team

profile avatar
  • 1
    Projects
  • 137
    Downloads

Thinking......