Skript is a Bukkit plugin which allows server admins to customize their server easily, but without the hassle of programming a plugin or asking/paying someone to program a plugin for them.
Clone or download
Permalink
Failed to load latest commit information.
.idea Temporarily update IntelliJ code style config for consistency Oct 14, 2018
.settings Change a few things in the compiler's config Oct 14, 2018
docs Use correct English for index.html Oct 14, 2018
gradle/wrapper Update Gradle and ecj Sep 16, 2018
lib Update Residence Dec 22, 2016
skript-aliases @ fe920e9 Add leash holder support ((merge #1482) Oct 12, 2018
src Handle player killing properly (#1615) Oct 19, 2018
.classpath Eclipse config -> Java 8, always Mar 29, 2018
.gitignore Add comments and some files from the .idea directory to .gitignore Jun 20, 2018
.gitmodules Add aliases as submodule; API improvements Jul 19, 2018
.project Update ECJ to work with Java 9 (#1166) Mar 24, 2018
.travis.yml Update .travis.yml Feb 17, 2018
CONTRIBUTING.md Add myself to the reviewers list Feb 20, 2018
LICENSE Contributing guide Aug 22, 2017
PULL_REQUEST_TEMPLATE.md Contributing guide Aug 22, 2017
README.md Merge remote-tracking branch 'origin/master' into 1.13 Sep 2, 2018
build.gradle WorldGuard 7, untested (#1537) Oct 6, 2018
buildbot-compile.sh Test nightly building Sep 16, 2017
gradle.properties Prepare for release Oct 12, 2018
gradlew Fixed issue #850, upgraded gradle wrapper from 3.4.1 to 4.6 and conve… Jun 21, 2018
gradlew.bat Update Gradle wrapper and tweak Maven repositories Sep 20, 2017
insertversion.sh INSERT VERSION replace failed, fix it Aug 25, 2017
licenseheader.txt Update license headers (sorry, commit history) Mar 4, 2017
updaterepo.sh Improve maven publish to take sources too Jun 1, 2017

README.md

Skript Build Status

Skript is a plugin for Bukkit/Spigot, which allows server owners and other people to modify their servers without learning Java. It can also be useful if you do know Java; some tasks are quicker to do with Skript, and so it can be used for prototyping etc.

This Github fork of Skript is based on Mirreski's improvements which was built on Njol's original Skript. It is supported for Spigot (not Bukkit) versions of Minecraft 1.9-1.12. Other versions might work, but no guarantees. Paper is recommended, but not mandatory - without it, some features such as timings will be not available.

Documentation

Documentation is available here for the latest version of Skript.

Reporting Issues

You should use Github issue tracker for all bug reports, feature requests and such. If you are not sure if something is a bug, please still report it.

Please use the search to see if an issue has been reported already. Duplicates will be closed and ignored. If the issue is indeed not yet reported, please use common sense: what might a Skript developer need to know to solve your issue?

If issue has been reported before, and is open, you can comment to it to ask if there has been progress or provide more information. If it has been closed, you can do same thing, but then it might be good idea to ping @bensku and/or @Snow-Pyon since closed issues are not often checked.

Finally, there is no guarantee that an issue will be resolved. Sometimes it might be harder than it sounds to you; in other cases, no one has time to take a look at it.

If your having an aliases issue please report that here instead.

A Note About Addons

Skript developers cannot provide support for third-party addons of Skript. If you encounter issues with them, contact the author of that addon. Also, when reporting issues which seem to be unrelated to addons, you may be asked to test without any addons (and you should do so to get your issue resolved).

That being said, if the addon developer thinks that some bug is caused by Skript, they should report it. We just do not want everyone who has an issue with an addon to clutter Skript's issue tracker; in most cases, we cannot do anything to help.

As a side note, I really, really, discourage making addons closed-source. After all, Skript has been licensed under GPLv3 for ages...

Compiling

Skript uses Gradle for compilation. Use your command prompt of preference and navigate to Skript's source directory. Then you can just call Gradle to compile and package Skript for you:

./gradlew clean build # on UNIX-based systems (mac, linux)
gradlew clean build # on Windows

You can get source code from the releases page. You may also clone this repository, but that code may or may not be stable.

Importing to Eclipse

With new Eclipse versions, there is integrated Gradle support, and it actually works now. So, first get latest Eclipse, then import Skript as any Gradle project. Just make sure to keep the configuration when the importer asks for that!

If you encounter strange issues, make sure you follow the instructions above and have actually downloaded latest Eclipse or update your installation correctly. Skript's new Gradle version (starting from dev26) does not work very well with older Eclipse versions. Also, do not use Gradle STS; it is outdated.

Importing to IDEA

Skript relies heavily on use of nullness annotations and the way how Eclipse interprets them. Thus, using IDEA is not easy. However, if you have truly exceptional new features, I might be able to complete the code with applicable nullness rules. Note that this really means exceptional; adding some expressions and stuff like that do not count.

Contributing

Code guidelines can be found below. You should also see CONTRIBUTING.md for a lot of useful information.

Code Guidelines

So, you want to work with Skript's codebase? There are a few guidelines for you:

  • Understand Java as a language (Skript is not good learning project)
  • Use Eclipse as your IDE for Skript or get your own IDE to support Eclipse's nullness annotations
  • Not to alter Eclipse's nullness annotation settings; they affect even the compiler
  • Use tabs as indentation (provided Eclipse settings will do this)
  • Try to write code that looks similar to Skript's
  • DO NOT use NMS code (Net Minecraft Server)

Of course, these are just recommendations. However, not following them may get your pull requests rejected.

More clear code style guidelines are probably coming in future.

Maven repository

If you use Skript as (soft) dependency for your plugin, and use maven or Gradle, this is for you.

First, you need to add the JitPack repository at the END of all your repositories. Skript is not available in Maven Central.

repositories {
    jcenter()
    ...
    maven { 
        url 'https://jitpack.io' 
    }
}

Or, if you use Maven:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

For versions of Skript after dev37 you might need to add the paper-api repository to prevent build issues.

maven { 
    url 'https://repo.destroystokyo.com/repository/maven-public/' 
}

Or, if you use Maven:

<repository>
    <id>destroystokyo-repo</id>
    <url>https://repo.destroystokyo.com/content/repositories/snapshots/</url>
</repository>

Then you will also need to add Skript as a dependency.

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

An example of the version tag would be dev37c.

Note: If Gradle isn't able to resolve Skript's dependencies, just disable the resolution of transitive dependencies for Skript in your project.

Or, if you use Maven:

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

Note that these repositories are provided as-is, for now. I cannot currently spend time to add nice, but not mandatory, features like Javadoc.

Relevant Links

Note that these resources are not maintained by me. If you notice something wrong with them, do not contact me.

Developers

Current team behind Skript:

Also, of course, we should thank Njol for creating Skript and Mirreski for maintaining it for a long time.

In addition to that, Skript has received a lot of pull requests over time. You can find all contributors here.

All code is owned by it's writer, licensed for others under GPLv3 (see LICENSE) unless otherwise specified.