# EventJS<\/p>\n
is a KubeJS addon that adds reloadable native events for KubeJS.<\/p>\n
With EventJS, you can<\/p>\n
* refresh your native event listeners without restarting the whole game or store the handler within a `global[‘someId’]`, which is both simpler and more performant.
\n* add\/remove native event listeners as you like without relaunching, which was impossible in KubeJS for 1.16-1.20
\n* prevent your game from crashing if something goes wrong in your native event listener
\n* add event listener only in server\/client side<\/p>\n
## Usage<\/p>\n
By default, EventJS will replace the original native event listening method to make it reloadable. So you actually don’t need to learn anything new in order to use EventJS, just install it and you Forge event listening is reloadable now.<\/p>\n
But, if you’re looking for some more dynamic and well-defined event listending, you can use `NativeEvents.onEvent(…)`, and `NativeEvents.onGenericEvent(…)` for generic event listening.<\/p>\n
`NativeEvents` will be avaliable for all 3 script types (client\/server\/startup), so you can perform sided event listening, that is, for example, listen to client-only event in `client_scripts`, then this event listening will not happen on server side.<\/p>\n
### Syntax (v1.0.0~1.3.0)<\/p>\n
“`js
\nNativeEvents.onEvent(eventType, handler)
\nNativeEvents.onEvent(priority, receiveCancelled, eventType, handler)
\nNativeEvents.onGenericEvent(genericClassFilter, eventType, handler)
\nNativeEvents.onGenericEvent(genericClassFilter, priority, receiveCancelled, eventType, handler)
\n“`<\/p>\n
The `handler` in JS side, is a callback that receives the event, for example: `(event) => {…}`<\/p>\n
The `eventType` and `genericClassType` is something that can represent a class, like a string that holds the event class name, or the event class itself loaded by `java(…)` or `Java.loadClass(…)`.<\/p>\n
“`typescript
\nlet handler: (event: AnyForgeEvent) => void
\nlet eventType: string | Class
\nlet genericClassFilter: string | Class
\nlet priority: $EventPriority | “highest” | “high” | “normal” | “low” | “lowest”
\nlet receiveCancelled: boolean
\n“`<\/p>\n
### Changes in 1.4.0<\/p>\n
In EventJS 1.4.0, in order to support ProbeJS Legacy out of the box, the `eventType` and `genericClassFilter` will only actively support `Class` loaded via `java(…)` (1.16.5) or `Java.loadClass(…)` (1.20.1).<\/p>\n
“`typescript
\nlet eventType: Class
\nlet genericClassFilter: Class
\n“`<\/p>\n
## Supported Version<\/p>\n
1.0.0: 1.16.5<\/p>\n
1.1.0: 1.16.5, 1.20.1<\/p>\n
1.2.0: all major version between 1.16 and 1.20<\/p>\n
## Do You Know That<\/p>\n
The reason why I make this mod is that KubeJS is absurdly slow in implementing similar features. They added native event listener reloading only after KubeJS updated to 1.21, leaving all versions between 1.16~1.20 behind.<\/p>\n
KubeJS for 1.21+ also contains support for native event listener reloading, using the same name `NativeEvents`, but its implementation is not the same as EventJS, so please dont make assumptions when interacting EventJS internals via Java.<\/p>\n","protected":false},"excerpt":{"rendered":"
Sided reloadable native event for KubeJS<\/p>\n","protected":false},"featured_media":65960,"template":"","meta":{"_minecraft_slug":"eventjs","_minecraft_project_id":"Pubv5FOl","_minecraft_author":"ZZZank","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":33095,"_minecraft_follows":5,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"eventjs.zip","_minecraft_size_bytes":94611,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T15:23:42.944553Z","_minecraft_date_created":"2025-05-31T22:42:02.748390Z","_minecraft_date_modified":"2025-05-27T00:51:41.057626Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/eventjs","_minecraft_icon_attachment_id":65960,"_minecraft_imported_at":"2026-06-03T18:57:02+00:00","_minecraft_import_hash":"178a3fef8f24f56a9c91405b9a2d8876","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,873,92],"mod_loader":[106],"minecraft_version":[48,36],"class_list":["post-65959","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-library","mod_category-utility","mod_loader-forge","minecraft_version-1-16-5","minecraft_version-1-20-1"],"yoast_head":"\n