Description

CCPE — CC Peripheral Extender

Handy ComputerCraft: Tweaked peripherals for Create: Aeronautics on NeoForge

What's Included

Micro Peripheral Extender — wireless NBT reading for any block; wireless redstone signal control; remote peripheral access
Redstone Transceiver — wireless read and transmit of Create Redstone Link signals
Electronic Transmission — a rotation speed controller designed specifically for CC:T control

Features

📡 Wireless Block Reading

CC:Tweaked requires computers to be directly adjacent to target blocks for peripheral access. While many mods add peripheral support for their blocks, not every block has it.

CCPE adds a Peripheral Extender. Attach the sensor to any block, set a channel number, and wirelessly read that block's data from Lua — no cables, no distance limits.

Read NBT via pe.get(channel, path) or pe.getAll(channel)
Path syntax: "Items[0].Count", "ForgeData.CustomName", etc.

Data refreshes every server tick (50ms), Lua reads take ~0.02ms/call — ideal for high-frequency monitoring.

local pe = require("ccpe.pe") local data = pe.getAll(1) -- read full NBT of block on channel 1 local cnt = pe.get(1, "Items[0].Count") -- read a specific field by path

🔌 Peripheral Proxy

pe.getPeripheral(ch) — wirelessly access the attached block's CC:T peripheral methods

🧭 Navigation Table Integration (requires simulated:navigation_table)

Method Return Description pe.getNavTargetPos(ch) {x, y, z} Target world position pe.getNavSelfPos(ch) {x, y, z} Self world position pe.getNavDistance(ch) number Distance to target (meters) pe.getNavRelativeAngle(ch) number Bearing angle (degrees, 0~360)

🚀 Physics Data (requires Sable/physics structure)

Method Return Description getPhysicsPos(ch) {x, y, z} World position (m) getPhysicsOrientation(ch) {x, y, z, w} Rotation quaternion getPhysicsCenterOfMass(ch) {x, y, z} Center of mass (world coordinates) getPhysicsMass(ch) number Mass (kg) getPhysicsChainMass(ch) number Total mass of physics body chain (kg) getPhysicsGravityForce(ch) number Gravity force (N) getPhysicsChainGravityForce(ch) number Total gravity force of physics body chain (N)

Velocity methods require sensor attached to simulated:velocity_sensor

Method Return Description getPhysicsVelocity(ch) {x, y, z} Ground velocity (m/s) getPhysicsAirVelocity(ch) {x, y, z} Airspeed, wind subtracted (m/s) getPhysicsAngularVelocity(ch) {x, y, z} Angular velocity (rad/s)

📶 Wireless Redstone

pe.setRedstoneOutput(ch, 0-15) — transmit redstone signal (main thread)
pe.getRedstoneOutput(ch) — read transmitted signal
pe.getRedstoneInput(ch) — read received signal

📻 Redstone Transceiver

Allows computers to directly read and transmit Create Redstone Link signals — no need to place multiple redstone link blocks next to your computer.

Each transceiver uses Banners to configure multiple channels, each bound to a pair of redstone frequency items. Access via channel number from Lua:

local r = peripheral.find("ccpe:redstone_transceiver") -- Read the Create redstone network signal on channel 3 local signal = r.getRedstoneSignal(3) -- Transmit a full signal to the Create network on channel 7 r.setRedstoneSignal(7, 15) Method Description getRedstoneSignal(channel) Read the Create Redstone Link signal bound to the channel (0–15) setRedstoneSignal(channel, 0-15) Transmit a redstone signal to the Create network bound to the channel (main thread)

🎛️ Electronic Transmission

How is it different from the RotationSpeedController? Using Create's RotationSpeedController as a peripheral (calling setTargetSpeed()) triggers RotationPropagator.handleRemoved(), which cascades through the entire downstream sub-network clearing all sources. This causes unexpected behavior (e.g. stepper servos from Aeroworks running wild when speed changes). Simulated's AnalogTransmission lacks a CC:T interface and is difficult to fine-tune.

The Electronic Transmission uses detachKinetics() + attachKinetics() to gently refresh the network without disrupting downstream devices.

Electronic Transmission (ccpe:transmission_peripheral) does not accept redstone signals — Lua control only. Place it in a kinetic network to adjust downstream speed in real time.

local t = peripheral.find("ccpe:transmission_peripheral") -- Ratio mode: downstream = upstream × ratio t.setRatio(0.5) -- reduce to 50% t.setRatio(3.0) -- boost to 3× (capped at 256 RPM) -- Target speed mode: directly set downstream speed (0–256, 2 decimal places) t.setTargetSpeed(128.56) print(t.getTargetSpeed()) -- 128.56 -- Query current state print(t.getRatio()) Method Description setRatio(ratio) Set speed ratio (≥0), enters ratio mode (main thread) getRatio() Get current ratio setTargetSpeed(speed) Directly set downstream speed 0–256.00, enters target mode (main thread) getTargetSpeed() Get target speed

Calling setRatio switches to ratio mode; calling setTargetSpeed switches to target mode. Actual output is capped at 256 RPM in both modes.

🏗️ Chunk & Physics Body Loading

The sensor can keep its target area loaded:

Mode Description Use Case Off No loading Short-range use Load Chunk Uses vanilla setChunkForced on the sensor's chunk Prevent the block's chunk from unloading Load Physics Body Registers Sable force-load ticket + PORTAL ticket that follows movement Prevent aircraft/physics bodies from being unloaded by Sable's distance optimization

Physics body mode automatically tracks the structure's movement, relocating PORTAL tickets to the body's current chunk. Bearing connection chains are refreshed every 5 seconds.

Config (config/ccpe-common.toml):

sensorChunkLoadEnabled — enable chunk loading
sensorMaxForceLoad — max concurrent loaded sensors
sensorPortalTicketRadius — PORTAL ticket radius

Quick Start

local pe = require("ccpe.pe") -- Read a chest's inventory local items = pe.getAll(1) for k, v in pairs(items) do print(k, v) end -- Navigation guidance (sensor on navigation table required) local target = pe.getNavTargetPos(2) local dist = pe.getNavDistance(2) local angle = pe.getNavRelativeAngle(2) print(string.format("Target: %.0fm away, bearing %.1f°", dist, angle)) -- Physics data local mass = pe.getPhysicsMass(3) local com = pe.getPhysicsCenterOfMass(3) print(string.format("Mass: %.1f kg, COM: %.1f, %.1f, %.1f", mass, com.x, com.y, com.z)) -- Wireless redstone pe.setRedstoneOutput(4, 15) -- power the sensor on channel 4 -- Create redstone link control local redstone = peripheral.find("ccpe:redstone_transceiver") redstone.setRedstoneSignal(5, 15) -- transmit to Create network on channel 5 redstone.getRedstoneSignal(3) -- read Create network signal on channel 3 -- Electronic transmission control local trans = peripheral.find("ccpe:transmission_peripheral") trans.setTargetSpeed(200) -- set downstream speed to 200 RPM trans.setRatio(0.75) -- switch to ratio mode: 75% output