Files
Coalgov/coalgov-wiki-pages/npcs.txt
2026-05-06 02:34:52 +00:00

74 lines
1.9 KiB
Plaintext

====== NPC Supply Chains ======
CoalGov NPCs use Citizens and are managed with:
/cgnpc
===== Farm-To-Market Example =====
Select a polygon around the farm with ''/claim wand'', then create an NPC zone:
/cgnpc zone create farm
Create workers and a trader in that zone:
/cgnpc create worker Farmer farm
/cgnpc create worker Baker farm
/cgnpc create trader Marketman farm
The default supply chain is:
* Farmer scans the farm zone for mature WHEAT, CARROTS, POTATOES, and BEETROOTS.
* Farmer walks to mature crops, harvests drops into NPC inventory, and replants if it has the seed or crop item.
* Baker pulls WHEAT from same-zone NPC inventories.
* Baker consumes 3 WHEAT to produce 2 BREAD.
* Workers keep a reserve and move surplus output to same-zone traders.
* Players can haggle with traders for stocked goods.
Example player trade:
/cgnpc list
/cgnpc haggle <traderId> buy BREAD 8 8
===== Configuration =====
Worker roles are matched by NPC name under ''npc.worker.roles''. For example, an NPC named ''Farmer Joe'' uses the ''farmer'' role.
npc:
worker:
tick_interval_seconds: 20
roles:
farmer:
behavior: FARM
output_material: WHEAT
output_amount: 4
crops:
- WHEAT
- CARROTS
- POTATOES
- BEETROOTS
replant: true
baker:
behavior: CRAFT
output_material: BREAD
output_amount: 2
inputs:
WHEAT: 3
farm:
action_distance: 3.0
max_scan_blocks: 512
supply_chain:
max_transfer_per_tick: 64
source_reserve: 16
worker_output_reserve: 16
traders_accept_outputs: true
trader_restock_target: 256
Admins can seed inventories with:
/cgnpc stock <id> <material> <amount>
and fund trader purchases with:
/cgnpc funds <id> <amount>