Data Driven Villagers

Create new villager professions and change existing ones, including textures, workstations, day plans, behaviours and village buildings, from simple JSON files or directly in the in-game editor GUI, no coding required.

No Java, no fork, no resource pack. One file per profession.

Versions: 1.20.1, 1.21.1, 1.21.8

Loader: Fabric, NeoForge (1.21.1, 1.21.8), Forge (1.20.1)

Support my work on

Requirements

• On Fabric you need Fabric API. On Forge and NeoForge you do not.
• For trades, install VillagersTradingPlus.
  Without it your professions work, but they have nothing to sell.

What you can do with it

• New professions bound to a block of your choice, from vanilla or from other mods.
• Your own look: a profession texture, a zombie-villager texture and the hat setting. You need
  no resource pack. On a server, the images go to every player automatically.
• Change vanilla professions with overrides. For example, put the farmer on the night shift
  in four lines.
• Day plans: "schedule": "night" or your own switch-over times for work, idle, meet and rest.
• Behaviour:
  • farm work: harvest, replant and use bone meal like the farmer.
  • flees_from: extra mobs to run from.
  • attacks: guards that fight zombies and skeletons.
  • health: more health for the profession.
  • villages: keep a job in desert or snowy villages only.
• Village buildings: your own .nbt house appears in generated villages. Or give only a
  workstation, and the mod builds a stall in each village style: oak, sandstone, acacia or spruce.
• Custom villager types, tied to biomes, with their own clothing.
• Hero of the Village gifts from your own loot table.
• In-game editor: /ddv edit opens a GUI with every field. Save writes the file and reloads it.
• Live reload: /ddv reload applies textures, hats, gifts, workstations, behaviour and day
  plans without a restart. New day plans reach villagers that already stand in the world.

Quick start

1. Start the game once. The mod writes an example into config/datadrivenvillagers/professions/.
2. Edit example_baker.json (or open /ddv edit), then restart.
3. Get a structure block with /give @s minecraft:structure_block and place it next to an unemployed
   villager. The villager becomes a baker. The example uses a structure block so it takes no block
   away from a normal world.

{
  "workstation": "minecraft:structure_block",
  "display_name": "Baker",
  "texture": "example_baker.png",
  "hat": "none",
  "work_sound": "minecraft:entity.villager.work_farmer",
  "gatherable_items": ["minecraft:wheat", "minecraft:bread"],
  "secondary_job_sites": ["minecraft:cake"]
}

The file name is the id: baker.json becomes datadrivenvillagers:baker. Put baker.png next to
the json and the texture loads at runtime.

Why a config folder and not a datapack? Professions and job sites are registries that Minecraft
freezes before any datapack loads. Everything that can be a datapack still is one: trades, gifts,
tags and translations.

On a server, every player needs the mod and the same profession files, because the game
refuses a client that does not know a registered profession. /ddv export <name> packs one
profession into a zip that you can give to your players.

Commands

list, errors, why, blocks and help need permission level 2. edit, reload, scaffold,
export and doctor write files and need level 3. In a singleplayer or LAN world, only the host can
use them.

Trades

Trades come from VillagersTradingPlus.
Put a trade file into a datapack at data/<namespace>/default_villager_trades/baker.json with
"profession": "datadrivenvillagers:baker". Or press Create default trades in /ddv edit, and
the mod writes a starting file into the world’s datapacks for you. The full trade format is on the
VillagersTradingPlus page.

Good to know

• Minecraft allows one job site per block. The thirteen vanilla workstation blocks, such as the
  composter and the lectern, are taken. /ddv blocks shows what is still free.
• On Fabric, blocks from mods that register after DataDrivenVillagers are skipped with a warning.
  Vanilla blocks are always available.
• Blocks that world generation places in bulk (stone, dirt, sand, logs, leaves, ores and a few more)
  are refused as workstations, because every natural one would become a job site. Set
  "allow_natural_block": true to use one anyway. Air, fluids and blocks without collision are never
  allowed.
• If a file has an error, the mod does not load it and does not crash. /ddv errors and /ddv why
  tell you what is wrong.

More mods by LithiumPlus

• VillagersPlus: new villager
  types, trades and new workstations. Forge version:
  VillagersPlus (Forge).
• VillagersTradingPlus:
  add, replace or delete the trades of any villager, change the currency and gate trades behind
  conditions, all from a datapack.
• Nyctophobia: dark, foggy biomes
  for the Overworld. Forge version:
  Nyctophobia (Forge).
• The Graveyard (Fabric)
  and The Graveyard (Forge/NeoForge):
  structures, mobs, bosses and blocks with a graveyard theme.