Quests

Autonomous NPC quests

These are the NPC's own location objectives. They are distinct from a player's supply delivery.

Files: tacznpc_quests.json (settings/progression) and tacznpc_quests/*.json (definitions).

Master field	Default	Bounds
enabled	true	Enable autonomous quest processing
checkIntervalTicks	100	20–12000
assignmentRetryTicks	200	20–72000
progression	Built-in progression	Levels
loadouts.ID.minSpawnLevel	0, except military=2	0–1000000

If the definition directory does not exist, example quests are installed. An existing empty directory intentionally supplies an empty catalogue. A quest's ID is its filename without .json; allowed characters are lowercase letters, digits, dot, underscore and hyphen. At most 1024 definitions.

Example: find a biome

{
  "enabled":true,
  "weight":1,
  "xp":25,
  "loadouts":["guard"],
  "dimensions":["minecraft:overworld"],
  "acceptance": {
    "requireOutsideObjective":true
  },
  "objective": {
    "type":"biome",
    "targets":["minecraft:plains"],
    "minTravelDistance":32
  },
  "dialogues": {
    "default": {
      "activity":["Looking for open country."],
      "news":["The plains might be safer."]
    }
  }
}

Save as tacznpc_quests/find_plains.json.

Definition key	Default	Meaning
enabled	true	Include in assignment/validation
weight	1	Relative assignment weight; 1–1000000
xp	25	Completion reward; 0–1000000
loadouts	[]	Allowed loadouts; empty means unrestricted
excludedLoadouts	[]	Excluded loadouts
dimensions	[]	Allowed dimension IDs; empty means unrestricted
acceptance	Empty rules	Conditions at acceptance
objective	Required	Location goal
dialogues	Empty	Default/loadout activity and news

Location fields

objective.type is biome, structure or poi. targets must be a nonempty array of corresponding registry IDs. poiRadius defaults to 8 (1–32), and minTravelDistance defaults to 32 (0–1000000).

Both acceptance and objective support excludedBiomes, excludedStructures, excludedPoiTypes. Acceptance additionally supports requireOutsideObjective (true). If false, minimum travel distance must be at least 1, preventing instant zero-distance farming.

Enabled definitions validate referenced registries. Disabled examples may refer to optional content. Removing/disabling a quest does not justify granting its old reward again.

Quest dialogue uses dialogues.default.activity/news and dialogues.loadouts.ID.activity/news; strings or arrays, up to 64 lines of 4096 characters per topic.

Use quest commands to assign, inspect and check. Assignment still obeys eligibility. A quest does not itself force chunks to load or perform a global locate. Travel optionally resolves distant movement through known loaded sites. Followers pause autonomous quest progress until dismissed.

---

Home · Configuration map · Troubleshooting