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