JavaSkript

What is JavaSkript?

JavaSkript is a plugin for Paper and Folia that runs plain .java files as server scripts. It compiles them in memory and reloads them when you save, so you can add commands, events, GUIs and other server logic without setting up a plugin project, building a jar, or restarting the server.

Security Warning

Scripts run with plugin-level access. Review scripts before loading them.

Example

import dev.mukulx.javaskript.script.FoliaSupport;
import net.kyori.adventure.text.Component;
import net.kyori.adventure.text.format.NamedTextColor;
import org.bukkit.command.*;
import org.bukkit.entity.Player;

@FoliaSupport
public class HealCommand implements CommandExecutor {

  @Override
  public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
    if (!(sender instanceof Player player)) return true;
    player.setHealth(player.getMaxHealth());
    player.sendMessage(Component.text("Healed", NamedTextColor.GREEN));
    return true;
  }
}

Save it as HealCommand.java in plugins/JavaSkript/scripts/. The /heal command registers by itself.

What you get

• Hot reload and background compiling
• Several classes per file
• Maven Central libraries loaded on demand
• Commands, permissions and tab completion without plugin.yml
• Built-in scheduler, config, SQLite database, GUI builder, economy, teams, boss bars, mannequins, advancements and resource packs
• Paper and Folia support

Requirements

• Paper or Folia 1.21+ (not Spigot or Bukkit)
• Java 21+

Install

Put the jar in plugins/ and restart once. Scripts go in plugins/JavaSkript/scripts/. Example scripts ship inside the jar under examples/.

Commands

Permission: javaskript.admin. Aliases: /js, /jskript.

/js reload | restart | configreload | list | load | unload | enable | disable | info | profile | benchmark

Links

Docs · Community scripts · Issues · Source · Discord