-- AD Hitch -- Kobler redskaber på og af med AutoDrive. -- "Connect " (eller "Kobl "): markøren ligger lige under vognens trækøje med et bakkespor ned til -- den. Når en traktor har kørt AD "Kør til" dertil og står stille, kobles det redskab på, som spillet selv finder -- inden for koblingsafstand (samme kald som Courseplay bruger til skærebord: updateVehiclesInAttachRange + -- attachImplementFromInfo). -- "Afkobl " (eller "Kobl af", "Detach", "Disconnect"): ved ankomst kobles redskaberne BAG traktoren af; -- frontvægt og frontlæsser bliver siddende. -- ADHitch.fetch()/ADHitch.drop() er indgangen for flows/markarbejde: kør til markøren, kobl på/af, meld tilbage. ADHitch = {} ADHitch.LOG_PREFIX = "ADSmartPickup: kobling: " -- afkobling tjekkes først, så "Kobl af X" ikke læses som "Kobl " ADHitch.MARKER_PREFIXES = { {prefix = "afkobl", action = "detach"}, {prefix = "kobl af", action = "detach"}, {prefix = "detach", action = "detach"}, {prefix = "disconnect", action = "detach"}, {prefix = "connect", action = "attach"}, {prefix = "kobl", action = "attach"}, } ADHitch.TIMEOUT_REASON = {attach = "noAttachable", detach = "nothingToDetach"} ADHitch.ARRIVE_DISTANCE = 5 -- m fra markøren, AD standser traktoren tæt på waypointet ADHitch.STILL_SPEED = 1 -- km/t ADHitch.START_GRACE_MS = 3000 -- så længe må AD være om at komme i gang efter fetch/drop ADHitch.ACT_TIMEOUT_MS = 8000 -- så længe forsøges kobling/afkobling efter ankomst ADHitch.TICK_MS = 250 -- ---- ren logik ---- -- "Connect Bredal" -> "attach", "Bredal"; "Afkobl" -> "detach", ""; andre navne -> nil function ADHitch.parseMarker(name) if type(name) ~= "string" then return nil end local trimmed = name:match("^%s*(.-)%s*$") local lower = trimmed:lower() for _, entry in ipairs(ADHitch.MARKER_PREFIXES) do local prefix = entry.prefix if lower == prefix then return entry.action, "" end if lower:sub(1, #prefix + 1) == prefix .. " " then return entry.action, (trimmed:sub(#prefix + 2):match("^%s*(.-)$")) end end return nil end -- implements = {{z = position i traktorens rum, ...}} -> kun dem bag traktoren function ADHitch.rearImplements(implements) local rear = {} for _, implement in ipairs(implements or {}) do if implement.z ~= nil and implement.z < 0 then table.insert(rear, implement) end end return rear end -- konsol-argumenter "Connect Bredal > Start" -> "Connect Bredal", "Start" (mål nil uden ">") function ADHitch.parseTrip(...) local text = table.concat({...}, " ") local first, second = text:match("^%s*(.-)%s*>%s*(.-)%s*$") if first == nil then return (text:match("^%s*(.-)%s*$")), nil end return first, second end -- markers = {{name, id}} -> markøren med navnet (store/små bogstaver ligegyldigt) function ADHitch.findMarker(markers, name) if type(name) ~= "string" then return nil end local wanted = name:lower() for _, marker in pairs(markers or {}) do if type(marker.name) == "string" and marker.name:lower() == wanted then return marker end end return nil end -- state = {adActive, distance, speed} function ADHitch.hasArrived(state) return not state.adActive and state.distance <= ADHitch.ARRIVE_DISTANCE and state.speed <= ADHitch.STILL_SPEED end function ADHitch.newJob(markerId, markerName, action) return {markerId = markerId, markerName = markerName, action = action, state = "driving", elapsed = 0, actElapsed = 0, seenActive = false} end -- Et skridt i jobbet. succeeded = lykkedes kobling/afkobling i denne tick (kun relevant i "acting"). -- Tilstande: driving -> acting -> done | failed (reason: stoppedAway / noAttachable / nothingToDetach) function ADHitch.step(job, state, dt, succeeded) if job.state == "driving" then job.elapsed = job.elapsed + dt if state.adActive then job.seenActive = true elseif ADHitch.hasArrived(state) then job.state = "acting" elseif state.distance > ADHitch.ARRIVE_DISTANCE and (job.seenActive or job.elapsed >= ADHitch.START_GRACE_MS) then job.state, job.reason = "failed", "stoppedAway" end elseif job.state == "acting" then if succeeded then job.state = "done" else job.actElapsed = job.actElapsed + dt if job.actElapsed >= ADHitch.ACT_TIMEOUT_MS then job.state, job.reason = "failed", ADHitch.TIMEOUT_REASON[job.action] end end end return job end -- ---- spil ---- local jobs = setmetatable({}, {__mode = "k"}) -- [vehicle] = job (+ onDone) local tickTimer = 0 local function vehicleName(vehicle) if type(vehicle) ~= "table" then return tostring(vehicle) end return vehicle.getFullName ~= nil and vehicle:getFullName() or tostring(vehicle.configFileName) end local function stateModule(vehicle) return vehicle.ad ~= nil and vehicle.ad.stateModule or nil end local function vehicleState(adEnv, vehicle, markerId) local module = stateModule(vehicle) local wayPoint = adEnv.ADGraphManager:getWayPointById(markerId) local distance = math.huge if wayPoint ~= nil and vehicle.rootNode ~= nil then local x, _, z = getWorldTranslation(vehicle.rootNode) distance = math.sqrt((x - wayPoint.x) ^ 2 + (z - wayPoint.z) ^ 2) end return { adActive = module ~= nil and module:isActive(), distance = distance, speed = vehicle.getLastSpeed ~= nil and vehicle:getLastSpeed() or 0, } end -- Kobler det redskab på, som spillet finder inden for koblingsafstand. -> ok, redskab eller årsag function ADHitch.tryAttach(vehicle) local spec = vehicle.spec_attacherJoints if spec == nil or AttacherJoints == nil or AttacherJoints.updateVehiclesInAttachRange == nil then return false, "noJoints" end AttacherJoints.updateVehiclesInAttachRange(vehicle, AttacherJoints.MAX_ATTACH_DISTANCE_SQ, AttacherJoints.MAX_ATTACH_ANGLE, true) local info = spec.attachableInfo if info == nil or info.attachable == nil then return false, "noAttachable" end local attacher = info.attacherVehicle or vehicle local farmId = vehicle.getActiveFarm ~= nil and vehicle:getActiveFarm() or vehicle:getOwnerFarmId() local allowed, warning = info.attachable:isAttachAllowed(farmId, attacher) if not allowed then return false, tostring(warning or "notAllowed") end attacher:attachImplementFromInfo(info) return true, info.attachable end -- Redskaber koblet direkte på traktoren, med deres placering langs traktoren (z > 0 foran, z < 0 bagved). local function attachedImplements(vehicle) local list = {} if vehicle.getAttachedImplements == nil then return list end for _, implement in ipairs(vehicle:getAttachedImplements()) do local jointDesc = vehicle.spec_attacherJoints.attacherJoints[implement.jointDescIndex] local node = jointDesc ~= nil and (jointDesc.jointTransform or jointDesc.rootNode) or nil if implement.object ~= nil and node ~= nil then local _, _, z = localToLocal(node, vehicle.rootNode, 0, 0, 0) table.insert(list, {object = implement.object, z = z, name = vehicleName(implement.object)}) end end return list end -- Kobler redskaberne bag traktoren af. -> ok, navne eller årsag function ADHitch.tryDetach(vehicle) local rear = ADHitch.rearImplements(attachedImplements(vehicle)) if #rear == 0 then return false, "nothingToDetach" end local names = {} for _, implement in ipairs(rear) do local object = implement.object local allowed, warning = true, nil if object.isDetachAllowed ~= nil then allowed, warning = object:isDetachAllowed() end if not allowed then return false, tostring(warning or "detachNotAllowed") end vehicle:detachImplementByObject(object) table.insert(names, implement.name) end return true, table.concat(names, ", ") end local function start(adEnv, vehicle, markerId, action, onDone) local marker = adEnv.ADGraphManager:getMapMarkerByWayPointId(markerId) local job = ADHitch.newJob(markerId, marker ~= nil and marker.name or tostring(markerId), action) job.onDone = onDone jobs[vehicle] = job ADFieldWork.startAd(adEnv, vehicle, adEnv.AutoDrive.MODE_DRIVETO, markerId) Logging.info(ADHitch.LOG_PREFIX .. "'%s' kører til '%s'", vehicleName(vehicle), job.markerName) return job end -- Kør til en Connect-markør og kobl på. onDone(vehicle, ok, redskab eller årsag) kaldes én gang. function ADHitch.fetch(adEnv, vehicle, markerId, onDone) return start(adEnv, vehicle, markerId, "attach", onDone) end -- Kør til en Afkobl-markør og kobl af. onDone(vehicle, ok, navne eller årsag) kaldes én gang. function ADHitch.drop(adEnv, vehicle, markerId, onDone) return start(adEnv, vehicle, markerId, "detach", onDone) end -- "Hent vogn og kør til": kør til Connect-markøren, kobl på, kør så med AD til målet. function ADHitch.trip(adEnv, vehicle, connectId, destinationId, onDone) return ADHitch.fetch(adEnv, vehicle, connectId, function(tractor, ok, detail) if not ok then if onDone ~= nil then onDone(tractor, false, detail) end return end local destination = adEnv.ADGraphManager:getMapMarkerByWayPointId(destinationId) ADFieldWork.startAd(adEnv, tractor, adEnv.AutoDrive.MODE_DRIVETO, destinationId) Logging.info(ADHitch.LOG_PREFIX .. "'%s' kører med '%s' til '%s'", vehicleName(tractor), vehicleName(detail), destination ~= nil and destination.name or tostring(destinationId)) if onDone ~= nil then onDone(tractor, true, detail) end end) end -- Spilleren sender selv en traktor til en Connect-/Afkobl-markør med AD "Kør til": den kobles også. local function watchManualTrips(adEnv) for _, vehicle in ipairs(ADRunsController.getFarmVehicles(adEnv)) do local module = stateModule(vehicle) if jobs[vehicle] == nil and vehicle.spec_attacherJoints ~= nil and module ~= nil and module:isActive() and module:getMode() == adEnv.AutoDrive.MODE_DRIVETO then local marker = module:getFirstMarker() local action = marker ~= nil and ADHitch.parseMarker(marker.name) or nil if action ~= nil then jobs[vehicle] = ADHitch.newJob(marker.id, marker.name, action) end end end end local DONE_TEXT = {attach = "koblede '%s' på", detach = "koblede '%s' af"} local FAIL_TEXT = {attach = "kunne ikke koble på", detach = "kunne ikke koble af"} local function finish(vehicle, job, ok, detail) jobs[vehicle] = nil if ok then Logging.info(ADHitch.LOG_PREFIX .. "'%s' " .. DONE_TEXT[job.action] .. " ved '%s'", vehicleName(vehicle), vehicleName(detail), job.markerName) else Logging.warning(ADHitch.LOG_PREFIX .. "'%s' %s ved '%s': %s", vehicleName(vehicle), FAIL_TEXT[job.action], job.markerName, tostring(detail)) end if job.onDone ~= nil then pcall(job.onDone, vehicle, ok, detail) end end local ACTIONS = {attach = ADHitch.tryAttach, detach = ADHitch.tryDetach} function ADHitch.tick(adEnv, dt) if adEnv == nil or adEnv.ADGraphManager == nil then return end tickTimer = tickTimer + dt if tickTimer < ADHitch.TICK_MS then return end local elapsed = tickTimer tickTimer = 0 watchManualTrips(adEnv) for vehicle, job in pairs(jobs) do local succeeded, detail = false, nil if job.state == "acting" then succeeded, detail = ACTIONS[job.action](vehicle) if not succeeded then job.lastReason = detail end end ADHitch.step(job, vehicleState(adEnv, vehicle, job.markerId), elapsed, succeeded) if job.state == "done" then finish(vehicle, job, true, detail) elseif job.state == "failed" then finish(vehicle, job, false, job.lastReason or job.reason) end end end -- Konsol: "spuConnect" / "spuDetach" på den maskine spilleren sidder i. local function currentVehicle() return g_localPlayer ~= nil and g_localPlayer.getCurrentVehicle ~= nil and g_localPlayer:getCurrentVehicle() or nil end function ADHitch:consoleConnect() local vehicle = currentVehicle() if vehicle == nil then return "spuConnect: sæt dig i en traktor først" end local ok, detail = ADHitch.tryAttach(vehicle) if ok then return "spuConnect: koblede " .. vehicleName(detail) .. " på" end return "spuConnect: intet koblet på (" .. tostring(detail) .. ")" end function ADHitch:consoleDetach() local vehicle = currentVehicle() if vehicle == nil then return "spuDetach: sæt dig i en traktor først" end local ok, detail = ADHitch.tryDetach(vehicle) if ok then return "spuDetach: koblede " .. tostring(detail) .. " af" end return "spuDetach: intet koblet af (" .. tostring(detail) .. ")" end -- "spuTrip Connect Bredal > Start": maskinen spilleren sidder i henter vognen og kører til målet (spilleren -- kan blive siddende; AD kører også med spilleren i førerhuset). function ADHitch:consoleTrip(...) local vehicle = currentVehicle() if vehicle == nil then return "spuTrip: sæt dig i en traktor først" end local adEnv = ADFieldSilos ~= nil and ADFieldSilos.adEnv or nil if adEnv == nil then return "spuTrip: AutoDrive er ikke klar endnu" end local connectName, destinationName = ADHitch.parseTrip(...) local markers = adEnv.ADGraphManager:getMapMarkers() local connect, destination = ADHitch.findMarker(markers, connectName), ADHitch.findMarker(markers, destinationName) if connect == nil or ADHitch.parseMarker(connect.name) ~= "attach" then return "spuTrip: ukendt Connect-markør '" .. tostring(connectName) .. "'" end if destination == nil then return "spuTrip: ukendt mål '" .. tostring(destinationName) .. "' (brug: spuTrip Connect Bredal > Start)" end ADHitch.trip(adEnv, vehicle, connect.id, destination.id) return "spuTrip: " .. vehicleName(vehicle) .. " henter ved '" .. connect.name .. "' og kører til '" .. destination.name .. "'" end if addConsoleCommand ~= nil then addConsoleCommand("spuConnect", "Kobler nærmeste redskab på den maskine du sidder i", "consoleConnect", ADHitch) addConsoleCommand("spuTrip", "Hent vogn og kør: spuTrip Connect Bredal > Start", "consoleTrip", ADHitch) addConsoleCommand("spuDetach", "Kobler redskaberne bag den maskine du sidder i af", "consoleDetach", ADHitch) end