General Fixes & Improvements

• Scripts run more than 2.5 times faster than in previous versions now! No changes needed, just update!
• You can convert scripts (scriptPacks) into plugins now!
• Added support for minecraft version 26.1
• Reviewed and fixed numerous bugs across the entire codebase.
• Added a debug mode boolean to the config for easier troubleshooting.
• Fixed a bug where reloading with the reload command would not update the debug mode boolean until a full restart.
• Fixed an issue where deleting folders inside the script folder was not possible due to the file watcher locking them.
• Removed all deprecated code and cleaned up a large portion of the codebase.

Dialog API

• Created a new DialogApi for managing in-game graphical dialogs.

Task API

• Tasks are now shared across all scripts, meaning they can be cancelled from external scripts using setShared and getShared.
• Added task.latch() which returns an object with the following thread-safe methods: .destroy(), .connect(function), .wait(), .invoke(), .fire(), and .invoked.
• Added task.threadType() which returns a string indicating the thread type (main, async, or sync).
• Enhanced thread safety in DelayTask by properly handling thread interruptions.

FileManager API

• Added FileManager.getPath(File), which returns the relative path of a file based on the script's folder.
• Added support for ZIP files: any .zip file containing an info.json will automatically be extracted into a folder named after the zip file.
• Fixed a bug where the file watcher could receive null paths, causing errors.
• Improved watcher robustness by handling OVERFLOW events and adding a null check for the watch service when clearing listeners. This fixed many errors with the file listener, its more reliable now

ProtocolLib Integration

• Added the following new ProtocolLib methods:
  • broadcastServerPacket(packet, source, broadcastRange) broadcasts a packet to nearby players.
  • sendServerPacket(player, packet) sends a packet directly to a specific player.
  • createPacket(packetTypePath) creates a packet by type path.

PlaceholderAPI

• Fixed parseString not working correctly when passing an offline player as the target.

Inventory API

• Added the following new methods:
  • getSlot(slot) retrieves the item in a given slot.
  • setItemLore(slot, lore) sets the lore of an item in a slot.
  • setItemName(slot, name) sets the display name of an item in a slot.
• Fixed colors not being applied correctly in item lore.
• Added backwards compatibility for Inventory.setTitle via ProtocolLib.

Service Objects & Internal Refactoring

• Refactored Folia support initialisation for improved performance, including a centralised init() method and pre-cached scheduler.
• Refactored setShared() & getShared() , replacing complex lock logic with a simpler and safer wait()/notifyAll() approach.
• Optimised script preprocessing to read from CODE_CACHE first, avoiding unnecessary disk reads.
• Switched import ID generation in importJavaToJsGC from random strings to an AtomicLong counter (__import_0, __import_1, ...) for better performance.
• Added player permission verification (openjs.use) at the start of onCommand to prevent unauthorised command execution.
• Added Array.from() support.
• Created custom mappings to support Minecraft 1.13 through the current version.
• Fixed importClass() it now correctly translates Java classes into Javascript objects
• Fixed Java.type() it can now correctly read and translate external plugin classes too! This is huge, trust me :)

Thank you, guys, for downloading this plugin. I’ve poured my heart and a lot of passion into this project 💚

Alpha Build - Use at your own risk! Full release soon!

Changelog

General Fixes & Improvements

• Reviewed and fixed numerous bugs across the entire codebase.
• Added a debug mode boolean to the config for easier troubleshooting.
• Fixed a bug where reloading with the reload command would not update the debug mode boolean until a full restart.
• Fixed an issue where deleting folders inside the script folder was not possible due to the file watcher locking them.
• Removed all deprecated code and cleaned up a large portion of the codebase.

Dialog API

• Created a new DialogService for managing in-game graphical dialogs.
• Added NMS support for the Dialog API.
• Added backwards compatibility for Inventory.setTitle via ProtocolLib.

Task API

• Tasks are now shared across all scripts, meaning they can be cancelled from external scripts using setShared and getShared.
• Added task.latch() which returns an object with the following thread-safe methods: .destroy(), .connect(function), .wait(), .invoke(), .fire(), and .Fired.
• Added task.threadType() which returns a string indicating the thread type (main, async, or sync).
• Enhanced thread safety in DelayTask by properly handling thread interruptions.

FileManager API

• Added FileManager.getPath(File), which returns the relative path of a file based on the script's folder.
• Added support for ZIP files: any .zip file containing an info.json will automatically be extracted into a folder named after the zip file.
• Fixed a bug where the file watcher could receive null paths, causing errors.
• Improved watcher robustness by handling OVERFLOW events and adding a null check for the watch service when clearing listeners. This fixed many errors with the file listener, its more reliable now

ProtocolLib Integration

• Added the following new ProtocolLib methods:
  • broadcastServerPacket(packet, source, broadcastRange) — broadcasts a packet to nearby players.
  • sendServerPacket(player, packet) — sends a packet directly to a specific player.
  • createPacket(packetTypePath) — creates a packet by type path.

PlaceholderAPI

• Fixed parseString not working correctly when passing an offline player as the target.

Inventory API

• Added the following new methods:
  • getSlot(slot) retrieves the item in a given slot.
  • setItemLore(slot, lore) sets the lore of an item in a slot.
  • setItemName(slot, name) sets the display name of an item in a slot.
• Fixed colors not being applied correctly in item lore.

Service Objects & Internal Refactoring

• Refactored Folia support initialisation for improved performance, including a centralised init() method and pre-cached scheduler.
• Refactored PublicVarManager's waiting mechanism, replacing complex lock logic with a simpler and safer wait()/notifyAll() approach.
• Optimised script preprocessing to read from CODE_CACHE first, avoiding unnecessary disk reads.
• Switched import ID generation in importJavaToJsGC from random strings to an AtomicLong counter (__import_0, __import_1, ...) for better performance.
• Added player permission verification (openjs.use) at the start of onCommand to prevent unauthorised command execution.
• Added Array.from() support.
• Created custom mappings to support Minecraft 1.13 through the current version.
• Fixed importClass() it now correctly translates Java classes into Javascript objects
• Fixed Java.type() it can now correctly read and translate external plugin classes too! This is huge, trust me :)

This release is just a hotfix, containing crucial fixes and new features.

General Fixes & Improvements

• Migrated from Nashorn 15.6 to 15.7 for better JavaScript compatibility and performance.
• Reduced plugin file size by ~1,000KB through code cleanup and a complete rewrite of the UpdateChecker.
• Fixed an error where task.bindToUnload would crash because the plugin attempted to schedule tasks during the shutdown sequence.
• Resolved a ConcurrentModificationException that occurred when destroying an inventory immediately upon a player closing it.

Custom-Menus Api Updates

• Menu.setTitle(String): Added the missing setTitle method.
• Setting any Menu/Inventory slot to null now automatically converts it to Air instead of throwing a null pointer error.

FileManager Api Updates

The FileManager service has received a few new methods

New Methods:

• getFile(path): Retrieves a specific file.
• removeFile(path): Deletes a file.
• getFolder(path): Retrieves a directory.
• removeFolder(path): Deletes a directory and its contents.
• getFiles(path): Returns an array of all files within the specified folder.

FileManager path prefixes for easier navigation:

• .. (Parent Directory): Jump up one level out of the current folder.
• / (Script Root): Quickly reference the directory where your script is currently located.
• Example: FileManager.getFiles("/"); returns everything in the script's local folder.

Improvements

• Fixed DiskApi issues that caused unexpected behavior
• DiskApi now removes datastore entries when values are NULL
• DiskApi now persists active files on script reload
• Fixed rare ConcurrentModificationException issues when:
  • Registering commands
  • Syncing commands
• Improved error handling: script exceptions now log as ERROR instead of WARN
• All scripts now unload before any other shutdown logic
• Scripts unload asynchronously on the main thread, allowing tasks to finish safely

Additions

• Completely rewritten script management & I/O system
  • Significantly reduces unnecessary disk operations
• Added official folder support for scripts
• Scripts are automatically loaded when added while the server is running
• Added requireScript
• Introduced global [script] class
• Fixed scripts failing to load via command due to parsing errors
• Added task.bindToUnload(function) to register unload handlers
• Yielding operations now block unload until execution completes
• Cache behavior improved:
  • Cache drops only after I/O operations complete
  • Fully handled automatically by scripts

APIs & Services improvements

• Introduced Services API

  • ProtocolLib and PlaceholderAPI are now service-based

• PlaceholderAPI improvements:

  • Fully thread-safe (fixes random unregister issues)
  • OfflinePlayer support
  • Parsing support for offline players

• Added FileSystem Service

  • https://gitlab.com/spidermodders/openjs/-/milestones/3#tab-issues

• Added InventoryApi service for simplified menu & inventory management

• Example Menu

• 

Commands & Runtime fixes

• Refactored addCommand / registerCommand
• Added removeCommand(commandName)
  • Allows scripts to override existing plugin commands

Deprecations

• Added importClass() for runtime class importing
• Deprecated //!import xxx.xxx in favor of importClass()
• Deprecated feature flags / service flags

Configuration & Automation

• Added autoReloadScripts config option
  • Toggle automatic reload when scripts change or are added

Threading & more Folia Support

• Added task.thread(function) for parallel execution
  • This means you can multithread scripts on non-Folia servers now
• Services and PlaceholderAPI are now fully thread-safe

Documentation

• Added "Advanced Guides" section that also explains how to use the new folder support
• Reconstructed everything to find APIs and Methods faster
• Added 3 new example scripts: Food Bait, Nuke Menu and Spawn Menu
• All old example scripts have been updated to use the latest non deprecated methods

OpenJS v1.2.0

Major Changes

• Added official internal support for ProtocolLib
• Introduced BridgeEngine system for external plugin bridges
• Task library now supports creating Java listeners/proxies from scripts
• Universal cleanup system for listeners and proxies
• PlaceholderAPI support now lazy-loads for better performance
• Ported PlaceholderAPI integration to the new BridgeEngine system

Fixes

• Commands now properly unregister
• Fixed placeholders being unregistered after PlaceholderAPI reload
• Fixed nullFailed to unregister all script commands error
• Fixed missing script source name in rare ghost error cases
• Fixed missing tab-completion for the version command

Optimizations

• Minimized IO operations during script loading
• Improved error catching to prevent script freezing
• Removed feature flag limitations

Additions

• Added removePlaceholder(String prefix) for scripts
• Added new commands: /documentation and /page
• Added missing unregisterEvent() method

Documentation

• Updated and extended documentation:
  • Added missing entries: getMethod, removePlaceholder, ProtocolLib
  • Split into cleaner sections to reduce clutter
  • documented how to make scripts interact with external plugins
  • added script example that modifies packets to create custom fluids

---

Sorry for the update delay, I'm currently working on my driving license.
Thanks for your patience and enjoy the update.

Update Log

• Rewritten the async system for full Folia compatibility
• Now finally stable on Folia, a major milestone
• Introduced a new task library: simpler, more intuitive, and fully cross-platform compatible
• Added support for loading .jar files directly into scripts
• Upgraded from ECMAScript 5.1 to ECMAScript 6.0
  (Modern JavaScript features are now available in OpenJS)
• Implemented script security enforcement
• Completed documentation for all previously half-documented components
• added new example script that runs a local ai with the new features
• registerEvent can now take functions directly instead of having to put them in a array

---

We also have a dedicated server now

Need help or want to share your scripts?
Join our Discord for support and discussion

Small patch with new additions

• Fixed Schedules not unregistering on Folia Servers

• Fixed Plugin breaking if PlaceholderApi is not installed

• Fixed /oj reload command on Folia servers

• Added Bstats opt-out option in the configuration file

• Fixed a few weird errors that only occurred on Folia servers

• Fixed the no hit cooldown example script causing errors

• Added 2 new example scripts: hitstand script & Knockback-stick script to the documentation

• Fixed Bstats silently failing to load on Folia servers

OpenJS Update 1.0.6

• A Wiki for OpenJS has been created. Everything is documented from the ground up, although it is not yet fully complete.

• Added official PlaceholderAPI support.

• Introduced a new DiskAPI system for loading and saving files.

• Added a permission system for custom commands.

• Fixed an issue where custom commands were not appearing.

• Fixed scheduling not working correctly.

• Deprecated getVar and setVar due to a memory leak, in favor of the new DiskAPI.