🛠️ 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