⚙️ 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.

• Spiral traversal — generates chunks in an outward square spiral (Ulam-style) from the center, giving better early-game coverage than a raster scan; radius can be finite (pregen.radius > 0), infinite (-1), or disabled (0)
• 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
• Scheduled burst window — enable schedule.enabled to run an aggressive pregeneration pass during a daily hour window (default 08:00–10:00) that bypasses MSPT throttle, work/rest, and player-pause; emits a restart warning on window close
• 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

Two commented TOML files (NeoForge ModConfigSpec). Every value is reachable at runtime by its section.key name:

• Common config — config/utility_nexus/admin/config.toml (datapacks, commands, logging) — shared between client and server
• Server config — utility_nexus/admin/pregen.toml (pregeneration + schedule) — written to world/serverconfig/ on dedicated servers; only generated on dedicated servers
• /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 both files from disk

🔐 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 both config files:

📋 Requirements

📦 Available Versions

1.21.1 is the only target — there is no earlier build.

🎮 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 common config is written to config/utility_nexus/admin/config.toml; the pregen server config lives in utility_nexus/admin/pregen.toml (dedicated server only).
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 does not auto-start by default; enable it with pregen.enabled = true in utility_nexus/admin/pregen.toml, and tune it under the [pregen] config section or with /una pregen. Monitor with /una pregen status.

🙏 Credits & License

An original mod by Stalking Dragons — not a port or fork of another mod. Released under the MIT license; see the LICENSE file.

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