turtle/libs/turtleutils.lua
2025-06-27 15:04:01 +01:00

149 lines
3.3 KiB
Lua

local M = {}
local logger = require("libs.logger")
-- Minimum fuel required to proceed with one movement
local MIN_FUEL = 1 -- you can raise this if you want a safety margin
-- 🔋 Attempt to refuel from inventory
local function refuelFromInventory(minRequired)
minRequired = minRequired or MIN_FUEL
local gained = 0
for slot = 1, 16 do
turtle.select(slot)
if turtle.getItemCount() > 0 and turtle.refuel(0) then
local before = turtle.getFuelLevel()
if turtle.refuel(1) then
local after = turtle.getFuelLevel()
local added = after - before
gained = gained + added
logger.log(string.format("Refueled +%d from slot %d", added, slot))
if after >= minRequired then break end
else
logger.log(string.format("⚠️ Refuel failed from slot %d", slot))
end
end
end
return gained
end
-- ✅ Ensure fuel before doing anything
local function refuelIfNeeded()
local fuel = turtle.getFuelLevel()
if fuel == "unlimited" then return true end
if fuel < MIN_FUEL then
logger.log("⚠️ Low fuel, attempting to refuel...")
local added = refuelFromInventory(MIN_FUEL)
fuel = turtle.getFuelLevel()
end
if fuel < MIN_FUEL then
logger.log("Not enough fuel. Waiting...")
return false
end
return true
end
-- 🚶 Retry a movement or action with fuel awareness
local function try(actionFn, times, name)
times = times or 5
for i = 1, times do
if not refuelIfNeeded() then
sleep(2)
elseif actionFn() then
if name then logger.log("Action succeeded: " .. name) end
return true
end
if name then logger.log("Retrying: " .. name) end
sleep(0.5)
end
if name then logger.log("Gave up after retries: " .. name) end
return false
end
-- Basic movement
function M.forward()
return try(turtle.forward)
end
function M.back()
return try(turtle.back)
end
function M.up()
return try(turtle.up)
end
function M.down()
return try(turtle.down)
end
-- Digging with movement
function M.digForward()
while turtle.detect() do
turtle.dig()
sleep(0.3)
end
end
function M.digUp()
while turtle.detectUp() do
turtle.digUp()
sleep(0.3)
end
end
function M.digDown()
while turtle.detectDown() do
turtle.digDown()
sleep(0.3)
end
end
-- Move forward, clearing blocks if necessary
function M.moveUntilClearForward()
while not turtle.forward() do
if turtle.detect() then
turtle.dig()
else
sleep(0.5)
end
end
end
-- Inspection
function M.inspectForward()
local success, data = turtle.inspect()
if success then return data else return nil end
end
function M.inspectUp()
local success, data = turtle.inspectUp()
if success then return data else return nil end
end
function M.inspectDown()
local success, data = turtle.inspectDown()
if success then return data else return nil end
end
-- Turning
function M.turnLeft()
turtle.turnLeft()
end
function M.turnRight()
turtle.turnRight()
end
function M.turnAround()
turtle.turnLeft()
turtle.turnLeft()
end
return M