A powerful plugin designed to intercept Citizens2 NPCs and add advanced logic with conditions, actions, and custom visibility This plugin works perfectly on Paper and requires PlaceholderAPI and Citizens2




Check the docu

Required Dependencies - Java 25 and 1.21.8 of Paper

• Citizens-2.0.41-b4138 (Core for NPC creation and management)
  
• PacketEvents 2.9.+
• bettermodel-3.1.0-paper (Engine for rendering Blockbench 3D models natively on Paper servers)
  
• PlaceholderAPI (Core for math operations and dynamic conditions)

Features

• Infinite Subfolders You can organize your configuration files into unlimited subdirectories inside the configs folder
  
  
• Advanced Math and Conditions Supports PlaceholderAPI and full mathematical operations for condition checks Example: %player_level%+2 != 2
  
  
• Real-Time Visibility System Updates NPC visibility instantly without requiring players to reconnect
  
  
• Action Execution Execute multiple types of actions when a player interacts with an NPC
  
  
• Dynamic Viewer List Save players safely using their exact UUID
  
  
• Precise Centered Messages Calculates exact pixel width for perfect text centering in chat
  
  
• 3D Model Integration Allows you to seamlessly assign .bbmodel files from Blockbench directly to any NPC using the BetterModel engine
  
  
• Internal HTTP Resource Pack Server SantumNPC has a built-in, lightweight HTTP server that automatically hosts the build.zip generated by BetterModel and safely delivers it to the clients without requiring external web servers

Commands and Permissions
Permission for all commands: santumnpc.admin

• /santumnpc reload Reloads all configuration files and messages
  
  
• /santumnpc viewer set <config_name> <player|@p> Adds a player to the whitelist of a specific NPC configuration
  
  
• /santumnpc viewer unset <config_name> <player|@p> Removes a player from the whitelist
  
  
• /santumnpc status <config_name> <true/false> Enables or disables an NPC configuration in real-time
  
  
• /santumnpc loadresourcepack [player|@p] Calculates the SHA-1 hash of the BetterModel build.zip, generates a unique secure token, and forces the resource pack prompt on the player's screen automatically

All commands feature an intelligent tab-completer that suggests loaded config names and active players