Travel

Experimental offline travel

File: tacznpc_travel.json. This feature is disabled by default and uses the existing time wallet and autonomous quest.

Key	Default	Bounds / meaning
enabled	false	Enable departure/arrival processing
blocksPerPoint	32	>0–4096; distance purchasing rate
playerExclusionRadius	64	32–256 blocks
intervalTicks	20	1–1200
recordsPerPass	4	1–64; queue work budget
sitesPerRecord	8	1–64; destination samples
arrivalCooldownTicks	1200	20–1728000

An eligible NPC with an active quest can leave outside player observation. Its complete serialized state is stored in the world's travel ledger; it does not remain as an invisible ticking entity.

Processing samples already loaded locations around players. It checks quest biome/structure/POI rules, exclusions, safe ground, observation and arrival space. No forced chunk tickets or global locate are used. A valid destination can take time to be sampled; low budgets trade throughput for lower work per pass.

Travel cost in wallet ticks:

max(1, ceil(horizontalStraightLineDistance / blocksPerPoint × move.cost × ticksPerPoint)).

With the defaults, 320 blocks costs 12000 wallet ticks. Time progresses with the world clock, not real-world downtime. Arrival charges the journey, checks quest completion and preserves identity, cargo and progression.

Combat, alert, fire, conversation, mounts/passengers, leash, cooldown and companion ownership can prevent departure. Disabling travel pauses travelers; it does not automatically materialize them. Recall requests can still return a traveler when its origin is loaded, safe and outside observation.

Commands: /tacznpcs_travel list, status <uuid>, recall <uuid>. Status is a ledger snapshot, which can be older than a currently resident entity's latest state.

The ledger can be the authoritative current copy of an absent NPC. Preserve it with the world. Test travel and any migration in a copy before using it for an established population; deleting ledger data can lose NPC state. This is a specific storage limitation, not a requirement to disable the other NPC systems.

---

Home · Configuration map · Troubleshooting