[OPEN SOURCE] Brazilian Government script auto farm

--[[
    NPC INTERACT FARMER — Velocity Executor
    Fluxo: rota até a FRENTE do NPC -> 5x E -> cooldown individual de 30s naquele NPC
    - Monitor de velocidade: < 20 studs/s por 2s entra em recuperação
    - Recuperação: SPACE a cada 0.1s em ciclos de 2s + recálculo de rota em loop
    - Recuperação ignora validação de waypoint e timeout
    - Waypoint sempre termina em MoveTo / cooldown por NPC / loop infinito
--]]

--==================== CONFIG ====================--
local CONFIG = {
    CONTAINER        = "PopulacaoNPC",
    MAX_INDEX        = 45,
    USE_PHYSICS      = true,
    INFINITE         = true,
    SPEED            = 55,
    FRONT_DISTANCE   = 5,
    FRONT_DIST_MIN   = 1.8,
    ARRIVE_EPS       = 0.2,
    PHYS_EPS         = 2.5,
    WAYPOINT_EPS     = 2.5,
    APPROACH_TIMEOUT = 25,
    -- monitor de velocidade / recuperação
    MIN_SPEED        = 20,
    LOW_SPEED_TIME   = 2,
    SPEED_SAMPLE     = 0.2,
    SPACE_INTERVAL   = 0.1,    -- intervalo do spam de SPACE
    SPACE_HOLD       = 0.03,   -- tempo com a tecla pressionada
    RECOVERY_CYCLE   = 2,      -- duração de cada janela de spam
    RECOVERY_PAUSE   = 0.3,    -- pausa entre janelas
    RECOVERY_REPATH  = 1.0,    -- intervalo de recálculo durante recuperação
    -- validação de waypoint
    MIN_NORMAL_Y     = 0.70,
    MAX_GROUND_DELTA = 6,
    PROBE_UP         = 3,
    PROBE_DOWN       = 12,
    PROBE_SIDE       = 0.7,
    WAYPOINT_TIMEOUT = 1.5,
    STUCK_WINDOW     = 0.4,
    STUCK_MIN_MOVE   = 0.6,