路径： Components&Features/铜灯.md

li_chun515 / 2 分钟最后编辑： 2026-08-19

IMG.BANNERISO 100 f/2.8 1/125s | 50mm Lens WB 5600K | EV +0.3 AF-S RAW

// Graduate Texts in Minecraft

04 铜灯

1 方块状态

铜灯有 2 个方块状态：

属性	类型	含义	默认值
`LIT`	`BooleanProperty`	铜灯是否点亮	`false`
`POWERED`	`BooleanProperty`	铜灯是否收到红石信号	`false`

LIT 只会在红石信号从无到有时翻转。
POWERED 表示当前是否有相邻红石信号输入，与 LIT 相互独立。
默认状态为 LIT=false, POWERED=false。

2 状态检查的触发条件

状态检查只在以下两个服务端时机调用 checkAndFlip：

放置 / 替换时：onPlace
- 仅当旧方块不是铜灯时执行。
- 因此新放置的铜灯如果周围已有红石信号，会立即检查并可能切换一次亮灭。
收到 NC 更新时：neighborChanged

只在 ServerLevel 执行。
铜灯的状态检查在收到更新时被瞬时调用，不添加任何计划刻事件

3 红石信号检查与翻转逻辑

收到 NC 更新后，铜灯先判断是否在ServerLevel，如果是则直接调用checkAndFlip完成后续的检测与更新

checkAndFlip 方法如下：

java

14 LINES||

    public void checkAndFlip(final BlockState state, final ServerLevel level, final BlockPos pos) {        boolean signal = level.hasNeighborSignal(pos);        //1. 获取当前位置的红石输入信号        if (signal != state.getValue(POWERED)) {         //状态需要变化            BlockState newState = state;            if (!state.getValue(POWERED)) {                newState = newState.cycle(LIT);                level.playSound(null, pos, newState.getValue(LIT) ? SoundEvents.COPPER_BULB_TURN_ON : SoundEvents.COPPER_BULB_TURN_OFF, SoundSource.BLOCKS);            }            level.setBlockAndUpdate(pos, newState.setValue(POWERED, signal));        }    }

// SYNTAX_HIGHLIGHT

解释：

获取当前位置的红石输入信号：如果 signal == state.getValue(POWERED)，则不需要变化，不做任何处理。
如果 signal != state.getValue(POWERED)：
- 当前不是激活状态：无信号 → 有信号（上升沿）
  当前 POWERED == false，且 signal == true：
  1. 翻转 LIT：
    newState = newState.cycle(LIT);
  2. 播放声音：根据变化状态判断应该播放铜灯亮起的声音还是铜灯熄灭的声音
  3. 设置 POWERED = true 更新方块状态并发出方块更新
- 当前是激活状态 有信号 → 无信号（下降沿）
  当前 POWERED == true，且 signal == false：
  1. 不翻转 LIT，不播放声音。
  2. 设置 POWERED = false更新方块状态并发出方块更新

铜灯只在红石信号出现时切换一次亮灭；信号消失时只清除 POWERED，LIT 保持。

4 比较器输出

hasAnalogOutputSignal 始终返回 true，因此铜灯可以被比较器检测。
getAnalogOutputSignal 输出：
- LIT == true → 输出强度 15
- LIT == false → 输出强度 0
比较器输出只由 LIT 决定，与当前是否收到红石信号（POWERED）无关。

5 铜灯氧化

与其他铜制品的氧化逻辑相同，这里不多赘述

路径： Components&Features/铜灯.md

li_chun515 / 2 分钟最后编辑： 2026-08-19

IMG.BANNERISO 100 f/2.8 1/125s | 50mm Lens WB 5600K | EV +0.3 AF-S RAW

// Graduate Texts in Minecraft

04 铜灯

1 方块状态

铜灯有 2 个方块状态：

属性	类型	含义	默认值
`LIT`	`BooleanProperty`	铜灯是否点亮	`false`
`POWERED`	`BooleanProperty`	铜灯是否收到红石信号	`false`

LIT 只会在红石信号从无到有时翻转。
POWERED 表示当前是否有相邻红石信号输入，与 LIT 相互独立。
默认状态为 LIT=false, POWERED=false。

2 状态检查的触发条件

状态检查只在以下两个服务端时机调用 checkAndFlip：

放置 / 替换时：onPlace
- 仅当旧方块不是铜灯时执行。
- 因此新放置的铜灯如果周围已有红石信号，会立即检查并可能切换一次亮灭。
收到 NC 更新时：neighborChanged

只在 ServerLevel 执行。
铜灯的状态检查在收到更新时被瞬时调用，不添加任何计划刻事件

3 红石信号检查与翻转逻辑

收到 NC 更新后，铜灯先判断是否在ServerLevel，如果是则直接调用checkAndFlip完成后续的检测与更新

checkAndFlip 方法如下：

java

14 LINES||

    public void checkAndFlip(final BlockState state, final ServerLevel level, final BlockPos pos) {        boolean signal = level.hasNeighborSignal(pos);        //1. 获取当前位置的红石输入信号        if (signal != state.getValue(POWERED)) {         //状态需要变化            BlockState newState = state;            if (!state.getValue(POWERED)) {                newState = newState.cycle(LIT);                level.playSound(null, pos, newState.getValue(LIT) ? SoundEvents.COPPER_BULB_TURN_ON : SoundEvents.COPPER_BULB_TURN_OFF, SoundSource.BLOCKS);            }            level.setBlockAndUpdate(pos, newState.setValue(POWERED, signal));        }    }

// SYNTAX_HIGHLIGHT

解释：

获取当前位置的红石输入信号：如果 signal == state.getValue(POWERED)，则不需要变化，不做任何处理。
如果 signal != state.getValue(POWERED)：
- 当前不是激活状态：无信号 → 有信号（上升沿）
  当前 POWERED == false，且 signal == true：
  1. 翻转 LIT：
    newState = newState.cycle(LIT);
  2. 播放声音：根据变化状态判断应该播放铜灯亮起的声音还是铜灯熄灭的声音
  3. 设置 POWERED = true 更新方块状态并发出方块更新
- 当前是激活状态 有信号 → 无信号（下降沿）
  当前 POWERED == true，且 signal == false：
  1. 不翻转 LIT，不播放声音。
  2. 设置 POWERED = false更新方块状态并发出方块更新

铜灯只在红石信号出现时切换一次亮灭；信号消失时只清除 POWERED，LIT 保持。

4 比较器输出

hasAnalogOutputSignal 始终返回 true，因此铜灯可以被比较器检测。
getAnalogOutputSignal 输出：
- LIT == true → 输出强度 15
- LIT == false → 输出强度 0
比较器输出只由 LIT 决定，与当前是否收到红石信号（POWERED）无关。

5 铜灯氧化

与其他铜制品的氧化逻辑相同，这里不多赘述

路径： Components&Features/铜灯.md

li_chun515 / 2 分钟最后编辑： 2026-08-19

IMG.BANNERISO 100 f/2.8 1/125s | 50mm Lens WB 5600K | EV +0.3 AF-S RAW

// Graduate Texts in Minecraft

04 铜灯

1 方块状态

铜灯有 2 个方块状态：

属性	类型	含义	默认值
`LIT`	`BooleanProperty`	铜灯是否点亮	`false`
`POWERED`	`BooleanProperty`	铜灯是否收到红石信号	`false`

LIT 只会在红石信号从无到有时翻转。
POWERED 表示当前是否有相邻红石信号输入，与 LIT 相互独立。
默认状态为 LIT=false, POWERED=false。

2 状态检查的触发条件

状态检查只在以下两个服务端时机调用 checkAndFlip：

放置 / 替换时：onPlace
- 仅当旧方块不是铜灯时执行。
- 因此新放置的铜灯如果周围已有红石信号，会立即检查并可能切换一次亮灭。
收到 NC 更新时：neighborChanged

只在 ServerLevel 执行。
铜灯的状态检查在收到更新时被瞬时调用，不添加任何计划刻事件

3 红石信号检查与翻转逻辑

收到 NC 更新后，铜灯先判断是否在ServerLevel，如果是则直接调用checkAndFlip完成后续的检测与更新

checkAndFlip 方法如下：

java

14 LINES||

    public void checkAndFlip(final BlockState state, final ServerLevel level, final BlockPos pos) {        boolean signal = level.hasNeighborSignal(pos);        //1. 获取当前位置的红石输入信号        if (signal != state.getValue(POWERED)) {         //状态需要变化            BlockState newState = state;            if (!state.getValue(POWERED)) {                newState = newState.cycle(LIT);                level.playSound(null, pos, newState.getValue(LIT) ? SoundEvents.COPPER_BULB_TURN_ON : SoundEvents.COPPER_BULB_TURN_OFF, SoundSource.BLOCKS);            }            level.setBlockAndUpdate(pos, newState.setValue(POWERED, signal));        }    }

// SYNTAX_HIGHLIGHT

解释：

获取当前位置的红石输入信号：如果 signal == state.getValue(POWERED)，则不需要变化，不做任何处理。
如果 signal != state.getValue(POWERED)：
- 当前不是激活状态：无信号 → 有信号（上升沿）
  当前 POWERED == false，且 signal == true：
  1. 翻转 LIT：
    newState = newState.cycle(LIT);
  2. 播放声音：根据变化状态判断应该播放铜灯亮起的声音还是铜灯熄灭的声音
  3. 设置 POWERED = true 更新方块状态并发出方块更新
- 当前是激活状态 有信号 → 无信号（下降沿）
  当前 POWERED == true，且 signal == false：
  1. 不翻转 LIT，不播放声音。
  2. 设置 POWERED = false更新方块状态并发出方块更新

铜灯只在红石信号出现时切换一次亮灭；信号消失时只清除 POWERED，LIT 保持。

4 比较器输出

hasAnalogOutputSignal 始终返回 true，因此铜灯可以被比较器检测。
getAnalogOutputSignal 输出：
- LIT == true → 输出强度 15
- LIT == false → 输出强度 0
比较器输出只由 LIT 决定，与当前是否收到红石信号（POWERED）无关。

5 铜灯氧化

与其他铜制品的氧化逻辑相同，这里不多赘述

#04 铜灯复制为 Markdown

#1 方块状态

#2 状态检查的触发条件

#3 红石信号检查与翻转逻辑

#4 比较器输出

#5 铜灯氧化

#04 铜灯复制为 Markdown

#1 方块状态

#2 状态检查的触发条件

#3 红石信号检查与翻转逻辑

#4 比较器输出

#5 铜灯氧化

#04 铜灯复制为 Markdown

#1 方块状态

#2 状态检查的触发条件

#3 红石信号检查与翻转逻辑

#4 比较器输出

#5 铜灯氧化

#04 铜灯复制为 Markdown

#1 方块状态

#2 状态检查的触发条件

#3 红石信号检查与翻转逻辑

#4 比较器输出

#5 铜灯氧化

04 铜灯

1 方块状态

2 状态检查的触发条件

3 红石信号检查与翻转逻辑

4 比较器输出

5 铜灯氧化

04 铜灯

1 方块状态

2 状态检查的触发条件

3 红石信号检查与翻转逻辑

4 比较器输出

5 铜灯氧化

04 铜灯

1 方块状态

2 状态检查的触发条件

3 红石信号检查与翻转逻辑

4 比较器输出

5 铜灯氧化

04 铜灯

1 方块状态

2 状态检查的触发条件

3 红石信号检查与翻转逻辑

4 比较器输出

5 铜灯氧化