NPC Shops

Create immersive merchant NPCs using Citizens integration!

---

Overview

NPC Shops allow you to create interactive villager or custom NPCs that act as shop keepers. Players can interact with NPCs to open shop menus, creating an immersive trading experience.

---

Requirements

NPC Shops require the Citizens plugin:

• Download Citizens

---

Creating NPC Shops

Method 1: Using the NPC Create Command

/ishop npc create

This opens an interactive setup menu:

Method 2: Link Existing NPC

1. Select an existing Citizens NPC:

/npc select

2. Link it to a shop:

/ishop npc link <shopName>

Method 3: Create with Parameters

/ishop npc create VILLAGER tools "Tool Merchant"

Parameters:

• Entity Type (VILLAGER, PLAYER, etc.)
• Shop name (from your shops folder)
• Display name

---

NPC Configuration

Basic NPC Settings

# In config.yml

npc:
  # Enable teleport to NPC on click
  teleport: true
  
  # Click actions
  clicks:
    RIGHT: OPEN_SHOP
    LEFT: INFO
    SHIFT_RIGHT: TELEPORT  # Admin only

Per-NPC Configuration

Each NPC can have custom settings:

/ishop npc settings

Opens the NPC settings GUI:

---

Entity Types

InfiniteShops supports all Citizens entity types:

Setting Entity Type

/ishop npc type WANDERING_TRADER

Or use the settings GUI.

---

NPC Holograms

Display information above NPCs:

npc:
  hologram:
    enabled: true
    height: 2.5
    lines:
      - '&6&l%npc_name%'
      - '&7Click to open shop'
      - '&e%shop_name%'

---

NPC Interactions

Click Actions

Configure what happens on different clicks:

npc:
  clicks:
    RIGHT: OPEN_SHOP      # Open linked shop
    LEFT: INFO            # Show NPC info
    SHIFT_RIGHT: TELEPORT # Teleport (admin)
    SHIFT_LEFT: DELETE    # Delete NPC (admin)

Available Actions

---

NPC List Management

View All NPCs

/ishop npc list

Opens a GUI showing all NPC shops:

Teleport to NPC

From the list, click an NPC to teleport to it (with permission).

Remove NPC

/ishop npc remove <id>

Or left-click in the NPC list (admin only).

---

Advanced Configuration

Merchant Trades (Villager-style)

Create villager-like trading interfaces:

# In npc config
merchant:
  enabled: true
  trades:
    - input:
        material: EMERALD
        amount: 10
      output:
        material: DIAMOND
        amount: 1
    - input:
        material: WHEAT
        amount: 20
      output:
        material: EMERALD
        amount: 1

NPC Animations

Configure NPC behaviors:

npc:
  animations:
    look_at_player: true
    idle_animation: true
    particle_effect: HAPPY_VILLAGER

---

Commands Reference

---

Permissions

---

Troubleshooting

NPC Not Opening Shop

1. Verify shop file exists
2. Check NPC is linked: /ishop npc info
3. Verify player has shop permissions
4. Check Citizens is properly installed

Invalid Entity Type

Ensure the entity type is valid for Citizens. Check Citizens documentation for supported types.

NPC Not Spawning

1. Check spawn location is valid
2. Verify chunk is loaded
3. Check Citizens spawn settings

---

Tips

1. Use player NPCs for custom skins
2. Position NPCs in logical market areas
3. Add holograms for clear identification
4. Use different entity types for different shop categories
5. Test permissions to ensure players can interact