CC Chunk Loader

A dynamic chunk loading mod for ComputerCraft turtles that goes beyond traditional always-on/always-off chunk loaders.

Why This Mod?

I wasn't happy with existing chunk loading options for ComputerCraft setups. Standard chunk loaders are either always active or completely off - there's no middle ground for dynamic, intelligent chunk management.

CC Chunk Loader solves this by giving turtles the ability to dynamically scale their chunk loading based on what they're actually doing, with remote management capabilities for distributed automation systems.

Core Features

🔄 Dynamic Chunk Loading

• Turtles can adjust their chunk loading radius through code (0 to 2.5 chunks by default)
• Perfect for tasks that need different area coverage at different times
• Automatic shutdown when fuel runs out prevents abandoned chunk loaders

🔋 Fuel-Based Balancing

• Powered by turtle fuel with exponential cost scaling by distance loaded
• Random ticking support for farms (doubles fuel cost)
• Fractional fuel debt system for precise cost calculation
• All costs are fully configurable

📡 Remote Management

• Wake up dormant turtles by ID even in unloaded chunks
• Control any turtle's chunk loading remotely through the manager block
• Perfect for managing distributed automation without keeping everything loaded

⚙️ Smart Persistence

• Complete state preservation across server restarts/world reloads
• Wake-on-world-load option for critical turtles

API Reference

Chunkloader Peripheral

local chunkloader = peripheral.find("chunkloader")

-- Core chunk loading control
chunkloader.setRadius(radius)           -- Set loading radius (0-2.5, 0 = disabled)
chunkloader.getRadius()                 -- Get current radius
chunkloader.getFuelRate()              -- Get fuel consumption per tick

-- Wake control
chunkloader.setWakeOnWorldLoad(boolean) -- Auto-resume on server restart
chunkloader.getWakeOnWorldLoad()        -- Check wake setting

-- Random tick control (for farms)
chunkloader.setRandomTick(boolean)      -- Enable random ticking (doubles fuel cost)
chunkloader.getRandomTick()            -- Check random tick status

-- Turtle identification
chunkloader.getTurtleIdString()         -- Get unique turtle ID for remote management

Chunkloader Manager Block

local manager = peripheral.find("chunkloader_manager")

-- Remote turtle management
manager.getTurtleInfo(turtleId)                    -- Get turtle status/stats
manager.setTurtleRadius(turtleId, radius)          -- Wake & control dormant turtles
manager.setTurtleWakeOnWorldLoad(turtleId, boolean) -- Control wake settings remotely
manager.getTurtleWakeOnWorldLoad(turtleId)         -- Check wake settings
manager.listTurtles()                              -- List all active turtles

Use Cases

🌾 Smart Farming Systems

• Turtles enable chunk loading and random ticking only when tending crops
• Scale down to minimal radius when just monitoring
• Remote activation to start the farm remotely

📊 Monitoring Networks

• Wake dormant sensor turtles on-demand
• Collect data across large areas without constant chunk loading
• Centralized management through chunkmanager block

Highlights

• UUID-based persistence - Turtle identities survive world restarts and position changes
• Exponential fuel scaling - Larger areas cost exponentially more fuel to prevent abuse
• Custom block models - Polished visual design
• Comprehensive admin tools - Debug commands for troubleshooting

Configuration

All fuel costs and limits are configurable via in-game commands:

/ccchunkloader get <key>          # View current settings
/ccchunkloader set <key> <value>  # Modify settings
/ccchunkloader list               # Show all config values

Default Settings:

• Max radius: 2.5 chunks (covers ~21 chunks total)
• Base fuel cost: 0.033 per chunk per tick
• Random tick max radius: 1.4 chunks
• Distance multiplier: 2.0 (exponential scaling)

Advanced Features

Debug Commands

/ccchunkloader debug uuids        # List all tracked UUIDs
/ccchunkloader debug stats        # Show system statistics
/ccchunkloader debug orphans      # Find orphaned UUIDs

Remote Bootstrap

• Manager blocks can wake turtles in unloaded chunks
• Persistent state ensures no data loss during dormancy
• Wake-on-world-load for critical automation systems

---

Perfect for: Dynamic automation systems, large-scale turtle networks, smart resource management, and anyone who wants intelligent chunk loading instead of static always-on solutions.