Controller（抽屉控制器）

基本信息

功能

抽屉控制器是 StorageDrawers 抽屉网络的核心方块，用于发现、连接和管理周围的抽屉方块。

网络发现

• 控制器在服务器tick中主动检测相邻方块，发现周围5格范围内的抽屉方块
• 通过 INetworked 接口与 BlockDrawers、BlockTrim 等多方块成员通信
• 每个控制器最多管理 16个抽屉槽位
• 支持多个控制器组成更大网络，最多约160个槽位

状态与标签显示

• 支持显示所连接抽屉的物品图标、名称和数量
• 物品图标和数量随实际存储情况实时更新
• 通过按键绑定可切换：显示/隐藏物品图标、显示/隐藏数量标签

交互行为

• 遮蔽（Shroud）：手持遮蔽钥匙右键切换遮蔽模式，隐藏所有标签显示
• 锁定（Lock）：手持升级锁右键切换锁定模式，锁定所有连接的抽屉（防止取出物品）
• 个人钥匙（Personal Key）：手持个人钥匙右键切换保护模式，通过安全提供者验证
• 数量钥匙（Quantify Key）：手持数量钥匙右键切换数量显示模式

放置行为

• onBlockPlacedBy：放置时若物品有自定义显示名，则设置为方块的自定义名称
• 放置后若处于服务器端，立即调用 cache.update() 更新网络缓存
• 支持 rotateBlock：根据 Forge 方向旋转

摆放要求

• 可放置于任意固体方块表面
• 最佳放置位置为抽屉组的中心位置，以便覆盖周围5格范围
• 建议配合 Controller Slave 扩展覆盖范围

交互

数值

渲染特性

• renderAsNormalBlock = false：不作为完整方块渲染
• isOpaqueCube = false：不遮挡邻近方块的光照
• 使用 neighborBrightness 特殊渲染，根据相邻方块亮度调整自身亮度

所属多方块结构

• Drawer Network - 抽屉网络的核心节点，负责发现和管理网络中所有连接的抽屉方块

相关条目

• Controller Slave - 从属控制器，扩展主控制器的网络覆盖范围
• Drawer Network - 抽屉网络的整体架构说明

第三方集成