CreateAddition项目中的Computercraft外设API详解

项目概述

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()：获取应力输出容量

实用技巧：

• 使用rotate和translate方法时，返回的时间值可以配合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. 使用getDurationDistance和getDurationAngle预先计算运动时间，实现更精确的时序控制

总结

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