# MiguelEconomy X EasyNPC<\/p>\n
**Turn your EasyNPC characters into real shopkeepers \u2014 powered by MiguelEconomy.**<\/p>\n
This mod is an addon that bridges two popular mods: **EasyNPC** (which lets you place and customize NPC characters) and **MiguelEconomy** (which adds an in-game currency system). Together they let players walk up to an NPC, open a shop, and buy or sell items using coins \u2014 no command blocks, no complicated setup.<\/p>\n
—<\/p>\n
## What This Mod Does<\/p>\n
– **NPC Shops** \u2014 Assign a shop to any EasyNPC character. Players can open it by right-clicking the NPC.
\n– **Buy & Sell** \u2014 Each item in a shop can be set to allow buying, selling, or both, each at its own price.
\n– **Progression System** \u2014 Players earn ranks as they play (based on money earned and job levels). Higher ranks unlock access to better shops and exclusive items.
\n– **Shop Builder** \u2014 Server operators can build and edit shops directly in-game through a visual menu, without touching any files.
\n– **JSON Config** \u2014 All shops and NPC assignments are stored in easy-to-read JSON files in the server’s config folder, so advanced users can edit them directly if they prefer.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Mod | Required? |
\n|—–|———–|
\n| Minecraft Forge 1.20.1 | Yes |
\n| MiguelEconomy | Yes (handles the currency) |
\n| EasyNPC | Yes (provides the NPCs) |<\/p>\n
—<\/p>\n
## How to Use<\/p>\n
### For Players<\/p>\n
1. **Walk up to an NPC** that has a shop assigned and **right-click** it.
\n2. A shop window opens. Browse the items listed.
\n3. Click **Buy** to purchase an item (coins are deducted from your balance) or **Sell** to turn items in your inventory into coins.
\n4. Some items or shops are locked behind a **rank**. Open the **Progression screen** (available from the shop screen) to see your current rank and what you need to reach the next one.<\/p>\n
### For Server Operators \u2014 Setting Up a Shop<\/p>\n
**Option A: In-Game Shop Builder**
\n1. Use the `\/shop create` command (requires operator permission).
\n2. The Shop Builder menu opens. Add items, set buy\/sell prices, and save.
\n3. Once saved, open the NPC binding config file and link the shop ID to the NPC’s name or UUID.<\/p>\n
**Option B: JSON Files**
\n1. Start the server once \u2014 it will create the config folder at:
\n “`
\n config\/migueleconomy_easynpc\/npc_shops\/
\n “`
\n2. Each `.json` file in that folder represents one NPC’s shop. You can copy and edit `example_npc.json` as a starting point.
\n3. Restart the server, or run `\/shop reload`, to apply changes.<\/p>\n
**Example NPC shop file:**
\n“`json
\n{
\n “shops”: [
\n {
\n “id”: “basic_goods”,
\n “title”: “Basic Goods”,
\n “description”: “Everyday supplies.”,
\n “requiredTier”: “survivor”,
\n “entries”: [
\n {
\n “id”: “bread”,
\n “item”: { “itemId”: “minecraft:bread”, “count”: 1 },
\n “buyEnabled”: true,
\n “sellEnabled”: false,
\n “buyPrice”: 10,
\n “sellPrice”: 0,
\n “description”: “A loaf of bread.”
\n }
\n ]
\n }
\n ],
\n “npcBindings”: [
\n {
\n “npcName”: “Merchant”,
\n “shopIds”: [“basic_goods”]
\n }
\n ]
\n}
\n“`<\/p>\n
> **Tip:** You can match an NPC by **name** (`npcName`) or by their exact **UUID** (`npcUuid`). Using UUID is more reliable if multiple NPCs share the same name.<\/p>\n
### Progression Tiers<\/p>\n
Players start at the **Survivor** rank. As they earn money and level up jobs through MiguelEconomy, they automatically advance through ranks. Each rank can unlock:<\/p>\n
– Access to entire shops
\n– Individual items within a shop<\/p>\n
The tier list and requirements are configured in:
\n“`
\nconfig\/migueleconomy_easynpc\/progression.json
\n“`<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Permission | What it does | `\/shop create`, `\/shop builder`, `\/shop reload`, `\/shop debug`, and the `\/he` admin commands require operator permission level 2.<\/p>\n —<\/p>\n ## Config Folder Layout<\/p>\n “` This mod is an addon that bridges two popular mods: EasyNPC (which lets you place and customize NPC characters) and MiguelEconomy<\/p>\n","protected":false},"featured_media":101118,"template":"","meta":{"_minecraft_slug":"migueleconomy-x-easynpc","_minecraft_project_id":"1nSZMgso","_minecraft_author":"Monsieur-V","_minecraft_license":"MIT","_minecraft_downloads":23,"_minecraft_follows":0,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"migueleconomy-x-easynpc.zip","_minecraft_size_bytes":129143,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T14:42:29.725260Z","_minecraft_date_created":"2026-04-30T15:24:23.465594Z","_minecraft_date_modified":"2026-04-26T05:07:48.012810Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/migueleconomy-x-easynpc","_minecraft_icon_attachment_id":101118,"_minecraft_imported_at":"2026-06-05T19:28:23+00:00","_minecraft_import_hash":"76220a10ae98886ac4bf0fa15a0eb3d6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,104,89,126,867],"mod_loader":[106],"minecraft_version":[36],"class_list":["post-101117","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-social","mod_loader-forge","minecraft_version-1-20-1"],"yoast_head":"\n
\n|———|———–|————–|
\n| `\/level` | Player | Opens your progression screen so you can see your current tier and unlock path |
\n| `\/shop create` | Operator | Opens the in-game Shop Builder with a blank draft for a new shop |
\n| `\/shop builder` | Operator | Opens the in-game Shop Builder |
\n| `\/shop builder open` | Operator | Same as `\/shop builder`; kept as a readable alias |
\n| `\/shop reload` | Operator | Reloads shop, NPC binding, progression, and economy config without restarting |
\n| `\/shop debug` | Operator | Shows shop\/debug counts, detected EasyNPC entities, mapped NPCs, and economy adapter status |
\n| `\/he shopbuilder` | Operator | Legacy alias for opening the Shop Builder |
\n| `\/he reloadshops` | Operator | Legacy alias for `\/shop reload` |
\n| `\/he debugshop` | Operator | Legacy alias for `\/shop debug` |
\n| `\/he settier
\nconfig\/
\n\u2514\u2500\u2500 migueleconomy_easynpc\/
\n \u251c\u2500\u2500 progression.json \u2190 tier definitions and unlock requirements
\n \u2514\u2500\u2500 npc_shops\/
\n \u251c\u2500\u2500 example_npc.json \u2190 auto-generated sample, safe to delete
\n \u2514\u2500\u2500 your_npc.json \u2190 one file per NPC (or group of NPCs)
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"