逃走中MOD 技术文档

Appearance

方块参考 ​

文档版本：基于 2026-06-01 代码分析

概述 ​

逃走中MOD核心模组注册了 8 个方块，分为两类：4 个高硬度猎人箱结构方块和 4 个功能性方块。扩展模组额外提供 12 个方块。所有方块注册于 ModBlocks。

核心概念 ​

猎人箱体系 ​

猎人箱是多方块结构，通过红石信号控制开关门：

方块结构部件方块实体
hunter_box_a3高×1宽BOTTOM/CENTER/TOP无
hunter_box_a23高×1宽同上 + SCREEN屏幕面有（释放时间显示）
hunter_box_start_main3高×2宽BOTTOM/CENTER/TOP × CORE/DOOR无
hunter_box_start_side3高×1宽BOTTOM/CENTER/TOP无

架构设计 ​

方块关系图 ​

mermaid
graph TB
    subgraph HunterBox["猎人箱方块 (4个)"]
        A["HunterBoxABlock<br/>hunter_box_a<br/>硬度100/抗性300000"]
        A2["HunterBoxA2Block<br/>hunter_box_a2<br/>继承A+释放时间BE"]
        StartMain["HunterBoxStartMainBlock<br/>hunter_box_start_main<br/>6方块(2x3)结构"]
        StartSide["HunterBoxStartSideBlock<br/>hunter_box_start_side<br/>3方块柱形结构"]
    end

    subgraph Functional["功能性方块 (4个)"]
        Detect["DetectBlock<br/>detect_block<br/>侦测逃走者范围"]
        Notice["NoticeSenderBlock<br/>notice_sender<br/>绑定通知+红石触发"]
        Trigger["RedstoneTriggerBlock<br/>redstone_trigger<br/>红石信号源"]
        TimePad["TimePadBlock<br/>time_pad<br/>壁挂式装饰方块"]
    end

    A --> A2

方块清单 ​

猎人箱方块 ​

注册名类硬度爆炸抗性红石响应特殊属性
hunter_box_aHunterBoxABlock100300000受控（POWERED && !LOCKED 开门）3部件，FACING/LOCKED/POWERED/PART
hunter_box_a2HunterBoxA2Block100300000继承A继承A + 屏幕面释放时间显示
hunter_box_start_mainHunterBoxStartMainBlock100300000受控（与A相同模式）6方块(2x3)，CORE/DOOR双部分
hunter_box_start_sideHunterBoxStartSideBlock100300000受控（传播POWERED）3方块柱形，可通行

功能性方块 ​

注册名类硬度方块实体功能
detect_blockDetectBlock2有（serverTick 注册）侦测逃走者范围+联动警报
notice_senderNoticeSenderBlock2有（serverTick 红石触发）绑定通知+右键/红石触发发送
redstone_triggerRedstoneTriggerBlock2有（信号控制+存储）红石信号源，MOMENT/SUSTAINED模式
time_padTimePadBlock2有（无ticker）壁挂式装饰，FACING方向

扩展模组方块（chenxi_rfm_addition） ​

注册名类功能
charge_blockChargeBlock充能/输出双模式，5级红石输出
redstone_alarmRedstoneAlarmBlock红石警报器（红石灯）
broadcast_padBroadcastPadBlock2×1 广播语音面板，3状态机
dice_panelDicePanelBlock2×3 骰子显示面板
redstone_conductorRedstoneConductorBlock红石导体（带伪装功能）
nfa_running_track_blockBlock（匿名）跑道方块
nfa_running_track_line_blockDirectionalRunningTrackBlock定向跑道线
nfa_running_track_lines_blockDirectionalRunningTrackBlock定向跑道双线
nfa_running_track_angle_blockDirectionalRunningTrackBlock定向跑道转角
nfa_running_track_vertex_blockDirectionalRunningTrackBlock定向跑道顶点
nfa_running_track_center_blockDirectionalRunningTrackBlock定向跑道中心
nfa_running_track_circle_blockDirectionalRunningTrackBlock定向跑道圆弧

注意事项 ​

  1. 猎人箱方块硬度 100/抗性 300000，几近不可破坏
  2. 功能性方块硬度 2.0，需合适工具
  3. 所有方块使用 SoundType.METAL 音效
  4. 猎人箱有复杂的多方块同步逻辑（打破一个部件需清理所有部件）
  5. 扩展模组方块详情见 扩展模组总览

相关文档 ​