Utility Nexus Admin

⚙️ Utility Nexus Admin

Server-side admin utility for NeoForge: inject datapacks into every world without a restart, and pregenerate chunks in the background without ever lagging or blocking players.

✨ Overview

Utility Nexus Admin bundles two things every modded server ends up needing — a global datapack loader and a server-safe chunk pregenerator — into one lightweight, dependency-free mod, with a single commented TOML config and one /una command tree. Built for NeoForge 21.1.249 on Minecraft 1.21.1. What it covers: Datapacks — auto-load folder / .zip packs from <game-dir>/datapacks/ into every world; load, unload, reload and validate at runtime Chunk pregeneration — asynchronous, throttled, resumable, and guaranteed to step aside for players Configuration — one config/utility_nexus/admin/config.toml, read and edited live with /una config Permissions — one configurable OP-level gate for the whole command tree, no permission mod required

🎯 Features

📦 Global Datapack Loader

Vanilla only loads datapacks from a single world's <world>/datapacks/ folder. This loads every folder or .zip datapack placed in <game-dir>/datapacks/ into every world, on dedicated servers and in single-player alike.

• Packs are selected before the world's first data load, so enabling them does not trigger an extra resource reload at startup
• Structure is validated first (pack.mcmeta parses, data/ directory present); invalid packs are skipped with a warning
• A folder pack with no pack.mcmeta can have a default one generated automatically
• Runtime management, no restart: /una datapack list, load|unload|reload <name>, validate <name>, loadall

🌎 Server-Safe Chunk Pregeneration

A background pregenerator designed so it can never get in a player's way or stall a login.

• Off-thread generation — chunks are requested asynchronously with a bounded number of requests in flight (pregen.maxConcurrentChunks); the server thread never blocks building a chunk
• Per-tick time budget (pregen.maxMillisPerTick) plus an MSPT-aware throttle (pregen.maxServerMspt) — pregen skips any tick where the server is already running slow
• Work / rest cycles — generate for pregen.workSeconds, idle for pregen.restSeconds, repeat (set rest to 0 to always work)
• Player-safe — pauses the instant a player is online or a connection reaches the login / configuration handshake; server-list pings are ignored; resumes only after the server has been empty for pregen.resumeGraceSeconds
• Deferred auto-start — starts pregen.startupDelaySeconds after the server is fully up, and only while it is empty, so it never collides with world load
• Resumable — progress is written to a small file and picked up on the next start
• Commands: /una pregen status | start | stop | pause | resume and /una pregen config enabled|center|radius|chunksPerTick|dimension

⚙️ Configuration System

A single commented TOML file at config/utility_nexus/admin/config.toml (NeoForge ModConfigSpec). Every value is also reachable at runtime by its section.key name:

• /una config get <key> — read a value (e.g. pregen.maxMillisPerTick)
• /una config set <key> <value> — change it and persist to disk
• /una config reload — re-read an externally edited file

🔐 Command Permissions

The whole /una tree is gated behind a configurable vanilla OP level (commands.opLevel, default 2). The datapack and config sub-trees can each be turned off entirely from the config. No permission-mod dependency.

🪶 Lightweight & Dependency-Free

Zero hard dependencies beyond NeoForge. Server-focused; every system is event-driven and idle until used.

⚙️ Configuration Reference

Full contents of config/utility_nexus/admin/config.toml:

📋 Requirements

🎮 How to Use

1. Install NeoForge 21.1.249 for Minecraft 1.21.1.
2. Place Utility Nexus Admin in your mods folder.
3. Start once — a default config is written to config/utility_nexus/admin/config.toml.
4. Put folder or .zip datapacks in <instance-or-server>/datapacks/; they load into every world automatically.
5. Run /una help in-game or from console for the full command list.
6. Chunk pregeneration auto-starts on an empty server after a short delay; tune it under the [pregen] config section or with /una pregen, and monitor it with /una pregen status.

🙏 Credits

Developed by Stalking Dragons.

https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft Modding