OpenJavascript

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

• !Example menu made with the InvetoryApi

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