Write real Minecraft plugins in JavaScript, Lua, or Python — not a pseudo-language

/birdlib reload            → reload every script (.js, .lua and .py)
/birdlib reload example    → reload example.lua if it exists, else example.py, else example.js
/birdlib reload example.js → same thing, with filename tab-completion

Bird.onEvent("org.bukkit.event.player.PlayerJoinEvent", function (event) {
    var player = event.getPlayer();
    event.setJoinMessage("&a[+] " + player.getName() + " joined");
    player.sendMessage("&bWelcome! (powered by BirdLibraryApi)");
});

// Priority can be set (LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR)
Bird.onEvent("org.bukkit.event.block.BlockBreakEvent", "HIGH", function (event) {
    var Material = Java.type("org.bukkit.Material");
    if (event.getBlock().getType() === Material.BEDROCK) {
        event.setCancelled(true);
    }
});

Bird.onCommand("goto", "example.goto", function (sender, label, args) {
    if (args.length < 1) {
        sender.sendMessage("&cUsage: /goto <player>");
        return;
    }
    var target = Bird.getPlayer(args[0]);
    if (target === null) {
        sender.sendMessage("&cPlayer not found: " + args[0]);
        return;
    }
    sender.teleport(target.getLocation());
}, function (sender, alias, args) {
    // Suggest online player names for the first argument
    if (args.length === 1) {
        return java.util.Arrays.asList(Bird.getPlayerNames());
    }
    return java.util.Collections.emptyList();
});

Bird.runTask(function () { /* runs next tick, on the main thread */ });
Bird.runTaskLater(function () { /* runs once, after N ticks */ }, 40);

var id = Bird.runTaskTimer(function () { /* runs repeatedly every N ticks */ }, 0, 20);
Bird.cancelTask(id);

// Off the main thread — never touch the Bukkit API (player/block) in here
Bird.runTaskAsync(function () { /* heavy work, HTTP calls, file I/O */ });

Bird.onCommand("sequence", function (sender, label, args) {
    Bird.runTaskAsync(function () {
        Bird.tell(sender, "&e3...");
        Bird.sleep(1);
        Bird.tell(sender, "&e2...");
        Bird.sleep(1);
        Bird.tell(sender, "&e1...");
        Bird.sleep(1);
        Bird.runTask(function () {
            // Back on the main thread — safe to touch world/player
            Bird.tell(sender, "&aGO!");
        });
    });
});

Bird.tell(player, "&7This message is just for you");
Bird.tell("Notch", "&7Hey Notch!");           // true if online, false if not found

Bird.broadcastChat("&aEvent starting now!");
Bird.broadcastChat("&7[Staff] ...", "example.staff"); // only sent to those with this permission

Bird.sendActionBar(player, "&c⚠ Low health!");
Bird.broadcastTitle("&6&lBOSS DEFEATED", "&7Well done, everyone!");
Bird.broadcastTitle("&e&lWAVE 3", "", 5, 40, 10); // custom fadeIn/stay/fadeOut

Bird.giveItem(player, "DIAMOND_SWORD", 1, "&b&lFrost Blade",
    ["&7A blade forged in ice", "&7+5 Attack Damage"]);

Bird.playSound(player, "ENTITY_PLAYER_LEVELUP");
Bird.spawnParticle(player, "HAPPY_VILLAGER", 15);

Bird.strikeLightning("world", 100, 64, -230, true); // true = effect only, no damage

var looking = Bird.getTargetBlock(player, 10);   // the block being looked at, up to 10 blocks away
var underfoot = Bird.getBlockPlayerIsOn(player); // the block under the player's feet

if (underfoot.getType().name() === "LAVA") {
    Bird.tell(player, "&cYou're standing in lava!");
}

if (Bird.hasCooldown("kit", sender)) {
    var left = Bird.getCooldownRemaining("kit", sender);
    Bird.tell(sender, "&cWait another " + Math.ceil(left) + "s");
} else {
    Bird.setCooldown("kit", sender, 300); // 5 minutes
    // ... give the item ...
}

var key = "joins_" + player.getUniqueId();
var count = parseInt(Bird.getData(key, "0")) + 1;
Bird.setData(key, String(count));

Bird.getData("missingKey");             // → null
Bird.getData("missingKey", "default");  // → "default"
Bird.removeData(key);
Bird.getDataKeys();                     // → list of all stored keys

var raw = Bird.readFile("playerstats.json");
var stats = raw ? JSON.parse(raw) : {};

stats[sender.getName()] = (stats[sender.getName()] || 0) + 1;
Bird.saveFile("playerstats.json", JSON.stringify(stats, null, 2));

// ---- economy.js ----
Bird.emit("coins-added", { player: player.getName(), amount: 50 });

// ---- logging.js (a completely separate file) ----
Bird.on("coins-added", function (data) {
    Bird.log(data.player + " received " + data.amount + " coins");
});

Bird.fetch("https://api.example.com/status", function (res) {
    if (res.ok) {
        Bird.log("Status: " + res.status + " body: " + res.body);
    } else {
        Bird.warn("Request failed: " + res.status);
    }
});

// POST with a JSON body
Bird.fetch("https://api.example.com/events", "POST",
    JSON.stringify({ type: "join" }),
    function (res) { Bird.log(res.body); });

Bird.sendDiscordWebhook(webhookUrl, "A player just found a diamond! 💎");

// rich embed: title, description, hex color
Bird.sendDiscordEmbed(webhookUrl, "Player joined",
    playerName + " joined the server", "#57F287");

Bird.log("Loading broken-example.js...")

Bird.onCommand("broken" function (sender, label, args) {
    sender.sendMessage("This line will never be reached");
});

import java

Material = java.type("org.bukkit.Material")

Bird.log("Loading example.py...")

def on_join(event):
    player = event.getPlayer()
    event.setJoinMessage("&a[+] " + player.getName() + " joined")
    player.sendMessage("&bWelcome! (powered by BirdLibraryApi)")

Bird.onEvent("org.bukkit.event.player.PlayerJoinEvent", on_join)

def on_block_break(event):
    if event.getBlock().getType() == Material.BEDROCK:
        event.setCancelled(True)

# Priority can be set too, same as JS (LOWEST, LOW, NORMAL, HIGH, HIGHEST, MONITOR)
Bird.onEvent("org.bukkit.event.block.BlockBreakEvent", "HIGH", on_block_break)

def hello_command(sender, label, args):
    sender.sendMessage("&eHello from Python! You sent " + str(len(args)) + " argument(s)")

Bird.onCommand("hello", hello_command)

Bird:log("Loading example.lua...")

local Material = luajava.bindClass("org.bukkit.Material")

Bird:onEvent("org.bukkit.event.player.PlayerJoinEvent", function(event)
    local player = event:getPlayer()
    player:sendMessage("&bWelcome to the server!")
end)

Bird:onCommand("hello", function(sender, label, args)
    sender:sendMessage("&eHello from Lua! You sent " .. #args .. " argument(s)")
end)

/birdlib reload             → reload every script (.js, .lua and .py)
/birdlib reload example     → reload example.lua if it exists, else example.py, else example.js
/birdlib reload example.py  → reload example.py specifically

Bird.log("Loading example.js...");

// Greet the player on join + permanently count how many times they've joined
Bird.onEvent("org.bukkit.event.player.PlayerJoinEvent", function (event) {
    var player = event.getPlayer();
    event.setJoinMessage("§a[+] " + player.getName() + " joined the server");
    player.sendMessage("§bWelcome to the server! (powered by BirdLibraryApi)");

    var key = "joins_" + player.getUniqueId();
    var count = parseInt(Bird.getData(key, "0")) + 1;
    Bird.setData(key, String(count));
    if (count === 1) {
        Bird.broadcast("§d" + player.getName() + " is joining for the first time, welcome them!");
    }
});

// Prevent breaking Bedrock (example of accessing the Bukkit API directly)
Bird.onEvent("org.bukkit.event.block.BlockBreakEvent", function (event) {
    var Material = Java.type("org.bukkit.Material");
    if (event.getBlock().getType() === Material.BEDROCK) {
        event.setCancelled(true);
        event.getPlayer().sendMessage("§cYou can't break Bedrock!");
    }
});

// /kit - gives items with a cooldown + fires a custom event for other scripts to listen for
Bird.onCommand("kit", function (sender, label, args) {
    if (Bird.hasCooldown("kit", sender)) {
        var left = Bird.getCooldownRemaining("kit", sender);
        Bird.tell(sender, "&cYou can claim another kit in " + Math.ceil(left) + "s");
        return;
    }
    Bird.giveItem(sender, "IRON_SWORD", 1, "&b&lStarter Sword", ["&7Given by /kit"]);
    Bird.giveItem(sender, "BREAD", 8);
    Bird.playSound(sender, "ENTITY_PLAYER_LEVELUP");
    Bird.spawnParticle(sender, "HAPPY_VILLAGER", 15);
    Bird.setCooldown("kit", sender, 300);
    Bird.tell(sender, "&aHere's your starter kit!");
    Bird.emit("kit-claimed", { player: sender.getName() });
});

Bird.on("kit-claimed", function (data) {
    Bird.log(data.player + " claimed the starter kit");
});

// /countdown  - scheduler example
Bird.onCommand("countdown", function (sender, label, args) {
    var seconds = args.length > 0 ? parseInt(args[0]) : 5;
    var remaining = [seconds];
    var taskId = Bird.runTaskTimer(function () {
        if (remaining[0] <= 0) {
            Bird.broadcastTitle("§a§lGO!", "");
            Bird.cancelTask(taskId);
            return;
        }
        Bird.broadcastActionBar("§e" + remaining[0] + "...");
        remaining[0] = remaining[0] - 1;
    }, 0, 20);
});

Bird.log("example.js loaded — /kit and /countdown are ready");