• 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.

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