## EternalScript: A Kotlin Scripting Plugin for Minecraft Paper Servers<\/p>\n
EternalScript allows you to dynamically load and manage code at runtime on your Minecraft Paper server without requiring restarts. It supports diverse customization features like script lifecycle management, event handling, and custom commands.<\/p>\n
### Commands<\/p>\n
Here are the available commands for EternalScript:<\/p>\n
* `\/es compile`: Compiles and loads all scripts within the configured script folder.
\n* `\/es clear`: Unloads all currently loaded scripts.
\n* `\/es config`: Reloads the plugin configuration.
\n* `\/es call [script] [function]`: Calls a function within a specified script.
\n* `\/es load [script]`: Loads a specific script file (e.g., `\/es load “\/hello.kt”`).
\n* `\/es unload [script]`: Unloads a specific script file (e.g., `\/es unload “\/hello.kt”`).
\n* `\/es list`: Lists all currently loaded scripts.<\/p>\n
### Script Lifecycle<\/p>\n
Control how your scripts behave, including performing initial setup when loaded and cleaning up resources when unloaded.<\/p>\n
“`kotlin
\nenable {
\n \/\/ This code runs when the script is loaded\/enabled.
\n Bukkit.broadcastMessage(“Eternal Script: Script loaded!”)
\n}<\/p>\n
disable {
\n \/\/ This code runs when the script is unloaded\/disabled.
\n Bukkit.broadcastMessage(“Eternal Script: Script unloaded!”)
\n}
\n“`<\/p>\n
### Event Handling<\/p>\n
Easily register and handle events directly within your scripts to add custom logic.<\/p>\n
“`kotlin
\nimport org.bukkit.Bukkit
\nimport org.bukkit.event.player.PlayerJoinEvent
\nimport org.bukkit.event.player.PlayerQuitEvent<\/p>\n
event event ### Custom Commands<\/p>\n Define and register your own in-game commands directly from your scripts.<\/p>\n “`kotlin command(“test-command”) { ### Script Inclusion\/Exclusion Rules<\/p>\n Control which scripts the plugin processes.<\/p>\n * `*.kt | *.kts`: Includes all Kotlin files (`.kt`) and Kotlin script files (`.kts`). ### Installation<\/p>\n It’s quick and easy to get EternalScript up and running on your server:<\/p>\n 1. Download the latest version of **EternalScript** from Modrinth. ### Getting Started<\/p>\n Experience the power of EternalScript by writing and running your first Kotlin script:<\/p>\n 1. After installation, a `plugins\/EternalScript\/scripts\/` folder will be created. ### Simple “Hello World” Example<\/p>\n Create a `hello.kt` file in the `plugins\/EternalScript\/scripts\/` folder and enter the following content:<\/p>\n “`kotlin enable { Then, execute `\/es load “\/hello.kt”` from the server console, and you’ll see the message appear in the game chat.<\/p>\n","protected":false},"excerpt":{"rendered":" A scripting plugin for Minecraft Paper servers that dynamically loads and unloads Kotlin scripts at runtime.<\/p>\n","protected":false},"featured_media":65634,"template":"","meta":{"_minecraft_slug":"eternalscript","_minecraft_project_id":"qcSpvUov","_minecraft_author":"VectorTransformation","_minecraft_license":"MIT","_minecraft_downloads":113,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"eternalscript.zip","_minecraft_size_bytes":300014212,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-15T19:22:47.166705Z","_minecraft_date_created":"2025-06-17T09:31:16.842515Z","_minecraft_date_modified":"2026-01-02T22:15:24.072331Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/eternalscript","_minecraft_icon_attachment_id":65634,"_minecraft_imported_at":"2026-06-03T18:33:50+00:00","_minecraft_import_hash":"d7e992ff8986a7fe3c5e6234d8fb497a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,123,92],"mod_loader":[132],"minecraft_version":[38,81],"class_list":["post-65633","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21-4","minecraft_version-1-21-8"],"yoast_head":"\n
\n Bukkit.broadcastMessage(“${event.player.name} joined the server!”)
\n}<\/p>\n
\n Bukkit.broadcastMessage(“${event.player.name} left the server.”)
\n}
\n“`<\/p>\n
\nimport org.bukkit.Bukkit<\/p>\n
\n \/\/ Players need this permission to execute the command.
\n permission = “eternals.command.test”
\n executor = { sender, label, args ->
\n \/\/ This code runs when the command is executed.
\n Bukkit.broadcastMessage(“Command executed by: ${sender.name}”)
\n }
\n}
\n“`<\/p>\n
\n* `-*\/ *.kt | -*.kt`: Ignores specific folders or files (e.g., excludes scripts in subfolders or specific files).
\n* `!*\/* .kt | !*.kt`: Loads specific folders or files synchronously (e.g., processes them before other scripts at server startup).<\/p>\n
\n2. Upload the downloaded file to your Minecraft server’s `plugins` folder.
\n3. Start or restart your server to load EternalScript.<\/p>\n
\n2. Write your Kotlin script file with a `.kt` extension inside this `scripts` folder.
\n3. From the server console, you can use the `\/es load “\/[script].kt”` command to load a specific script, or `\/es compile` to load all scripts within the folder.<\/p>\n
\n\/\/ plugins\/EternalScript\/scripts\/hello.kt<\/p>\n
\n Bukkit.broadcastMessage(“Hello, world!”)
\n}
\n“`<\/p>\n