首页
/ CreateAddition项目中的Computercraft外设API详解

CreateAddition项目中的Computercraft外设API详解

2025-05-31 23:24:48作者:吴年前Myrtle

项目概述

CreateAddition是一个为Create模组提供扩展功能的项目,其中Computercraft外设API是该项目的核心功能之一。通过这个API,玩家可以使用Lua脚本与Create模组中的各种机械装置进行交互,实现自动化控制和数据监控。

核心功能模块

1. 电动马达控制

电动马达是Create模组中的基础动力源,通过API可以实现精确控制:

local motor = peripheral.wrap("left")

主要功能方法:

  • setSpeed(rpm):设置马达转速(-256到256 RPM)
  • stop():停止马达(等同于setSpeed(0))
  • rotate(degrees, [rpm]):按指定角度旋转轴
  • translate(blocks, [rpm]):控制活塞或吊杆移动指定距离
  • getSpeed():获取当前转速
  • getStressCapacity():获取应力输出容量

实用技巧:

  • 使用rotatetranslate方法时,返回的时间值可以配合sleep实现精确时序控制
  • 马达转速变化不宜过快,API会限制调用频率

2. 能量存储系统

模块化蓄电池

local accumulator = peripheral.wrap("left")

关键功能:

  • getEnergy():获取当前存储能量
  • getCapacity():获取总容量
  • getPercent():获取电量百分比
  • getHeight()/getWidth():获取蓄电池物理尺寸

便携式能量接口(PEI)

local pei = peripheral.wrap("left")

特殊功能:

  • isConnected():检查是否连接到机械装置
  • 当未连接时,能量相关方法返回-1

3. 红石继电器

local relay = peripheral.wrap("left")

核心功能:

  • getThroughput():实时获取能量传输速率
  • isPowered():获取红石信号状态

4. 数字适配器(多功能接口)

数字适配器是与多种Create设备交互的桥梁:

local da = peripheral.wrap("left")

4.1 旋转速度控制器

  • setTargetSpeed(side, speed):设置目标转速
  • getTargetSpeed(side):获取目标转速

4.2 应力与速度监测

  • getKineticStress(side):获取机械应力
  • getKineticSpeed(side):获取实际转速

4.3 绳索/活塞控制

  • getPulleyDistance(side):获取绳索延伸长度
  • getPistonDistance(side):获取活塞延伸距离

4.4 电梯控制

local floorCount = da.getElevatorFloors("south")
da.gotoElevatorFloor("south", 2) -- 前往第三层
  • 完整的楼层管理功能,包括楼层名称获取

4.5 显示链接

da.print("第一行文本")
da.setLine(2)
da.print("第二行文本")
  • 16行文本显示能力
  • 支持文本缓冲和行控制

高级应用示例

自动化活塞控制

local motor = peripheral.wrap("back")
local da = peripheral.wrap("left")

-- 设置马达转速
motor.setSpeed(64)

-- 延伸活塞5格
sleep(motor.translate(5, 64))

-- 检查实际延伸距离
local extended = da.getPistonDistance("north")
print("活塞已延伸:"..extended.."格")

-- 等待2秒后收回
sleep(2)
sleep(motor.translate(-5, 64))
motor.stop()

电梯控制系统

local da = peripheral.wrap("right")

function gotoFloor(floorIndex)
    local current = da.getElevatorFloor("up")
    if current == floorIndex then return end
    
    local delta = da.gotoElevatorFloor("up", floorIndex)
    print("正在前往:"..da.getElevatorFloorName("up", floorIndex))
    sleep(math.abs(delta) * 0.5) -- 假设每格0.5秒
end

-- 使用示例
gotoFloor(3) -- 前往第四层

性能优化建议

  1. 避免高频调用马达速度设置方法,这可能导致异常
  2. 对于需要频繁读取的数据(如应力值),考虑缓存而非实时读取
  3. 使用getDurationDistancegetDurationAngle预先计算运动时间,实现更精确的时序控制

总结

CreateAddition的Computercraft API为Create模组提供了强大的程序化控制能力。通过合理组合各种外设功能,玩家可以构建复杂的自动化机械系统,从简单的马达控制到完整的电梯管理系统都能实现。掌握这些API将极大扩展Create模组的可玩性和自动化潜力。

登录后查看全文
热门项目推荐