OpenJavascript

## Important changes: * **task.repeat(delay, period)**: **period** has been changed from **ticks to seconds**. A new **ticks()** method has been added, to use ticks instead of seconds, wrap the value like `task.repeat(delay, ticks(period))`. * The `ticks()` method can be used in any task method that takes seconds as an argument, letting you pass tick values instead. * all minecraft versions below 1.18 are no longer supported! ## Welcome OpenJS Intellisense!  * You can now download the extension in VSCode and get full autocompletion for OpenJS scripts! * Simply run `/oj generatetypes` in the server console and follow the steps shown after the types have been generated. * Search for "OpenJS IntelliSense" in the Extensions marketplace on VSCode, or download it directly from the [marketplace page](https://marketplace.visualstudio.com/items?itemName=SpiderModders.openjs-intellisense). ## Compatibility & Multi-Version Support * Added support for Minecraft version **26.X**, including full compatibility testing for the Dialog and Inventory APIs. * Fixed **Cardboard** incompatibility. * Fixed Minecraft version detection breaking on **Spigot**. * Fixed the **Inventory API** being broken on **26.X** and on **Spigot** ## Task API * Rewrote **Folia scheduling** to use the Folia scheduler directly, reducing check calls and improving performance. * Fixed task overflow after ~27 days of uptime * Allowed **0-second delays** for the task API on Folia servers. * Added `ticks(ticks)`, letting all task API methods work in ticks instead of seconds. * Fixed a memory leak in `task.latch.listener()` where listeners were never garbage collected without a held reference. ## Dialog API * Added tooltip support for dialog buttons: `Dialog.baseButton.tooltip(text)` and `Dialog.setTooltip(buttonId, text)`. * Added a new **serverScreen** dialog for showing dialogs when a player joins the server. * Added the ability to pass an `Audience` into `dialog.show()` to support serverScreen dialogs. ## Dependency Management * Added `downloadDependency()`, letting scripts pull in dependencies directly from Maven repositories. * Downloaded dependencies are now cached and usable via `importClass()`. * Added `loadDependency(folder)` to load a dependency directly from any local path. * Imported libraries and dependencies can now also be loaded through `importClass()` and `Java.type()`. ## Intellisense Extension * Fixed type generation issues in the extension's Typegen. * Removed the leftover `$` placeholder from generated types. * Added the `plugin` global to intellisense. * Added a `Typegen` entry to the in-game help command. * Added more detailed error logging for the type generator. * Included missing `java.lang` class types in Typegen, complete with generated Javadocs. * Added a progress bar for Javadoc generation, since it can take a while. * Extension now uses the newly imported `java.lang` classes instead of relying on pre-built dummy classes. * Generated types now live in `plugins/OpenJS/scripts/.openjs-types/generated`, and the extension automatically detects and applies them * Added a new **"Auto Apply Definitions"** command to simplify type detection without needing to open a workspace. * Enabled type checking so the extension can now catch errors, not just autocomplete. * Fixed `importClass("")` autocomplete not triggering when the quotes were already typed. * Fixed `FileManager` service methods not autocompleting for existing files. ## Performance & Internal Refactoring * Scripts now get **force-compiled**, with compiled code cached to disk and reloaded on server restart, reducing script load times. * Reduced plugin file size after removing the old Folia scheduler and rewriting it. * Refactored script globals into a unified `ScriptGlobals` class. * Fixed 5 separate memory leaks, including one in the `FoliaSupport` class. * Improved overall main-thread performance. * Fixed debug logs not appearing during server initialization. * Added Bstats as a dependency. The goal of this update was to make the plugin more stable and reliable, so there are no more weird crashes or memory leaks. The documentation is still being updated to reflect the changes in this release. Thanks for your patience, everyone. This update took a while, mostly because of the VSCode extension.

 ## 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](https://openjs.wiki.gd/rescources/advanced-guides/creating-modular-scripts-and-converting-them-to-plugins)) **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](https://openjs.wiki.gd/apis-and-tools/services/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`](https://openjs.wiki.gd/apis-and-tools/globals/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):**](https://openjs.wiki.gd/apis-and-tools/services/inventoryapi#settitle) Added the missing `setTitle` method. * [Setting any Menu/Inventory slot](https://openjs.wiki.gd/apis-and-tools/services/inventoryapi#setslot) to `null` now automatically converts it to **Air** instead of throwing a null pointer error. ## FileManager Api Updates The [`FileManager`](https://openjs.wiki.gd/apis-and-tools/services/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`](https://openjs.wiki.gd/apis-and-tools/services/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](https://docs-mc-1.gitbook.io/openjs-docs/rescources/advanced-guides/managing-and-organizing-scripts-with-folders) for scripts - Scripts are automatically loaded when added while the server is running - Added [requireScript](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/requirescript) - Introduced global [`[script]`](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/script) class - Fixed scripts failing to load via command due to parsing errors - Added [`task.bindToUnload(function)`](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/task#bindtounload) 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](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/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](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/services/filemanager) Service - https://gitlab.com/spidermodders/openjs/-/milestones/3#tab-issues - Added [InventoryApi](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/services/inventoryapi) service for simplified menu & inventory management - [Example Menu](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/entity-spawn-menu) -  ## Commands & Runtime fixes - Refactored addCommand / registerCommand - Added [`removeCommand(commandName)`](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/removecommand) - Allows scripts to override existing plugin commands ## Deprecations - Added [`importClass()`](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/importclass) for runtime class importing - Deprecated `//!import xxx.xxx` in favor of [`importClass()`](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/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)`](https://docs-mc-1.gitbook.io/openjs-docs/apis-and-tools/globals/task#thread) 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"](https://docs-mc-1.gitbook.io/openjs-docs/rescources/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](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/food-bait-for-animals), [Nuke Menu](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/nuke-dropper-menu) and [Spawn Menu](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/entity-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](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins/protocollib-integration) - Introduced BridgeEngine system for [external plugin bridges](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins) - [Task library](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/in-build-classes/scheduling) 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](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins/placeholderapi) 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](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/fflags) limitations ### Additions - Added [removePlaceholder(String prefix)](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins/placeholderapi#removing-placeholders-with-scripts) for scripts - Added new commands: `/documentation` and `/page` - Added missing [unregisterEvent()](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/events/events) method ### Documentation - Updated and extended documentation: - Added missing entries: [getMethod](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins/unsupported-plugin-integration), [removePlaceholder](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins/placeholderapi#removing-placeholders-with-scripts), [ProtocolLib](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins/protocollib-integration) - Split into cleaner sections to reduce clutter - documented how to make scripts [interact with external plugins](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/interacting-with-external-plugins) - added [script example that modifies packets to create custom fluids](https://docs-mc-1.gitbook.io/openjs-docs/rescources/example-scripts/custom-fluids-with-protocollib) --- 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](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/scheduling): simpler, more intuitive, and fully cross-platform compatible - Added support for [loading `.jar`](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/javainscripts) 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](https://docs-mc-1.gitbook.io/openjs-docs) for all previously half-documented components - added [new example script](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/aichatbotexample) that runs a local ai with the new features - [registerEvent](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/events) 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](https://discord.gg/XuRC4at2Ha) 

# Small patch with new additions - Fixed [Schedules](https://docs-mc-1.gitbook.io/openjs-docs/openjs-components/scheduling) 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](https://docs-mc-1.gitbook.io/openjs-docs/getting-started/configdocs) file - Fixed a few weird errors that only occurred on Folia servers - Fixed the [no hit cooldown](https://app.gitbook.com/o/lJVeDfFucKbRvA1nGFas/s/ninfHRqxK6AQQSdjX6JX/example-scripts/nohitcooldown) example script causing errors - Added 2 new example scripts: [hitstand script](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/hitstandcmdexample) & [Knockback-stick script](https://docs-mc-1.gitbook.io/openjs-docs/example-scripts/knockbackstick) to the [documentation](https://docs-mc-1.gitbook.io/openjs-docs) - Fixed Bstats silently failing to load on Folia servers