Tags
Creators
Details
All versions
1.3.0
Release
OpenJavascript 1.3.09 months ago 132
Compatibility
Minecraft: Java Edition
1.21.x
1.20.x
1.19.x
1.18.x
Platforms
Folia
Paper
Purpur
Changes
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
-
Added InventoryApi service for simplified menu & inventory management
-

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.xxxin favor ofimportClass() - Deprecated feature flags / service flags
Configuration & Automation
- Added
autoReloadScriptsconfig 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
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:zS3HK0Z8:ji7TB8VS"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:zS3HK0Z8:ji7TB8VS"
}

