Coder v2.5.0

A powerful scripting engine for Minecraft. Run Java, Lua, and Python scripts on your server with real-time web editing.

What's New in v2.5.0

• Python runtime management: The plugin downloads and manages the Python interpreter under its runtime directory when Python execution is enabled. Python is no longer bundled through Jython.
• Simplified execution security: The former User Execution Control (UEC) and Java script manager (JSM) systems have been removed.

Features

Scripting Engine

• Multi-language support: Write and execute Java, Python, and Lua scripts on your Minecraft server.
• Unified workspace: Scripts live under the organized Coder/scripts/ folder.
• In-memory Java execution: Load Java code into server memory with /coder load.
• Runtime-managed Python: Python runtime files are downloaded into Coder/runtimes/Python/ and used for Python script execution.
• Clean cache directories: Compiled Java files are separated into runtime and loaded directories.

Addon System

• Addon registry: Plugins can integrate with Coder through CoderAddon.
• Version and dependency gating: AddonManager checks addon requirements before loading.
• Workers/helpers: Addons can expose managed recurring workers through CoderWorker.
• Custom execution handlers: Addons can provide Java, Python, and Lua handlers and preprocessing hooks.
• Custom commands, events, and tab completion: Addons can extend Coder's command and event APIs.
• Shared data store: Addons can store lightweight key/value data.
• Auto-tick and auto-save: Addons can opt into managed periodic callbacks.

Utilities Exposed via CoderAPI

• Messaging: Prefixed success, error, info, warning, debug, and broadcast messages.
• Players: Health, food, experience, game mode, permissions, teleporting, kicking, and location lookups.
• Inventory/items: Give, remove, count, check, and clear inventory items.
• Effects: Sounds, particles, action bars, and titles.
• Scoreboard: Simple sidebar creation and clearing.
• Scheduler: Sync, delayed, async, and repeating task helpers.
• Cooldowns, blocks, and chat helpers: Per-player cooldowns, block operations, and color conversion utilities.
• Server information: MOTD, Bukkit/Minecraft version, TPS, MSPT, tick count, and plugin lookups.

Operations

• Dual backup systems: Automated scheduled backups and instant manual snapshots.
• Graphical Web Interface (GWI): Securely manage, edit, and delete server files remotely.
• Virtual Console Interface (VCI): Run server commands remotely via https://coder-gwieditor.firesmasher.workers.dev/mc-console?=YOUR_TOKEN_HERE.
• Java 25 support: A dedicated Java 25 build is available for newer JVMs.
• Additional utilities: Script access to JetBrains annotations, NBT-API, and Commons Lang3.

GWI Editor Security

GWI sessions use SHA-256 tokens and automatically expire after 30 minutes of inactivity.

Virtual Console Interface Security

The Minecraft console panel blocks /op commands and uses SHA-256 server password tokens. To disable it, remove the value of serverPassword= from /plugins/Coder/.gwi/secure/serverPassword.env.

Quick Start

Workspace Directories

Purpose	Server Path
Scripts directory	/plugins/Coder/scripts/
Execution logs	/plugins/Coder/Logs/
GWI directory	/plugins/Coder/.gwi/
Python runtime	/plugins/Coder/runtimes/Python/

Command Reference

Script Management

• /coder run <filename> - Executes a script.
• /coder load <filename> - Loads and compiles a Java script into server memory.
• /coder unload <filename> - Unloads an active Java class.
• /coder reload <filename> - Reloads plugin configuration or a script.

GWI Web Editor

• /coder editor start - Starts a secure GWI editor session.
• /coder editor trust <username> - Grants access to a pending connection.
• /coder editor do-not-trust <username> - Denies a pending connection.
• /coder editor stop - Terminates the active GWI editor session.

Virtual Console Interface

• /coder gen-pass - Generates a server password for /mc-console/.

System and Maintenance

• /coder backup - Creates an immediate backup.
• /coder auto-backup-start - Starts automatic backups.
• /coder auto-backup-stop - Stops automatic backups.
• /coder reload-config - Reloads config.yml.
• /coder update - Checks for plugin updates.
• /coder update-jar - Downloads and installs the latest plugin version.
• /coder enable-activity-logging - Enables activity logging.
• /coder disable-activity-logging - Disables activity logging.

Coderc

• /coderc run <filename.class> - Runs a compiled class.
• /coderc compile <filename.java> - Compiles a Java file into a class file.

Security Warning

Coder executes Java, Python, and Lua scripts with access to the server environment. Only trusted administrators should manage files in the scripts/ directory.