Offline Actions

Offline activity and the time wallet

File: tacznpc_offline_actions.json.

Offline means time away from normal entity updates while the world clock advances. It does not mean earning progress while the server process is shut down. Credit is resolved when the NPC can receive updates again; this system does not keep every NPC ticking remotely.

Global key	Default	Bounds
ticksPerPoint	1200	World ticks per point; 1–1728000
maxActionsPerTick	16	Shared attempts budget; 1–128
nearbyNpcLimit	8	Population limit for meetAllies; 1–64
populationRadius	32	Population-check area; 8–64

Action profile

Global settings live under offlineActions, with enabled=true. Overrides live under loadouts.ID.offlineActions.

Action	Default cost	Default weight	Result
placeCampfire	2	1	Attempt safe campfire creation; requires canCreate
rest	1	1	Heal a wounded NPC to its maximum health
meetAllies	5	1	Attempt to introduce a mutually allied loadout nearby
loot	2	1	Roll the current biome's pools, then filter interests
share	1	1	Transfer cargo to an eligible nearby ally
move	1	1	Attempt experimental travel if enabled

Every action has enabled, cost (integer 1–1000000) and weight (integer 1–1000). Weight is a relative choice probability among eligible affordable actions, not a percent. Use enabled=false instead of weight=0.

{
    "offlineActions": {
        "meetAllies": {
            "enabled":false
        }
    },
    "loadouts": {
        "guard": {
            "offlineActions": {
                "loot": {
                    "weight":3
                },
                "rest": {
                    "cost":2
                }
            }
        }
    }
}

Cost normally means cost × ticksPerPoint wallet ticks. Travel pays its distance-based cost at arrival instead. Processing permits one eligible attempt per NPC per second under the shared per-tick budget; failed mutations have bounded retries. A valid loot roll can still cost credit when nothing useful was retained.

Combat, alert, fire, NoAI and conversation can block processing. Bound companions pause offline action execution and keep their saved credits. Meeting allies requires mutual alliance and respects population checks; it is not an unlimited faction spawner.

Sharing requires both NPCs to permit shareItems, be mutually allied, loaded, nearby and eligible, with line of sight. Offline sharing chooses an action rather than using the active social shareChance/cooldown roll. It transfers cargo, not worn equipment, and does not delete items to force room in the recipient.

Use /tacznpcs_offline status <selector> to inspect wallet ticks and last action. /tacznpcs_offline add 10 grants credit to all existing NPCs, including unloaded ones when they return; it is not a targeted command.

Offline actions and biome loot reload together. The legacy loot.table selector is ignored; loot source belongs to the current biome, never the loadout.

---

Home · Configuration map · Troubleshooting