Unlocking Advanced Scripting in Minecraft with Extended Scripts
For players who love pushing the boundaries of what Minecraft can do, the CustomNPCs mod has long been a staple. It allows you to create interactive characters, quests, and scripted items that breathe life into your worlds. But even the most dedicated scripters sometimes hit a wall when trying to implement complex mechanics. That is where Extended Scripts comes in — a powerful addon designed to supercharge Kamkeel's CustomNPC+ and make scripting more intuitive, flexible, and capable of feats that were previously out of reach.
What Exactly Is Extended Scripts?
Extended Scripts is not a standalone mod; it is an enhancement layer built specifically for CustomNPC+. Its primary goal is to expand the scripting API, giving creators access to new functions, events, and classes that simplify common tasks and enable entirely new gameplay possibilities. Beyond scripting, it also introduces a handful of non-scripting features that improve the overall modding experience, from custom attributes to world management tools.
If you have ever struggled with centering overlay text, wanted to fire custom projectiles from a script, or needed to check which hotbar slot a player is using, this addon fills those gaps elegantly. It is currently optimized for CustomNPC+ version 1.11.1, so keeping your mod versions aligned is recommended for the smoothest experience.
Scripting Superpowers: The Extended API
At the heart of Extended Scripts is the extAPI keyword, a gateway to a treasure trove of new functions. Once you have the addon installed, you can call extAPI from any script to access utilities that make your code cleaner and more powerful. Here are some standout additions:
- createIEntity(String name) — Spawn non-living entities like fireballs, arrows, or even custom projectiles directly from your scripts. This opens up dynamic combat systems and spell-casting mechanics.
- createCustomParticlePreset(int particleIndex) — Tap into CustomNPC+'s particle system with ease, using Minecraft's own particle textures to craft stunning visual effects.
- registerAttribute(String key, String displayName, char colorCode, int attributeType, int section) — Define your own visual-only custom attributes that appear in the player's attribute list, perfect for RPG-style stat displays.
- getStringPixelWidth() — A small but mighty function that returns the pixel width of a string, making it possible to perfectly center text on custom overlays.
These functions alone can transform how you approach scripted items and NPCs, but the mod goes much deeper. A new Key enum, for example, lets you write clean key-press checks like if (event.key == Key.K_V) instead of memorizing numeric key codes. This is a massive quality-of-life improvement for anyone building interactive menus or custom controls.
Custom Projectiles and Overlays
One of the most exciting additions is the custom projectile system. You can now create projectiles with custom rendering, particle trails, gravity, and on-impact effects — all controlled through scripts. This means you can design magic spells, throwable weapons, or even guided missiles that behave exactly as you envision. The included onTick and onImpact events give you full control over the projectile's lifecycle.
Overlay creators also get a major upgrade. With IPlayer.getScreenResolution(), you can now access the scaled resolution of a player's screen, allowing your custom HUDs and interfaces to adapt perfectly to different display settings. Combined with the pixel-width function, you can build professional-looking UI elements that feel native to the game.
ShapeMaker and Harvest Levels
Visual effects and game mechanics both benefit from the new ShapeMaker class. It provides functions to retrieve all points within geometric shapes, which is ideal for drawing particle circles, lines, or complex patterns. Meanwhile, setHarvestLevel(String toolClass, int level) ensures your scripted pickaxes and tools actually work like real ones — without it, breaking stone or ores would not drop the blocks, breaking immersion.
Another subtle but crucial event is hotbarSlotChanged(event). This triggers whenever a player switches their hotbar slot, allowing you to immediately disable effects from a scripted item when it is no longer held. No more lingering buffs or visual glitches after putting away a custom weapon.
Non-Scripting Features That Make Life Easier
Extended Scripts is not just for coders. It adds several features that benefit all server admins and map makers, even those who never touch a script editor.
Custom Attributes Without Items
Normally, custom attributes in CustomNPC+ are tied to held or equipped items. Extended Scripts breaks that limitation by allowing you to apply attributes directly to a player via the /veil attribute apply-player command or through scripts. These attributes — including new ones like gravity, swim boost, and flight speed — are fully integrated into the game's attribute system and display alongside vanilla attributes. You can even register your own visual-only attributes, which can then be checked and manipulated just like any other.
World Clippers and the /inspect Command
Debugging scripted mobs or items often means digging through NBT data. The World Clippers tool, found in the CustomNPCs Tools tab, lets you bind to any mob or block with a simple left/right click. Then, using /inspect target, you can view all the NBT data of that target in chat. For items, /inspect hand does the same. If the data is too long, you can filter by subtags or use -k to list only tag names. This tool alone saves hours of guesswork when troubleshooting complex scripts.
Global File Copying for New Worlds
Setting up a new world with all your custom quests, dialogs, and scripts can be tedious. Extended Scripts introduces a global folder inside your customnpcs directory. Any files placed there — animations, scripts, quests, etc. — are automatically copied into every new world's local customnpcs folder. This means your server's core content is always ready to go without manual duplication.
Scripted Armor That Actually Works
Scripted items have historically been awkward for armor, but Extended Scripts changes that. Now, scripted items with a valid armor type can be equipped with a simple right-click or shift-click, just like vanilla armor. The mod also adds an Armor Value attribute that provides real damage protection, and scripted armor renders on the player by default. You can customize the color and texture, even adding an overlay for leather-like dyeable effects. An armorDamaged event completes the package, allowing you to trigger durability or special effects when the wearer takes a hit.
Script Keybind for Faster Editing
If you have ever accidentally triggered a scripted item's right-click function while trying to edit it, you will appreciate the new script keybind (backslash by default). It opens the scripting interface directly, bypassing the item's normal behavior. This small tweak removes a major frustration from the development workflow.
Getting Started with Extended Scripts
To use Extended Scripts, you must have CustomNPC+ installed first, as it is a required dependency. The addon is designed to work seamlessly with version 1.11.1 of CustomNPC+, so double-check your versions to avoid compatibility hiccups. Once both are in place, the new scripting functions, commands, and items become available immediately.
For those who prefer a streamlined modding experience, the foxygame.net launcher offers a convenient way to manage your Minecraft setup. It provides a modern, flexible interface where you can browse and install mods like Extended Scripts directly from the menu, saving you the hassle of manual file placement. This launcher is especially handy when juggling multiple addons and version requirements.
Why Extended Scripts Matters for Creators
This addon effectively removes many of the friction points that scripters face in CustomNPC+. Whether you are building an RPG server with custom attributes, designing spell systems with unique projectiles, or simply want your scripted armor to behave like real armor, Extended Scripts delivers the missing pieces. The combination of new API functions, the World Clippers debug tool, and quality-of-life features like global file copying makes it an essential companion for any serious CustomNPC+ user.
By bridging the gap between what is possible in vanilla Minecraft and what ambitious creators imagine, Extended Scripts empowers you to craft richer, more immersive experiences. The documentation is thorough, and the community around it is active, so even complex ideas can become reality with a bit of scripting know-how.
Final Thoughts
Extended Scripts is more than just a utility — it is a creativity multiplier. It respects the foundation laid by CustomNPC+ while fearlessly expanding its horizons. From the moment you use extAPI to spawn a custom fireball or center your first overlay text, you will wonder how you ever scripted without it. If you are ready to take your Minecraft worlds to the next level, this addon deserves a spot in your mod folder.
--- **Update Jul 1, 2026:** Added 1 file for version 1.7.10 (Forge).