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