Modrinth · Fabric, Forge, NeoForge, Quilt

Easy NPC on your Minecraft server

Easy NPC runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

Create easily NPCs with dialogs for your world or for your mods.

Downloads
1.3M
Author
Kaworru
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
1.18.2 – 26.3
Updated
–

Screenshots

What Easy NPC looks like

Images: Easy NPC on Modrinth, published by the project team.

Setup

Install Easy NPC on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.3.

  3. 03

    Install the mod

    Search the mod browser for “Easy NPC” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    Every player installs the same Easy NPC release locally and connects using the server address from the panel.

On the server
Required
On the client
Required
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
26.3, 26.2, 26.1.2 +19 more
License
MIT License

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

Easy NPC · Modrinth
Original description by the project author

🗣 Easy NPC (Bundle)

Daily Rewards Versions

Download on CurseForge
CurseForge Downloads

Download on Modrinth
Modrinth Downloads

Report an Issue
Open Issues
Closed Issues

Wiki
Support me on Ko-fi

Easy NPC provides a simplified system for creating custom NPCs with dialogs, trading,
and interactions for map makers, RPGs, adventure servers, modpacks, and other mods.

This project is the Easy NPC Bundle, a launcher convenience package that installs the
required Easy NPC modules automatically.

This bundle does not contain the Easy NPC modules themselves.

📦 Installation Overview

Easy NPC is split into multiple modules.
The bundle exists to simplify installation via launchers that support automatic dependency
resolution.

Option A: Launcher install (recommended)
  • Install Easy NPC Bundle
  • Your launcher will automatically install the required modules:
    • Easy NPC Core
    • Easy NPC Config UI (configuration tools and required networking)
Option B: Manual install or copied modpacks

If you install mods manually or copy a modpack between instances, make sure the required modules are
present:

  • Easy NPC Core
  • Easy NPC Config UI

Tip: When sharing or copying a modpack, copy the full mods/ folder to ensure all required jars are
included.

Introduction & Overview Video (English)

✨ Features

  • Easy NPCs with dialogs, trading, and interactions
  • Simple setup for map makers, servers, and RPG environments
  • Configurable actions with debug options
  • Trading support with configurable offers and conditions
  • Skin configuration with player name and URL support
  • Designed for both server and client environments
  • API support and integration for other mods

📦 Mod Integration

Armourer's Workshop

Basic integration for Armourer's Workshop to use skins from the library.

Epic Fight Mod

Built in support for Epic Fight is included since Easy NPC 6.4.x.
No additional integration mod is required.

[Immersive Melodies][immersive-melodies]

Basic integration for Immersive Melodies to use music instruments.

Usage

Spawn an NPC using the corresponding spawn egg or via the summon command.

Use the predefined /easy_npc commands or the NPC config wand to open a graphical user interface.
The GUI allows you to configure dialogs, trading options, skins, actions, and other NPC related
settings directly in game.

Most interactions and adjustments can be done directly in game without editing files or restarting
the server.

⬆️ Upgrading

Please make sure to check the upgrade guide before upgrading/updating to a new
version.

ℹ️ Why there is no jar-in-jar bundle anymore

Older versions used a jar-in-jar setup to bundle multiple Easy NPC modules into a single file.

This approach caused several technical issues:

  • Duplicate mod IDs when modules were installed separately
  • Class loading conflicts and ambiguous mod sources
  • Incompatibilities when only the Easy NPC Core was required as a dependency
  • Increased maintenance and support complexity

Modern launchers already provide dependency resolution.
Using this mechanism results in a cleaner, more predictable setup and allows Easy NPC modules to be
updated independently.

ℹ️ More Information

Please check the wiki for additional information.

🐛 Report Issues, Bugs, Crashes or Feature Requests

Please report issues and feature requests over the issues link. I'm happy to help you.

🫶 Support me

If you enjoy using my creations, consider supporting my development! ☕️
Donations via Ko-fi are immensely helpful,
but not required (my mods are free and open-source!).
Every bit helps me keep creating mods in my free time, covering software, services, hardware costs
and some extra slice of pizza or additional Spezi.

⚖️ License

The MIT LICENSE applies only to the code in this repository.
Images, models and other assets are explicitly excluded.

FAQ

Easy NPC questions

Question not listed? Ask our team.

Easy NPC server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does Easy NPC run on?

According to Modrinth, Easy NPC supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.3, 26.2, 26.1.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.

How much RAM does a server with Easy NPC need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with Easy NPC?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server