Test Guide - MarkusBordihn/BOs-Easy-NPC GitHub Wiki

Easy NPC Test Guide ๐Ÿงช

This guide helps you test the main Easy NPC features in a structured way. It is written for testers, pack authors, and developers who want a reliable checklist.

Step 1: Spawn a Test NPC

Spawn NPC

  1. Launch a clean test world.
  2. Switch to Creative Mode.
  3. Spawn at least one standard NPC, usually a Humanoid NPC.
  4. If you test integrations, also spawn the relevant integration NPCs such as a Cobblemon NPC.

Step 2: Open the NPC Editor

Easy NPC Wand

  1. Take the Easy NPC wand.
  2. Right-click the NPC while sneaking.
  3. Confirm that the main configuration screen opens.

Configuration screen

Step 3: Check Basic Persistence

For each category:

  1. Change a value
  2. Save if needed
  3. Reopen the screen
  4. Reload the world if useful
  5. Confirm the value still matches

Step 4: Appearance Tests ๐ŸŽจ

Check at least:

Important checks:

  • player skins render correctly
  • custom skins reload correctly
  • player heads render correctly in the head slot
  • equipment visibility toggles behave correctly
  • model changes do not break equipment, names, or hitbox feel

Step 5: Interaction Tests ๐Ÿ’ฌ

Check at least:

Important checks:

  • default dialog opens correctly
  • yes/no and advanced dialog buttons trigger the expected actions
  • On Interaction, distance, dialog, and On Trade actions work
  • per-offer trade actions only trigger for the intended trade
  • remaining trade uses are shown correctly
  • reset button and timed trade reset work

Step 6: Presets and Commands ๐Ÿงฐ

Check:

Important checks:

  • preset import/export still works
  • .npc.snbt presets load correctly
  • blocked features are removed or reduced when server rules require it
  • debug commands use the correct names:
    • /easy_npc debug core true
    • /easy_npc debug npc <NPC>
    • /easy_npc debug config true
  • if a name, skin, or scale change looks wrong on a server, compare the NPC state before and after the change with /easy_npc debug npc <NPC>

Step 7: Resource Pack and Texture Checks ๐Ÿ–ผ๏ธ

If you test client customization, verify that overrides work for:

Important checks:

  • resource pack overrides load without modifying the mod jar
  • small, medium, and large dialog scenes all use the correct replacement texture

Step 8: Integration Checks ๐Ÿ”Œ

If the relevant mods are installed, test:

Important checks:

  • Cobblemon NPC species selection updates correctly
  • Epic Fight compatibility still works for supported NPCs
  • action-based integrations open the correct third-party screens

Recommended Final Checklist

Reporting

When you find a bug, include:

  • exact version and loader
  • steps to reproduce
  • the affected NPC type
  • related preset or command if relevant
  • latest.log or debug.log if useful
โš ๏ธ **GitHub.com Fallback** โš ๏ธ