Nuclear Tech: Second Dawn — Early Loading

By
BySally

An animated NTSD early-loading screen that follows real Forge startup progress.

Nuclear Tech: Second Dawn — Early Loading

Part of Nuclear Tech: Second Dawn

This is an official component of the Nuclear Tech: Second Dawn (NTSD) ecosystem, developed and maintained primarily for that modpack. BySally — Project Creator & Maintainer. Standalone use outside the tested NTSD environment is not a supported compatibility promise.

“Official” refers to the NTSD project only. NTSD is an independent community project, not an official product of Minecraft, Mojang Studios, Microsoft, HBM, or the original NTNH developers. Upstream authors do not thereby endorse this adaptation.

What this component does

NTSD Early Loading replaces the presentation of Forge's early display window with the configured NTSD animated background, project title, and startup meters. It runs before normal mod initialization through Forge's ImmediateWindowProvider service mechanism.

The bars read actual Forge progress meters. Stages with known totals show their counters; indeterminate stages remain indeterminate. The module does not manufacture a single overall percentage for a startup process that does not provide one.

Installation and supported environment

This is client-only, for Minecraft 1.20.1, Forge 47.4.28, Java 17. It is a genuine SPI library with FMLModType: LIBRARY, not a conventional content mod, and may not appear as a normal entry in Minecraft's mod list. Do not install it on a dedicated server.

NTSD supplies the external presentation files and selects the provider automatically as part of the modpack configuration. For a manual installation, put the JAR in mods, supply config/ntsd-loading/loading.properties and its authorized .ntsd frame sequence, and set the existing config/fml.toml entry to:

earlyWindowProvider = "ntsd_early_window"

Do not replace the rest of fml.toml. To remove the module, first restore earlyWindowProvider = "fmlearlywindow", then remove its JAR. Leaving a missing provider selected is not a supported uninstall path.

Rendering and fallback

The NTSD animation is an indexed image sequence, not direct MP4 playback. Frames stream through a bounded decoder buffer and two reusable GPU textures, with GPU blending between adjacent frames. The image fills the window while preserving its proportions through centered cropping. Forge retains window initialization, scheduling, and handoff to Minecraft.

Missing, invalid, or disabled animation resources fall back to the standard Forge rendering path. A missing provider JAR, an incompatible Forge internal API, or a graphics-driver failure cannot be solved by the animation fallback. Compatibility with untested Forge releases is not promised.

Credits and licensing

Integration code: LGPL-2.1-only. The corresponding source archive includes the license, notices, build script, and frame-conversion tool. The module uses installed Forge and LWJGL/STB components; it does not redistribute their runtime libraries or Minecraft classes.

The external NTSD illustrations, icons, and derived animation were AI-generated with OpenAI under BySally's direction and prepared for NTSD. They are separate from the JAR's code license. Their origin does not automatically establish exclusive copyright, and third-party references retain any applicable rights. The project credits Forge Development LLC and the Forge contributors for the early display API.

Project links

Nuclear Tech: Second Dawn — Early Loading

Часть Nuclear Tech: Second Dawn

Это официальный компонент экосистемы Nuclear Tech: Second Dawn (NTSD), который разрабатывается и сопровождается прежде всего для этой сборки. BySally — Project Creator & Maintainer. Совместимость с произвольной сторонней сборкой не заявляется.

Слово «официальный» относится только к проекту NTSD. NTSD — независимый проект сообщества, а не официальный продукт Minecraft, Mojang Studios, Microsoft, HBM или оригинальных разработчиков NTNH. Упоминание авторов не означает их одобрения адаптации.

Что делает компонент

NTSD Early Loading оформляет раннее окно Forge: анимированный фон NTSD, название проекта и реальные индикаторы запуска. Он работает до обычной инициализации модов, через сервис ImmediateWindowProvider.

Полосы используют настоящие ProgressMeter Forge. Для этапов с известным объёмом работы отображаются счётчики, для неопределённых — индикатор без выдуманного общего процента.

Установка

Только клиент, Minecraft 1.20.1, Forge 47.4.28, Java 17. Это настоящая SPI-библиотека с FMLModType: LIBRARY, которая может отсутствовать в обычном списке модов. На выделенный сервер не устанавливать.

В сборке NTSD ресурсы и выбор провайдера поставляются автоматически. Для ручной установки нужны JAR в mods, config/ntsd-loading/loading.properties, разрешённая последовательность кадров .ntsd и одна настройка в существующем config/fml.toml:

earlyWindowProvider = "ntsd_early_window"

Остальное содержимое fml.toml сохраняется. Перед удалением JAR сначала верните earlyWindowProvider = "fmlearlywindow". Нельзя удалять библиотеку, оставляя выбранным отсутствующий провайдер.

Воспроизведение и резервный режим

Используется индексированная последовательность кадров, ограниченный буфер, две GPU-текстуры и плавное смешивание соседних кадров. Это не прямой MP4-плеер. Пропорции сохраняются центральной обрезкой. Инициализация окна, планировщик и передача окна игре остаются у Forge.

При отключённой, отсутствующей или повреждённой анимации используется штатная отрисовка Forge. Защита не исправляет отсутствие JAR выбранного провайдера, несовместимость внутренних API Forge или отказ драйвера. Совместимость с непроверенными версиями Forge не обещается.

Авторы и лицензии

Код — LGPL-2.1-only. Архив соответствующих исходников содержит лицензию, уведомления, скрипт сборки и инструмент конвертации кадров. API ранней загрузки: Forge Development LLC и Forge contributors. Библиотеки Forge, LWJGL/STB и классы Minecraft в JAR не копируются.

Внешняя графика, иконки и анимация NTSD создавались как AI-generated with OpenAI по заданию BySally. Лицензия кода автоматически на них не распространяется. Исключительные права на любой ИИ-результат не предполагаются автоматически; права сторонних референсов сохраняются.

Ссылки проекта