# Plugin Engine, Live Scripting IDE for Minecraft<\/p>\n
**Write JavaScript or Java in your browser and execute it on your running server, no reload, no restart, no config.**<\/p>\n
Just drop the JAR into `\/plugins`, type `\/plugin-engine` in chat, click the link, and start coding. That’s it.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\udfe1 JavaScript, Instant & No Boilerplate
\nRegister Bukkit event handlers with a single line using the built-in scripting API:<\/p>\n
“`js
\non(“playerJoin”, (player) => {
\n player.sendMessage(“\u00a7aWelcome, \u00a7e” + player.name + “\u00a7a!”);
\n server.broadcast(“\u00a77[\u00a7a+\u00a77] \u00a7a” + player.name + ” joined.”);
\n});<\/p>\n
on(“playerChat”, (player, msg) => {
\n if (msg.startsWith(“!heal”)) player.heal();
\n});
\n“`<\/p>\n
Press **Ctrl+Enter** \u2192 runs live on the server. No classes, no imports, no boilerplate.<\/p>\n
—<\/p>\n
### \u2615 Java, Real Classes, Live Compiled
\nCompile actual Java classes at runtime using the server’s JDK. Supports `implements Listener`, `extends EngineScript`, or any class with a `run(ScriptContext)` method:<\/p>\n
“`java
\npublic class JoinScript extends EngineScript {
\n @Override
\n public void onEnable(ScriptContext ctx) {
\n ctx.listen(PlayerJoinEvent.class, e ->
\n e.getPlayer().sendMessage(“\u00a7aWelcome!”));
\n ctx.scheduleRepeating(() -> ctx.log(“Tick!”), 20L, 20L);
\n }
\n @Override public void onDisable() {}
\n}
\n“`<\/p>\n
*Requires JDK (not just JRE) on the server.*<\/p>\n
—<\/p>\n
### \ud83c\udf10 Zero Config, Works Out of the Box
\nPlugin Engine automatically connects to the hosted cloud backend at **gianhosting.tech**. No API keys, no shared secrets, no reverse proxy setup required.<\/p>\n
– Install JAR \u2192 start server \u2192 type `\/plugin-engine` \u2192 get a link \u2192 code.
\n– The plugin generates a unique server ID on first start and connects automatically.
\n– Want to self-host the backend? The Node.js backend is open source.<\/p>\n
—<\/p>\n
### \ud83d\udd12 Secure Session Links
\n– Sessions are tied to your **Minecraft account**, identity cannot be spoofed.
\n– Each link is a one-time personalized token, valid for **60 minutes** (configurable).
\n– All session routes are protected by session validation on every request.
\n– Security headers (CSP, X-Frame-Options, Referrer-Policy, Permissions-Policy) on all session pages.<\/p>\n
—<\/p>\n
### \ud83d\uded2 Community Script Marketplace
\nShare your scripts with the community and discover scripts made by others, directly from within the IDE.<\/p>\n
– **Uploader identity is verified** through the Minecraft session: the player name is pulled from the authenticated Minecraft session, not user input. It cannot be faked.
\n– Every script shows a warning that community code should be reviewed before execution.
\n– Filter by JS \/ Java, search by name, author, or description.
\n– Your own scripts show a delete button.<\/p>\n
—<\/p>\n
### \ud83d\udd04 Scripts Survive Sessions & Restarts
\nScripts **keep running** after your session ends, they are not tied to the browser tab.<\/p>\n
– Use `\/plugin-engine stop` to explicitly stop all scripts (admin-only).
\n– Mark any script as **Auto-Start** in the IDE: it will be saved to disk and re-executed automatically every time the server starts, with no further action required.
\n– Auto-Start entries are stored in `plugins\/PluginEngine\/startup.json`.<\/p>\n
—<\/p>\n
### \ud83d\udcbe Script Storage
\nSave and load your scripts from within the IDE. Storage can be:<\/p>\n
– **Global** (`global-storage: true`, default), all players on the server share one script library.
\n– **Per-player** (`global-storage: false`), each player gets their own `scripts\/{name}\/` folder.<\/p>\n
—<\/p>\n
## \ud83d\ude80 Getting Started<\/p>\n
**1. Install**
\nDrop `PluginEngine-1.0.0.jar` into your server’s `\/plugins` folder and restart.<\/p>\n
**2. Open the IDE**
\nIn Minecraft chat, type:
\n“`
\n\/plugin-engine
\n“`
\nA clickable link appears in chat. Click it to open the browser IDE.<\/p>\n
**3. Write & Execute**
\nSelect JavaScript or Java, write your code, press **Ctrl+Enter**.<\/p>\n
That’s everything. No configuration required.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration (`config.yml`)<\/p>\n
| Option | Default | Description |
\n|—|—|—|
\n| `port` | `5000` | Port for the built-in web server (fallback if no backend) |
\n| `max-sessions` | `5` | Maximum number of simultaneous open sessions |
\n| `session-duration-minutes` | `60` | How long a session link stays valid |
\n| `global-storage` | `true` | `true` = shared script folder, `false` = per-player folders |
\n| `backend-url` | `wss:\/\/gianhosting.tech\/plugin-wss` | WebSocket URL of the backend |
\n| `public-url` | `https:\/\/gianhosting.tech` | Public URL used in session links |
\n| `server-id` | *(auto-generated)* | Unique identifier for this server, do not edit manually |<\/p>\n
You don’t have to change anything, everything is already setup.<\/p>\n
—<\/p>\n
## \ud83d\udccb Permissions<\/p>\n
| Permission | Default | Description |
\n|—|—|—|
\n| `pluginengine.use` | `op` | Open a session and use the IDE |
\n| `pluginengine.admin` | `op` | Access to `\/plugin-engine stop` and `revoke all` |<\/p>\n
—<\/p>\n
## \ud83d\udda5\ufe0f Commands<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/plugin-engine` | Open a new session and receive a link |
\n| `\/plugin-engine revoke` | End your own sessions (scripts keep running) |
\n| `\/plugin-engine stop` | Stop all running scripts **[Admin]** |
\n| `\/plugin-engine status` | Show active sessions, script count, backend status |
\n| `\/plugin-engine help` | Show all available commands |<\/p>\n
Aliases: `\/pe`, `\/peng`<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements<\/p>\n
– **Paper** 1.21 or higher (Spigot is not officially supported)
\n– **Java 21** or higher
\n– **JDK** (not just JRE), required for Java compilation. JavaScript works without JDK.<\/p>\n
—<\/p>\n
## \ud83d\udd27 JavaScript API Reference<\/p>\n
“`js
\n\/\/ Event handler
\nconst id = on(“eventName”, callback) \/\/ register
\noff(id) \/\/ unregister<\/p>\n
\/\/ Events
\n“playerJoin” \/\/ (player)
\n“playerQuit” \/\/ (player)
\n“playerDeath” \/\/ (player)
\n“playerRespawn” \/\/ (player)
\n“playerMove” \/\/ (player)
\n“playerInteract” \/\/ (player)
\n“playerChat” \/\/ (player, msg)
\n“blockBreak” \/\/ (player, block)
\n“blockPlace” \/\/ (player, block)<\/p>\n
\/\/ Player
\nplayer.name player.health player.gameMode
\nplayer.sendMessage(“\u00a7aText”)
\nplayer.kick(“reason”)
\nplayer.teleport(x, y, z)
\nplayer.giveItem(“DIAMOND”, 1)
\nplayer.heal()
\nplayer.setGameMode(“creative”)<\/p>\n
\/\/ Server
\nserver.broadcast(“\u00a76Text”)
\nserver.runCommand(“say hello”)
\nserver.getOnlinePlayers()
\nserver.getTPS()<\/p>\n
\/\/ Logging
\nlog(“message”)
\n“`<\/p>\n
—<\/p>\n
## \u2753 FAQ<\/p>\n
**Does this work without internet?**
\nYes. If the cloud backend is unreachable, the plugin falls back to the built-in web server on the configured `port`. You can also set `backend-url` to blank in `config.yml` to always use the local server.<\/p>\n
**Are scripts persisted across reloads?**
\nScripts in memory are lost on `\/reload` or restart. Use the **Auto-Start** feature in the IDE to re-execute scripts automatically on every server start.<\/p>\n
**Can players grief with this?**
\nThe `pluginengine.use` permission defaults to `op`. Only grant it to trusted players. Scripts run with full server permissions, treat them like plugins.<\/p>\n
**Why does Java compilation require JDK?**
\nThe `javax.tools.JavaCompiler` API used for runtime compilation is only available in a JDK, not a plain JRE. Most server hosting providers include a JDK; if yours doesn’t, JavaScript still works without it.<\/p>\n
**Is the cloud backend safe?**
\nThe server authenticates to the backend using its auto-generated UUID `server-id` (stored in `config.yml`). This ID acts as a 128-bit random secret. Don’t share your `config.yml`.<\/p>\n
—<\/p>\n
*Built with Mozilla Rhino for JavaScript \u00b7 Ace Editor \u00b7 Fastify backend on Raspberry Pi via Cloudflare Tunnel*<\/p>\n","protected":false},"excerpt":{"rendered":"
Plugin Engine is a live scripting IDE for Minecraft that lets you write and execute JavaScript or Java directly on a running server through a browser, without restarts or configuration. It also provides secure session-based access, persistent scripts, and<\/p>\n","protected":false},"featured_media":123046,"template":"","meta":{"_minecraft_slug":"plugin-engine","_minecraft_project_id":"CwyKVNAi","_minecraft_author":"Gian552","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":1,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"plugin-engine.zip","_minecraft_size_bytes":44858651,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:20:55.634083Z","_minecraft_date_created":"2026-05-05T21:02:34.716159Z","_minecraft_date_modified":"2026-04-26T18:31:03.312068Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/plugin-engine","_minecraft_icon_attachment_id":123046,"_minecraft_imported_at":"2026-06-07T05:40:20+00:00","_minecraft_import_hash":"b4e8bb0e39d2cf2425c5781b05c2decd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,91,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-123045","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-storage","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n