Utility Nexus Admin

View mod page →

Überblick

Utility Nexus Admin ist ein Utility-Mod für die Minecraft-Server-Administration mit Datapack-Ladefunktionalität, Chunk-Pregenerierung und Admin-Tools. Es ist ein eigenständiger Split aus dem Admin-Modul von Utility Core, entwickelt und gewartet von Stalking Dragons.

Funktionen

Datapack-Loader

Lädt und verwaltet Datapacks dynamisch ohne Server-Neustart. Unterstützt globale Packs in <gameDir>/datapacks/ mit Pack-Auswahl während ServerAboutToStartEvent um zusätzliche Startup-Resource-Reloads zu vermeiden.

Chunk-Pregenerierung

Neu gestaltet als load-sicheres Design:

  • Outward square spiral traversal — Ulam-Spirale vom Zentrum für bessere Early-Game-Abdeckung
  • Async generation — via ServerChunkCache.getChunkFuture mit begrenztem in-flight count
  • Per-tick wall-time budget — konfigurierbare max Millisekunden pro Tick
  • MSPT throttle — überspringt Ticks wenn Server MSPT Schwellwert überschreitet
  • Work/rest duty cycle — Generationsblöcke gefolgt von Ruhephasen
  • Login-safe gating — pausiert bei Spieler-Login, resume wenn leer
  • Deferred auto-start — startet nach Grace-Delay auf leerem Server
  • Daily burst window — optionaler aggressiver burst mode (default 08:00-10:00) umgeht Throttles
  • Progress persistence — überlebt restarts/crashes

Admin-Tools

Verschiedene Server-Administrations-Utilities für Moderation und Management.

Utility-Funktionen

Helper-Funktionen für Server-Management und Automatisierung.

Konfiguration

Server-Config (utility_nexus/admin/pregen.toml — SERVER spec):

  • [pregen] — center, radius, chunksPerTick, dimension, enabled, chunksPerTick, maxConcurrentChunks, maxMillisPerTick, maxServerMspt, workSeconds, restSeconds, resumeGraceSeconds, startupDelaySeconds
  • [schedule] — enabled, startHour, endHour, burstChunksPerTick, burstMaxConcurrentChunks, burstMaxMillisPerTick, burstMaxServerMspt, ignorePlayers, autoStopAtWindowEnd, requireRestartAfter

Common config (config/utility_nexus/admin/config.toml — COMMON spec):

  • [datapack] — path, autoLoad, validateOnLoad
  • [commands] — opLevel, enableDatapackCommands, enableConfigCommands
  • [logging] — level

Befehle

Datapack-Befehle

  • /una datapack load <pack> — Datapack laden
  • /una datapack unload <pack> — Datapack entladen
  • /una datapack reload <pack> — Datapack neu laden
  • /una datapack loadall — Alle Datapacks laden
  • /una datapack validate <pack> — Datapack validieren
  • /una datapack list — Alle Datapacks auflisten

Pregeneration-Befehle

  • /una pregen start — Pregenerierung starten
  • /una pregen stop — Pregenerierung stoppen
  • /una pregen pause — Pregenerierung pausieren
  • /una pregen resume — Pregenerierung fortsetzen
  • /una pregen status — Aktuellen Status anzeigen
  • /una pregen config <key> <value> — Pregenerierung konfigurieren

Config-Befehle

  • /una config get <section.key> — Config-Wert abrufen
  • /una config set <section.key> <value> — Config-Wert setzen
  • /una config reload — Konfiguration neu laden

Anforderungen

AnforderungVersion
Minecraft1.21.1
NeoForge21.1.249+
Java21
SeiteServer

Credits & Lizenz

Utility Nexus Admin ist ein eigenständiger Split aus dem Admin-Modul von Utility Core, entwickelt und gewartet von Stalking Dragons.

Lizenziert unter der MIT-Lizenz — siehe LICENSE für Details.

Overview

Utility Nexus Admin is a utility mod for Minecraft server administration, featuring datapack loading functionality, chunk pregeneration, and admin tools. It is a standalone split from the admin module of Utility Core, developed and maintained by Stalking Dragons.

Features

Datapack Loader

Load and manage datapacks dynamically without server restart. Supports global packs in <gameDir>/datapacks/ with pack selection during ServerAboutToStartEvent to avoid extra startup resource reload.

Chunk Pregeneration

Reworked into a load-safe design with:

  • Outward square spiral traversal — Ulam-style spiral from center for better early-game coverage
  • Async generation — via ServerChunkCache.getChunkFuture with bounded in-flight count
  • Per-tick wall-time budget — configurable max milliseconds per tick
  • MSPT throttle — skips ticks when server MSPT exceeds threshold
  • Work/rest duty cycle — generation blocks followed by rest periods
  • Login-safe gating — pauses on player login, resumes when empty
  • Deferred auto-start — starts after grace delay on empty server
  • Daily burst window — optional aggressive burst mode (default 08:00-10:00) bypassing throttles
  • Progress persistence — survives restarts/crashes

Admin Tools

Various server administration utilities for moderation and management.

Utility Functions

Helper functions for server management and automation.

Configuration

Server config (utility_nexus/admin/pregen.toml — SERVER spec):

  • [pregen] — center, radius, chunksPerTick, dimension, enabled, chunksPerTick, maxConcurrentChunks, maxMillisPerTick, maxServerMspt, workSeconds, restSeconds, resumeGraceSeconds, startupDelaySeconds
  • [schedule] — enabled, startHour, endHour, burstChunksPerTick, burstMaxConcurrentChunks, burstMaxMillisPerTick, burstMaxServerMspt, ignorePlayers, autoStopAtWindowEnd, requireRestartAfter

Common config (config/utility_nexus/admin/config.toml — COMMON spec):

  • [datapack] — path, autoLoad, validateOnLoad
  • [commands] — opLevel, enableDatapackCommands, enableConfigCommands
  • [logging] — level

Commands

Datapack Commands

  • /una datapack load <pack> — Load a datapack
  • /una datapack unload <pack> — Unload a datapack
  • /una datapack reload <pack> — Reload a datapack
  • /una datapack loadall — Load all datapacks
  • /una datapack validate <pack> — Validate a datapack
  • /una datapack list — List all datapacks

Pregeneration Commands

  • /una pregen start — Start pregeneration
  • /una pregen stop — Stop pregeneration
  • /una pregen pause — Pause pregeneration
  • /una pregen resume — Resume pregeneration
  • /una pregen status — Show current status
  • /una pregen config <key> <value> — Configure pregeneration

Config Commands

  • /una config get <section.key> — Get config value
  • /una config set <section.key> <value> — Set config value
  • /una config reload — Reload configuration

Requirements

RequirementVersion
Minecraft1.21.1
NeoForge21.1.249+
Java21
SideServer

Credits & License

Utility Nexus Admin is a standalone split from the admin module of Utility Core, developed and maintained by Stalking Dragons.

Licensed under the MIT License — see LICENSE for details.

Resumen

Utility Nexus Admin es un mod de utilidad para la administración de servidores Minecraft, que incluye funcionalidad de carga de datapacks, pregeneración de chunks y herramientas de administración. Es un split independiente del módulo admin de Utility Core, desarrollado y mantenido por Stalking Dragons.

Características

Cargador de Datapacks

Carga y gestiona datapacks dinámicamente sin reiniciar el servidor. Soporta packs globales en <gameDir>/datapacks/ con selección de packs durante ServerAboutToStartEvent para evitar recargas extra de recursos al inicio.

Pregeneración de Chunks

Reescrita con un diseño load-safe:

  • Recorrido en espiral cuadrada hacia afuera — Espiral estilo Ulam desde el centro para mejor cobertura early-game
  • Generación asíncrona — vía ServerChunkCache.getChunkFuture con contador bounded in-flight
  • Presupuesto de tiempo por tick — milisegundos máximos configurables por tick
  • Throttle por MSPT — salta ticks cuando el MSPT del servidor excede el umbral
  • Ciclo trabajo/descanso — bloques de generación seguidos de períodos de descanso
  • Gating seguro para login — pausa en login de jugador, reanuda cuando el servidor queda vacío
  • Auto-inicio diferido — inicia tras delay de gracia en servidor vacío
  • Ventana diaria de burst — ventana opcional agresiva (default 08:00-10:00) que bypassea throttles
  • Persistencia de progreso — sobrevive a reinicios/crashes

Herramientas de Administración

Diversas utilidades de administración de servidor para moderación y gestión.

Funciones de Utilidad

Funciones helper para gestión y automatización del servidor.

Configuración

Config servidor (utility_nexus/admin/pregen.toml — spec SERVER):

  • [pregen] — center, radius, chunksPerTick, dimension, enabled, chunksPerTick, maxConcurrentChunks, maxMillisPerTick, maxServerMspt, workSeconds, restSeconds, resumeGraceSeconds, startupDelaySeconds
  • [schedule] — enabled, startHour, endHour, burstChunksPerTick, burstMaxConcurrentChunks, burstMaxMillisPerTick, burstMaxServerMspt, ignorePlayers, autoStopAtWindowEnd, requireRestartAfter

Config común (config/utility_nexus/admin/config.toml — spec COMMON):

  • [datapack] — path, autoLoad, validateOnLoad
  • [commands] — opLevel, enableDatapackCommands, enableConfigCommands
  • [logging] — level

Comandos

Comandos de Datapack

  • /una datapack load <pack> — Cargar un datapack
  • /una datapack unload <pack> — Descargar un datapack
  • /una datapack reload <pack> — Recargar un datapack
  • /una datapack loadall — Cargar todos los datapacks
  • /una datapack validate <pack> — Validar un datapack
  • /una datapack list — Listar todos los datapacks

Comandos de Pregeneración

  • /una pregen start — Iniciar pregeneración
  • /una pregen stop — Detener pregeneración
  • /una pregen pause — Pausar pregeneración
  • /una pregen resume — Reanudar pregeneración
  • /una pregen status — Mostrar estado actual
  • /una pregen config <key> <value> — Configurar pregeneración

Comandos de Config

  • /una config get <section.key> — Obtener valor de config
  • /una config set <section.key> <value> — Establecer valor de config
  • /una config reload — Recargar configuración

Requisitos

RequisitoVersión
Minecraft1.21.1
NeoForge21.1.249+
Java21
LadoServidor

Créditos y Licencia

Utility Nexus Admin es un split independiente del módulo admin de Utility Core, desarrollado y mantenido por Stalking Dragons.

Licenciado bajo la Licencia MIT — ver LICENSE para detalles.

Aperçu

Utility Nexus Admin est un mod utilitaire pour l’administration de serveur Minecraft, offrant le chargement de datapacks, la pré-génération de chunks et des outils d’administration. C’est un split autonome du module admin de Utility Core, développé et maintenu par Stalking Dragons.

Fonctionnalités

Chargeur de Datapacks

Charge et gère les datapacks dynamiquement sans redémarrage du serveur. Supporte les packs globaux dans <gameDir>/datapacks/ avec sélection de packs pendant ServerAboutToStartEvent pour éviter les rechargements de ressources supplémentaires au démarrage.

Pré-génération de Chunks

Repensée avec un design load-safe :

  • Parcours en spirale carrée vers l’extérieur — spirale Ulam depuis le centre pour une meilleure couverture early-game
  • Génération asynchrone — via ServerChunkCache.getChunkFuture avec compteur in-flight borné
  • Budget de temps par tick — millisecondes max configurables par tick
  • Throttle MSPT — saute les ticks si le MSPT serveur dépasse le seuil
  • Cycle travail/repos — blocs de génération suivis de périodes de repos
  • Gating login-safe — pause à la connexion joueur, reprend quand vide
  • Auto-start différé — démarre après délai de grâce sur serveur vide
  • Fenêtre burst quotidienne — burst mode agressif optionnel (défaut 08:00-10:00) bypassant les throttles
  • Persistance de progression — survit aux restarts/crashes

Outils d’Administration

Divers utilitaires d’administration serveur pour la modération et la gestion.

Fonctions Utilitaires

Fonctions helper pour la gestion et l’automatisation du serveur.

Configuration

Config serveur (utility_nexus/admin/pregen.toml — spec SERVER) :

  • [pregen] — center, radius, chunksPerTick, dimension, enabled, chunksPerTick, maxConcurrentChunks, maxMillisPerTick, maxServerMspt, workSeconds, restSeconds, resumeGraceSeconds, startupDelaySeconds
  • [schedule] — enabled, startHour, endHour, burstChunksPerTick, burstMaxConcurrentChunks, burstMaxMillisPerTick, burstMaxServerMspt, ignorePlayers, autoStopAtWindowEnd, requireRestartAfter

Config commune (config/utility_nexus/admin/config.toml — spec COMMON) :

  • [datapack] — path, autoLoad, validateOnLoad
  • [commands] — opLevel, enableDatapackCommands, enableConfigCommands
  • [logging] — level

Commandes

Commandes Datapack

  • /una datapack load <pack> — Charger un datapack
  • /una datapack unload <pack> — Décharger un datapack
  • /una datapack reload <pack> — Recharger un datapack
  • /una datapack loadall — Charger tous les datapacks
  • /una datapack validate <pack> — Valider un datapack
  • /una datapack list — Lister tous les datapacks

Commandes de Pré-génération

  • /una pregen start|stop|pause|resume|status|config — Contrôler la pré-génération
  • /una pregen config radius|center|chunksPerTick|dimension|enabled — Configurer la pré-génération

Prérequis

PrérequisVersion
Minecraft1.21.1
NeoForge21.1.249+
Java21
CôtéServeur

Crédits & Licence

Utility Nexus Admin est un split autonome du module admin de Utility Core, développé et maintenu par Stalking Dragons.

Sous licence MIT — voir LICENSE pour les détails.

Visão Geral

Utility Nexus Admin é um mod utilitário para administração de servidor Minecraft, com carregamento de datapacks, pré-geração de chunks e ferramentas de administração. É um split autônomo do módulo admin do Utility Core, desenvolvido e mantido por Stalking Dragons.

Recursos

Carregador de Datapacks

Carrega e gerencia datapacks dinamicamente sem reiniciar o servidor. Suporta packs globais em <gameDir>/datapacks/ com seleção de packs durante ServerAboutToStartEvent para evitar recarregamentos extras de recursos na inicialização.

Pré-geração de Chunks

Reescrita com design load-safe:

  • Travessia em espiral quadrada para fora — espiral Ulam a partir do centro para melhor cobertura early-game
  • Geração assíncrona — via ServerChunkCache.getChunkFuture com contador in-flight limitado
  • Orçamento de tempo por tick — milissegundos máximos configuráveis por tick
  • Throttle MSPT — pula ticks quando MSPT do servidor excede limite
  • Ciclo trabalho/descanso — blocos de geração seguidos de períodos de descanso
  • Gating login-safe — pausa no login do jogador, retoma quando vazio
  • Auto-início diferido — inicia após delay de graça em servidor vazio
  • Janela burst diária — modo burst agressivo opcional (padrão 08:00-10:00) bypassando throttles
  • Persistência de progresso — sobrevive a restarts/crashes

Ferramentas de Administração

Diversas utilidades de administração de servidor para moderação e gestão.

Funções Utilitárias

Funções helper para gerenciamento e automação do servidor.

Configuração

Config do servidor (utility_nexus/admin/pregen.toml — spec SERVER):

  • [pregen] — center, radius, chunksPerTick, dimension, enabled, chunksPerTick, maxConcurrentChunks, maxMillisPerTick, maxServerMspt, workSeconds, restSeconds, resumeGraceSeconds, startupDelaySeconds
  • [schedule] — enabled, startHour, endHour, burstChunksPerTick, burstMaxConcurrentChunks, burstMaxMillisPerTick, burstMaxServerMspt, ignorePlayers, autoStopAtWindowEnd, requireRestartAfter

Config comum (config/utility_nexus/admin/config.toml — spec COMMON):

  • [datapack] — path, autoLoad, validateOnLoad
  • [commands] — opLevel, enableDatapackCommands, enableConfigCommands
  • [logging] — level

Comandos

Comandos de Datapack

  • /una datapack load <pack> — Carregar um datapack
  • /una datapack unload <pack> — Descarregar um datapack
  • /una datapack reload <pack> — Recarregar um datapack
  • /una datapack loadall — Carregar todos os datapacks
  • /una datapack validate <pack> — Validar um datapack
  • /una datapack list — Listar todos os datapacks

Comandos de Pré-geração

  • /una pregen start|stop|pause|resume|status|config — Controlar pré-geração
  • /una pregen config radius|center|chunksPerTick|dimension|enabled — Configurar pré-geração

Requisitos

RequisitoVersão
Minecraft1.21.1
NeoForge21.1.249+
Java21
LadoServidor

Créditos e Licença

Utility Nexus Admin é um split autônomo do módulo admin do Utility Core, desenvolvido e mantido por Stalking Dragons.

Licenciado sob a Licença MIT — ver LICENSE para detalhes.