imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li

2026-08-24T08:08:27Z

Imported from legacy OpenComputers documentation at ocdoc.cil.li

New page

= 组件：红石 =

此组件由[[Item/redstone card/zh|红石卡]]提供。

1级红石卡仅支持MC原版红石功能（单路模拟红石信号）。2级红石卡提供与其他模组红石系统的联动（集束红石和无线红石）。对于集束红石，在Minecraft 1.12版本我们仅支持Project Red（红石计划），在更低版本我们支持：RedLogic、Project Red（1.1版本）、MineFactory Reloaded（我的工厂重制版）。无线红石方面支持以下模组：WR-CBE、SlimeVoid's WR。

= ==== get''与set''方法重载 =

自patch release 1.7.3起，红石组件提供以下函数的重载版本：`getInput`、`getOuput`、`setInput`、`getBundledInput`、`getBundledOutput`以及`setBundledOutput`。

= ==== get''与set''调用开销 =

'''get'''方法为“直接”调用，且几乎无开销。实验中我每秒可以调用20000到22000次`getInput`方法。

'''set'''方法并非为“直接”调用，因此每tick最多只能调用一次。也就是说每秒钟可以调用约20次。除了间接成本（消耗剩余的tick）之外，调用'''set'''改变了输出的强度等级后机器上还会有额外的延迟。默认情况下，调用'''set'''每秒可以改变输出约6次。

使用这些重载变体的显著优势之一是，API调用开销为每次调用后结算，而不是每次设定数值后结算。

组件名：`redstone`。

回调函数：

* `getInput(side: number): number`

<pre>`getInput(): table`
</pre>
返回当前输入的（非集束）红石信号值。`getInput(side)`会返回指定[[API/sides/zh|方向]]上的红石信号等级。`getInput()`会返回包含所有方向上红石信号等级的表。请注意返回的表的索引从0开始。因为表的索引其实是方向的原始值，`sides.bottom`对应了0。还需注意此函数用到的方向是相对于电脑而言的。即`sides.south`为'''电脑的前方'''，而不是世界的南方。类似还有`sides.left`为电脑的左侧，也就是说如果你站在电脑面前的话，在你的右侧。如果使用了例如RedLogic这样的模组，输入值可能会超出MC原版的[0, 15]范围。

```lua lua> component.redstone.getInput(sides.left) 15 lua> component.redstone.getInput(sides.right) 4 lua> component.redstone.getInput() {[0]=7, 0, 0, 0, 4, 15} lua> component.redstone.getInput()[sides.bottom] 7 ```

* `getOutput(side: number): number`

<pre>`getOutput(): table`
</pre>
获取指定方向上输出的设定值，若不含参数调用则返回所有方向上的设定值。

```lua lua> component.redstone.getOutput(sides.left) 7 lua> component.redstone.getOutput() [sides.left] 7 ```

* `setOutput(side: number, value: number): number`

<pre>`setOutput(values: table): table`
</pre>
设定要发出的红石信号强度。返回'''旧的'''值。配合支持的mod时可以为很大的值。此方法的参数为[[API/sides/zh|方向]]以及要应用到此方向的红石信号强度。`setOutput(values)`这种写法可以在一次调用内设定所有方向（或数个方向）上的红石信号强度。
* `getBundledInput(side: number, color: number): number`

<pre>`getBundledInput(side: number): table`
`getBundledInput(): table`
</pre>
和`getInput`类似，但适用于集束输入。读取指定[[API/colors/zh|颜色]]对应通道的值。 '''对OC 1.3而言：'''仅可用于2级红石卡。

<pre>`getBundledInput(side, color)`返回指定方向上输入的指定颜色红石信号强度值。
`getBundledInput(side)`返回一个表（格式为Map[Int, Int]这样的表结构），整合了指定方向上红石信号值，索引值为颜色。
`getBundledInput()`返回所有的红石信号值，包括所有方向以及所有颜色。格式为Map[Int, Map[Int, Int]]这样的两层表结构。外层表的索引值范围是[0, 5]，值为[[API/sides/zh|方向]]（请记住`sides.bottom`为0）。每个方向对应内层表的数据结构与`getBundledInput(side)`返回值相同。
</pre>

* `getBundledOutput(side: number, color: number): number`

<pre>`getBundledOutput(side: number): table`
`getBundledOutput(): table`
</pre>
类似`getOutput`，但是适用于集束输出。用于获取先前设定的输出值。 '''对OC 1.3而言：'''仅可用于2级红石卡。
* `setBundledOutput(side: number, color: number, value: number): number` 类似`setOutput`，但是适用于集束输出。用于设定指定[[API/colors/zh|颜色]]对应通道的输出值。返回之前设定的值。

<pre>`setBundledOutput(side, values)`设定一组红石信号值，以颜色为索引，颜色取值范围为[0, 15]，`colors.white`为0。提供的值不一定要连续，省略的值将会保持不变。
`setBundledOutput(values)`让你能在单次API调用中修改所有方向上所有颜色的红石信号值。
</pre>
'''对OC 1.3而言：'''仅可用于2级红石卡。
```lua lua> component.redstone.setBundledOutput(sides.left, { [colors.white] = 15 } ) -- only sets 1 output lua> component.redstone.setBundledOutput({ [sides.left] = { [colors.white] = 15 } } ) -- same as above ```

* `getComparatorInput(side:number):number`

<pre>获取指定方向上的比较器输入。
</pre>

* `getWirelessInput():number`

<pre>获取无线红石输入值。
</pre>
'''自OC 1.3起添加：'''仅可用于2级红石卡。

* `getWirelessOutput():boolean`

<pre>获取无线红石输出值。
</pre>
'''自OC 1.3起添加：'''仅可用于2级红石卡。

* `setWirelessOutput(value:boolean):boolean`

<pre>设定无线红石输出值。
</pre>
'''自OC 1.3起添加：'''仅可用于2级红石卡。

* `getWirelessFrequency():number`

<pre>获取当前设定的无线红石频率。
</pre>
'''自OC 1.3起添加：'''仅可用于2级红石卡。

* `setWirelessFrequency(frequency:number):number`

<pre>设定要使用的无线红石频率。
</pre>
'''自OC 1.3起添加：'''仅可用于2级红石卡。

* `getWakeThreshold():number`

<pre>获取当前唤醒阈值。
</pre>

* `setWakeThreshold(threshold:number):number`

<pre>将唤醒阈值设定为给定数字。\\
</pre>
请注意对于如ProjectRed（红石计划）这样的模组而言，较低的强度值（例如原版最高为15的强度值）可能不会像预期一样起到简单开/关信号的作用（例如用于开门）。因为这些模组的红石信号值范围更大。你可能需要指定一个更大的值，例如255。
== 使用例： ```lua local component = require("component") local sides = require("sides") local colors = require("colors") local rs = component.redstone --获取首选红石组件 print(rs.getInput(sides.back)) rs.setBundledOutput(sides.bottom, colors.green, rs.getBundledInput(sides.top, colors.red)) ``` ` 目录 ==

{{:Component/contents/zh}}

Component/redstone/zh - Revision history

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li