Minecraft Skript Tutorial

Skript is the easiest way to add custom behaviour to a Minecraft server without writing Java. If you can read English-like configs, you can write Skript. This tutorial gets you from install to a working custom scoreboard and welcome system.

1. Install

Download Skript from the GitHub releases (build for your Minecraft version) and drop into plugins/. Restart. You'll see a new folder plugins/Skript/scripts/. Files in there ending in .sk are loaded automatically.

2. Your first script

Create plugins/Skript/scripts/welcome.sk:

on join:
    send "&aWelcome to the server, %player%!" to player
    send title "&6Welcome" with subtitle "&7Type /help to begin" to player for 4 seconds

Indent with 4 spaces (or one tab) consistently. Reload with /sk reload welcome.

3. Variables

Skript variables are persistent by default. Three scopes:

• {var}, global, persistent across restarts.
• {_var}, local, dies at end of trigger.
• {var::%player%}, list-style, indexed.

on join:
    add 1 to {joins::%player's uuid%}
    send "&7You have joined %{joins::%player's uuid%}% times."

4. Commands

command /heal <player>:
    permission: server.heal
    trigger:
        heal arg-1
        send "&aHealed %arg-1%."

5. Events

Skript covers nearly every Bukkit event. Common ones:

• on damage:
• on death: / on death of player:
• on right click on a chest:
• on break of diamond ore:

6. A working scoreboard

You'll need an addon: install SkBee alongside Skript.

every 1 second in "world":
    loop all players:
        set {_score} to {coins::%loop-player's uuid%} ? 0
        set scoreboard of loop-player to "&6&lMY SERVER" with lines:
            ""
            "&7Coins: &f%{_score}%"
            ""
            "&8play.example.com"

7. Useful addons

• skript-reflect, arbitrary Java reflection from Skript.
• SkBee, scoreboards, NBT, recipes, bossbars.
• skquery / skript-mirror, older but still useful for niche features.

8. Common pitfalls

• Mixing tabs and spaces in one file, Skript will silently skip the script.
• Using %player% in async events without storing it first.
• Heavy loops in every 1 second, you can tank the main thread fast.

Where to go next

Skript pairs well with PlaceholderAPI (read placeholders inline), EssentialsX (Vault econ in one line: add 100 to player's balance), and MythicMobs (custom drops triggered from Skript events).

Looking for a server that nails this setup end-to-end? Try Astroworld MC, economy survival, custom bosses, full crossplay.

Questions about Minecraft Skript

What exactly is Minecraft Skript doing here?

Skript is the easiest way to add custom behaviour to a Minecraft server without writing Java.

What should Minecraft Skript measure out at?

Heavy loops in every 1 second, you can tank the main thread fast.

What do you type for Minecraft Skript?

Create plugins/Skript/scripts/welcome.sk: Indent with 4 spaces (or one tab) consistently. This guide uses /sk reload welcome.

Minecraft Skript: what does 2. your first script mean here?

This tutorial gets you from install to a working custom scoreboard and welcome system.