Skip to content

BytePaper, a ByteSkript -> Paper bridge

License

Notifications You must be signed in to change notification settings

bluelhf/BytePaper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

85e13d2 · Mar 16, 2024
Aug 30, 2023
Jul 12, 2022
Mar 16, 2024
Jul 16, 2022
Sep 3, 2023
Mar 8, 2022
Apr 1, 2022
Sep 3, 2023
Mar 16, 2024
Mar 8, 2022
Jun 15, 2022
Jun 15, 2022
Jun 16, 2022

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.