CustomNPC+

- Script Editor Fixes + Styling Changes - Improved FONT for Script Editor - Auto Complete / Script Syntax Bugs - Fix Sound Selection GUI Reset - Accept Quest / Marks Data Crash on Client - Base Fullscreen Directory Fix for New Worlds Fix - Global API / Object Caching Optimizations - Profile Shared Quests Syncing

# CustomNPC+ 1.11 Changelog ## Ability System - Phase-based abilities (Wind-up, Active, Dazed) with configurable cooldowns, targeting, range, interrupts, invulnerability, and magic damage - **Melee:** Slam, Heavy Hit, Cutter - **Energy Projectiles:** Orb, Disc, Beam, Laser Shot with variant system, homing, hit types (Single/Pierce/Multi), size interpolation, explosions - **Barriers:** Dome, Wall, Shield with HP, reflection, damage absorption - **Defensive:** Guard, Counter, Dodge - **Movement:** Charge, Dash, Teleport - **AOE:** Shockwave, Sweeper, Vortex - **Hazards & Traps:** Persistent zones and proximity triggers with visual presets - **Effect:** Healing, buffs, debuffs with target filtering (Allies/Enemies/All) - **Custom Ability:** Blank-slate type with full script hooks and toggle modes - Burst system, chained ability combos with concurrency, telegraph system (6 shapes) - Per-phase animations and sound events - Ability conditions: HP Threshold, Hit Count, Has Item, Quest Completed, Has Effect - 12-slot player ability hotbar with HUD editor - Full scripting API for ability and energy projectile lifecycle events - Ability Extender system for custom hooks - Live preview in editor - Commands: `/kam ability list|types|prebuilts|info|delete|reload|give|remove|giveChain|removeChain|player` ## Auction House - Global marketplace with bidding, buyout, and snipe protection - Built-in currency system (configurable, profile-persistent, Vault support) - Listing fees, sales tax, minimum prices - My Trades panel with claim management (20-day expiry) - Search/sort, notifications (online + offline summary) - Trade slots (default 8, expandable via permissions) - Item blacklist (by item, wildcard, mod, NBT; soulbound always blocked) - Auctioneer NPC role - Admin GUI and logging - Cancelable scripting events: Create, Bid, Buyout, Cancel, Claim ## Script Editor - Full code editor with syntax highlighting, autocomplete, error detection, and hover tooltips - Go to Line, Search/Replace, Go to Definition, Fullscreen - Undo/Redo, Duplicate Line, Comment Toggle, Rename, Move Lines - Line numbers, smooth scrolling, indent guides, brace matching, smart brackets ## Java Scripting - Write scripts in Java via Janino compiler with automatic hook resolution - Per-tab language selector (mix Java and JavaScript) - External `.java` file support ## Client-Side Scripting - Server-controlled client script execution with auto-sync (off by default) ## Addon API Support - Ship `.d.ts` type definitions for automatic script editor autocomplete - Patch support for extending CNPC+ types, hot reload ## Traders - Stock system: Global or Per-Player modes with configurable restock timers - Currency trades (items + coins) - Client-side balance preview ## Cloner - Folder and subfolder organization for all categories - Full-width directory browser, improved tabs, tag-based filtering ## Animations - Data store for passing data across events/frames - Consumer-based task system - Expanded scripting API ## Animated Textures - Frame-based animation for items, effect icons, ability hotbar, scripted GUIs ## NPC API - `IHitboxData` (width/height scaling), `ITintData` (hurt tint, persistent tints) - Scriptable behavior: sprint, swim, doors, fire reactions, tactical chance, walking range - `ISound` (volume, pitch, repeat, position) - Skin overlay `getColor()`/`setColor()`, knockback API - Six overlays in singleplayer, script error reporting to console ## NPC Combat & Behavior - Attack speed enforcement, passive faction protection - Improved track speed, invalid texture fallback ## Other Changes - Player Dialog Events match NPC Dialog Events - Linked Item attack speed and scripting API - Right-click cycling on multi-option buttons - Legacy quest import (1.6.4), fullscreen/pannable GUIs, unified menu background - Textfield CTRL shortcuts, `java.lang.reflect` banned in scripts - Entity packet loss fix (invisible NPCs) - Natural spawn GUI, runtime control, and despawn improvements ## Bug Fixes - Script config sync, Bukkit integration - Quest cooldown for MC/RL Custom timers, quest/dialog saving and categories - Bard music restart on dialog open - Spawner yaw, biome spawn persistence, NPC invisibility - Track speed, set speed edge cases, spawn data, block waypoints, job spawner - Hitbox scaling and collision - Animation offsets, lookup failures, syncing, resync on teleport, registration names, double loading - Mount movement jitter, dismount edge cases

## 🛠️ CustomNPC+ 1.10.3 🛠️ ### Mounts Role I've added a new role to NPCs to allow Mount Access, directional and fly handling for Mounts. Right now there is a new keybind currently named **Special Key**. This will have more functionality and perhaps a better name in the future. However, on Flying Mounts this key is the only key that will allow you to *DESCEND* on a flying mount, because Sneaking will always be directed towards **Dismounting** ### Attack Speed Attack Speed is now fully incorporated in the **Linked** and **Scripted Items**. There will be more attack speed handling in the future, that will allow you to bypass the **20 tick limit** of hitting speeds to make them slower or faster. Currently, the range will be [1 to 20 ticks]. ### Features - Ranged Invincibility Toggle - `getPartyMembers()` on `IPlayer` ### Fixes - Various Party Crashes, Desync and Fixes - Close on ESC for all Windows - Fixes for Player Data Viewer Search Modes - Bow Rendering Fixes for Mixin Compatible Mods - Better Sync Handling so Bulk data does not need to resend for reconnecting players - DBC Addon Inconsistencies and Interaction Fixes - Linked Item Translation Fixes - Better NPC Hitbox Scaling so large NPCs do not fall through slabs - Quest Item Requires now take the Total - Quest Cooldowns for Custom MC and Custom RL fixes - Bard Music / Dialog Duplication Audio Fixed? (Needs more testing) - Console can now send Scripted Commands - Follower Role Packet Fixes

## CustomNPC+ 1.10.2 + Better Party to Client Data Syncing + Improved Scripting Performance and Function Lookup Speeds + Added the new API Action Manager, which allows you to queue up actions on NPCs, based on Conditions or Ticks. Either in parallel or sequentially. + Added new Recipe Script Support for Carpentry and Anvil Recipes. A Pre & Post Event + Added Soulbind and Slotbind Attributes to Item Attributes + Shift-Click Support in Bank Containers + Added all Biome Support to Natural Spawns + Added Configs to Determine Script Load Order ### Fixes - Animation Data Crash - Dialog Close Event will always run now, no matter how GUI closes - Profile Slot Data Overwriting - Fix Passive Faction Toggle Button - Fix Mob Spawner Crash Bug - Fixed Player Respawn Event not getting Hooked - NPC Paintbrush Crash - Sign Model Crash - Job Selection Menu corrected to allow selecting all Jobs/Roles again - Bard Song Duplication issues - Player Data Remove not working - NPC Flying 0 Gravity Corrections

- Fixed Imported Scripts not loading first - Fix getTopBlock() - Prevent Scripts from Saving Empty when opening and closing too quickly - Fixed Negative Values on Magic Interactions - Fix Corner Couch Rendering - Added Right Click Event for Players - Fix CustomGuiClose Event

## Features :hammer_pick: ### Animation Events Synchronize animations across **ALL CLIENTS** with server-controlled frame timing for precision scripting. **New Event Types:** - **Started** - **Ended** - **Frame Enter** - **Frame Exit** Utilize `Animation ID` and `Animation Frame` to trigger events on `NPCs`, `Players`, or `All NPCs`. ## Profiles Player Profile Support is now integrated for CNPC+ and DBC Addon. They can be disabled within the **configs** of **CNPC+**. Profiles are similar to a form of **Character Slot**, that allows players to create profiles that save CNPC+ information (quests, dialogs, etc) and if DBC Addon is installed all the subsequent DBC Data / Information. **Permissions for Profile Management:** - `customnpcs.profile.admin` – Admin-level commands and tweaking - `customnpcs.profile.create` - `customnpcs.profile.delete` - `customnpcs.profile.rename` - `customnpcs.profile.change` - `customnpcs.profile.max.NUMBER` – Set the maximum number of slots allowed per player Switch profiles via the `/profile` command or the in-game GUI (Profile Inventory).   Profiles support automatic backups (configurable in the Main Config) and can be rolled back using: `/profile rollback PLAYER filename` ## Profile / Quest Changes - **Quest Cooldowns:** Automatically adjust to the maximum allotted time when switching between MC and RL components. - **Custom Cooldown Times:** New RL Custom and MC Custom options with API support and a GUI component. - **Quest Profile Options:**     - **Cooldown:** Choose between Sharing (one slot’s cooldown prevents acceptance on all slots) or Individual.   - **Completion:** Choose between Sharing (completion on one slot marks all as complete) or Individual. ## Model Rework Most models have been redesigned by [@Artist](#) and [@popsiclenate](#). Legacy models are still available in the `Client Config`. **New Tools:** - **Npc Brush :paintbrush:**     Set COLORS/HUES for colorable blocks (e.g., Couches, Banners, Lamps). - **Npc Hammer :hammer:**     Modify specific models:   - Adjust chair positions (tucked in or out)   - Change banner variation textures ## Hud Rework 👁️ The Quest Tracking and Quest Compass now use Marks along with a revamped Hud System that can be tweaked via the CNPC+ Inventory GUI. **Features:** - Drag, resize, and manually edit hud components in the Client Config. - Option to disable any hud component. - *Upcoming:* Quest Objectives integration into the Compass Hud for setting coordinates on tracked quests. ## Linked Items 🔗 A new Linked Item System functions similarly to the Scripted Item System but uses its own item type. **Features:** - Create Linked Items in the **Global Menu** under the **Linked Tab** and script them there. - Update all Linked Items by clicking the **Version** button (triggers the `onVersionChange` event). - *Note:* Linked Items update visually only after entering a player's inventory. ## Anvil Recipes 🛠️ The CNPC+ Anvil now has dedicated functionality, distinct from the Carpentry Bench. **Features:** - Configure Anvil Recipes in the **Global Menu** under **Recipes** by switching to the Anvil System. - Customize repair processes for Weapons/Tools with configurable XP and Material Costs. - View all Anvil Recipes created by players directly on the Anvil. ## Custom Effects ✨ Custom Effects can now be added through the **Global Effects Menu** and applied with the `/kam effect` command. **Events:** - **OnAdded** - **OnTick** - **OnRemoved** **Features:** - Fully scriptable via the GUI. - Effects appear on the left side of the CNPC+ Inventory (unless on the Quest Tab). - The same command is used in **DBC Addon** for built-in effects. ## Magic 🧙 Access the Magic System via the **Global Menu** to create and configure Magic Elements, enabling dynamic interactions similar to a Pokémon-type system. You can also switch to view **Magic Cycles** which allows you to configure visual diagrams displaying your Magic System. [ADD SYSTEM TO VIEW FOR PLAYERS] **Features:** - Define additional damage or resistances (negative values). - Apply Magic Elements to **NPCs** (via the Advanced Tab) and **Players** (via the PlayerData GUI in the Global Tab). - **Damage Splitting:**     For instance, an NPC dealing 100 damage with both **Fire** and **Water** magic can split the damage (e.g., 70% Fire, 30% Water), resulting in 70 Fire damage and 30 Water damage. - Enables interaction boosts and dynamic combat calculations between different magic types. ## Attributes 📊 Item Attributes are now available via the `/kam attribute` command! Attributes are a system of **stat enhancements** that be made to Players by giving their items and armors specific values. This system is also extended upon in **DBC Addon** allowing Stat buffs to DBC based attributes. **Commands:** - **List Attributes:**     `/kam attribute list [page]`     *(Permission: `cnpc.kamkeel.attribute.list`)* - **Apply Attribute:**     `/kam attribute apply <attribute> <value> [magicID]`     *(Permission: `cnpc.kamkeel.attribute.apply`)*     - Standard example: `/kam attribute apply main_attack 5`   - Magic example: `/kam attribute apply magic_damage 3 101` - **Remove Attribute:**     `/kam attribute remove <attribute> [magicID]`     *(Permission: `cnpc.kamkeel.attribute.apply`)* - **Manage Requirements:**     `/kam attribute requirement <apply|remove> <requirement> [value]`     Example: `/kam attribute requirement apply quest_active 2` **Tooltip Details:** - **Base Attributes:** Health, Main Attack Damage, Neutral Damage. - **Modifiers:** Percentage boosts (e.g., Main Attack Boost, Neutral Boost). - **Additional Stats:** Critical Chance, Critical Damage. - **Magic Attributes:** Detailed info including Magic Damage, Magic Boost, Magic Defense, Magic Resistance, and their magic IDs. - **Requirements:** Shows any conditions that affect attribute activation. For full details, visit the [Item Attribute System Wiki](<https://github.com/KAMKEEL/CustomNPC-Plus/wiki/Item-Attributes>). ### Other Changes: > - Added Faction Passivity for Lowering Memory Usage > - Allow Custom Trails for NPC Projectiles / Links > - Fix FakePlayer Crashes > - Completely remade Packet System > - getRotation() fix for NPCs > - Added Soulbind & Slot Bind Requirements to Item Attributes > - Added NPC Magic Book Item > - Fix Overlay Crashes > - Fix Animation Offets > - Better NPC Advanced Permissions for Traders. Markets, Roles, Dialogs > - Ranged Attack Modifications (Sound Options now can be set for Per Shot or On First Shot) > - Machine Gun config in Item Config > - A BUNCH OF OTHER MINOR CRASH / BUG FIXES # Scripting > API: LINK ## Scripted Action Manager -- ADD DETAILS to Scripted Action Manager ### Other Scripting: > - setAimType,  getAimType > - IAttributeHandler -- For Item Attribute Scripting > - IMagicHandler / IMagic > - ICustomEffectHandler  > - Profile Events, Change, Rename, Switch > - ILinkedItem

## 1.9.3 ### **Changes** - Support for **DBC Addon** - Changes to Flying Height API - Optimize Render Events for JBRA Client - GuiScrollWindow - Entity Field to CNPC Natural Spawn Event - HTTP Posts are Multithreaded - Scroll Wheel works in Scripting Menu and other GUIs - Breaking Carpentry Bench shows Plank Textures instead of Lava - Reduce Lag on Scripted Items during Right Click Event - Improved Barrel Model (To Be Changed) - Tint Damage during Hurt Effects - Animation Frames can be Copy and Pasted with Keybinds CTRL + V and CTRL + C - Script Loading performance Improvements - Scripts Save Asynchronously after Editting - Allow setLootItem to be set to Null for Empty Item ### **Fixes** - Music Memory leak fixes - Entity Null bug on Kill Quests - Animation Null bug on Player Models - Fixes to Sneaking while Animating - Animation GUI now closes correctly with ESC - Player Specific Invisible to Client Fixes - Soulstoning Animals works again - Auto Completed Item Quest Fixes - Swing Packet only Sent to Server Side

### **Changes** - Sync / Save Scripts asynchronously on closing Player / Forge / All Npc Tabs - Scripted Block now renders more like a block with shadows [TileEntities do not cast sky shadows] - Scripted Block hover selection only shows if Block is Visible and not when not passible - Send Swing Event only to Serverside - Ping Client to Reload NPC on Url Changes - Scroll Bars reset when typing into Search Bars - Added `Acceptable` and `NotAcceptable` Availability options for Cooldown Detection - Added `scriptCommand` hook - *Some* colored blocks now render in banners correctly - Send PlayerData in Chunks to prevent `SYNC_END` overload - Added `createNew()` IItemStack - `broadcast()` for IWorld - `has()` clone in ServerCloneControllers ### **Fixes** - Better MorePlayerModel+ Handling for Overlays - Fix Tint Hurt Damages - Fix HasCode() not checking for Loaded Scripts - Fix Item Quest on Pickup calculating Quest Reward too quickly - Fix `setLootItem(null)` - Casting Fixes for FakePlayer - Scripted Block Text Compounds not saving - Better Null Crate handling - Gui Trade Setup Cutoff - Fix `setLore` clearing item titles and other display objects - Banner Items Rendering Above - :skullclown: removed another print - Fix `removeItem()` considering ignoreNBT and ignoreDamage properly now - Fix `set` ServerCloneController - Fix Sound Selector not visually updating right away after choosing - Permission Handler error for `isOp` on Client Side

### **Changes** - Was in 1.9 -- **Added Quest Manual** - `/kam quest objective` command for completing objectives for parties and players on quests - Added an isOp Permission check for all permissions - Add `setIsNormalItem()` and `isNormalItem()` to Scripted Items to make items held / render like default MC Items ### **Fixes** - Switching Skin Overlay URLs / Textures maintains Glow / Solid - Fix Scripted Block Null on Save - Fix Scripted Block Events `event.block` null - Fix GUI Texture Selector cutting off texture paths - removed print statement - Fixed Scripted Item ghost items when being dropped - Fixed DBC Custom Item Models causing Player Animation rendering crash - Adding more dialog images with different indexes don't crash - Fix Player Animations not rendering when switching dimensions

# 1.9 MASSIVE RELEASE TONS OF CHANGES. **NEW** - Entire Party System!! SEE GITHUB WIKI - TEXTURE REVAMP for ALL ITEMS to more Modern Look - Client Side Animation Cache - Animations now also have an ID - `/kam animation` to play animations on a player via a command - Brand new configs in `mixins.cfg` to disable and enable animation functionality. - **First Person Animation** rendering - Timeline Viewer for all Animations Frames [with Color Picker for categorizing] - Dialog / Quest / Sound / Texture Selection Revamped with new Dynamic Popup Selection - Dialog Test Button for directly testing dialogs from within the GUI - Script Syntax Highlighting - Quest Log Categories are now **SCROLLABLE** :closed_book: - Factions GUI now displays **2 columns** and is fully hideable in the `config/CustomNpcPlus/client.cfg` - **Settings Tab** - Clear Quest Tracking - Clear Skin Cache - Modify Quest Tracking [Position, Offset, and Scale] - For Dialogs with Noise and Gradual Speed - Edit Values - Hide Chat Bubbles / Alert Banners / Chat Info Message - **Party Tab** (read party changes) - Hoverable Text in all GUI Lists (Now you can see values fully) - Code Highlighting in Scripting Menu - `/kam command [ScriptedCommandName]` to run Scripted Commands via a normal comamand - New APIs for added content: `IParty`, `IHitBoxData`, `ITintData`, `IMark`, - IRoleFollower - Combat Policy API - SET/GET Melee Range, Swing Warmup, Knockback, Aggro Range - ILine for Attack, Killed and World Lines - Better Hotkey Handling `Ctrl` + `X`, `C`, `V`, `Z`, `Y`... etc - Mouse Drag selection in Script GUI. - `Banned Scripting Classes` editable in the `main.cfg` - `IVillager` for modifying Villager Trading - `IScreenSize` for sending Client Screen Size to Server - URL Support on **Capes **and **Overlays** - Spawner Job 2 new AI Variations (Spawns on Summoner Death, Kills Spawns when Summoner Dies) - Blocks can now be used in Banners / Hanging Banners / Signs - `/kam` is the same as `/kamkeel` - `/kam questcat` command - `/kam dialogcat` command - `/kam overlay` command - `/kam config market` allows for Market conversion from `JSON` to `DAT` filetype similar to `/kam config playerdata`, The Market Dat feature must also be enabled within the `main.cfg` - 3 New Shield Types: Frost, Mithril, Demonic Full Variations - Added `Pounce` as a Leap option for NPCs. So now you have `Jump` and `Pounce` (Pounce is way further) - Friendly Fire and Party Configs for enabling / disabling functionality - Better naming for CNPC+ related mobs in Entity Selector - Enhanced Build Gradle - 2 New Tail Types Monkey (Remade to look like DBC's Tail) and Fox Tail - Marks from 1.12 - Tint Modification Settings - Hitbox Modification Settings - New Permissions (Printed to Console on Start) - Multi-Commands broken up by `@x` - Combat Policy System -> See Discord for Details **FIXES** - Clicking through Animation Deletion Bug - Animations and Armors Desyncing - Animations slowing down and speeding up - Animations now playing in different dimensions - Mouse Scroll working in all scrollable text areas - Quest Dialog Selector popping off of screen - Trader GUI Setup cutoff - Autocomplete Quest Tracking no longer displays an NPC name - Top Alignment Dialog Fix - Dialog Image Positioning Fix - Shift Clicking in Carpentry Bench now updates client inventory - getWorld for End and Nether Fix - Script Book not hooking Book and Quill - getIRoleType returning wrong values - `npc.updateEntity()` to fix dimension ID error for updateClient [fixes existing NPCs] - getStoredDataKeys Crash - Scripted Particles spawned on summoners player not at proper Y Value - Resizing Scripting GUI clears Script - Scripted Items being dropped and bobbing in items frames - Melee Swing and RangedLaunch Event not being called - Custom GUI Item Slots not registering - getLeftItem Typo Fix. Both misspelled and correctly spelled are available - Inventory Tab Offset Issue - Fix Remote Freeze Button not showing the correct option - Removed Nashorn Size of Object Dependancy for Java 17 Support - Buttons highlighting even when a Sub GUI is pulled up - Mouse Overlap Double Clicking buttons - World Lines spamming, now has cooldowns - Item Giver Job having shared cooldowns (if still broken remake item givers from scratch) - **HD** Textures not loading on NPCs - Dispenser Soulstone Crash - Kill Projectiles after 1 minute of lifetime - Quest Location Crash Fix - Scroll Tag Crash - 3D Layer Duplicate for Chestplate - Spawner Job NPC Bouncing - Spawner Job "X" Button - DBC Add Bonus Crash - Singleplayer Cache not clearing - Imgur Redirect Links