FoNPC

NPCs but built different.

FoNPC is a packet-based NPC plugin for Paper/Spigot/Purpur 1.21+ focused on fast setup and deep control: create NPCs, style them, add click actions, and run waypoint movement profiles.

Special Mentions

• Movement walking/jumping NPCs (with pathfinding & waypoints), also support all other entities
• Poses like sitting, sleeping, swimming, crouching or standing
• Editor GUI (way easier for editing NPCs quickly)

Features

• Player-like NPCs with custom names, skins, glow, scale, equipment, and attributes.
• Poses (crouching, sitting, sleeping, swimming).
• Built-in GUI editor (/fonpc editor) for quick in-game editing.
• Full command editor for precise control over every NPC setting.
• Skin options:
  • Player name / UUID
  • Placeholder-based skin input (with PlaceholderAPI)
  • @mirror (mirror viewer skin)
  • @texturl <textures.minecraft.net URL>
• NPC visibility modes:
  • Visible to everyone
  • Permission-gated visibility per NPC (permission_required)
• Click actions per trigger (left_click, right_click, any_click) with action chains.
• Action system supports:
  • console_command
  • player_command
  • player_command_as_op
  • message
  • wait
  • play_sound
  • need_permission
  • execute_random_action
  • block_until_done
  • play_movement
  • stop_movement
• Movement profile system with waypoints and runtime overrides.
• Movement settings include speed, loop mode, yaw mode, pathfinding, round-path smoothing, arrival tolerance, and more.
• Converter (/fonpc convert ).
• Supports non-player NPC entity (like mobs) on 1.21.5+ servers

Commands

Main command: /fonpc Alias: /npc

• /fonpc create
• /fonpc copy
• /fonpc teleport
• /fonpc remove
• /fonpc list
• /fonpc info
• /fonpc editor [npc name]
• /fonpc debug
• /fonpc convert

Edit Command

• /fonpc edit move_here
• /fonpc edit move_to [world] [yaw] [pitch]
• /fonpc edit rotate
• /fonpc edit look_at_player <on|off> [range]
• /fonpc edit look_range
• /fonpc edit type
• /fonpc edit displayname <text|%placeholder%|@none|reset>
• /fonpc edit skin <player|uuid|%placeholder%|@mirror|@texturl |reset>
• /fonpc edit glow <on|off> [color]
• /fonpc edit collidable <on|off>
• /fonpc edit visibility <all|permission_required> [permission]
• /fonpc edit interaction_cooldown
• /fonpc edit scale
• /fonpc edit tablist <on|off>
• /fonpc edit equipment <material|clear|hand|offhand> [amount]
• /fonpc edit attribute set <invisible|shaking|on_fire> <on|off>
• /fonpc edit attribute set pose <crouching|sitting|sleeping|standing|swimming>
• /fonpc edit attribute list

Actions

• /fonpc edit actions list [click_type]
• /fonpc edit actions add [value]
• /fonpc edit actions add_before [value]
• /fonpc edit actions add_after [value]
• /fonpc edit actions set [value]
• /fonpc edit actions remove
• /fonpc edit actions move_up
• /fonpc edit actions move_down
• /fonpc edit actions clear

Movement

• /fonpc movement list
• /fonpc movement create
• /fonpc movement delete
• /fonpc movement info
• /fonpc movement set
• /fonpc movement waypoint list
• /fonpc movement waypoint add [wait_ticks]
• /fonpc movement waypoint add [wait_ticks] (player position capture)
• /fonpc movement waypoint insert [wait_ticks]
• /fonpc movement waypoint set [wait_ticks]
• /fonpc movement waypoint remove
• /fonpc movement waypoint move
• /fonpc movement waypoint clear
• /fonpc start_movement [key=value ...]
• /fonpc stop_movement
• /fonpc movement_status

Movement setting keys:

• speed
• loop
• yaw
• pathfinding
• round_path
• round_radius
• sample_distance
• arrival_tolerance
• fall_speed_multiplier
• pause_on_waypoint_ticks

Permissions

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

Dependencies

Required

• ProtocolLib (depend)

Optional

• PlaceholderAPI (softdepend) for placeholder-based values (for example display name / skin inputs).