A collection of utilities and abstractions for Minecraft plugin development.

About

Modules

Getting Started

repositories {
    maven("https://repo.eternalcode.pl/releases")
}

dependencies {
    // Core utilities (scheduling API, time parsing, cooldowns, etc.)
    implementation("com.eternalcode:eternalcode-commons-shared:1.4.2")

    // Pick your platform's scheduler implementation:
    implementation("com.eternalcode:eternalcode-commons-bukkit:1.4.2")   // Bukkit/Paper
    // implementation("com.eternalcode:eternalcode-commons-folia:1.4.2") // Folia

    // Optional: virtual thread scheduler (Java 21+)
    implementation("com.eternalcode:eternalcode-commons-bukkit-loom:1.4.2")   // Bukkit/Paper
    // implementation("com.eternalcode:eternalcode-commons-folia-loom:1.4.2") // Folia

    // Optional: Adventure text utilities
    implementation("com.eternalcode:eternalcode-commons-adventure:1.4.2")

    // Optional: Modrinth update checker
    implementation("com.eternalcode:eternalcode-commons-updater:1.4.2")
}

Quick Examples

Scheduler (Bukkit/Paper)

public class MyPlugin extends JavaPlugin {

    private MinecraftScheduler scheduler;

    @Override
    public void onEnable() {
        this.scheduler = new BukkitSchedulerImpl(this);
    }

    public void example(Player player) {
        // Run once, async
        scheduler.runAsync(() -> {
            String data = database.load(player.getUniqueId());

            // Switch back to main thread
            scheduler.run(() -> player.sendMessage(data));
        });

        // Repeating task with delay
        scheduler.timer(() -> player.sendMessage("tick"), Duration.ofSeconds(1), Duration.ofSeconds(5));
    }
}

Virtual Thread Scheduler (Java 21+, Bukkit/Paper)

public class MyPlugin extends JavaPlugin {

    private BukkitLoomScheduler scheduler;

    @Override
    public void onEnable() {
        this.scheduler = BukkitLoomScheduler.create(this);
    }

    @Override
    public void onDisable() {
        this.scheduler.shutdown(Duration.ofSeconds(5));
    }

    public void loadData(Player player) {
        scheduler.supplyAsync(() -> database.load(player.getUniqueId()))  // virtual thread
            .thenApply(data -> transform(data))                           // virtual thread
            .thenAcceptSync(result -> player.sendMessage(result))         // main thread
            .exceptionally(e -> getLogger().severe(e.getMessage()));
    }
}

Virtual Thread Scheduler (Java 21+, Folia)

FoliaLoomScheduler scheduler = FoliaLoomScheduler.create(plugin);

// Player operations
scheduler.forEntity(player)
    .supplyAsync(() -> database.load(player.getUniqueId()))
    .thenAcceptSync(data -> player.sendMessage(data));  // player's region thread

// Block operations
scheduler.forLocation(location)
    .runSync(() -> location.getBlock().setType(Material.STONE));  // location's region thread

// Global operations (broadcast, plugin state)
scheduler.forGlobal()
    .runSync(() -> Bukkit.broadcast(Component.text("Hello!")));

Duration Parsing

// Pre-built parsers
Duration duration = DurationParser.TIME_UNITS.parse("1h30m");    // 1 hour 30 minutes
Duration duration2 = DurationParser.DATE_TIME_UNITS.parse("2d12h"); // 2 days 12 hours

// Or build a custom one
TemporalAmountParser<Duration> parser = new DurationParser()
    .withUnit("s", ChronoUnit.SECONDS)
    .withUnit("m", ChronoUnit.MINUTES);

Duration result = parser.parse("5m30s"); // 5 minutes 30 seconds

Cooldowns (Delay)

Delay<UUID> cooldown = Delay.withDefault(() -> Duration.ofSeconds(10));

public void onCommand(Player player) {
    if (cooldown.hasDelay(player.getUniqueId())) {
        Duration remaining = cooldown.getRemaining(player.getUniqueId());
        player.sendMessage("Wait " + remaining.toSeconds() + "s");
        return;
    }

    cooldown.markDelay(player.getUniqueId());
    // ... execute command
}

Progress Bar

ProgressBar bar = ProgressBar.builder()
    .length(20)
    .filledChar("█")
    .emptyChar("░")
    .filledColor("§a")
    .emptyColor("§7")
    .brackets("§8[", "§8]")
    .build();

String rendered = bar.render(current, max);
// e.g. §8[§a██████████░░░░░░░░░░§8]

Update Checker (Modrinth)

UpdateChecker checker = new ModrinthUpdateChecker();
UpdateResult result = checker.check("your-modrinth-project-id", new Version(getDescription().getVersion()));

if (result.isUpdateAvailable()) {
    getLogger().info("New version available: " + result.latestVersion());
    getLogger().info("Download: " + result.downloadUrl());
}

Adventure Utilities

// Parse &-color codes to Adventure component
Component component = AdventureUtil.component("&aHello &bWorld!");

// Auto-linkify URLs in a component
Component withLinks = new AdventureUrlPostProcessor().apply(component);

// Convert §-color codes (e.g. from config) to &-codes before parsing
String normalized = new AdventureLegacyColorPreProcessor().apply(rawString);

📄 License

🔗 Links