Default Presets - MarkusBordihn/BOs-Easy-NPC GitHub Wiki
Easy NPC ships with ready-made NPCs. They are the fastest way to see how a feature is meant to be used: import one, open its configuration, and copy the parts you need.
If you are unsure how conditions, trade actions, or custom poses are set up, start here instead of building from scratch.
In the game: open the preset browser (/easy_npc preset_browser) or the Default Import screen
in an NPC's preset configuration, then pick a preset from the list.
With a command:
/easy_npc preset import_new default <preset>Use tab completion for <preset> — it lists every available default preset. import_new always
creates a new NPC with a new UUID, which is what you want for trying things out.
Importing default presets requires the DEFAULT_PRESET_IMPORT feature (default: creative player),
see Permissions.
| Preset | NPC Type | Shows |
|---|---|---|
| Stone or Dirt Supplier | Humanoid Slim | Yes/no dialog that gives the player an item on request |
| Professor Quiz | Humanoid | Multiple-choice quiz with sounds and firework effects |
| Dialog Colors and Styles | Humanoid | Every text color and formatting tag in one dialog |
| Dialog Sequence: Daily Limits | Illusioner | Dialog chain with execution limits that reset once a day |
| Scoreboard Example | Illusioner | Increase/decrease buttons on a scoreboard, switching dialogs at 10 |
| Threshold Warden | Humanoid | Buttons and dialogs gated by item, XP level, game mode, inventory and team |
| Skywatch Scout | Humanoid | Time-of-day and weather conditions selecting different dialogs |
| Goldmere | Piglin | A trader that only deals with players carrying a gold ingot |
| Translator | Humanoid | Translated name, dialog, and button texts, see Translations |
| Preset | NPC Type | Shows |
|---|---|---|
| Skeleton Trader | Skeleton | Distance actions plus a basic trading screen |
| Welcome Coin Trader | Villager | A daily custom coin per player, exchanged for other custom items |
| Griselda Grindstone | Witch | Trades with per-offer trade actions running commands after a buy |
Welcome Coin Trader is the reference for Consumable Items — custom named
coins, keys, and tokens with item conditions.
| Preset | NPC Type | Shows |
|---|---|---|
| Sitting Skeleton | Skeleton | A custom pose plus a dialog on interaction |
| Headless Skeleton | Skeleton | Custom pose with part visibility - head placed on the floor |
| Yoga Master | Villager | A held pose with a quote on interaction |
| Remote Skin | Humanoid Slim | A skin loaded from a URL, see Skins |
| Preset | NPC Type | Shows |
|---|---|---|
| Guard Knight with Armor and Weapon | Humanoid | Armor, a weapon, home patrol, and attacking hostile mobs |
| Grukk, the Sparring Post | Orc Warrior | 1000 HP training dummy reacting to damage taken |
| Preset | NPC Type | Shows |
|---|---|---|
| One Wish Companion | Fairy | A lifetime execution limit granting each player one reward once |
| Builder | Villager | An NPC that places a block and then activates it with a lever |
Presets carry metadata that the preset browser uses for its list and preview:
PresetMetadata:{
name:"Welcome Coin Trader",
author:"Kaworru",
category:"Villager",
description:"A daily welcome trader who gives one custom named NPC coin per player per day.",
entityTypeId:"easy_npc:villager",
variantType:"PLAINS_LIBRARIAN",
version:"1.0.0"
}
Add the same block to your own presets and they show up with a proper name and description instead of just a file name. This is worth doing for modpacks that ship a preset library.
Default presets are read-only. To build on one:
- Import it with
import_new - Change the NPC to your liking
- Export it as a custom or world preset
See Preset for the export commands and the difference between the preset sources.