Minecraft plugin NPC

🔌 About NPC

NPC is a Minecraft plugin for Spigot servers that allows administrators to create simple, persistent NPCs. Each NPC can clone a player's skin or use an entity-based skin, is saved to disk so it persists across server restarts, and displays a configurable message when a player interacts with it.

🎯 Purpose

The plugin provides a lightweight way to place decorative or interactive NPCs in a server world for staff markers, lobby selectors, static shopkeepers, or other simple interactions where full-featured NPC frameworks are not required.

⚙️ Features

• Create NPCs that clone the creating player's skin by default.
• Option to specify an entity or skin name to change an NPC's appearance.
• NPCs persist across server restarts by saving locations and skin data to a data.yml file.
• Each NPC can display a custom message when clicked.
• Basic create and delete commands for in-game administration.
• Plugin stores data under a plugin folder (NpcMain) and creates data.yml on first run.
• Author-provided versions target specific Minecraft/Spigot releases (separate jar per supported server version).

🧩 Who It Is For

This plugin is aimed at small to medium Spigot server administrators who need simple, persistent NPCs without the complexity of larger NPC frameworks. It is suitable for lobby or survival servers that require static NPCs for messaging or cosmetic presence.

🏗️ Example Use Cases

• Place an NPC at spawn that shows server rules when clicked.
• Create a cosmetic statue that matches a staff member's skin.
• Use NPCs as named, clickable selectors in a lobby to open menus (via the NPC message or by combining with other plugins).

⌨️ Commands

(The above commands are documented in the plugin's official resources.)

⚙️ Installation

📥 Setup

• Download the plugin jar appropriate for your Spigot server version.
• Place the jar into the server plugins/ directory.
• Start or restart the server.
• On first load the plugin will create a plugin folder (NpcMain) and a data.yml file to store NPC entries.

📦 Dependencies

• No required dependencies are documented by the author.

🧾 Configuration

• NPC data (positions, names, skin signatures, messages) is stored in data.yml inside the plugin folder.
• Editing data.yml allows renaming or changing the message for an NPC; a server restart is required to load manual changes.

🧠 Technical Notes

• The author publishes separate builds for specific Spigot/Minecraft versions; the current repository build targets Spigot 1.18.2 and the project notes that versions are not backwards compatible across major server releases.
• The project repository is licensed under the MIT license.
• The plugin includes usage metrics (bStats) as indicated by the repository and resource metadata.

🤝 When This Plugin Is Useful

If you need simple, persistent NPCs that display messages or serve as cosmetic/staff markers without adopting a larger NPC framework, this plugin provides a small, version-targeted solution for Spigot servers.