星际货运火箭 [非官方]

星际货运火箭 [非官方]

这是BillBodkin的AdAstra货运火箭的非官方分支。此模组添加货运火箭,用于跨维度运输物品并实现自动化。

此模组为 Ad Astra 添加货运火箭,并且在与 CC:tweaked 配合使用时,可以让你自动化星球之间的物品运输。

此分支新增的功能

新增粒子与音效,并重做发射/着陆动画

使用 Ad Astra 的音效与粒子进行表现
现在起飞和着陆比之前更加平滑。
同时修复了火箭会降落在无碰撞检测的方块上的问题。

新增火箭类型

新增三个等级的火箭。
每个等级可到达的最大星球数量不同。
适用与 AdAstra 火箭相同的距离限制
随着火箭等级的加入,燃料与能量消耗现在会根据目的地而增加

新增实用标签

此模组新增物品标签 denied_in_launch_pad,用于阻止在发射台中使指定物品(例如潜影盒)
通过使用此标签,你可以防止非法运输手段。

可自定义目的地的难度等级与燃料效率

修改 config/ad_astra_cargo_rockets.json 以自定义目标目的地的消耗与燃料效率。

新增实用的 CC 功能

📥 loadAllItems([filter])

将发射台物品栏中的所有物品移动到火箭物品栏中。
如果指定物品 ID,则只移动该物品。

📤 unloadAllItems([filter])

将火箭物品栏中的所有物品移动到发射台物品栏中。
如果指定物品 ID,则只移动该物品。

参数

  • filter? (string) :要加载或卸载的物品名称(例如 "minecraft:cobblestone")

火箭发射台 Lua API

此 API 允许你通过 CC:Tweaked 电脑控制火箭发射台。它提供发射火箭、管理物品栏以及检查能量的函数。


连接

你必须将电脑连接到发射台的中心方块才能访问以下方法。 连接到外部方块将允许你访问通用物品栏方法。


📦 物品栏槽位索引

  • Lua 中的所有物品栏槽位索引均从 1 开始,与 CC:Tweaked 的约定一致。

🧨 launch(planet)

尝试将火箭发射到指定星球。(参见 getValidDestinations)

参数

  • planet (string):目的星球名称。

错误

  • "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 (int):火箭物品栏中的槽位。
  • launchPadSlot (int):发射台物品栏中的槽位。

错误

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

📤 moveItemsFromLaunchPadToRocket(launchPadSlot, rocketSlot)

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

参数

  • launchPadSlot (int):发射台物品栏中的槽位。
  • rocketSlot (int):火箭物品栏中的槽位。

错误

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

⚡ getEnergyRequiredForLaunch()

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

返回值

  • int:所需能量。

🔋 getEnergy()

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

返回值

  • long:当前能量。

🔋 getMaxEnergy()

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

返回值

  • long:最大能量。

🌍 getValidDestinations()

返回有效目的星球名称的表,键为星球,值为到达该星球所需的火箭等级。

返回值

  • table<string, int>:键为星球、值为到达该星球所需火箭等级的表。

📦 listLaunchPadInventory()

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

返回值

  • table<int, table>:将槽位索引映射到物品表的表,包含:
    • name (string):显示名称。
    • id (string):注册 ID。
    • count (int):堆叠数量。
    • max_count (int):最大堆叠数量。

📥 listLaunchPadInputSlotIndexes()

列出哪些槽位索引被视为输入槽位。 这些是漏斗和其他物品运输模组可以插入的槽位。

返回值

  • int[]:输入槽位索引列表(从 1 开始)。

📤 listLaunchPadOutputSlotIndexes()

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

返回值

  • int[]:输出槽位索引列表(从 1 开始)。

🚀 isRocketPresent()

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

返回值

  • boolean:如果存在火箭则为 true,否则为 false。

🚀 listRocketInventory()

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

返回值

  • table<int, table>|nil:如果存在火箭,则为将槽位索引映射到物品数据的表;如果未找到火箭,则为 nil。物品表包含:
    • name (string):显示名称。
    • id (string):注册 ID。
    • count (int):堆叠数量。
    • max_count (int):最大堆叠数量。

致谢

分支来源:Ad Astra Cargo Rockets by BillBodkin URL: https://modrinth.com/mod/ad-astra-cargo-rockets