NPCPremium

# NPCPremium NPCPremium is a configurable NPC mod for Minecraft Fabric servers and clients. It adds persistent player-like NPCs with custom skins, formatted name/subname, right-click actions, placeholders, messages, sounds, a full in-game editor GUI, real Emotecraft emotes played by the NPC itself, and a configurable lightweight AI behavior system. Created by zJuqni Compatible with: - Minecraft 1.21.1-1.20.1 - Fabric Loader 0.18.2+ - Fabric API - Java 21 - Optional: Emotecraft 2.4.12+ (playeranimator may also be required depending on the setup) ## What it does - Creates persistent NPC entities saved in world NBT. - Supports custom name and subname, legacy formatting with `&` and `§`, and escaped ampersands with `\&`. - Resolves skins from a player nickname, with Steve/Alex fallback if textures cannot be resolved. - Supports right-click interaction with commands as player or console, click messages in chat or actionbar, click sounds, click emotes, per-NPC cooldowns, proximity radius, near-trigger emotes, and optional interaction restrictions. ## AI and behavior - AI modes: `static`, `wander`, `patrol`, `follow`, `guard`, `orbit`, `greet`, `flee`, `mirror`, `showcase`. - AI tuning: home, detection range, speed, radius, stop distance, and teleport range. - Saved waypoint routes for patrol and showcase setups. - AI presets: `host`, `guard`, `pet`, `shy`, `mirror`, `showcase`, `patrol`. - Contextual greeting messages, greeting emotes, greeting cooldowns, and ambient emotes with configurable intervals. - Uses a custom lightweight movement system instead of vanilla mob AI/pathfinding. ## Editor GUI - `/npcpremium gui <npcName>` opens a tabbed editor for General, Position, AI Brain, Click, Feedback, and Emotes. - Lets you manage most NPC settings in-game without memorizing the full command syntax. ## Other features - Built-in placeholders for commands and messages: `%player%`, `%player_uuid%`, `%player_x%`, `%player_y%`, `%player_z%`, `%player_world%`, `%npc%`, `%npc_uuid%`, `%npc_x%`, `%npc_y%`, `%npc_z%`, `%npc_world%`, `%world%`. - Optional PB4 Placeholder API support by reflection if present. - `/summon npcpremium:npc` auto-registers summoned NPCs with numeric ids like `1`, `2`, `3`, and assigns a default visible name like `NPC #1` when needed. - Advanced controls include `look static|nearest`, configurable look range, move to looked block, rotation presets, per-NPC damage toggle, and NPC cloning. ## Commands - Core management: create, delete, list, tp, info, gui, name, subname, skin, move, rotate, look, clone, damage. - Interaction and feedback: onclick, message, sound, emote, near radius, cooldown, interact onlyplayers, interact requirepermission. - AI management: ai status, mode, home, range, speed, radius, stopdistance, teleportrange, ambientemote, ambientinterval, preset, waypoint add/list/remove/clear, greeting message/clear/cooldown/emote. ## Permissions - `npcpremium.admin` grants admin access to `/npcpremium`. - Falls back to the configured OP level if no compatible permission provider is available. - Per-NPC `interact requirepermission <node>` can use real permission nodes when a compatible provider is present. ## Important limits - The main interaction trigger is right-click. - NPCs are static by default and do not use vanilla AI or vanilla pathfinding. - AI movement is lightweight and behavior-driven, not full autonomous navigation. - Emotes are optional and require Emotecraft support in the environment that renders them. - Skin lookup may fall back to Steve/Alex if profile textures cannot be resolved. - For the full experience, install the mod on both server and client. Install Emotecraft on the side that should render NPC emotes. # ----- SPANISH ----- # NPCPremium NPCPremium es un mod de NPCs configurables para Minecraft Fabric en servidor y cliente. Añade NPCs tipo jugador persistentes con skins personalizadas, name/subname con formato, acciones por click derecho, placeholders, mensajes, sonidos, una GUI completa de edición, emotes reales de Emotecraft reproducidos por el propio NPC y un sistema configurable de IA ligera. Creador por zJuqni Compatible con: - Minecraft 1.21.1-1.20-1 - Fabric Loader 0.18.2+ - Fabric API - Java 21 - Opcional: Emotecraft 2.4.12+ (playeranimator también puede ser necesario según la instalación) ## Qué hace - Crea entidades NPC persistentes guardadas en el NBT del mundo. - Soporta name y subname personalizados, formato legacy con `&` y `§`, y escape de ampersands con `\&`. - Resuelve skins a partir del nick de un jugador, con fallback a Steve/Alex si no se pueden obtener las texturas. - Soporta interacción por click derecho con comandos como player o console, mensajes al click en chat o actionbar, sonidos, emotes al click, cooldowns por NPC, radio de proximidad, emotes por cercanía y restricciones opcionales de interacción. ## IA y comportamiento - Modos de IA: `static`, `wander`, `patrol`, `follow`, `guard`, `orbit`, `greet`, `flee`, `mirror`, `showcase