装订器!⌨️

装订器!⌨️

在Minecraft中高亮显示重要按键绑定的简便方法!

Binders

Binders 是一个轻量级实用模组和 API,专为模组包和模组开发者设计,用于向玩家突出显示重要的按键绑定。不再需要困惑或在菜单中翻找以弄清某个特定按键绑定。Binders 让关键按键绑定脱颖而出!

替代文本

功能

📌 屏幕按键绑定高亮 直接在屏幕上显示按键绑定,支持自定义图标、标签和位置。

🧩 完全可配置 支持 JSON 配置,可控制显示哪些按键绑定、何时显示以及如何显示。为高级用户支持正则表达式匹配。

🎮 上下文感知显示 仅在特定情况下显示按键绑定(例如飞行时、持有特定物品时、在下界时等)。

🎨 自定义样式 通过颜色、字体和动画调整外观,以匹配你的模组包主题。

🔄 动态更新 自动响应按键重映射,因此你的屏幕显示始终保持准确。

⌨️ 实用命令 使用 /binders dump 将所有可用的按键绑定 ID 记录到 latest.log 以便参考。 使用 /binders reload 无需重启游戏即可重新加载配置。

配置指南

Binders 在 config/binders/binders_definitions.json 中定义。

示例定义

{
  "keyBinding": "key.jump",
  "label": "Jump",
  "iconItem": "minecraft:feather",
  "context": "always",
  "contextLogic": "OR",
  "color": "#FFFFFF",
  "scale": 1.0,
  "showLabel": true,
  "maxPresses": -1,
  "resetOnLog": false,
  "isRegex": false,
  "dynamicIcon": false
}

上下文系统

context 字段决定 Binder 何时可见。你可以列出多个上下文,用逗号分隔。

逻辑:

  • "contextLogic": "OR"(默认):如果所列上下文中任意一个为真,则显示 Binder。
  • "contextLogic": "AND":仅当所列上下文中全部为真时才显示 Binder。

基本上下文

  • always:始终可见。
  • flying:飞行时可见(创造或生存模式)。
  • creative:创造模式下可见。
  • survival:生存或冒险模式下可见。
  • sneaking:蹲下时可见。
  • sprinting:疾跑时可见。
  • swimming:游泳时可见。
  • on_ground:站在固体地面上时可见。
  • riding:骑乘任何实体(马、船等)时可见。
  • raining:下雨时可见。
  • thundering:雷暴时可见。

高级上下文

  • 持有物品:
    • holding:<item_id>:任意一只手中持有物品。
    • holding_main:<item_id>:主手持有物品。
    • holding_off:<item_id>:副手持有物品。
  • 穿戴盔甲:
    • wearing_head:<item_id>
    • wearing_chest:<item_id>
    • wearing_legs:<item_id>
    • wearing_feet:<item_id>
  • 世界与玩家状态:
    • dimension:<dimension_id>:例如 dimension:minecraft:the_nether
    • biome:<biome_id>:例如 biome:minecraft:plains
    • health_below:<value>:例如 health_below:10(低于 5 颗心时显示)。
    • hunger_below:<value>:例如 hunger_below:6(低于 3 个鸡腿时显示)。
  • 注视目标:
    • looking_at_block:<block_id>:例如 looking_at_block:minecraft:chest
    • looking_at_entity:<entity_id>:例如 looking_at_entity:minecraft:villager
    • looking_at_tag:<tag_id>:例如 looking_at_tag:minecraft:logs

通配符与正则表达式

  • 你可以使用 *、any 或 *:* 作为物品、方块或实体的通配符。
    • 示例:looking_at_entity:*(注视任意实体时可见)。
  • 如果 "isRegex": true,你可以对物品/方块 ID 使用正则表达式。
    • 示例:holding:.*_sword(持有任意剑时可见)。

动态图标

如果 "dynamicIcon": true,Binder 将尝试使用触发上下文的物品作为图标。

  • 示例: 如果上下文为 holding:minecraft:diamond_sword,图标将变为钻石剑。

适用场景

  • 模组包创作者,希望引导新玩家。
  • 冒险地图,其中特定操作与上下文相关。
  • 教程或训练场景。

兼容性

  • Minecraft Forge (1.20.1)
  • 与大多数 HUD 和 GUI 模组兼容。