FlatScript

FlatScript is a lightweight, no-indent scripting language for Minecraft servers running Paper 1.20.1 – 1.21.4. It allows server owners to create custom features without writing a single line of Java.

Features include simple syntax with no indentation, brackets, or semicolons. You can create custom commands like /kit, /heal, or /fly. The event system triggers scripts on player join, quit, death, chat, move, damage, and more. GUI menus allow you to create interactive shops with clickable buttons. The NBT system stores persistent data on players, items, and entities. The random system generates random numbers, picks random items from lists, and checks chances. MiniMessage and RGB support provides gradient text and hex colors. Clickable links open URLs in the player's browser. The cooldown system limits how often players can use commands. Particle and sound effects can be spawned anywhere. Title and action bar messages are fully supported. Teleportation to specific coordinates or spawn is available. Gamemode changes are simple to implement. PlaceholderAPI support allows any placeholder to be used. Vault support enables checking balances, giving money, and taking money. The addon system allows developers to extend FlatScript with custom functions, conditions, and effects.

Example command script:

command /kit:
    cooldown check kit 60 &cWait {time} seconds!
    give player 1 diamond_sword
    give player 16 steak
    send player &aKit received!
    effect player speed 30
    play_sound player ENTITY_PLAYER_LEVELUP 1 1

Example event script:

on player join:
    send player &6Welcome %player%!
    give player 1 cookie
    broadcast server: &e%player% joined the game!

Example GUI script:

gui shop:
    title &6&lITEM SHOP
    rows 3
    button 11 &aDiamond Sword "give player 1 diamond_sword"
    button 13 &bGolden Apple "give player 1 golden_apple"
    button 22 &cClose "gui close"

command /shop:
    gui open shop

Commands: /fs reload - Reload all scripts /fs help - Show help menu

Installation:

1. Download FlatScript.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Create .fs files in plugins/FlatScript/scripts/
5. Run /fs reload to load your scripts

Requirements:

• Paper 1.20.1 – 1.21.4 (also works on Purpur, Pufferfish, and other Paper forks)
• Java 17 or higher
• No dependencies required (PlaceholderAPI and Vault are optional)

License: This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

Copyright © 2026 VoidOaz (FlatScript Team).