DOCUMENTATION

The complete
Lumen reference

Everything you need to write Lumen scripts. Browse 514 entries across statements, expressions, conditions, blocks, loop sources, types, and events.

welcome.luma

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

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

    if chance 50%:
        give player diamond 1
        message player "You got a diamond!"

Compiled Performance

Scripts compile to Java bytecode and execute almost identically to hand-written plugin code with zero interpretation overhead.

Hot Reloading

Watches your script files and reloads on save. No server restart or commands needed. Full unload and reload support included.

Clean Syntax

Indentation-based, inspired by Skript. No brackets, no semicolons, no boilerplate.

Looking for examples and guides?Visit docs.lumenlang.dev for tutorials, in-depth examples, and everything you need to get started with Lumen.

Open docs

Browse the Reference

Jump into any section to explore the full syntax documentation.