Lumen

Lumen is a scripting system for Minecraft servers built for speed and simplicity.

You write scripts in .luma files, save them, and they run instantly. No commands, no restart, no waiting.

Scripts are compiled directly into Java bytecode, so they run like real plugins instead of being interpreted.

Quick Example

on join:
    message player "Welcome to the server!"

    if player is a op:
        message player "Hello, admin!"

    if a chance of 50%:
        give player diamond 1

How It Works

Lumen handles everything automatically once your file exists.

1. You create a .luma file
2. Lumen detects it, parses it, and emits Java Code
3. Lumen then compiles the following code
4. The script runs on the server

When you save the file, it reloads immediately. No need to even enter a command.

Features

Commands

Create commands with support for aliases, permissions, and custom namespaces. Everything updates instantly when you change the script.

Events

Use built-in events or connect to more through addons. Works with Bukkit, other plugins, and custom hooks.

Entries

Over 600 built-in patterns including:

• statements
• expressions
• conditions
• blocks

You can also define your own super easily!

Extendable

Lumen exposes the same API it uses internally. You are not locked into a limited system.

Scheduling

Run code later, repeatedly, or at intervals. Changes apply instantly after saving.

VSCode Support

Official VSCode extension helps you write scripts faster with:

• autocomplete
• hover information
• syntax highlighting
• 100% accurate errors!
• MiniColorize support

Links

Reference Documentation https://lumenlang.dev

Documentation https://docs.lumenlang.dev

GitHub https://github.com/LumenLang/lumen

Beta Status

Lumen is currently in beta.

Some parts are still unfinished, and bugs can happen. Updates are frequent and the system is improving quickly.