Ad Astra Cargo Rockets

早期测试版！

此模组添加了可在星球之间运送货物的自动火箭。你可以使用 CC:Tweaked 电脑，通过以下 API 控制火箭：

火箭发射台 Lua API

此 API 可让你通过 CC:Tweaked 电脑控制火箭发射台。它提供了发射火箭、管理物品栏和检查能量的功能。

连接方式

你必须将电脑连接到发射台的中央方块，才能使用以下方法。
连接到外围方块则可以使用通用物品栏方法。

📦 物品栏槽位索引

• Lua 中的所有物品栏槽位索引都从 1 开始，与 CC:Tweaked 的惯例一致。

🧨 launch(planet)

尝试向指定星球发射火箭。（参见 getValidDestinations）

参数

• planet（字符串）：目的地星球的名称。

错误

• "No rocket found"– 发射台上没有火箭。
• "<planet> is not a valid planet"– 指定的星球名称无效。
• "Not enough energy to launch"– 发射台能量不足。
• "<planet> is too high of a tier for this rocket"– 火箭等级不足以抵达目的地。

📥 moveItemsFromRocketToLaunchPad(rocketSlot, launchPadSlot)

将物品从火箭的物品栏移动到发射台的物品栏。

参数

• rocketSlot（整数）：火箭物品栏中的槽位。
• launchPadSlot（整数）：发射台物品栏中的槽位。

错误

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

📤 moveItemsFromLaunchPadToRocket(launchPadSlot, rocketSlot)

将物品从发射台的物品栏移动到火箭的物品栏。

参数

• launchPadSlot（整数）：发射台物品栏中的槽位。
• rocketSlot（整数）：火箭物品栏中的槽位。

错误

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

⚡ getEnergyRequiredForLaunch()

返回发射火箭所需的能量。

返回值

• int：所需能量。

🔋 getEnergy()

返回发射台当前储存的能量。

返回值

• long：当前能量。

🔋 getMaxEnergy()

返回发射台的最大能量容量。

返回值

• long：最大能量。

🌍 getValidDestinations()

返回有效目的地星球名称组成的表，其中键为星球名称，值为抵达该星球所需的火箭等级。

返回值

• table<string, int>：一个表，键为星球名称，值为抵达该星球所需的火箭等级。

📦 listLaunchPadInventory()

返回发射台当前非空的物品栏。

返回值

• table<int, table>：一个表，将槽位索引映射到包含以下内容的物品表：
• name（字符串）：显示名称。
• id（字符串）：注册 ID。
• count（整数）：堆叠数量。
• max_count（整数）：最大堆叠数量。

📥 listLaunchPadInputSlotIndexes()

列出被视为输入槽位的索引。
漏斗和其他物品传输模组可以向这些槽位放入物品。

返回值

• int[]：输入槽位索引列表（从 1 开始）。

📤listLaunchPadOutputSlotIndexes()

列出哪些槽位索引被视为输出槽位。
这些槽位可供漏斗和其他物品运输模组提取物品。

返回

• int[]：输出槽位索引列表（从1开始）。

🚀 isRocketPresent()

检查发射台上是否有火箭。

返回

• boolean：如果有火箭则返回 true，否则返回 false。

🚀 listRocketInventory()

返回火箭当前非空的物品栏。

返回

• table<int, table>|nil：如果找到火箭，则返回槽位索引到物品数据的映射表；如果未找到火箭，则返回 nil。物品表包含：
• name（字符串）：显示名称。
• id（字符串）：注册表 ID。
• count（整数）：堆叠数量。
• max_count（整数）：最大堆叠数量。