CC-Tweaked/doc/events/redstone.md

---
module: [kind=event] redstone
---

<!--
SPDX-FileCopyrightText: 2021 The CC: Tweaked Developers

SPDX-License-Identifier: LicenseRef-CCPL
-->

The @{event!redstone} event is fired whenever any redstone inputs on the computer change.

## Return values
1. @{string}: The event name.

## Example
Prints a message when a redstone input changes:
```lua
while true do
  os.pullEvent("redstone")
  print("A redstone input has changed!")
end
```
Finish the rest of the event documentation (#683) 2021-01-19 09:20:52 +00:00			`---`
			`module: [kind=event] redstone`
			`---`

License CC:T according to the REUSE specification (#1351) This adds SPDX license headers to all source code files, following the REUSE[1] specification. This does not include any asset files (such as generated JSON files, or textures). While REUSE does support doing so with ".license" files, for now we define these licences using the .reuse/dep5 file. [1]: https://reuse.software/ 2023-03-15 21:52:13 +00:00			`<!--`
			`SPDX-FileCopyrightText: 2021 The CC: Tweaked Developers`

			`SPDX-License-Identifier: LicenseRef-CCPL`
			`-->`

Allow peripherals to have multiple types (#963) Peripherals can now have multiple types: - A single primary type. This is the same as the current idea of a type - some identifier which (mostly) uniquely identifies this kind of peripheral. For instance, "speaker" or "minecraft:chest". - 0 or more "additional" types. These are more like traits, and describe what other behaviour the peripheral has - is it an inventory? Does it supply additional peripherals (like a wired modem)?. This is mostly intended for the generic peripheral system, but it might prove useful elsewhere too - we'll have to see! - peripheral.getType (and modem.getTypeRemote) now returns 1 or more values, rather than exactly one. - Add a new peripheral.hasType (and modem.hasTypeRemote) function which determines if a peripheral has the given type (primary or additional). - Change peripheral.find and all internal peripheral methods to use peripheral.hasType instead. - Update the peripherals program to show all types This effectively allows you to do things like `peripheral.find("inventory")` to find all inventories. This also rewrites the introduction to the peripheral API, hopefully making it a little more useful. 2021-11-29 17:37:30 +00:00			`The @{event!redstone} event is fired whenever any redstone inputs on the computer change.`
Finish the rest of the event documentation (#683) 2021-01-19 09:20:52 +00:00
Update event docs (#1304) 2023-01-17 21:17:47 +00:00			`## Return values`
			`1. @{string}: The event name.`

Finish the rest of the event documentation (#683) 2021-01-19 09:20:52 +00:00			`## Example`
			`Prints a message when a redstone input changes:`
			```lua
			`while true do`
			`os.pullEvent("redstone")`
			`print("A redstone input has changed!")`
			`end`
			```