Ad Astra Cargo Rockets

WARNING: EARLY ALPHA VERSION!

This mod adds automated rockets to the game for transporting cargo between planets. Control is managed through CC:Tweaked computers using a special API.

Launchpad Management API

This interface allows programming computers to control rocket launchpads, including rocket launches, inventory management, and energy monitoring.

Connection

To access control functions, the computer must be connected to the central block of the launchpad. Connecting to side blocks only provides access to standard inventory methods.

Inventory Slot Numbering

All slot numbers in Lua start from 1, following CC:Tweaked standards.

🧨 launch(planet)

Launches a rocket to the specified planet. (See getValidDestinations)

Parameters:

• planet (string): Destination planet name

Possible errors:

• "No rocket found" – No rocket on the pad
• "<planet> is not a valid planet" – Invalid planet name
• "Not enough energy to launch" – Insufficient energy
• "<planet> is too high of a tier for this rocket" – Rocket tier too low

📥 moveItemsFromRocketToLaunchPad(rocketSlot, launchPadSlot)

Moves items from rocket inventory to launchpad inventory.

Parameters:

• rocketSlot (number): Slot in rocket inventory
• launchPadSlot (number): Slot in launchpad inventory

Errors:

• "No rocket found"
• "Destination full"
• "Invalid slot"

📤 moveItemsFromLaunchPadToRocket(launchPadSlot, rocketSlot)

Moves items from launchpad inventory to rocket inventory.

Parameters:

• launchPadSlot (number): Slot in launchpad inventory
• rocketSlot (number): Slot in rocket inventory

Errors: similar to previous function

⚡ getEnergyRequiredForLaunch()

Returns the amount of energy required to launch the rocket.

Returns: int – Required energy

🔋 getEnergy()

Shows the current energy stored in the launchpad.

Returns: long – Current energy

🔋 getMaxEnergy()

Returns the maximum energy capacity of the launchpad storage.

Returns: long – Maximum energy

🌍 getValidDestinations()

Returns a table of available destination planets with required rocket tier.

Returns: table<string, int> – Key: planet, value: required tier

📦 listLaunchPadInventory()

Shows the contents of launchpad inventory (only filled slots).

Returns: table<int, table> – Table with item data:

• name (string): Display name
• id (string): Registry ID
• count (number): Stack size
• max_count (number): Maximum stack size

📥 listLaunchPadInputSlotIndexes()

List of input slots for item transportation (for hoppers and transport).

Returns: int[] – Input slot numbers (starting from 1)

📤 listLaunchPadOutputSlotIndexes()

List of output slots for item extraction.

Returns: int[] – Output slot numbers (starting from 1)

🚀 isRocketPresent()

Checks if a rocket is present on the launchpad.

Returns: boolean – true if rocket is present

🚀 listRocketInventory()

Shows the contents of rocket inventory.

Returns: table<int, table>|nil – Item data or nil if no rocket

Item data structure is similar to listLaunchPadInventory()