✨ Features & Showcase

Experience the next level of NPC management. ModelEngineNPC combines the power of ModelEngine's animations with intuitive management tools.

🌟 Key Features

• ModelEngine 4 Support: Seamlessly integrate any ModelEngine model.
• Intuitive GUI Editor: Manage everything from a visual menu—no complex commands needed.
• Rich Holograms: Add beautiful, floating text above NPCs with MiniMessage support (gradients, hex colors).
• Dynamic Interactions: Configure commands or messages on Left-Click or Right-Click.
• Smart Looking: NPCs can track players with customizable ranges.
• Optimized Performance: Built for stability on modern Paper servers.

Before installing, ensure your server meets these requirements:

📦 Installation

1. Download the latest ModelEngineNPC.jar from the releases page.
2. Place the jar file into your server's plugins/ directory.
3. Restart your server to load the plugin.
4. Verify the installation by running /menpc version in-game or checking the console.

🚀 Getting Started

Creating your first NPC is simple. Make sure you have a ModelEngine model ID ready (e.g., kindle_trone).

1. Spawn an NPC

Run the following command to spawn an NPC at your current location:

/menpc create <unique_id> <model_id>

Example: /menpc create guard kindle_trone

2. Open the Editor

Once spawned, the easiest way to customize your NPC is through the GUI Editor:

/menpc editor

🖥️ The GUI Editor

The Visual Editor is the heart of ModelEngineNPC. It allows you to configure every aspect of your NPCs without memorizing commands.

🔹 Main Menu

The main menu lists all active NPCs.

• Left-Click: Edit the specific NPC.
• Right-Click: Teleport to the NPC.
• Status Icons: Instantly see if an NPC is spawned or has issues.

🔹 NPC Settings

Inside an NPC's settings, you can control:

• Display Name: Set a fancy name with MiniMessage support.
• Model: Change the underlying ModelEngine model on the fly.
• Position: Teleport the NPC to you or fine-tune its rotation.
• Look Behavior: Toggle head tracking and set the look radius.

🔮 Holograms

(Requires FancyHolograms)

Add informative or decorative text above your NPCs to guide players or add lore.

Capabilities

• Rich Text: Full support for RGB gradients and formatting.
• Live Preview: Changes appear instantly as you edit them.
• Customization: Adjust height offset, background color, shadow, and scale.

Make your world interactive! Configure commands or messages that trigger when a player clicks an NPC.

Supported Actions:

• [message]: Send a private message to the player.
• [console]: Execute a console command (e.g., give items).
• [player]: Force the player to chat or run a command.
• [broadcast]: Announce a message to the entire server.

Example Configuration:

# When Right-Clicked:
"[message] Hello, {player}! Welcome to the server."
"[console] give {player} diamond 1"

⌨️ Commands & Permissions

All commands use the prefix /menpc (or alias /megnpc).

⚙️ Configuration

config.yml

Controls the core behavior of the plugin.

# How often (in seconds) to save NPC data to disk.
save-interval: 300

# Enable debug logging in the console.
debug: false

messages.yml

Customize every message sent by the plugin. We use MiniMessage format for full RGB support.

prefix: "<gradient:#00C9FF:#92FE9D><bold>ModelEngineNPC</bold></gradient> <dark_gray>»</dark_gray> "
command:
  no-permission: "<red>You do not have permission to do this."
  success: "<green>Operation completed successfully!"

📞 Support

Need help? Found a bug? Join our Discord or open an issue!

• Discord Server
• Issue Tracker