Getting Started

Getting started

Install the matching build

Use Java 21 and Minecraft 1.21.1 NeoForge. The documentation baseline was built with NeoForge 21.1.262, TaCZ 1.1.8-hotfix-r7, Player Animator 2.0.1+1.21.1 and Aviel's Dialogue Mod (ADM) 0.8.5. These are the tested dependency versions, not a claim that every newer version is compatible.

First custom NPC

Merge this entry into config/tacznpc_loadouts.json:

{
  "guard": {
    "faction": "settlers",
    "relations": {
      "settlers": 50,
      "monster": -100
      },
    "names": ["Morgan", "Robin"],
    "primary": "%tacz:ak47",
    "helmet": "minecraft:iron_helmet"
  }
}

The complete object above is a minimal standalone file. On an existing installation, add its guard property alongside the other loadouts instead of replacing them.

Run:

/tacznpcs_reload
/summon tacznpcs:npc ~ ~ ~ {template:"guard"}
/tacznpcs_quest status @e[type=tacznpcs:npc,sort=nearest,limit=1]

The AK-47 GunId must exist in the installed gunpack. The summon command is an administrator test; creating a loadout does not itself add a natural spawn rule.

Make it useful

• Give guard some interests, so it collects and sells supplies.
• Use structure replacement to introduce the loadout into world generation.
• Use reputation to set the player's relationship.
• Give the NPC cargo with inventory commands to test its shop.
• Set faction reputation to 50 to test recruitment; the standard initial reputation is 0.

Editing rules

Use JSON with double quotes, no comments and no trailing commas. IDs and field names are case-sensitive. Use fully qualified registry IDs such as minecraft:bread.

Most time values use ticks: 20 ticks is one second at 20 TPS. Distances use blocks. A probability of 0.25 means 25%; a selection weight of 25 is a relative weight, not 25%.

The included examples form a small complete demonstration using guard. They are not a replacement for an existing modpack's configuration. Merge the fields you need, reload, then inspect both the command response and server log.

---

Home · Configuration map · Troubleshooting