ComputerCraft Wake Nodes

模组

· 作者 0Davgi0

一个为 Forge 添加的模组,为 CC: Tweaked 计算机添加了唤醒节点,支持动态区块加载控制,允许你远程唤醒远处的 CC 计算机。

0 本站下载 0 关注 更新于 7 个月前

最新 1.2.0 · 1.20.6 · Forge

一键开服(送7天)

ComputerCraft Wake Nodes

ComputerCraft Wake Nodes 是一款适用于 Minecraft 1.20.1 的 Forge 模组,为 CC: Tweaked (ComputerCraft) 计算机添加了一个小型区块加载网络,特别适用于自动化设置。

它引入了三种 ComputerCraft 外围设备:

  • wake_node:连接到 ComputerCraft 计算机并以字符串 ID 注册,实质上充当区块加载器。
  • wake_node_advanced:wake_node 的升级版,允许用户选择加载区域(1×1、3×3 或 5×5 个区块)。
  • wake_controller:供其他计算机用于列出、加载、卸载和检查已注册的节点。

主要用途是唤醒远处的计算机设置,使其区块加载并运行 tick,从而让启动逻辑得以执行。

它还添加了 Wake Chip,一种由其他方块使用的合成组件。

如果安装了 Create,则提供 Wake Chip、Wake Node、Advanced Wake Node 和 Wake Controller 的自定义 Create 合成配方。

功能

  • 通过将 Wake Node 附加到 ComputerCraft 计算机上来注册远程唤醒点。
  • 从 Wake Controller 按需加载远程计算机所在的区块。
  • 永久加载区块直到手动卸载,或使用自动超时临时加载。
  • 跨服务器重启持久化节点注册信息。
  • 保持区块加载的瞬态性:重启后不会自动恢复已加载的区块。
  • 为两种方块提供简单的 ComputerCraft API。

要求

  • Minecraft 1.20.1
  • Forge 47.2.0+
  • Java 17
  • CC: Tweaked 1.108.4+

新增内容

Wake Chip

由其他方块使用的合成组件。

配方:

Wake chip recipe

创造模式标签页:Ingredients

Wake Node

一个薄型外围设备方块,必须直接放置在 CC: Tweaked 计算机方块的旁边。

功能:

  • 暴露 wake_node 外围设备类型
  • 存储从 Lua 分配的节点 ID
  • 将所连接计算机的维度与区块注册到持久化注册表中
  • 如果支撑它的计算机被移除,会自动销毁

重要放置规则:

  • 除非支撑方块是 ComputerCraft 计算机方块,否则拒绝放置

配方:

Wake Node recipe

创造模式标签页:Functional Blocks

Advanced Wake Node

升级版的 Wake Node,允许用户选择围绕所连接计算机的加载区域:

  • 1×1 — 1 个区块(与基础 Wake Node 相同)
  • 3×3 — 9 个区块
  • 5×5 — 25 个区块

它继承了基础 Wake Node 的所有功能,并增加了 setRange()、getRange() 和 listAvailableRanges() 方法。

配方(形状与 Wake Node 相同,但使用下界合金而非铁):

Advanced Wake Node recipe

创造模式标签页:Functional Blocks

Wake Controller

供控制器计算机管理已注册唤醒点的外围设备方块。

功能:

  • 暴露 wake_controller 外围设备类型
  • 列出已注册的节点
  • 加载和卸载节点区块
  • 报告节点当前是否处于加载状态以及临时加载剩余的时间

配方:

Wake Controller recipe

创造模式标签页:Functional Blocks

工作原理

  1. 在 CC: Tweaked 计算机的面上放置一个 Wake Node。
  2. 在该计算机上,对 wake_node 外围设备调用 setId("some_name") 以注册该节点。
    执行此注册的计算机将成为该节点的所有者。
  3. 使用 grantController(computerId) 授权控制器计算机。
  4. 在另一台计算机旁放置一个 Wake Controller。
  5. 从已授权的控制器计算机上,调用 loadNode("some_name") 或 loadFor("some_name", seconds)。

被加载的区块是计算机所在的区块,而不是 Wake Node 方块所在的区块。

每个节点都有一个所有者计算机和一个授权控制器计算机 ID 的访问控制列表 (ACL)。
控制器方法仅对调用计算机有权管理的节点进行操作。

节点注册信息会被保存,但强制加载的活跃区块不会保留。服务器重启后,节点仍存在于注册表中,但在再次请求之前,它们都不会保持加载状态。

ComputerCraft API

外围设备类型

  • Wake Node 外围设备类型:wake_node
  • Advanced Wake Node 外围设备类型:wake_node_advanced
  • Wake Controller 外围设备类型:wake_controller

Wake Node API

使用标准的 ComputerCraft 调用查找外围设备,例如:

local wake = peripheral.find("wake_node")

有关更紧凑的 API 文档版本,请参阅 GitHub 上的 API.md 文件。

setId(id)

在给定的字符串 ID 下注册此 Wake Node。

  • id 必须是非空字符串
  • 首次成功注册时,调用计算机将成为节点所有者
  • 如果同一节点上已注册相同的 ID,则接受调用
  • 如果该 ID 已被另一个节点使用,则调用会引发错误

示例:

local wake = peripheral.find("wake_node")
assert(wake, "wake_node not found")

wake.setId("remote_factory")

grantController(computerId)

授权控制器计算机 ID 管理此节点。

  • 只有所有者计算机可以调用此方法
  • computerId 必须是正整数
  • 幂等:重复授予相同的 ID 会被接受

revokeController(computerId)

从此节点的允许列表中移除控制器计算机 ID。

  • 只有所有者计算机可以调用此方法
  • 幂等:撤销不存在的 ID 会被接受

listControllers()

返回排序后的授权控制器计算机 ID 列表。

getPermissions()

返回此节点的所有权和控制器 ACL:

{
  owner = 17,
  controllers = { 42, 73 }
}

getId()

返回当前节点 ID,如果尚未分配则返回 nil。

示例:

print(wake.getId())

getChunk()

返回一个描述附加计算机所在区块的表格:

{
  dimension = "minecraft:overworld",
  chunk_x = 12,
  chunk_z = -4
}

getInfo()

返回包含节点 ID 和区块信息的表格:

{
  id = "remote_factory",
  dimension = "minecraft:overworld",
  chunk_x = 12,
  chunk_z = -4
}

如果尚未分配 ID,则 id 字段将返回空字符串。

Advanced Wake Node API

Advanced Wake Node 暴露了 wake_node_advanced 外设类型。它继承了基础 Wake Node 的所有方法,并增加了以下内容:

local wake = peripheral.find("wake_node_advanced")

setRange(size)

设置计算机周围的加载区域大小。

  • size 必须为 1、3 或 5
  • 只有节点所有者可以调用此方法
  • 如果节点当前处于加载状态,设置的区块会实时更新(除非在配置中禁用)
  • 如果范围超过服务器最大值或调用者不是所有者,则抛出错误

示例:

wake.setRange(5) -- 加载 5×5 的区域(25 个区块)

getRange()

返回当前的范围大小(1、3 或 5)。

print(wake.getRange()) -- 3

listAvailableRanges()

根据服务器配置返回允许的范围值数组。

local ranges = wake.listAvailableRanges()
-- { 1, 3, 5 }

getInfo() (重写)

返回与基础 getInfo() 相同的表格,并额外增加两个字段:

{
  id = "remote_factory",
  dimension = "minecraft:overworld",
  chunk_x = 12,
  chunk_z = -4,
  range = 3,
  loaded_chunks = 9
}

Wake Controller API

使用标准的 ComputerCraft 调用查找外设,例如:

local ctl = peripheral.find("wake_controller")

listNodes()

返回调用控制器计算机可访问的已注册节点 ID 列表。

示例:

for _, id in ipairs(ctl.listNodes()) do
  print(id)
end

getNodeInfo(id)

返回可访问节点的节点信息。

如果节点不存在或调用控制器未获授权,则抛出错误。

返回的表格:

{
  id = "remote_factory",
  dimension = "minecraft:overworld",
  chunk_x = 12,
  chunk_z = -4,
  loaded = false,
  expires_at = 90
}

注意:

  • loaded 是布尔值
  • expires_at 仅存在于临时加载的情况
  • expires_at 报告的是剩余秒数,而非绝对时间戳

loadNode(id)

无限期强制加载该节点的区块,直到发生以下情况之一:

  • 调用了 unloadNode(id)
  • 调用了 unloadAll()
  • 服务器停止

如果节点不存在,则抛出错误。

如果调用控制器未获得该节点的授权,也会抛出错误。

loadFor(id, seconds)

强制加载该节点的区块一段时间。

  • seconds 必须为正数
  • seconds 不得超过配置的 max_load_duration_seconds

如果节点不存在或持续时间无效,则抛出错误。

如果调用控制器未获得该节点的授权,也会抛出错误。

unloadNode(id)

如果给定节点当前处于加载状态,则将其卸载。

unloadAll()

卸载调用控制器可访问的所有当前加载的节点。

isNodeLoaded(id)

如果节点当前处于加载状态则返回 true,否则返回 false。

如果调用控制器未获得该节点的授权,则抛出错误。

getLoadedNodes()

返回调用控制器可访问的当前加载的节点 ID 列表。

示例设置

Remote Computer

将 Wake Node 附加到计算机并注册它:

local wake = peripheral.find("wake_node")
assert(wake, "wake_node not found")

wake.setId("remote_factory")
wake.grantController(42) -- controller computer ID
print(textutils.serialize(wake.getInfo()))

Controller Computer

远程加载区块两分钟:

local ctl = peripheral.find("wake_controller")
assert(ctl, "wake_controller not found")

print("Known nodes:")
for _, id in ipairs(ctl.listNodes()) do
  print(" - " .. id)
end

ctl.loadFor("remote_factory", 120)
print(textutils.serialize(ctl.getNodeInfo("remote_factory")))

配置

服务器配置键:

  • chunk_loading.max_loaded_nodes: 同时加载的最大节点数。默认值:16
  • chunk_loading.max_load_duration_seconds: loadFor 接受的最大持续时间。默认值:300
  • chunk_loading.default_load_radius: 目标计算机周围的区块半径。0 表示仅加载计算机所在的区块。默认值:0
  • chunk_loading.chunk_ops_per_tick: 每个服务器刻处理的最大排队加载/卸载操作数。较低的值可以平滑峰值,但 Wake Node 的响应速度会变慢。默认值:3

通用配置键:

  • logging.enable_node_logs: 启用注册、加载、卸载和过期事件的服务器日志消息。默认值:true

行为说明

  • 注册通过世界级注册表共享。
  • 每个节点都有一个所有者计算机 ID 和一个授权控制器计算机 ID 的 ACL。
  • 控制器方法仅对调用控制器被授权管理的节点进行操作。
  • 如果 Wake Node 被破坏,其注册将被移除。
  • 如果支撑计算机被移除,Wake Node 会自动损坏。
  • 临时区块加载会在服务器刻到期并自动清理。
  • 服务器停止时,所有活动的区块票证都会释放。

示例脚本

仓库中包含 sampleScripts/recallCreateTrains/ 中的示例 Lua 脚本,演示了如何使用 Wake Node 唤醒远程 Create 站计算机并通过 Rednet 协调列车召回流程。

许可证

代码采用 MIT 许可证授权。

部分捆绑资产(纹理)根据 ComputerCraft 公共许可证 v1.0.0 (CCPL) 获得许可。

有关详细信息,请参阅 GitHub 上的 LICENSE 和 LICENSE-CCPL 文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源