红石之手官方Wiki

红石之手 — 双击秒挖红石组件 · Minecraft 1.21.1 · Fabric
版本：v1.0 “神之右手” | 更新日期：2026-07-17

📑 目录

模组概述
使用方法
支持的红石组件
背包机制
音效反馈
成就系统
配置系统
兼容性说明
常见问题（FAQ）
版本历史
未来计划

📖 模组概述

红石之手（R’s QuickAdjust） 是一个轻量级的 Minecraft 实用模组。在生存模式下双击任意红石组件，即可瞬间破坏并将物品直接传送至背包——告别繁琐的徒手敲红石、满地捡掉落物的烦恼。

核心特色

生存模式下双击红石组件 → 瞬间破坏
破坏后掉落物直传背包，无需拾取
背包空间不足时自动取消破坏，避免掉落物丢失
成功/失败双音效反馈
首次使用解锁成就「神之右手」
blocks.json 数据驱动，方块列表可自由扩展
零 Mixin，纯 Fabric API 事件钩子

模组信息

项目	内容
模组 ID	`rs_quick_adjust`
支持版本	Minecraft 1.21.1
加载器	Fabric
依赖	Fabric API
源码	GitHub
许可协议	MIT
联系方式	RicardoK@foxmail.com

🖱️ 使用方法

基本操作

生存模式下，对准红石组件左键攻击一次（首次点击）
在 500ms 内再次左键攻击同一方块（第二次点击）
双击判定通过 → 方块瞬间破坏，掉落物直传背包
同时播放末影珍珠传送音效 + 成就授予（首次）

触发条件

玩家必须处于生存模式（创造模式不生效）
目标方块必须在 blocks.json 定义的列表中
第一次和第二次点击必须在 500ms 以内
两次点击必须指向同一个方块
背包必须有足够空间（空间不足则取消操作并提示）

适用场景

场景	效果
拆除搭错的电路	双击秒拆，重建无压力
回收红石组件	自动入包，不丢任何掉落物
批量拆除	逐个双击，连续操作
背包满时误操作	自动取消 + 村民拒绝音效

🔌 支持的红石组件

信号源（26 种）

类别	方块
拉杆/火把	拉杆、红石火把、红石墙上火把
按钮	石质按钮、橡木按钮、云杉木按钮、白桦木按钮、丛林木按钮、金合欢木按钮、深色橡木按钮、绯红菌按钮、诡异菌按钮
压力板	石质压力板、橡木压力板、云杉木压力板、白桦木压力板、丛林木压力板、金合欢木压力板、深色橡木压力板、绯红菌压力板、诡异菌压力板、轻质测重压力板、重质测重压力板
红石矿石	红石矿石、深层红石矿石

红石元件（12 种）

类别	方块
逻辑/传输	红石中继器、红石比较器、红石粉、观察者
机械	活塞、粘性活塞
功能方块	发射器、投掷器、音符盒、红石灯
传感器	阳光探测器、标靶方块、陷阱箱

🎒 背包机制

直传背包

双击破坏成功后，掉落物不会散落在地面，而是直接传入玩家背包：

获取方块的掉落物列表（Block.getDroppedStacks）
背包容量预检（canFitAll）
通过预检后，依次加入背包（inventory.offerOrDrop）
方块设为空气

背包满保护

背包空间不足时，系统会：

取消破坏操作，方块保持原样
播放村民拒绝音效（ENTITY_VILLAGER_NO）
聊天栏显示红色提示：「背包空间不足，无法破坏！」

与普通破坏的区别

对比项	普通徒手破坏	红石之手双击
破坏速度	取决于方块硬度	瞬间破坏
掉落物去向	散落地面	直传背包
背包满时	掉落物散落	自动取消
操作步骤	长按左键	双击

🔊 音效反馈

场景	音效	说明
双击成功	`ENTITY_ENDERMAN_TELEPORT`	末影珍珠传送声，清脆识别度高
背包不足	`ENTITY_VILLAGER_NO`	村民摇头声——“哼，包满了”

音效通过 player.getWorld().playSound(null, pos, ...) 播放，所有附近的玩家都能听到。

🏆 成就系统

神之右手

首次成功双击破坏红石组件时自动解锁。

成就 ID：rs_quick_adjust:redstone_hand
标题：神之右手（金色）
描述：第一次使用红石之手双击破坏方块
触发器：minecraft:impossible（仅由代码手动授予）
提示：Toast 弹窗 + 聊天栏全服公告

成就 JSON 文件路径：data/rs_quick_adjust/advancement/redstone_hand.json

⚠️ 注意：Minecraft 1.21 将成就目录名从 advancements（复数）改为了 advancement（单数）。自定义成就请使用单数形式的目录名。

⚙️ 配置系统

blocks.json

方块列表通过 JSON 配置文件管理，路径为 data/rs_quick_adjust/rs_quick_adjust_config/blocks.json。

{
  "description": "红石之手 - 双击秒挖的红石方块列表",
  "blocks": [
    "minecraft:repeater",
    "minecraft:comparator",
    "minecraft:redstone_wire"
  ]
}

配置项说明

字段	类型	说明
`description`	String	描述信息（仅供阅读，代码不读取）
`blocks`	Array[String]	红石方块 ID 列表，每项为完整的命名空间 ID

自定义方块列表

在 blocks 数组中添加或删除条目
每个条目使用完整的命名空间 ID：minecraft:your_block
未知的方块 ID 会被自动跳过（日志输出警告）
修改后重新打包 JAR 或使用数据包覆盖

兼容数据包

由于配置文件位于 data/rs_quick_adjust/ 命名空间下，其他数据包可以通过同名路径覆盖此配置，服务端可以统一管理生效的方块列表。

📋 兼容性说明

模组兼容

完全兼容其他模组——红石之手仅监听 AttackBlockCallback，不干涉任何其他 Mod 的逻辑
不会与其他模组的挖掘加速、工具修改等功能冲突
对其他模组新增的红石组件，只需在 blocks.json 中添加对应 ID 即可支持

安装要求

要求	说明
客户端	✅ 需要安装
服务端	✅ 需要安装
单机（局域网）	✅ 需要安装
依赖	Fabric API（≥0.116.13）

已知问题

目前双击时间窗口（500ms）为硬编码，暂不支持配置文件调整
硬度为 0 的方块（如红石粉、中继器、比较器）在单击时即会被原版机制破坏，双击机制对此类方块效果等同于单击

❓ 常见问题（FAQ）

Q: 红石之手在创造模式有效吗？

A: 无效。双击检测会跳过创造模式玩家。

Q: 如何添加更多红石组件？

A: 编辑 blocks.json，在 blocks 数组中添加对应的方块 ID，然后重新打包 JAR 或使用数据包覆盖。

Q: 双击时间窗口可以调整吗？

A: 当前版本（v1.0）为硬编码 500ms，未来版本计划支持配置文件调整。

Q: 为什么红石粉/中继器单击就碎了？

A: 这些方块原版硬度为 0，单击时原版机制已将其破坏。双击机制对此类方块不产生额外效果。

Q: 背包满了会被吞物品吗？

A: 不会。双击判定前会进行背包容量预检，空间不足时自动取消操作并提示玩家，不会有任何物品丢失。

Q: 如何更新方块列表？

A: 直接修改 blocks.json，支持数据包覆盖。修改后重启游戏或重载数据包即可生效。

Q: 这个模组会和其他模组冲突吗？

A: 不会。红石之手使用 Fabric API 事件，不涉及 Mixin，兼容性极高。

Q: 如何反馈 Bug 或建议？

A: 通过 GitHub Issue 提交，或邮件至 RicardoK@foxmail.com。

Q: 这个模组开源吗？

A: 是的，MIT 协议开源，源码在 GitHub。

Q: 模组的成就无法弹出怎么办？

A: 确保成就 JSON 文件放在 data/rs_quick_adjust/advancement/（注意是单数）下。如果仍不生效，可以用 /advancement revoke @s only rs_quick_adjust:redstone_hand 重置后再试。

📦 版本历史

版本	日期	主题	主要内容
v1.0	2026-07-17	神之右手	正式发布，38 种红石组件支持，背包直传，音效反馈，成就系统，blocks.json 数据驱动
v0.1	—	雏形	核心技术验证，双击判定 + 基础破坏功能

v1.0 更新亮点

🎯 双击秒挖 — 500ms 窗口内的双击判定，瞬间破坏红石组件
🎒 物品直传背包 — 掉落物自动进入背包，无需拾取
🛡️ 背包满保护 — 空间不足时自动取消破坏，防止物品丢失
🔊 音效反馈 — 末影人传送（成功）+ 村民拒绝（失败）
🏆 神之右手成就 — 首次使用自动获得
📋 38 种红石组件覆盖 — 信号源 + 红石元件全覆盖
⚙️ 数据驱动 — blocks.json 控制方块列表，可自由扩展
🧩 零 Mixin — 纯 Fabric API 事件钩子，极致兼容

🚀 未来计划

自定义双击时间窗口 — 配置文件支持调整 500ms 阈值
更多自定义选项 — 是否开启音效、是否开启成就等
批量操作模式 — 按住某键后双击，拆除相连的同类红石组件
数据包支持完善 — 更好地支持服务端统一配置

反馈 & 建议： RicardoK@foxmail.com GitHub： https://github.com/RicardoKael/RsQuickAdjust
© 2026 红石之手 (R’s QuickAdjust). MIT License.

红石之手 官方Wiki