AtbarNpc-----Native ModelEngine R4 support. -----
High-Performance Packet-Based NPC Plugin⚡ AtbarNpc
High-Performance Packet-Based NPC Plugin
Lightweight. Blazing-fast. Zero entity overhead.
Native ModelEngine R4 support.
Spigot / Paper 1.20+ | Java 21+ | PacketEvents | ModelEngine R4
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What is AtbarNpc?
AtbarNpc is a modern, high-performance NPC plugin for Spigot / Paper 1.20+ servers with native ModelEngine support.
Unlike traditional NPC plugins that spawn real entities, AtbarNpc uses packet-based virtual entities — NPCs only exist on the client side, meaning your server TPS stays untouched even with hundreds of NPCs running simultaneously.
Why AtbarNpc?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
Three NPC Types — One Plugin
- Player — Classic player-skin NPCs. Set any skin by player name or texture URL.
- Vanilla Mob — Use any vanilla entity as an NPC — Villager, Zombie, Iron Golem, animals, and more.
- ModelEngine Model — The killer feature. Use any custom ModelEngine R4 3D model as an NPC. Dragons, custom mobs, furniture — anything. Combined with holograms and click commands, the possibilities are endless.
- Packet-Based — NPCs are purely client-side. Zero TPS impact. No real entities on the server.
- ModelEngine R4 Integration — First-class support for custom 3D models. Turn any .bbmodel into a living NPC.
- Hologram Text — Multi-line floating text via Text Display. Supports MiniMessage (colors, gradients).
- Click Commands — Execute commands on right-click. Supports %player% placeholder.
- View-Distance Tracking — NPCs auto spawn/despawn based on configurable player distance.
- Look-At-Player — Smooth head rotation to face nearby players.
- Glow Effect — Customizable glow colors per NPC.
- Smart Selection — Select NPCs by looking at them or by ID — no UUID memorizing.
- Auto-Save — YAML storage with configurable auto-save intervals.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Performance
Code (Text):
NPC Count | Real Entities (TPS) | AtbarNpc / Packets (TPS)
-----------+-----------------------+---------------------------
100 | 18 - 19 | 20
500 | 12 - 15 | 19 - 20
1000 | 5 - 10 | 18 - 19
- Async distance checks (off main thread)
- View-distance culling (only visible NPCs send packets)
- Batch packet sending (reduced network overhead)
- GameProfile & skin caching
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands
Code (Text):
/npc create Create a Player NPC at your location
/npc create <entityType> Create a vanilla mob NPC (VILLAGER, ZOMBIE, etc.)
/npc create model:<id> Create a ModelEngine model NPC
Code (Text):
/npc sel Select the NPC you're looking at
/npc sel <id> Select an NPC by ID
/npc list List all NPCs
/npc near [radius] List nearby NPCs (default: 10 blocks)
/npc info View selected NPC info
/npc delete Delete selected NPC
Code (Text):
/npc tp Teleport to the selected NPC
/npc movehere Move the NPC to your location
Code (Text):
/npc skin <player|url> Set skin (switches to PLAYER type)
/npc entity <type> Switch to vanilla mob type
/npc model <modelId> Set ModelEngine model (switches to MODEL type)
/npc name <name> Set display name
/npc lookat <true|false> Toggle look-at-player
/npc glow <true|false> [color] Toggle glow effect
Code (Text):
/npc hologram add <text> Add a hologram line (MiniMessage supported)
/npc hologram remove <line> Remove a hologram line
/npc hologram set <line> <text> Edit a hologram line
/npc hologram clear Clear all hologram lines
Code (Text):
/npc addcmd <command> Add a right-click command
/npc removecmd <index> Remove a command by index
/npc listcmd List all commands
/npc clearcmd Clear all commands
Placeholder: %player% → player name
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Permissions
- atbarnpc.admin — Access to all NPC management commands (Default: OP)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Dependencies
- PacketEvents — Required — Packet handling library (Spigot variant)
- ModelEngine R4 — Optional — Enables custom 3D model NPCs
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Configuration
Code (Text):
# Tracking
tracking:
distance: 48 # blocks
update-interval: 10 # ticks
# Hologram
hologram:
default-offset: 0.3
model-offset: 0.1
line-spacing: 0.25
# NPC Defaults
npc-defaults:
look-at-player: true
collidable: false
# Performance
performance:
load-delay: 100 # ticks
auto-save:
enabled: true
interval: 300 # seconds
debug: false
Code (Text):
npcs:
"550e8400-e29b-41d4-a716-446655440000":
display-name: "Shop Keeper"
location:
world: "world"
x: 100.5
y: 64.0
z: -200.5
yaw: 90.0
pitch: 0.0
type: PLAYER
skin-texture: "ewogICJ0aW1lc3RhbXAi..."
skin-signature: "signature..."
hologram:
lines:
- "<gold>Shop Keeper</gold>"
- "<gray>Right-click to open shop</gray>"
offset: 0.3
look-at-player: true
glowing: false
collidable: false
commands:
- "openguishop shop"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
If you encounter any issues or have feature requests, feel free to post in the discussion tab.
Made by Atbar
Resource Information
Author:
----------
Total Downloads: 13
First Release: Mar 4, 2026
Last Update: Mar 14, 2026
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings