Computer Craft

CC:Tweaked permite ler sensores, criar telas e automações, consultar a rede aviônica, gerenciar waypoints FMS e reagir aos alertas do Avionics Computer (GPWS) durante o jogo. Todos os exemplos de código e APIs dos peripherals para jogadores estão reunidos aqui.

Conectar um computador

Instale CC:Tweaked 1.120.0 ou mais recente. Coloque um computador ou modem cabeado encostado no bloco que deseja consultar, ou conecte-o pela rede de modems cabeados do CC:Tweaked. Peripherals de sensores, do Avionics Computer e da mesa são independentes da rede aviônica.

Encontre um dispositivo pelo tipo do peripheral:

local altimeter = assert(peripheral.find("radar_altimeter"), "Radar Altimeter não encontrado")
local reading = altimeter.getReading()
print(reading.status, reading.value, reading.unit)

peripheral.find(type) encontra um dispositivo. Se houver vários do mesmo tipo, peripheral.find(type, callback) pode selecionar pelo nome da attachment; peripheral.getNames() lista todos os peripherals conectados.

APIs dos peripherals

• Radar Altimeter
• Terrain Scanner
• Advanced Terrain Scanner
• Modular Table
• API de waypoints FMS e Navigator
• Avionics Computer
• Avionics Network Bridge

Ler snapshots e eventos

Métodos retornam o snapshot atual. Eventos permitem aguardar mudanças relevantes em vez de consultar a cada tick. Snapshots de sensores usam status, unit e gameTime; leituras válidas incluem value. Trate unavailable e failed como estados diferentes de valor numérico zero.

while true do
  local _, attachment, reading = os.pullEvent("radar_altimeter_reading_changed")
  if reading.status == "valid" and reading.value < 6 then
    print(attachment, "POUCA ALTURA", reading.value, reading.unit)
  end
end

A cobertura da varredura pode ser parcial perto de chunks descarregados. Mesmo assim, ela pode retornar contatos conhecidos; porém, uma varredura parcial vazia não comprova que o caminho está livre. Consulte os guias Terrain Scanner e Advanced Terrain Scanner para tratar essa condição.

Radar Altimeter API

O peripheral radar_altimeter retorna a distância medida abaixo do sensor. Ele funciona sem a rede aviônica.

Contrato da leitura

getReading() retorna {status, value?, unit, gameTime}. status pode ser valid, unavailable ou failed. value só existe em leituras valid, com unidade blocks. radar_altimeter_reading_changed fornece o nome da attachment e o snapshot atualizado; ocorre quando status ou valor muda, não por atualização isolada do timestamp.

local altimeter = assert(peripheral.find("radar_altimeter"), "Altímetro ausente")
local reading = altimeter.getReading()
if reading.status == "valid" then
  print(string.format("Distância do solo: %.1f %s", reading.value, reading.unit))
else
  print("Leitura está", reading.status)
end

while true do
  local _, attachment, updated = os.pullEvent("radar_altimeter_reading_changed")
  if updated.status == "valid" and updated.value < 6 then
    print(attachment, "POUCA ALTURA", updated.value)
  end
end

Como a leitura funciona

O altímetro dispara nove raios para baixo num cone com meio ângulo de 20°. Pelo menos três precisam atingir uma superfície para validar a amostra; o valor é a mediana das distâncias a partir da face inferior do sensor. Entidades e o sublevel que o contém são ignorados. O sensor não carrega chunks; menos de três retornos produz unavailable. O alcance máximo padrão é 128 blocos (radarAltimeterMaxRange); o intervalo compartilhado de varredura é de 5 ticks (sensorScanIntervalTicks).

Saída de redstone

O peripheral também oferece getOutputs(), getOutputConfiguration(), setOutputRange(channel, min, max) e setLinkFrequencies(channel, first, second). A faixa de saída converte a distância do solo na intensidade do sinal. Sem um par de frequências completo, o sinal sai pelas faces do bloco; um par completo seleciona Create Redstone Link.

getOutputs() retorna uma tabela como {altitude = 8}. getOutputConfiguration() retorna {mode, ranges, frequencies}; a faixa altitude tem {min, max}. O único nome de canal é altitude. setOutputRange("altitude", min, max) aceita distâncias inteiras com 0 <= min < max <= radarAltimeterMaxRange e retorna se a configuração foi aceita. setLinkFrequencies("altitude", first, second) aceita tabelas de frequência no formato {item = "minecraft:iron_ingot", color = 16711680}; color é opcional, RGB entre 0 e 16777215. Use {} para uma frequência vazia. Os dois slots precisam estar preenchidos para ativar saída Link.

setOutputMode("faces"|"link") continua disponível por compatibilidade e retorna false para modos desconhecidos. O roteamento é escolhido automaticamente pelos pares de frequência configurados, então esse método não substitui essa seleção. Mudanças de saída emitem sensor_outputs_changed; mudanças de configuração emitem sensor_output_configuration_changed com a tabela atualizada.

Terrain Scanner API

O peripheral terrain_scanner informa contatos com obstáculos à frente do bloco. Ele funciona sem a rede aviônica.

Ler uma varredura

getScan() retorna {status, contacts, sampledRays, totalRays, coverage, unit, gameTime}. unit é blocks. Cada contato contém rayIndex começando em 1, distance e directionX, directionY, directionZ relativos ao scanner (direita, cima, frente).

local scanner = assert(peripheral.find("terrain_scanner"), "Terrain Scanner ausente")
local function report(scan)
  print(scan.status, scan.sampledRays .. "/" .. scan.totalRays, scan.coverage)
  for _, hit in ipairs(scan.contacts) do
    print("contato", hit.distance, hit.directionX, hit.directionY, hit.directionZ)
  end
end

report(scanner.getScan())
while true do
  local _, attachment, scan = os.pullEvent("terrain_scanner_scan_changed")
  print("Atualizado:", attachment)
  report(scan)
end

Qualquer raio concluído torna a amostra valid, mesmo com cobertura parcial. Se nenhum raio for concluído, o status é unavailable; erros inesperados são failed. Uma lista vazia de contatos só indica ausência de obstáculo detectado quando a cobertura é completa. A varredura não carrega chunks, então uma fronteira descarregada pode reduzir a cobertura.

Comportamento da varredura

O Terrain Scanner Basic usa nove raios com abertura total fixa de 90°. Ele segue sua orientação horizontal, inclusive quando instalado de ponta-cabeça, e ignora entidades e o sublevel que o contém. terrainScannerMaxRange tem alcance padrão de 128 blocos; o intervalo compartilhado de varredura é de 5 ticks.

Lado da aeronave

Os dois scanners informam qual lado da aeronave vigiam, e o Avionics Computer usa isso como papel do scanner. getAircraftSide() retorna unset, front, rear, left ou right. setAircraftSide(side) aceita qualquer um desses valores e retorna se foi aplicado.

Saída de redstone

O peripheral oferece getOutputs(), getOutputConfiguration(), setOutputRange(channel, min, max) e setLinkFrequencies(channel, first, second). O sinal aumenta quando um contato se aproxima. Um par de frequências completo seleciona Create Redstone Link; sem ele, o sinal sai pelas faces.

O limite inferior configurado produz intensidade 15 nessa distância ou abaixo. O limite superior produz 0 nessa distância ou acima; valores intermediários são escalados dentro da faixa. Sem contato utilizável, a saída é 0.

getOutputs() retorna a intensidade do canal front, como {front = 12}. getOutputConfiguration() retorna {mode, ranges, frequencies}. setOutputRange("front", min, max) aceita distâncias inteiras dentro do alcance máximo configurado do sensor, com min < max, e retorna booleano. setLinkFrequencies("front", first, second) aceita tabelas {item = "minecraft:iron_ingot", color = 16711680}; color RGB é opcional e varia de 0 a 16777215. Use {} para limpar um slot de frequência; ambos precisam estar preenchidos para selecionar modo Link.

setOutputMode("faces"|"link") é mantido por compatibilidade; valida o modo, mas o roteamento automático continua dependendo de pares de frequência completos. Mudanças emitem sensor_outputs_changed e sensor_output_configuration_changed com os snapshots atualizados.

Para o scanner Advanced, consulte sua API.

Advanced Terrain Scanner API

O peripheral terrain_scanner_advanced informa contatos por canais independentes front, left e right. Ele funciona sem a rede aviônica.

Ler uma varredura

getScan() retorna {status, contacts, sampledRays, totalRays, coverage, unit, gameTime}. unit é blocks. Cada contato contém rayIndex começando em 1, distance e directionX, directionY, directionZ relativos ao scanner (direita, cima, frente).

local scanner = assert(peripheral.find("terrain_scanner_advanced"), "Advanced Terrain Scanner ausente")
local scan = scanner.getScan()
print(scan.status, scan.sampledRays .. "/" .. scan.totalRays, scan.coverage)
for _, hit in ipairs(scan.contacts) do
  print("contato", hit.distance, hit.directionX, hit.directionY, hit.directionZ)
end

Qualquer raio concluído torna a amostra valid, mesmo com cobertura parcial. Se nenhum raio for concluído, o status é unavailable; erros inesperados são failed. Uma lista vazia só significa que nenhum obstáculo foi detectado quando a cobertura é completa. A varredura não carrega chunks, então terreno descarregado pode reduzir a cobertura.

Configurar a abertura

O Advanced Scanner distribui aproximadamente 9–81 raios por uma abertura de 30° a 180°, com 90° como padrão. getConfiguration() retorna {openingAngle}. setOpeningAngle(degrees) só retorna true quando aplica um valor novo válido; caso contrário, retorna false. O evento terrain_scanner_configuration_changed informa o nome da attachment e a configuração atualizada.

O scanner segue sua orientação horizontal, inclusive quando instalado de ponta-cabeça, e ignora entidades e o sublevel que o contém. terrainScannerMaxRange tem alcance padrão de 128 blocos; o intervalo compartilhado de varredura é de 5 ticks.

Saídas de redstone

getOutputs() retorna intensidades de front, left e right, como {front = 12, left = 0, right = 0}. getOutputConfiguration() retorna {mode, ranges, frequencies}. O sinal aumenta quando um contato se aproxima. O limite inferior configurado produz intensidade 15 nessa distância ou abaixo; o superior produz 0 nessa distância ou acima. Valores intermediários são escalados dentro da faixa; sem contato utilizável, a saída é 0.

setOutputRange(channel, min, max) aceita front, left ou right, distâncias inteiras dentro do alcance máximo configurado do sensor e min < max; retorna booleano. setLinkFrequencies(channel, first, second) aceita tabelas de frequência como {item = "minecraft:iron_ingot", color = 16711680}. color RGB é opcional e varia de 0 a 16777215. Use {} para limpar um slot.

Um par de frequências completo seleciona a saída Create Redstone Link. O modo Link é global: configure um par completo para cada canal que deve transmitir. Caso contrário, o sinal sai pelas faces do bloco. setOutputMode("faces"|"link") continua por compatibilidade e valida o valor, mas o roteamento depende dos pares de frequência. Mudanças emitem sensor_outputs_changed e sensor_output_configuration_changed com snapshots atualizados.

Modular Table API

O peripheral modular_table consulta e configura os módulos instalados na mesa 3×3. As coordenadas do grid Lua começam em 1. A instalação e remoção continuam sendo ações físicas no jogo; Lua não cria módulos físicos.

Consultar e configurar o painel

Consulte o grid com getGridSize(), getModules() e getSlot(column, row). canFit(column, row, width, height) verifica se um footprint cabe, sem instalar nada. Coordenadas fora da faixa geram erro Lua; um footprint válido que ultrapasse a borda retorna false.

getGridSize() retorna {columns = 3, rows = 3}. getSlot() retorna {occupied = false, column = ..., row = ...} ou a descrição de um módulo ocupado com type, column, row, width, height, channel, threshold, source, alertChannel, minimumSeverity e buzzerVolume. getOutputs() retorna descrições dos módulos com active, signal e severity atual. getPanelStatus() informa networkStatus, gpwsAvailable, muted, installedModules e activeModules.

Escolha o que uma lâmpada ou buzzer indica com setIndication(column, row, indication): warning, caution, inop ou function:<canal> nas lâmpadas, e caution ou warning nos buzzers. getIndications(moduleType) lista as indicações oferecidas para lamp ou buzzer. A forma antiga configureAlertModule(column, row, source, channel, minimumSeverity) continua funcionando. source é gpws ou test; severidade é advisory, caution ou warning. applyBasicSetup() volta lâmpadas e buzzers instalados para a indicação padrão, Atenção GPWS. Sinais de teste locais usam configureModule(...) e setTestSignal(channel, value); o módulo ativa quando o valor alcança o threshold numérico. Esses sinais não são leituras de sensores da rede.

local panel = assert(peripheral.find("modular_table"), "Mesa ausente")
print(textutils.serialize(panel.getGridSize()))
print(textutils.serialize(panel.getModules()))
panel.applyBasicSetup()
print(textutils.serialize(panel.getOutputs()))

while true do
  local _, attachment, action, module = os.pullEvent("modular_table_changed")
  print(attachment, action, module.type, module.column, module.row)
end

Outros métodos: getAvailableChannels(), getPanelStatus(), setBuzzerVolume(column, row, percent), testPanel(), setMuted(muted), setLampTestIntensity(column, row, level) e clearLampTestIntensity(column, row). Volume aceita de 0 a 100. Intensidade de teste é uma sobreposição visual temporária e não projeta luz dinâmica no mundo.

applyBasicSetup() retorna a quantidade de módulos de lâmpada/buzzer configurados. getAvailableChannels() lista gpws.any, gpws.terrain, gpws.pull_up, gpws.sink_rate, gpws.dont_sink, gpws.too_low, gpws.bank_angle e gpws.sensor_fail. O método legado configureModule(column, row, channel, threshold) configura uma lâmpada instalada para sinais de teste locais. setTestSignal(channel, value) atualiza esse sinal local. configureAlertModule(...), setBuzzerVolume(...) e os métodos de teste da lâmpada retornam booleanos; coordenadas inválidas ou módulos não compatíveis geram erro Lua.

Eventos: modular_table_changed(attachment, action, module), modular_table_signal_changed(attachment, channel, value), modular_table_alert_outputs_changed(attachment, panelStatus, outputs) e modular_table_panel_state_changed(attachment, state, value). Eles indicam mudanças confirmadas pelo servidor. Consulte controles de waypoint do FMS e Avionics Computer.

Consultar a rede aviônica

getNetworkSignals() lê snapshots tipados dos canais publicados pelos dispositivos na rede aviônica conectada e completa. Se a travessia for incompleta, um resultado vazio não prova que não há endpoints.

FMS and Navigator API

O FMS é um módulo virtual 2×3 instalado na Modular Table. Ele guarda waypoints nomeados com dimensão e coordenadas inteiras de bloco. As coordenadas do grid Lua da mesa começam em 1. Valores fracionários enviados pela API são arredondados para baixo, inclusive coordenadas negativas.

Gerenciar waypoints por Lua

O peripheral da mesa oferece getFmsWaypoints(column, row), createWaypoint(column, row, name, x, y, z), updateWaypoint(column, row, id, name, x, y, z), deleteWaypoint(column, row, id), selectWaypoint(column, row, id) e clearWaypointSelection(column, row). Métodos de CRUD e seleção retornam true quando aceitam a mudança e false quando não aceitam; UUID malformado ou coordenadas fora do limite geram erro Lua. Cada waypoint retornado tem {id, name, dimension, x, y, z, selected}. createWaypoint retorna booleano, não o ID novo; use getFmsWaypoints para obter o UUID.

local panel = assert(peripheral.find("modular_table"), "Mesa ausente")
local column, row = 1, 1 -- célula inicial do módulo FMS instalado
for _, waypoint in ipairs(panel.getFmsWaypoints(column, row)) do
  print(waypoint.id, waypoint.name, waypoint.x, waypoint.y, waypoint.z,
    waypoint.selected and "ATIVO" or "")
end

-- createWaypoint retorna true/false; consulte a lista para obter o UUID novo.
if panel.createWaypoint(column, row, "Home", 0, 64, 0) then
  local waypoints = panel.getFmsWaypoints(column, row)
  local home = waypoints[#waypoints]
  if home then panel.selectWaypoint(column, row, home.id) end
end

Nomes aceitam de 1 a 32 caracteres. Waypoints novos usam a dimensão atual; editar preserva a dimensão original. Os dados e o destino selecionado ficam armazenados no item fms_module quando o módulo é removido.

getFmsSignals(column, row) retorna leituras indexadas por waypoint_selected e distance_to_waypoint. Cada leitura tem status, unit e gameTime, além de value quando válida. waypoint_selected é uma leitura booleana VALID. distance_to_waypoint é a distância horizontal X/Z em blocos e fica UNAVAILABLE sem destino ou quando ele está em outra dimensão. modular_table_fms_waypoint_changed(attachment, action, column, row, waypoint) informa edições; a tabela waypoint fica vazia quando o evento remove um waypoint. modular_table_fms_signal_changed(attachment, column, row, channel, reading) informa mudanças dos canais. getNetworkSignals() também lê snapshots tipados; módulos virtuais incluem module_column e module_row para identificar a posição.

Vincular o item Navigator

O item fms_navigator é a Bússola FMS. Clique em Vincular bússola na tela do FMS para vincular a primeira do inventário àquele módulo exato; o item não é consumido. Uma bússola vinculada a outro FMS mostra Vincular a este FMS, e o clique confirma a troca. Insira o item vinculado numa Navigation Table do Aeronautics para seguir o waypoint selecionado: alcance ilimitado na mesma nave, 256 blocos fora dela. O FMS precisa estar carregado e o waypoint na mesma dimensão; a busca não carrega chunks. A coordenada Y não afeta a direção da bússola. Canais FMS não criam alertas GPWS.

Avionics Computer API

O peripheral avionics_computer expõe o Avionics Computer: o estado do GPWS, os sensores encontrados na rede e os papéis deles. Ele nunca faz raycasts nem carrega chunks. Programas escritos para o antigo peripheral gpws precisam trocar para avionics_computer; perfis, modos, fase manual e regras por canal deixaram de existir.

Consultar estado, sensores e alertas

Método	Retorno ou efeito
getStatus()	state (normal, caution, warning, inop, test), alert (canal), testing, sensitivity, flightPhase, rede (networkStatus, networkComplete, endpointCount), sensorCount, e clearance, verticalSpeed e bankAngle com status, unidade e tempo
getSensors()	Lista de {type, role, x, y, z, status, unit, value?, issue?}, coordenadas relativas ao computador
getAlerts()	Tabela por canal com state (inactive, active, unavailable, inhibited), severity, gameTime e reason quando INOP
getConfiguration()	{sensitivity, inhibited}
test()	Roda o autoteste; false se já há um em andamento
setSensitivity(value)	low, normal ou high
setInhibited(function, inhibited)	Desliga ou reativa uma função; sensor_fail não pode ser inibido

local avionics = assert(peripheral.find("avionics_computer"), "Avionics Computer não encontrado")

for _, sensor in ipairs(avionics.getSensors()) do
  print(sensor.role, sensor.status, sensor.value or "-")
end

while true do
  local event, attachment, data = os.pullEvent()
  if event == "avionics_status_changed" then
    print(attachment, "estado:", data.state, data.alert)
  end
end

Os eventos trazem o nome da attachment e um snapshot: avionics_alert_changed (canais que mudaram de estado ou severidade), avionics_sensors_changed (a lista de sensores, quando muda um papel, a saúde ou o conjunto de sensores; leituras sozinhas não disparam), avionics_status_changed e avionics_configuration_changed.

Canais

Os canais são terrain, pull_up, sink_rate, dont_sink, too_low, bank_angle e sensor_fail. A severidade vai de 0 a 3 (nenhuma, advisory, caution, warning). Na rede, o computador publica gpws.<canal> e gpws.any, a maior severidade, que as lâmpadas da Modular Table leem. Os envelopes de alerta estão no guia do Avionics Computer.

Avionics Network Bridge API

A Avionics Network Bridge (no jogo em português, Ponte da Rede de Aviônicos) é um bloco Experimental disponível só no criativo. Ela entra na rede aviônica por um Conector de Fio e mostra o desenho da rede a um computador como o peripheral avionics_network_bridge. Ela expõe só a topologia: para leituras de sensores com papéis e alertas do GPWS, use o Avionics Computer; cada sensor também mantém o próprio peripheral.

Método	Retorna
getNetworkStatus()	{status, connected, complete, endpointCount, wireCount}
getConnectedDevices()	Uma lista de {type, x, y, z}, com coordenadas relativas à ponte

status é disconnected, connected, incomplete ou limit_exceeded; complete é falso nos dois últimos. Numa rede incompleta as contagens são limites inferiores e getConnectedDevices() retorna uma lista vazia, para que um resultado parcial nunca pareça a rede inteira. O evento avionics_network_changed(attachment, status) dispara quando a rede muda, com a mesma tabela de getNetworkStatus().

local bridge = assert(peripheral.find("avionics_network_bridge"), "Network Bridge não encontrada")
local network = bridge.getNetworkStatus()
print(network.status, network.endpointCount, network.wireCount)

for _, device in ipairs(bridge.getConnectedDevices()) do
  print(device.type, device.x, device.y, device.z)
end