Skip to content
Flint
Dokumentation
Start

Introduction

What Flint is, and how these docs are organised.

Flint is a script engine for Minecraft servers. You write scripts in a small, clean language, drop them in a folder, and they handle events, add commands, open menus, talk to databases and send messages across your network. It runs on Paper, Folia and the Velocity proxy.

import time

persist first_seen = {}

on player.join:
    if player.uuid not in first_seen:
        first_seen[player.uuid] = time.now()
        broadcast "<yellow>Welcome <white>{player.name}<yellow>!"
    wait 3 seconds
    player.title("<gold>Hello!", "<gray>Have fun")

command heal(target: player = sender):
    permission "myserver.heal"
    target.heal()
    send "<green>Healed {target.name}" to sender

Why Flint

  • Fast. Scripts are parsed once and compiled to bytecode. Variables are array slots, module functions are resolved when the script loads, and only the events a script actually handles get a listener.
  • wait never blocks. A wait, a database query or a web request pauses only that one script, even in the middle of an expression, and resumes it on the right thread.
  • Batteries included. Menus, boss bars, sidebars, SQL, files, regex, recipes, Vault, PlaceholderAPI and networking are built in.
  • Nothing is out of reach. Any server event can be used by its class name, and any method of the server API can be called. Java developers can add their own modules with the addon API.
  • A real editor. The VS Code extension completes, documents and checks your scripts as you type.

How these docs are organised

  • Guides (this section) explain the language and its features step by step. Start with Getting started.
  • Reference lists every module, function, type and event, generated from the plugin itself, so it always matches the version you download.
  • Press Ctrl K anywhere to search.