Skip to main content

​
Requirements

Skript requires Paper to work. Spigot does not work with Skript.
Skript only supports Paper servers. Spigot, CraftBukkit, and other server implementations are not supported.

​
Version Support

Skript supports the last 18 months of Minecraft versions, counting from the release date of Skript’s newest version.
  • New Minecraft versions are supported as soon as possible
  • Two major feature updates are expected each year (January and July)
  • Monthly patches occur between major releases
For the latest supported versions and release schedule, check the release model on GitHub.

​
Installation Steps

1

Download Skript

Download the latest version of Skript from the releases page.Choose the newest .jar file from the latest release.
2

Install the plugin

  1. Stop your Paper server if it’s running
  2. Place the downloaded Skript-[version].jar file into your server’s plugins/ folder
  3. Start your Paper server
The first time Skript loads, it will create a plugins/Skript/ directory with configuration files and example scripts.
3

Verify installation

Once your server has started, run the following command in your server console:
/skript help
If you see Skript’s help menu, the installation was successful!
4

Explore examples

Navigate to plugins/Skript/scripts/-examples/ to find example scripts:
  • events.sk - Event handling examples
  • commands.sk - Custom command examples
  • variables.sk - Variable storage examples
  • loops.sk - Loop examples
  • functions.sk - Function examples
Scripts in folders starting with - (like -examples) are disabled by default. To enable them, move them out of the -examples folder or rename the folder to remove the - prefix.

​
File Structure

After installation, your Skript directory will look like this: 
plugins/Skript/
├── config.sk              # Main configuration file
├── features.sk            # Feature toggles and settings
├── scripts/               # Your scripts go here
│   └── -examples/        # Example scripts (disabled by default)
│       ├── events.sk
│       ├── commands.sk
│       ├── variables.sk
│       └── ...
└── aliases/              # Custom item aliases

​
Commands & Permissions

Skript provides the /skript command (alias: /sk) for managing your scripts.

​
Main Commands

CommandDescriptionPermission
/skript helpShow help menuskript.admin
/skript reload <script>Reload a specific scriptskript.admin
/skript reload allReload all scriptsskript.admin
/skript enable <script>Enable a scriptskript.admin
/skript disable <script>Disable a scriptskript.admin

​
Permissions

PermissionDefaultDescription
skript.adminopAdministrative commands and version notifications
skript.effectcommandsfalseUse effects as commands (e.g., !set health to 10)
skript.see_runtime_errorsopSee runtime error notifications in chat
skript.reloadnotifyfalseGet notified when others reload scripts

​
Next Steps

Quickstart Guide

Create your first Skript and learn the basics

Core Concepts

Understand how Skript works

Example Scripts

Explore more advanced examples

Configuration

Customize Skript’s behavior

​
Troubleshooting

  • Make sure you’re using Paper, not Spigot or CraftBukkit
  • Check that you’re using a supported Minecraft version
  • Look for errors in your server console when starting up
  • Verify the plugin file is in the plugins/ folder
  • Check that script files are in plugins/Skript/scripts/ (not in subfolders starting with -)
  • Ensure files have the .sk extension
  • Look for syntax errors in the server console when reloading
  • Use /skript reload <scriptname> to reload a specific script
  • Verify Skript loaded successfully by checking the console for errors
  • Make sure you have the skript.admin permission
  • Try restarting your server

Build docs developers (and LLMs) love

Get started for freeTalk to us