Skip to content

BytePaper, a ByteSkript -> Paper bridge

License

Notifications You must be signed in to change notification settings

bluelhf/BytePaper

Repository files navigation

BytePaper

GitHub release (latest SemVer including pre-releases)

BytePaper is a ByteSkript library and Paper plugin that bridges the gap between the Minecraft server and the ByteSkript language. It allows you to compile and run ByteSkript scripts (.bsk) that interact with your Paper server, all from in-game commands.

We're still improving!

ByteSkript is a fairly young project, and BytePaper even younger than that. As such, many Skript syntaxes may not be available in BytePaper. If there's one you'd like to see, leave a feature request and we'll get to work adding it ASAP!

Usage

Using BytePaper is simple!

  1. Download the .jar file, and place it in your server's plugins directory
  2. (Re)start your server
  3. BytePaper is now installed! You'll find that a new scripts directory has been created in the plugins/BytePaper/ directory. This is the home of all of your future scripts.
  4. Create a new file with a name ending in .bsk in the newly created directory. This is your first script!
  5. Open the script file in your favourite text editor, and write the following code:
    on script load:
     trigger:
       broadcast mini "<rainbow>Hello, world!</rainbow>"
  6. Join your server and run /bp load <your file's name>
  7. Look at your server console, and notice the message you wrote!

Coming from Skript?

If you've gotten used to the SkriptLang implementation of the Skript language, you've come to the right place! ByteSkript is like Skript, but it's compiled to Java bytecode, making it much faster! There are also some syntactical differences, but you'll get used to them quite quickly.