Skript Plugin for Paper/Spigot (1.13.2-1.19.4)

Skript Plugin for Paper and Spigot Servers

Skript is a plugin that lets you write custom scripts for your Minecraft server without needing to learn Java. Whether you’re running a small survival server or managing a large community, Skript makes it easy to add custom features, commands, and mechanics. This fork was built on improvements by Mirreski, which themselves built on the original Skript by Njol.

What You Can Do With Skript

Write server scripts that control custom events, create new commands, modify game mechanics, and automate server tasks. Skript compiles scripts into Bukkit/Spigot code so everything runs at full speed. You write simple syntax instead of dealing with complex Java classes.

Installation

Drop the Skript jar file into your server’s plugins folder and restart. That’s it. The plugin requires Paper (recommended) or Spigot to run. Note that CraftBukkit is not supported.

Server Requirements

• Paper or Spigot server (Paper is strongly recommended)
• Minecraft 1.9 or newer (latest patch versions only)
• For example: 1.19.4 works, but 1.19.3 does not
• Minecraft 1.8 and earlier are not supported

For Developers: Maven and Gradle Setup

If you’re building a plugin that depends on Skript, add the Maven repository to your build config.

Gradle:

repositories {
    maven {
        url 'https://repo.skriptlang.org/releases'
    }
}

dependencies {
    implementation 'com.github.SkriptLang:Skript:[versionTag]'
}

Maven:

<repositories>
    <repository>
        <id>skript-releases</id>
        <name>Skript Repository</name>
        <url>https://repo.skriptlang.org/releases</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.SkriptLang</groupId>
    <artifactId>Skript</artifactId>
    <version>[versionTag]</version>
    <scope>provided</scope>
</dependency>

For Skript versions after dev37, you may also need to add the Paper API repository to avoid build issues.

Compiling From Source

Skript uses Gradle to compile. Run these commands in the Skript source directory:

Mac/Linux:

./gradlew clean build

Windows:

gradlew clean build

You can download source code from the releases page or clone the repository (though the repo code may not always be stable).

Running Tests

Skript includes tests written in Skript itself. The build script sets up a test server automatically. Run tests with these commands:

./gradlew quickTest          # Tests on newest supported version
./gradlew skriptTest         # Tests on Java 8 and Java 17
./gradlew skriptTestJava8    # Tests on oldest supported Java (1.13-1.16)
./gradlew skriptTestJava17   # Tests on newest Java (1.17+)

By running tests, you agree to Mojang’s End User License Agreement.

Setting Up in IDEs

Eclipse: Eclipse now has built-in Gradle support. Just import Skript as a Gradle project and make sure to keep the configuration when prompted. Use the latest Eclipse version; older versions don’t work well with the current Gradle setup.

IntelliJ IDEA: Make sure nullness annotations are configured correctly. Don’t commit any IDEA configuration files when submitting pull requests.

Download Links

Minecraft 1.13.2 to 1.18.2

Minecraft 1.19.4