CC:Optical

Adds sensor and cannon control peripherals to CC:Tweaked, compatible with Create:Aeronautics.

All blocks

Sensors

Four variants with dynamic FOV zoom, target filtering, and scanning methods:

Optical Sensor (optical_sensor) — omni-directional by default (360° FOV) with a base range of 96 blocks. Supports narrowing FOV down to 15° for increased zoom range (up to 192 blocks). Requires direct line of sight (real terrain blocks only; sublevel terrain is transparent).

Directional Optical Sensor (directional_optical_sensor) — directional cone field of view (default 125°, adjustable down to 10°), base range 90 blocks at full FOV, zooming up to 512 blocks at minimum FOV.

Long Range Optical Sensor (long_range_optical_sensor) — directional cone field of view (default 125°, adjustable down to 10°), base range 96 blocks at full FOV, zooming up to 900 blocks at minimum FOV.

Radar (entity_radar) — omni-directional, base range 64 blocks, ignores line of sight. Placing adjacent Radar Booster (radar_booster) blocks adds +224 blocks per booster (up to 2 boosters for 512 blocks total). Adding a 2-block antenna (lightning rods or iron bars) on top of the radar or on any of its boosters multiplies the booster effect, boosting the radar range up to ~900 blocks. Position readings have Gaussian noise (increases with distance, varies by sensor altitude relative to sea level).

Detections work across sublevel boundaries. A sensor on an airship can spot another airship and the entities inside it. Each detection carries the sublevel UUID when the target is inside one. Decorative non-entities (paintings, item frames, displays, markers) are automatically ignored.

Detection fidelity decreases with range, but recognition distances scale dynamically with FOV zoom and booster upgrades. Beyond precision limits, targets are classified only by size (object_small/object_mid/object_large). Radar position noise grows linearly with distance and varies with the sensor's altitude relative to sea level.

Range & Recognition Scaling

Sensor / Configuration	FOV / Addons	Max Range	Exact Type (`type`)	Player Name (`name`)
Optical Sensor	360° (Omni)	96 m	≤ 56 m	≤ 40 m
Optical Sensor	15° (Zoom)	192 m	≤ 112 m	≤ 80 m
Directional Optical	125° (Full FOV)	90 m	≤ 56 m	≤ 40 m
Directional Optical	10° (Max Zoom)	512 m	≤ 318 m	≤ 227 m
Long Range Optical	125° (Full FOV)	96 m	≤ 56 m	≤ 40 m
Long Range Optical	10° (Max Zoom)	900 m	≤ 525 m	≤ 375 m
Radar	Base (0 Boosters)	64 m	≤ 28 m	≤ 18 m
Radar	1 Booster	288 m	≤ 126 m	≤ 81 m
Radar	2 Boosters (Full Boost)	512 m	≤ 224 m	≤ 144 m
Radar	1 Booster + Antenna	482 m	≤ 211 m	≤ 135 m
Radar	2 Boosters + Antenna	900 m	≤ 394 m	≤ 253 m

Lua API

Sensor methods available in CC:Tweaked:

Method	Parameters	Returns	Description
`scan`	`relativeCoords: boolean` (optional)	`table`	Run an immediate scan. If `true`, returned positions are rotated into the sensor's sublevel local frame.
`setFov`	`fov: number`	`number`	Sets optical field of view in degrees (clamped to `[minFov, maxFov]`). Narrower FOV increases effective range. Optical only.
`getFov`	—	`number`	Returns current field of view in degrees.
`getMinFov`	—	`number`	Returns minimum allowed field of view in degrees.
`getMaxFov`	—	`number`	Returns maximum allowed field of view in degrees.
`getRange`	—	`number`	Returns current effective detection range in blocks (scales dynamically with FOV).
`setFilter`	`typeOrList: string\|table` (optional)	`string[]`	Sets active target filter (by exact ID, short name, `"sublevel"`, or size class `"object_small"`/`"object_mid"`/`"object_large"`). Unmatched entities do not count towards target limits. Pass `nil` to clear.
`getFilter`	—	`string[]`	Returns array of currently active target filters.
`clearFilter`	—	`boolean`	Clears all active filters.
`isOptical`	—	`boolean`	Returns `true` if this is an optical sensor supporting FOV/zoom/filtering, `false` for radar.

`scan()` return table

Field	Type	Description
`count`	`number`	Number of detections
`lastScanTick`	`number`	Server tick when scan ran
`relativeCoords`	`boolean`	Whether relative coordinates were used
`detections`	`table[]`	Array of detection objects

Detection fields

Field	Type	Description
`id`	`string`	Entity UUID (or sublevel UUID for sublevel bounding boxes)
`type`	`string`	Entity registry name (e.g. `"minecraft:zombie"`), size class (`"object_small"`/`"object_mid"`/`"object_large"`), or `"sublevel"`
`name`	`string` or `nil`	Player scoreboard name (if within name-precision distance)
`x`, `y`, `z`	`number`	Offset from sensor origin (blocks)
`distance`	`number`	Straight-line distance
`subLevelUUID`	`string` or `nil`	UUID of the sublevel the entity is inside
`subLevelName`	`string` or `nil`	Name of the sublevel

Example

local sensor = peripheral.wrap("left")

-- Narrow FOV to boost range and focus only on sublevels
if sensor.isOptical() then
  sensor.setFov(15)
  sensor.setFilter("sublevel")
end

while true do
  local res = sensor.scan(true)
  print("Targets: " .. res.count)
  for _, t in ipairs(res.detections) do
    print(("%s @ %.1f m (x=%.1f, y=%.1f, z=%.1f)"):format(t.type, t.distance, t.x, t.y, t.z))
  end
  sleep(0.25)
end

CBC Cannon Mount

Wraps cannon mounts from Create Big Cannons as cbc_cannon_mount peripherals (additional type cannon_mount). Aim, fire, and query state from Lua.

Method	Parameters	Returns	Description
`assemble`	—	`boolean`	Assembles the cannon contraption
`disassemble`	—	`boolean`	Disassembles
`fire`	—	`boolean`	Fires the cannon
`isRunning`	—	`boolean`	Whether assembled and running
`isAssembled`	—	`boolean`	Same as `isRunning`
`isLoaded`	—	`boolean`	Whether cannon can fire
`setPitch`	`pitch: number`	`boolean`	Set target pitch (degrees)
`setYaw`	`yaw: number`	`boolean`	Set target yaw (degrees)
`getPitch`	—	`number`	Current pitch
`getYaw`	—	`number`	Current yaw offset
`getX`	—	`number` or `nil`	Controller X position
`getY`	—	`number` or `nil`	Controller Y position
`getZ`	—	`number` or `nil`	Controller Z position
`getMaxDepress`	—	`number` or `nil`	Maximum depression angle
`getMaxElevate`	—	`number` or `nil`	Maximum elevation angle
`getDirection`	—	`string` or `nil`	Facing direction (`north`/`south`/`east`/`west`)
`getCannonWeight`	—	`number` or `nil`	Cannon stress-weight

Rotation can be restricted by config (cbcFreeRotationEnabled, cbcFreeRotationMaxWeight). Throws LuaException when blocked.

Fully compatible with CannonMountPeripheral from VS: Addition - same "cannon_mount" additional type, same method shapes.

For Server Owners

All features are configurable. Disable the CBC cannon mount peripheral (cbcPeripheralEnabled: false) to avoid conflicts with other mods that add the same peripheral (CC:CBC as example).

If you would like to translate the mod, have found a bug, or want to suggest something new:

Discord: Cyber_Jellyfish

CC:Optical

Adds sensor and cannon control peripherals to CC:Tweaked, compatible with Create:Aeronautics.

All blocks

Sensors

Four variants with dynamic FOV zoom, target filtering, and scanning methods:

Range & Recognition Scaling

Sensor / Configuration	FOV / Addons	Max Range	Exact Type (`type`)	Player Name (`name`)
Optical Sensor	360° (Omni)	96 m	≤ 56 m	≤ 40 m
Optical Sensor	15° (Zoom)	192 m	≤ 112 m	≤ 80 m
Directional Optical	125° (Full FOV)	90 m	≤ 56 m	≤ 40 m
Directional Optical	10° (Max Zoom)	512 m	≤ 318 m	≤ 227 m
Long Range Optical	125° (Full FOV)	96 m	≤ 56 m	≤ 40 m
Long Range Optical	10° (Max Zoom)	900 m	≤ 525 m	≤ 375 m
Radar	Base (0 Boosters)	64 m	≤ 28 m	≤ 18 m
Radar	1 Booster	288 m	≤ 126 m	≤ 81 m
Radar	2 Boosters (Full Boost)	512 m	≤ 224 m	≤ 144 m
Radar	1 Booster + Antenna	482 m	≤ 211 m	≤ 135 m
Radar	2 Boosters + Antenna	900 m	≤ 394 m	≤ 253 m

Lua API

Sensor methods available in CC:Tweaked:

Method	Parameters	Returns	Description
`scan`	`relativeCoords: boolean` (optional)	`table`	Run an immediate scan. If `true`, returned positions are rotated into the sensor's sublevel local frame.
`setFov`	`fov: number`	`number`	Sets optical field of view in degrees (clamped to `[minFov, maxFov]`). Narrower FOV increases effective range. Optical only.
`getFov`	—	`number`	Returns current field of view in degrees.
`getMinFov`	—	`number`	Returns minimum allowed field of view in degrees.
`getMaxFov`	—	`number`	Returns maximum allowed field of view in degrees.
`getRange`	—	`number`	Returns current effective detection range in blocks (scales dynamically with FOV).
`setFilter`	`typeOrList: string\|table` (optional)	`string[]`	Sets active target filter (by exact ID, short name, `"sublevel"`, or size class `"object_small"`/`"object_mid"`/`"object_large"`). Unmatched entities do not count towards target limits. Pass `nil` to clear.
`getFilter`	—	`string[]`	Returns array of currently active target filters.
`clearFilter`	—	`boolean`	Clears all active filters.
`isOptical`	—	`boolean`	Returns `true` if this is an optical sensor supporting FOV/zoom/filtering, `false` for radar.

`scan()` return table

Field	Type	Description
`count`	`number`	Number of detections
`lastScanTick`	`number`	Server tick when scan ran
`relativeCoords`	`boolean`	Whether relative coordinates were used
`detections`	`table[]`	Array of detection objects

Detection fields

Field	Type	Description
`id`	`string`	Entity UUID (or sublevel UUID for sublevel bounding boxes)
`type`	`string`	Entity registry name (e.g. `"minecraft:zombie"`), size class (`"object_small"`/`"object_mid"`/`"object_large"`), or `"sublevel"`
`name`	`string` or `nil`	Player scoreboard name (if within name-precision distance)
`x`, `y`, `z`	`number`	Offset from sensor origin (blocks)
`distance`	`number`	Straight-line distance
`subLevelUUID`	`string` or `nil`	UUID of the sublevel the entity is inside
`subLevelName`	`string` or `nil`	Name of the sublevel

Example

local sensor = peripheral.wrap("left")

-- Narrow FOV to boost range and focus only on sublevels
if sensor.isOptical() then
  sensor.setFov(15)
  sensor.setFilter("sublevel")
end

while true do
  local res = sensor.scan(true)
  print("Targets: " .. res.count)
  for _, t in ipairs(res.detections) do
    print(("%s @ %.1f m (x=%.1f, y=%.1f, z=%.1f)"):format(t.type, t.distance, t.x, t.y, t.z))
  end
  sleep(0.25)
end

CBC Cannon Mount

Wraps cannon mounts from Create Big Cannons as cbc_cannon_mount peripherals (additional type cannon_mount). Aim, fire, and query state from Lua.

Method	Parameters	Returns	Description
`assemble`	—	`boolean`	Assembles the cannon contraption
`disassemble`	—	`boolean`	Disassembles
`fire`	—	`boolean`	Fires the cannon
`isRunning`	—	`boolean`	Whether assembled and running
`isAssembled`	—	`boolean`	Same as `isRunning`
`isLoaded`	—	`boolean`	Whether cannon can fire
`setPitch`	`pitch: number`	`boolean`	Set target pitch (degrees)
`setYaw`	`yaw: number`	`boolean`	Set target yaw (degrees)
`getPitch`	—	`number`	Current pitch
`getYaw`	—	`number`	Current yaw offset
`getX`	—	`number` or `nil`	Controller X position
`getY`	—	`number` or `nil`	Controller Y position
`getZ`	—	`number` or `nil`	Controller Z position
`getMaxDepress`	—	`number` or `nil`	Maximum depression angle
`getMaxElevate`	—	`number` or `nil`	Maximum elevation angle
`getDirection`	—	`string` or `nil`	Facing direction (`north`/`south`/`east`/`west`)
`getCannonWeight`	—	`number` or `nil`	Cannon stress-weight

Rotation can be restricted by config (cbcFreeRotationEnabled, cbcFreeRotationMaxWeight). Throws LuaException when blocked.

Fully compatible with CannonMountPeripheral from VS: Addition - same "cannon_mount" additional type, same method shapes.

For Server Owners

All features are configurable. Disable the CBC cannon mount peripheral (cbcPeripheralEnabled: false) to avoid conflicts with other mods that add the same peripheral (CC:CBC as example).

If you would like to translate the mod, have found a bug, or want to suggest something new:

Discord: Cyber_Jellyfish

CC: Optical

Sable listing

CC:Optical

Sensors

Range & Recognition Scaling

Lua API

`scan()` return table

Detection fields

Example

CBC Cannon Mount

For Server Owners

CC: Optical

Sable listing

CC:Optical

Sensors

Range & Recognition Scaling

Lua API

`scan()` return table

Detection fields

Example

CBC Cannon Mount

For Server Owners

Sable listing

CC:Optical

Sensors

Range & Recognition Scaling

Lua API

scan() return table

Detection fields

Example

CBC Cannon Mount

For Server Owners

Sable listing

CC:Optical

Sensors

Range & Recognition Scaling

Lua API

scan() return table

Detection fields

Example

CBC Cannon Mount

For Server Owners

`scan()` return table

`scan()` return table