> ## Documentation Index
> Fetch the complete documentation index at: https://minekube.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Real examples of things you can ask the Minekube AI assistant to do -- from quick commands to complete minigame systems

# Examples

These are real examples of things you can ask the AI. None of these are pre-built commands -- the AI figures out how to accomplish each one on the fly using server commands, Skript scripts, plugins, and WorldEdit.

<Tip>
  You do not need to get the wording exactly right. The AI understands natural language and will figure out what you mean. If it is unsure, it will make its best guess and tell you what it did.
</Tip>

***

## Quick Commands

Simple requests the AI handles in a few seconds:

```
give me creative mode
give me 64 diamonds
teleport me to spawn
set time to day
set difficulty to peaceful
op me
list all players
what's the server TPS?
clear my inventory
set my health to full
give me a diamond sword with sharpness 5
```

***

## Player Management

```
give everyone online a diamond sword
set the spawn point to my current location
enable keep inventory
turn off mob griefing
make it so players can't break blocks within 10 blocks of spawn
whitelist my friend Steve
ban the player named Griefer123
set max players to 50
```

***

## Skript Scripts

The AI writes and installs Skript scripts for custom server mechanics. Each example shows what you say and what the AI does.

<AccordionGroup>
  <Accordion title="Welcome message on join">
    **You say:**

    ```
    when a player joins, send them a welcome message with the server name and player count
    ```

    **AI creates** a `.sk` file like:

    ```skript theme={null}
    on join:
        send "&6Welcome to the server, %player%!" to player
        send "&7There are &f%number of all players%&7 players online." to player
    ```

    The AI saves it, enables it, and confirms it loaded.
  </Accordion>

  <Accordion title="Custom /heal command">
    **You say:**

    ```
    create a /heal command that restores full health and hunger
    ```

    **AI creates:**

    ```skript theme={null}
    command /heal:
        trigger:
            heal player
            set player's food level to 20
            send "&aYou have been healed!" to player
    ```
  </Accordion>

  <Accordion title="Kit system with cooldown">
    **You say:**

    ```
    make a kit system with a starter kit (iron armor, stone sword, 16 steak) that has a 5 minute cooldown
    ```

    **AI creates** a full kit script with cooldown tracking using Skript variables, gives/equips all items, and enforces the timer.
  </Accordion>

  <Accordion title="Event handler -- diamond ore announcement">
    **You say:**

    ```
    when a player breaks a diamond ore, announce it to the server
    ```

    **AI creates:**

    ```skript theme={null}
    on break of diamond ore:
        broadcast "&b%player% &7found a &bdiamond ore&7!"
    ```
  </Accordion>

  <Accordion title="Sidebar scoreboard">
    **You say:**

    ```
    create a sidebar scoreboard showing player kills, deaths, and online time
    ```

    **AI creates** a scoreboard script that tracks stats using variables, updates periodically, and displays them on the sidebar.
  </Accordion>

  <Accordion title="Custom /fly toggle">
    **You say:**

    ```
    make a /fly command that toggles flight for players with the fly.use permission
    ```

    **AI creates:**

    ```skript theme={null}
    command /fly:
        permission: fly.use
        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
    ```
  </Accordion>
</AccordionGroup>

***

## Plugin Management

```
install WorldEdit
what plugins are installed?
install a shop plugin from Modrinth
remove the WorldEdit plugin
install Citizens for NPCs
reload the Skript plugin
```

The AI searches plugin repositories, downloads the right version for Paper 1.21, installs it, hot-loads it with PlugMan, and verifies it works -- all in one step.

***

## World Building

With WorldEdit installed (or ask the AI to install it first):

```
build a 20x20 stone platform at spawn
create a PvP arena with walls and a floor
make a spawn area with a fountain in the center
build a medieval castle with towers and a moat
create a parkour course with increasing difficulty
clear a 50x50 area and flatten it to grass
```

***

## Server Configuration

```
set max players to 50
enable the whitelist and add my friend Steve
change the server MOTD to "Welcome to my server!"
set the world border to 1000 blocks
disable the nether
set difficulty to hard
enable command blocks
turn off fire spreading
make it always daytime
disable phantom spawning
```

***

## Complex Multi-Step Tasks

These requests involve multiple tools, files, and commands. The AI plans the steps, executes them in order, and reports back.

<AccordionGroup>
  <Accordion title="Complete spleef minigame">
    **You say:**

    ```
    create a spleef minigame with:
    - a snow arena that regenerates after each round
    - 2-8 player support
    - countdown timer
    - winner announcement
    - automatic respawn for eliminated players
    ```

    **The AI:**

    1. Installs WorldEdit if not already present
    2. Builds the spleef arena with snow layers
    3. Writes a Skript with join/leave commands, countdown, fall detection, round reset, and winner logic
    4. Tests the commands and confirms everything works
  </Accordion>

  <Accordion title="Full survival server setup">
    **You say:**

    ```
    set up a survival server with:
    - keep inventory enabled
    - no mob griefing
    - starter kit with iron tools
    - welcome message on join
    - spawn protection 16 blocks
    ```

    **The AI:**

    1. Sets game rules (keepInventory, mobGriefing)
    2. Writes a starter kit Skript for first-time joins
    3. Creates a welcome message handler
    4. Configures spawn protection in server.properties
    5. Reloads everything and confirms
  </Accordion>

  <Accordion title="Custom enchantment system">
    **You say:**

    ```
    make a custom enchantment system where:
    - vampiric swords heal on hit
    - explosive pickaxes break 3x3 areas
    - lightning boots strike nearby mobs when walking
    ```

    **The AI** writes a complex Skript with custom item lore detection, event handlers for each enchantment type, and a command to apply enchantments to held items.
  </Accordion>

  <Accordion title="Automated event scheduler">
    **You say:**

    ```
    create an event system that runs a different event every 30 minutes:
    - double XP
    - mob arena
    - treasure drop
    Announce each event to all players
    ```

    **The AI** writes a Skript with a rotating schedule, broadcast announcements, and the mechanics for each event type.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

When something is not working, the AI can diagnose and fix it:

```
why is the server lagging?
check the logs for errors
the kit command isn't working, fix it
reload the welcome script
why can't players break blocks?
what's causing the console errors?
show me the last 20 lines of the server log
```

***

## Tips for Asking

<AccordionGroup>
  <Accordion title="Start simple, then iterate">
    ```
    make a basic PvP arena              <- Start here
    add team selection (red vs blue)     <- Add teams
    add a kill scoreboard                <- Add scoring
    make it best of 3 rounds             <- Add rounds
    add kit selection before each round   <- Add kits
    ```

    Building iteratively gives better results than one massive request.
  </Accordion>

  <Accordion title="Describe the outcome, not the implementation">
    ```
    -- Less effective
    write a skript that listens to PlayerJoinEvent and sends a message

    -- More effective
    when a player joins, welcome them with the server name
    ```

    Let the AI decide the best implementation approach.
  </Accordion>

  <Accordion title="Give context when fixing things">
    ```
    -- Less effective
    fix it

    -- More effective
    the /kit command gives iron armor but it should give diamond armor, fix it
    ```
  </Accordion>
</AccordionGroup>
