---
title: How to Configure Pixelmon NPCs, Shops, and Move Tutors
description: "NPCs help bring a Pixelmon world to life, whether they're teaching moves or running shops. This guide explains every setting in npcs.yml, including Move Tutors, shopkeeper inventories, NPC behavior, and the options that control these interactive systems on your Pixelmon server."
source: "https://nodecraft.com/support/games/minecraft/mods/pixelmon/how-to-configure-pixelmon-npcs-shops-and-move-tutors"
image: "https://dynamic-assets.nodecraft.com/signedurl/w7vokBAexMnVlnMZ1Q/image.jpg?modifications=W3sibmFtZSI6ImdhbWVfYmciLCJpbWFnZV91cmwiOiJodHRwczovL2Ntcy1hLm5vZGVjcmFmdC5jb20vZi8xMzM5MzIvMjAwMHg1NTAvZGNiMGFkNjkzOC9jYXZlcy1hbmQtY2xpZmZzLXB0LTItMS0yLTAucG5nL20vIn0seyJuYW1lIjoiZ2FtZV9sb2dvIiwiaW1hZ2VfdXJsIjoiaHR0cHM6Ly9jbXMtYS5ub2RlY3JhZnQuY29tL2YvMTMzOTMyLzM3NXgxNTAvM2MxZGIyYmFiNS9taW5lY3JhZnQucG5nL20vIn0seyJuYW1lIjoiY3RhX3RleHQiLCJ0ZXh0IjoiQ3JlYXRlIHlvdXIgb3duIHNlcnZlciEifSx7Im5hbWUiOiJ0ZXh0IiwidGV4dCI6IkhvdyB0byBDb25maWd1cmUgUGl4ZWxtb24gTlBDcywgU2hvcHMsIGFuZCBNb3ZlIFR1dG9ycyJ9XQ&s=8b890acdb15e999a634d31ab3e8f378ab2094b2d8064b67d97ecb59b1698f779"
published: "2026-08-16T23:26:05.602Z"
updated: "2026-08-16T23:26:05.602Z"
---

# How to Configure Pixelmon NPCs, Shops, and Move Tutors

NPCs help bring a Pixelmon world to life, whether they're teaching moves or running shops. This guide explains every setting in npcs.yml, including Move Tutors, shopkeeper inventories, NPC behavior, and the options that control these interactive systems on your Pixelmon server.

The NPC, Shop, and Move Tutor section contains the options Pixelmon uses for this part of the server. Configure Move Tutors, shopkeeper inventory rules, NPC behavior, and related shop systems.

## Pixelmon NPC, Shop, and Move Tutor Settings

The settings below are listed in the same order as they appear in npcs.yml. The table preserves each default and identifies the accepted value type. The Setting column shows a reader-friendly name first, followed by the matching npcs.yml key for reference.

| Setting and Config Key | Default and Accepted Values | Description |
| --- | --- | --- |
| **Traders Reusable** traders-reusable | **Default:** false **Values:** true or false | Whether or not traders can be used multiple times. If disabled, traders will disappear after completing their trade offers. |
| **Moves Per Tutor** moves-per-tutor | **Default:** 20 **Values:** whole number | The amount of moves a Move Tutor will have. |
| **Limit Shop Keeper Stack Size** limit-shop-keeper-stack-size | **Default:** true **Values:** true or false | If set to False, this will be based on the remaining inventory of the player. |

## Important NPC, Shop, and Move Tutor Setting Notes

### Defaults and Value Types

Boolean toggles, numeric rates, timers, lists, and mappings use different value formats. Preserve the value type shown in the table and keep collection syntax intact when changing npcs.yml.

### Settings That Work Together

Several npc, shop, and move tutor options can affect the same outcome. Review related rates, limits, timers, and lists together before deciding that one value is responsible for a result.

### Testing Changes

- Change one related group of settings at a time so its effect is easy to measure.
- Test the result under the conditions affected by the setting, including relevant dimensions, player states, or encounter types.
- Keep a copy of the previous values so unexpected balance or performance changes can be reversed quickly.

## Final Thoughts

NPC, Shop, and Move Tutor settings are easier to balance when changes are deliberate and documented. Start with the defaults, adjust only what the server needs, and verify the result before moving on to the next group.