Skript Basics

Understanding Skript on your Minekube AI server — what it is, how the AI uses it, and examples of what it can create

Skript Basics

Skript is a scripting language for Minecraft servers that reads almost like English. It is the AI’s primary tool for creating custom game mechanics, commands, events, and automation on your server.

---

You Do Not Need to Learn Skript

The AI writes all the Skript code for you. Just describe what you want in plain language:

make a /home command that saves and teleports to a location
create a leveling system that gives XP for mining
when it rains, give all players speed 2
announce "Server restarting in 5 minutes" every hour

The AI handles the syntax, saves the file, enables the script, and verifies it works.

Understanding the basics helps you ask better questions and troubleshoot issues, but it is entirely optional. Many players never look at a single line of Skript code.

---

What Skript Can Do

Custom Commands

/heal, /home, /kit, /spawn, /fly, /tpa — any command you can imagine

Event Handlers

React when players join, break blocks, kill mobs, craft items, open doors, etc.

Scheduled Tasks

Run actions every 5 minutes, at midnight, after a delay, or on a timer

Player Variables

Store data per player: homes, stats, cooldowns, balances, levels

Conditions and Logic

If player has permission, if it is raining, if inventory is full, if score > 10

Scoreboards and UI

Sidebar scoreboards, action bar messages, boss bars, titles

---

Example: Custom Command

You say: “make a /fly command that toggles flight for players with the fly.use permission”

The AI creates:

command /fly:
    permission: fly.use
    permission message: &cYou don't have permission to fly.
    trigger:
        if player's flight mode is true:
            set player's flight mode to false
            send "&cFlight disabled." to player
        else:
            set player's flight mode to true
            send "&aFlight enabled!" to player

Key parts:

• command /fly: — defines the command
• permission: fly.use — only players with this permission can use it
• trigger: — the code that runs when the command is used
• if/else — conditional logic

---

Example: Event Handler

You say: “when a player joins for the first time, give them a starter kit”

The AI creates:

on first join:
    give player iron sword
    give player 32 steak
    give player iron helmet
    give player iron chestplate
    give player iron leggings
    give player iron boots
    send "&6Welcome to the server! Here's a starter kit." to player

Key parts:

• on first join: — triggers only the first time a player joins
• give player — adds items to the player’s inventory
• send — sends a chat message to the player

---

Example: Variables and Cooldowns

You say: “create a /kit command with a 5 minute cooldown”

The AI creates:

command /kit:
    trigger:
        if {kit.cooldown.%player's uuid%} is set:
            set {_remaining} to difference between {kit.cooldown.%player's uuid%} and now
            send "&cKit on cooldown! Wait %{_remaining}%." to player
            stop
        give player diamond sword
        give player 16 golden apples
        set {kit.cooldown.%player's uuid%} to 5 minutes from now
        send "&aKit received! Next use in 5 minutes." to player

Key parts:

• {kit.cooldown.%player's uuid%} — a variable stored per player
• difference between ... and now — calculates remaining cooldown time
• stop — exits the command early

---

Example: Scheduled Task

You say: “every 30 minutes, announce a random tip to all players”

The AI creates:

every 30 minutes:
    set {_tips::*} to "Use /kit for free gear!", "PvP arena is at /warp arena!" and "Join our Discord for events!"
    set {_tip} to random element of {_tips::*}
    broadcast "&e[Tip] &f%{_tip}%"

---

Managing Scripts

You can ask the AI to manage your scripts at any time:

show me all loaded scripts
reload the home script
disable the pvp script
edit the welcome script to also give players 10 XP levels
delete the old test script
what scripts are running?

Scripts are stored at /plugins/Skript/scripts/ on your server and persist across restarts and hibernation. The AI can read, write, enable, disable, and reload them.

---

Skript + skript-reflect

Your server also has skript-reflect installed, which gives Skript access to the full Java/Bukkit API. This means the AI can write scripts that do things normally requiring a Java plugin:

• Access any Bukkit/Paper API method
• Work with packets and NMS
• Interact with other plugin APIs
• Handle complex data structures

You do not need to know about this — the AI uses skript-reflect automatically when a task requires it.