flubbyig

Create a Minecraft Paper plugin called EasySkript.

The goal is to make scripting MUCH easier than Skript. Every script should read like plain English so even beginners can understand it.

Create a folder: plugins/ └── EasySkript/ └── scripts/

The plugin should automatically load every .es file inside the scripts folder and support /es reload without restarting the server.

Requirements:

  • Super simple syntax
  • Fast parser
  • Helpful error messages with line numbers
  • Beginner friendly
  • Java 21+
  • Paper API
  • No external dependencies
  • Modular parser so new syntax can easily be added

Example Syntax:

Comments

command /hello send "&aHello!"

command /kit give diamond sword give 64 bread play sound level_up

on join send "&aWelcome %player%!" title "&6Welcome" "&7Enjoy your stay!" play sound level_up

on quit broadcast "&c%player% left the server."

on death broadcast "&4%player% died."

on block break send "You broke %block%."

if player is op send "&aYou are OP."

if health < 10 send "&cLow Health!"

set coins to 100 add 10 to coins remove 5 from coins

set player.coins to 0 add 1 to player.coins

teleport player to spawn

wait 5 seconds send "Done!"

repeat 5 send "Hello!"

chance 50% give diamond

effect speed 2 for 30 seconds

console "say Server restarting!"

cancel event

The syntax should feel like writing English instead of programming.

The parser should ignore blank lines and comments, detect mistakes, and print easy-to-understand errors like:

Line 12: Unknown command "giv" Did you mean "give"?

The plugin should include an example.es file demonstrating all features. Build the project professionally with clean code, proper package structure, and make it easy to extend with new keywords and events in the future.

Kodari AI
KodariJul 11 at 4:45 pm 11
EasySkript
EasySkript is a beginner-friendly Paper plugin that lets players write Minecraft scripts in plain-English syntax. It automatically loads .es files from plugins/EasySkript/scripts, supports commands, events, messages, variables, conditions, loops, delays, probabilities, effects, sounds, teleportation, console commands, and event cancellation. Scripts reload instantly with /es reload, while the modular parser provides fast processing, extensible keyword handling, and clear line-numbered errors with typo suggestions.
flubbyig

error then i try /easyskript:es reload it says a error

Kodari AI
KodariJul 11 at 4:56 pm 3

Please send the full red error from the server console immediately after running:

Plain Text
/easyskript:es reload

Also include the in-game message if there is one. The command is registered correctly in plugin.yml, so the stack trace will identify whether the problem is the plugin startup, command execution, or an .es script parsing error.

flubbyig
1 image attached
Kodari AI
KodariJul 11 at 4:57 pm 7
  1. Trace /es reload from command registration to script reload.

  2. Fix the command’s exception path and preserve the real error in console.

  3. Check the script loader for the likely reload failure and patch the root cause.

Fixed /easyskript:es reload so runtime errors are caught instead of showing the generic red command error.

The full exception is now logged to the server console, and you will receive:

Plain Text
EasySkript could not reload the scripts. Check the server console for details.

Run:

Plain Text
/easyskript:es reload

Then copy the console stack trace if it still fails.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
settings.gradle
Code
26 1,655
src/main/java/dev/kodari/easyskript/EasySkriptPlugin.java
package dev.kodari.easyskript;

import dev.kodari.easyskript.command.EasySkriptCommand;
import dev.kodari.easyskript.listener.ScriptCommandListener;
import dev.kodari.easyskript.listener.ScriptEventListener;
import dev.kodari.easyskript.manager.ScriptManager;
import org.bukkit.Bukkit;
import org.bukkit.command.PluginCommand;
import org.bukkit.plugin.java.JavaPlugin;

public final class EasySkriptPlugin extends JavaPlugin {
    private ScriptManager scriptManager;

    @Override
    public void onEnable() {
        this.scriptManager = new ScriptManager(this);

        Bukkit.getPluginManager().registerEvents(new ScriptEventListener(this.scriptManager), this);
        Bukkit.getPluginManager().registerEvents(new ScriptCommandListener(this.scriptManager), this);

        PluginCommand command = this.getCommand("es");
        if (command != null) {
            EasySkriptCommand executor = new EasySkriptCommand(this.scriptManager);
            command.setExecutor(executor);
            command.setTabCompleter(executor);
        }

        this.scriptManager.reloadScripts();
    }

    public ScriptManager getScriptManager() {
        return this.scriptManager;
    }
}