# EverlastingUtils<\/p>\n
EverlastingUtils is a powerful, server-side utility and API library for the Fabric modding toolchain. It provides a robust framework for common, yet complex, features that mod developers frequently need, allowing them to focus more on their mod’s unique content.<\/p>\n
> **For Players:** If a mod you downloaded requires “EverlastingUtils,” you just need to install this library in your `mods` folder. **You can ignore all the technical information below.**<\/font> ### Dependencies —<\/p>\n > <\/p>\n > The information from this point forward is intended for mod developers looking to use EverlastingUtils as a dependency in their own projects. ## Core Features<\/p>\n EverlastingUtils is designed to accelerate development by providing ready-to-use, high-quality systems for:<\/p>\n * **Configuration**: A type-safe, multi-file configuration system with JSONC support, live reloading, and automatic version migration. —<\/p>\n ## System Spotlights<\/p>\n ### Configuration System (`ConfigManager`)<\/p>\n The `ConfigManager` is a sophisticated system designed to handle all aspects of configuration management with minimal boilerplate.<\/p>\n **Key Functionalities:** **Example Usage:** \/\/ 2. Initialize the manager in your mod’s entry point \/\/ 3. Access your config anywhere ### Task Scheduler (`SchedulerManager`)<\/p>\n The `SchedulerManager` provides a safe and efficient way to schedule delayed or repeating tasks, built specifically for the Minecraft server environment.<\/p>\n **Key Functionalities:** **Example Usage:** \/\/ Schedule a task to run every 5 minutes on the main server thread —<\/p>\n ## Other Features<\/p>\n ### Command System (`CommandManager`) “`kotlin commandManager.command(“hello”, permission = “mymod.hello”) { ### GUI Framework (`CustomGui` & `AnvilGuiManager`) “`kotlin —<\/p>\n ## For Developers: Getting Started<\/p>\n To use EverlastingUtils in your project, add it to your dependencies.<\/p>\n #### build.gradle.kts dependencies { #### fabric.mod.json A modding utility that provides reusable components for configuration files, command systems, and user interfaces<\/p>\n","protected":false},"featured_media":60494,"template":"","meta":{"_minecraft_slug":"e-utils","_minecraft_project_id":"YG7mMy6f","_minecraft_author":"Hysocs","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":46258,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"e-utils.zip","_minecraft_size_bytes":13641444,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T10:28:02.828664Z","_minecraft_date_created":"2025-02-08T23:02:52.763890Z","_minecraft_date_modified":"2025-12-21T11:39:57.139261Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/e-utils","_minecraft_icon_attachment_id":60494,"_minecraft_imported_at":"2026-06-03T12:38:50+00:00","_minecraft_import_hash":"4a9504b907202c3830f96dbfdabc524e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,123,92],"mod_loader":[99],"minecraft_version":[118,49,51,54,59,36,60,93,94,101,102,62,37,73,74,38],"class_list":["post-60493","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-technology","mod_category-utility","mod_loader-fabric","minecraft_version-1-16","minecraft_version-1-17","minecraft_version-1-18","minecraft_version-1-19","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n
\n>
\n> **Legacy Versions:** If you are using older versions of mods that require this library, please download EverlastingUtils version `1.0.2`.<\/font><\/p>\n
\n* Fabric API
\n* Fabric Language Kotlin<\/p>\nAttention Developers<\/font><\/h2>\n
\n> <\/p><\/div>\n
\n* **Task Scheduling**: A server-aware scheduler that properly handles synchronous (main thread) and asynchronous tasks, preventing common concurrency issues.
\n* **Commands**: A fluent, Brigadier-based command builder with integrated permission handling.
\n* **GUIs**: A simple yet powerful framework for creating interactive inventory-based GUIs, including standard and anvil types.
\n* **Utilities**: A collection of helpers for things like MiniMessage color parsing and toggleable, per-mod debug logging.<\/p>\n
\n* **Type-Safe & Modern**: Uses Kotlin data classes for type-safe config access and JSONC for human-readable files with comments.
\n* **Live Reloading**: Automatically reloads configuration files from disk when they are changed, allowing server owners to adjust settings without a restart.
\n* **Multi-File Support**: Manages a main `config.jsonc` and any number of “secondary” configs in sub-directories, perfect for organizing complex data like Pok\u00e9mon or loot pools.
\n* **Automatic Migration**: When you release a new version of your mod, the `ConfigManager` compares the version number in the user’s config file with your mod’s current version. If they don’t match, it automatically merges their existing settings into a new, updated config structure, preserving their changes.
\n* **Metadata & Comments**: Programmatically add header comments, footer comments, and per-field descriptions to your config files, making them self-documenting.<\/p>\n
\n“`kotlin
\n\/\/ 1. Define your configuration structure
\ndata class MyConfig(
\n override val version: String = “1.0.0”,
\n override val configId: String = “mymod”, \/\/ Used for the config folder name
\n var debugMode: Boolean = false,
\n var welcomeMessage: String = “
\n) : ConfigData<\/p>\n
\nval configManager = ConfigManager(
\n currentVersion = “1.0.0”, \/\/ Your mod’s current version
\n defaultConfig = MyConfig(),
\n configClass = MyConfig::class,
\n metadata = ConfigMetadata(
\n headerComments = listOf(“Main configuration for MyMod.”),
\n sectionComments = mapOf(“debugMode” to “Enables detailed console logging.”)
\n )
\n)<\/p>\n
\nval isDebug = configManager.getCurrentConfig().debugMode
\n“`<\/p>\n
\n* **Server-Aware**: The scheduler is tied to the server lifecycle. It automatically shuts down when the server stops and recreates its thread pool on restart, preventing thread leaks and errors.
\n* **Sync vs. Async**: Easily specify whether a task should run **synchronously** on the main server thread (necessary for almost all Minecraft API calls) or **asynchronously** on a worker thread (for heavy, non-API work like database queries).
\n* **Efficient Threading**: Uses a shared, managed thread pool to prevent individual mods from creating excessive threads and bogging down the server.
\n* **Tracked Tasks**: All scheduled tasks are tracked by a unique ID, allowing you to cancel them later if needed.<\/p>\n
\n“`kotlin
\n\/\/ In your server-side initializer (e.g., inside ServerLifecycleEvents.SERVER_STARTED)
\nval server = … \/\/ Get the MinecraftServer instance<\/p>\n
\nSchedulerManager.scheduleAtFixedRate(
\n id = “mymod-broadcast-task”, \/\/ Unique ID for this task
\n server = server,
\n initialDelay = 0,
\n period = 5,
\n unit = TimeUnit.MINUTES,
\n runAsync = false, \/\/ IMPORTANT: false runs on the main server thread
\n task = {
\n \/\/ This code is safe to run because runAsync is false
\n server.playerManager.broadcast(Text.literal(“It has been 5 minutes!”), false)
\n }
\n)
\n“`<\/p>\n
\nA fluent builder for creating Brigadier commands with less boilerplate. It handles permission checks automatically, supporting both vanilla OP levels and the Fabric Permissions API.<\/p>\n
\nval commandManager = CommandManager(modId = “mymod”)<\/p>\n
\n executes { context ->
\n context.source.sendFeedback({ Text.literal(“Hello, world!”) }, false)
\n 1 \/\/ Success
\n }
\n subcommand(“admin”) {
\n executes { context -> \/* … *\/ }
\n }
\n}
\n\/\/ Don’t forget to register it!
\ncommandManager.register()
\n“`<\/p>\n
\nQuickly create interactive GUIs for your players with callback-based logic, dynamic updates, and full MiniMessage support for titles and lore.<\/p>\n
\n\/\/ Example of a simple chest GUI
\nCustomGui.openGuiFormatted(
\n player = player,
\n title = “
\n layout = listOf(
\n CustomGui.createFormattedButton(
\n ItemStack(Items.DIAMOND),
\n “
\n listOf(“
\n player
\n )
\n ),
\n onInteract = { context ->
\n if (context.slotIndex == 0) {
\n player.sendMessage(Text.literal(“You clicked the button!”))
\n CustomGui.closeGui(player)
\n }
\n },
\n onClose = { \/* … *\/ }
\n)
\n“`<\/p>\n
\n“`kotlin
\nrepositories {
\n \/\/ Add the repository where EverlastingUtils is hosted
\n maven { url = “https:\/\/api.modrinth.com\/maven” }
\n}<\/p>\n
\n \/\/ Add the library as a dependency
\n modImplementation(“maven.modrinth:e-utils:1.1.2”) \/\/ Replace with the latest version
\n}
\n“`<\/p>\n
\nMake sure to declare the dependency in your `fabric.mod.json` file.
\n“`json
\n“depends”: {
\n “everlastingutils”: “>=1.1.2” \/\/ Replace with the version you are using
\n}
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"