Interactive NPCs for Minecraft Servers

Create configurable NPCs that look alive, react to clicks, run server actions, and move through your world. FoNPC is built for server owners who want practical NPCs for shops, guides, quests, warps, menus, tutorials, events, and admin-controlled server interaction without editing a giant config for every change.

Features

• Create, copy, teleport, edit, and remove NPCs with one admin command set.
• Use the in-game NPC browser and editor to manage names, skins, display names, visibility, cooldowns, glow, scale, pose, and look-at-player behavior.
• Build click actions for left click, right click, or any click: console commands, player commands, messages, sounds, waits, permission checks, random action branches, movement playback, and cooldown blocking.
• Give NPCs player skins, mirrored skins, texture URLs, PlaceholderAPI-backed values, equipment, colored glow, custom visibility permissions, and tab-list behavior.
• Create named movement profiles with waypoints, speed, loop mode, yaw mode, pathfinding options, rounded paths, pause times, and live start/stop/status controls.
• Import existing FancyNPCs data with /fonpc convert fancynpcs to make migration faster.

Click Actions

FoNPC turns NPC clicks into useful server workflows. Use action chains to open menus, run commands, send messages, play sounds, start movement profiles, require permissions, add delays, or choose a random next action.

Movement Profiles

Create reusable movement paths and start them on any NPC. Profiles support waypoint editing, loop modes, yaw handling, pathfinding toggles, speed settings, rounded paths, arrival tolerance, fall-speed control, and waypoint pauses.

Dependencies / Compatibility

• Native input dialogs are used on compatible Paper or Paper-fork servers with the Dialog API.
• Non-player NPC entity types require server support for the 1.21.5+ entity path.
• Optional hooks: PlaceholderAPI for dynamic placeholders and ProtocolLib for packet/profile compatibility support when installed.

Commands

• /fonpc create <name> - create an NPC at your location.
• /fonpc editor [name] - open the NPC browser or edit a specific NPC.
• /fonpc edit <name> <option> ... - edit location, type, skin, display name, glow, visibility, cooldown, scale, equipment, attributes, tab-list state, or click actions.
• /fonpc movement ... - create and manage movement profiles and waypoints.
• /fonpc start_movement <npc> <movement> [key=value ...] - start a movement profile on an NPC.
• /fonpc stop_movement <npc> - stop an NPC movement.
• /fonpc movement_status <npc> - view active movement state.
• /fonpc convert fancynpcs - import supported FancyNPCs data.
• /fonpc list, /fonpc info <name>, /fonpc teleport <name>, /fonpc copy <old> <new>, /fonpc remove <name> - manage saved NPCs.
• /fonpc version, /fonpc reload, /fonpc resetcooldown <player|all> - admin utilities.

Aliases: /npc, /fonpcadmin, and /npcadmin.

Permissions

• fonpc.admin - grants access to all FoNPC commands. Default: op.

NPC visibility can also be locked behind a custom permission node per NPC when using permission_required visibility.

Optional Admin Tools

FoNPC includes editable messages.yml, GUI layout files, native-dialog templates, Modrinth update checking, a FancyNPCs converter, and resettable in-memory interaction cooldowns.