Prompt file imported from byron123t/cobblemon (.codex/prompts/generate-location-npcs.md). Copyright stays with the author.

Generate Location NPCs

Use for a location file such as locations/vaniville-town.md.

Required Reads

• AGENTS.md
• docs/npc-generation-playbook.md
• docs/command-reference.md
• template.npc.snbt
• the requested locations/<slug>.md

Steps

1. Parse each NPC: name, UUID, location note, personality, battle id, trade/reward/quest intent.
2. Create generated/<location-slug>/.
3. Clone template.npc.snbt for each NPC and write a legibly named .npc.snbt.
4. Apply the playbook hard checks exactly: UUID/name fields, static skin UUID, static ON_INTERACTION, template formatting, command placeholder rules.
5. Build natural dialog branches with personality, opinions, and actual player choices. Remember Texts is random selection, not sequential narration. For IMPORTANT CHARACTER NPCs, use multiple independent random Texts on major stage/greeting dialogs.
6. Add trades, battles, rewards, and scoreboard hooks only where they fit the NPC brief.
7. Put limited rewards behind named reward branches. Use scoreboard flags for 1/lifetime rewards like TMs, key items, EXP Share, and quest milestones. Use EXECUTION_LIMIT with Text:"PER_DAY",Type:"EXECUTION_LIMIT",Value:1 for 1/day events like check-ins, berries, contests, movies, and lotteries. Keep claim button actions simple: give, Easy NPC SCOREBOARD set/increase only when needed for lifetime/progress state, open result dialog. Do not use /scoreboard commands inside Easy NPC action lists.
8. Write generated/<location-slug>/notes.md with uncertain item ids, reward reset behavior, scoreboard objectives, and commands to test.
9. Run powershell -ExecutionPolicy Bypass -File .\scripts\Test-ProjectText.ps1.

Output Contract

Final response should list generated files, validation result, item ids needing in-game verification, and any commands worth testing first.