CC: Atmos

A ComputerCraft addon for Minecraft 1.21.1 (NeoForge)

CC: Atmos adds the Bangboo — a craftable entity with a built-in ComputerCraft computer — plus a set of standalone World Blocks (Upgradable PC, Upgradable Pocket Computer, Upgradable Turtle, Wireless Wired Modem) that reuse the same plug-in/peripheral system without needing a Bangboo at all. Nothing acts on its own; you write the Lua programs. Equip plug-in cartridges or upgrade items to unlock peripherals, then program to scan, navigate, communicate, and interact with the world.

---

The Bangboo

The Bangboo is deployed from a Boo Box item (right-click on a block). Each Bangboo runs its own CC computer accessible by right-clicking it. Plug-ins are installed into up to 8 cartridge slots (4 base, +4 with a Plugin Hub installed).

Core Plug-ins

Plug-in	Peripheral	What it unlocks
Sensor Core	scanner	scan(radius, [filter]) — detects nearby blocks and entities
Navigation Core	pathing	path(x,y,z) — navigates to exact world coordinates
Compass Core	compass	Waypoint storage and distance/facing queries
Comms Core	wireless	Wireless modem messaging between Bangboos
Logistics Core	inventory / storage	Internal inventory management and block storage I/O
Field Core	tool	Block breaking, placement, and entity interaction
Proximity Core	proximity	Fires events when entities enter or leave a radius
Redstone Core	redstone	Reads redstone signals from adjacent blocks
Lantern Core	lantern	Places a dynamic light source above the Bangboo
Speaker Core	speaker	Plays sounds and note blocks
Language Core	language	Speaks to nearby players and listens for replies
Cosmetic Core	cosmetic	Changes the Bangboo's active skin at runtime
Anti-Grav Core	anti_grav	Switches the Bangboo to flight mode
Config Core	config	Adjusts stats (speed, health, attack) at runtime
Command Core	command	Runs server commands (creative/admin only)
Backpack Plug-in	backpack	Attaches a Shulker Box or Sophisticated Backpack
Advanced Terminal	—	Upgrades the built-in terminal to Advanced (colour)
Plugin Hub	—	Unlocks 4 extra plug-in slots (8 total)

Tiered Cores

Cores bundle multiple plug-in peripherals into a single slot. Higher marks add more peripherals — same one slot, more capability.

Core	Mk1	Mk2	Mk3
Sensor	scanner	+ proximity	—
Navigation	pathing, compass	+ scanner, proximity	—
Comms	wireless, redstone	+ language	+ speaker
Logistics	inventory	+ storage	—
Field	tool	+ inventory	+ storage

Skin System

Bangboo skins are data-pack driven — drop a JSON into data/<namespace>/bangboo_skin/ to register a new skin with its own model, texture, animation set, hitbox, and scale. See docs/CUSTOM_SKINS.md for the full authoring guide.

---

World Blocks

Placed in the world (or carried, for the pocket computer) — none of these need a Bangboo.

Block/Item	What it is
Wireless Wired Modem (ccatmos:wireless_wired_modem)	A wall-mounted modem that links to other Wireless Wired Modems by shared password instead of Networking Cable — every modem sharing a password, in the same dimension, forms one peripheral network.
Upgradable PC (ccatmos:upgradable_pc)	A standalone desk computer. GPU/Storage upgrade slots (right-click for the terminal, shift-right-click for the upgrade bay) decide its computer family, terminal color range, and disk space; also scans for adjacent peripherals like a real CC:Tweaked Computer.
Upgradable Pocket Computer (ccatmos:upgradable_pocket_computer)	A handheld version of the Upgradable PC — same GPU/Storage upgrade slots, plus a 9-slot peripheral bay accepting both this mod's plug-ins and real CC:Tweaked pocket-upgrade items. Renders a live mini-terminal while held.
Upgradable Turtle (ccatmos:upgradable_turtle)	A real, fully-functional CC:Tweaked Turtle (stock movement/fuel/mining/inventory/upgrade slots, untouched) with a bolt-on Storage slot + 9-slot peripheral bay, and its own blue-recolored GUI so real vanilla turtles are unaffected.

Full details (Lua APIs, upgrade items, slot rules, known limitations) are in docs/PLUGINS.md.

---

Dependencies

Mod	Version	Role
CC: Tweaked	1.119.0	Required
GeckoLib	4.8.4	Required
Sophisticated Backpacks	—	Optional — enables Backpack Plug-in
Sophisticated Core	—	Optional — required if using Sophisticated Backpacks

A note on physics mod compatibility (Sable / Create Aeronautics)

Compatibility with Sable and Create Aeronautics was explored but ultimately removed. Sable injects global mixins into vanilla pathfinding (GroundPathNavigationMixin, WalkNodeEvaluatorMixin, PathNavigationMixin) that affect all entities — not just those on ships. Having the Sable JARs on the classpath caused the Bangboo's navigation to stop 1 block short of every target, even in a world with no ships at all.

Navigation on moving sublevels is something we'd like to revisit in the future.

---

Build & Dev Setup

Requirements: JDK 21, Gradle, VSCode with the Extension Pack for Java and Gradle for Java extensions.

# Compile (fast, for iteration)
./gradlew compileJava

# Build the mod jar
./gradlew build

# Launch dev client
./gradlew runClient

# Launch dev server
./gradlew runServer

Note: Avoid ./gradlew clean — it deletes NeoForge's generated artifacts and breaks VSCode's classpath. If you need a clean build, run compileJava afterwards and reload the Java language server.

---

Lua API

Full peripheral API documentation is in docs/PLUGINS.md.
Custom skin authoring guide is in docs/CUSTOM_SKINS.md.