JavaSkript

JavaSkript lets you create Paper server scripts using simple .java script files. Make changes instantly without setting up a full development environment or restarting your server.

Автор: mukulx3455обновлён 19 окт. 2026 г.

Скачать 2.1.0 Все версии (5)

УправлениеТехнологииУтилиты

Описание

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.

Links

Docs · Community scripts · Issues · Source · Discord

Последние версии

Все версии →

release

JavaSkript 2.1.0

2.1.0

19 окт. 2026 г.52Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3folia, paper, purpur

Скачать

Что нового

### Added - Economy provider that scripts can supply - Team system, editing, bank currency and messages - Resource packs, Mannequin and Advancement APIs - `@LoadAfter`, background reloads, `messages.yml`, regrouped `config.yml` ### Fixed - Reload cleanup, Folia teleports, data-loss and command isolation fixes

release

JavaSkript 2.0.1

2.0.1

3 сент. 2026 г.124Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur

Скачать

release

JavaSkript 2.0.0

2.0.0

31 авг. 2026 г.20Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur

Скачать

Что нового

v2.0.0 ### New Features - **Addon API:** Public gateway (`JavaSkript.getAPI()`) and custom field injectors (`registerInjector`) - **Shared Variables:** Thread-safe global cache with atomic math and persistent disk storage - **Custom EventBus:** Inter-script pub/sub events (`events.fire` / `events.onCustom`) - **Async HTTP & Discord:** 1-line async Discord embed webhooks and REST requests with zero dependencies - **Display Holograms:** 1.21 Text, Item, and Block Display Entities with auto-cleanup - **Persistent Economy:** Built-in SQLite balance engine with automatic Vault fallback - **Interactive Chat:** Clickable actions, hover tooltips, confirmation prompts, and chat pagers - **Command Builder:** Nested subcommands, typed arguments, and tab-completion without plugin.yml - **Inventory Menus:** Component-based GUI builder with pagination and sound feedback - **Items & PDC:** Fluent ItemBuilder and PersistentDataContainer helpers for items, entities, and blocks - **Sounds Helper:** Preset sound effects, pitch variance, and multi-note chords - **Dialogs API:** Modern 1.21.4+ notice and confirmation dialog prompts - **Profiler & Benchmarks:** Nanosecond CPU execution profiler (`/js profile`) and throughput benchmarks (`/js benchmark`) - **Lifecycle Events:** Standard Bukkit events for script load, unload, reload, and compilation - **JitPack Publishing:** Available on JitPack (`com.github.mukulx:JavaSkript:2.0.0`) for addon developers ### Improvements - **Clean Stack Traces:** Replaced 60-line JVM reflection noise with exact script file and line numbers - **Trace Config Toggle:** Added `errors.clean-stack-traces` in config.yml to toggle clean vs raw traces - **Reload Isolation:** Complete classloader and task cleanup preventing memory leaks on reload - **Folia Optimization:** Automatic routing to Folia regional threads and global schedulers - **Updated Docs:** Comprehensive documentation across 12 dedicated guides in `docs/` ### Bug Fixes - Fixed unhandled script exceptions getting masked behind generic reflection errors - Fixed classloader memory leaks by detaching listeners, tasks, and databases on unload - Fixed Folia regional tasks properly cancelling when scripts reload - Fixed null pointer exceptions when handling empty persistent data or item meta

release

JavaSkript 1.1.0

1.1.0

19 июл. 2026 г.55Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11folia, paper, purpur

Скачать

Что нового

**v1.1.0** ### New Features - **BossBar API**: Full-featured boss bar helper with countdown timers, gradients, and builder pattern - **Update Checker**: Automatically checks Modrinth for new versions on startup - **RestartTimerCommand Example**: Shows countdown timer with boss bars and auto-kick ### Improvements - Reduced console spam by moving verbose logs to debug mode ### Bug Fixes - Fixed config folder creation bug where disabling one script created config files in another script's folder

release

JavaSkript 1.0.0

1.0.0

3 июн. 2026 г.94Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur

Скачать

Что нового

## v1.0.0 Initial release of JavaSkript.