This mod allows the customization of Neoforge's early loading screen.
There is also a quite "hacky" version for Forge 1.20.1, 1.20.2, 1.20.4, 1.20.6.
I do not plan to continue supporting any other Forge versions due to technical reasons.
For newer versions, please use the NeoForge.

Currently, the window is not able to dynamically change its resolution when the window is resized.
I won't allow removing the Mojang logo.
Features:
- add and position custom images (see supported image formats)
- toggle and change the position of the progress bar
- toggle performance bar
- toggle NeoForge's fox
- toggle bottom left log
- toggle NeoForge's version (bottom right)
Installation - NeoForge:
- place the jar in the mods folder
- modify the
config/fml.tomlfile
# Early window provider
earlyWindowProvider = "SimpleCustomEarlyLoading"
# ... Other options ...
# Optionally set the window to be maximized
earlyWindowMaximized = true
Installation - Forge:
- place the jar in the mods folder
- forge version requires default
config/fml.tomlvalue
#Early window provider
earlyWindowProvider = "fmlearlywindow"
3 - Optional: update options.txt: darkMojangStudiosBackground:true
Unfortunately, the override is applied quite late, which may result in the original red early loading (or a white screen) to "flash" on the very game start. I can't do anything about that.
However, the red color of the original loading can be changed using darkMojangStudiosBackground:true in options.txt.
Supported image formats:
Animated images:
- APNG - must be created without unchanged pixels detection (each frame is rendered from scratch). The animation will respect the image timing and repeat count.
Static images:
- JPEG baseline & progressive (12 bpc/arithmetic not supported, same as stock IJG lib
- PNG 1/2/4/8/16-bit-per-channel
- TGA (not sure what subset, if a subset)
- BMP non-1bpp, non-RLE
- PSD (composited view only, no extra channels, 8/16 bit-per-channel)
- GIF (renders only single static frame, use APNG instead)
- HDR (radiance rgbE format)
- PIC (Softimage PIC)
- PNM (PPM and PGM binary only)
Configuration / Source code
For configuration instructions and the source code check the GitHub repository.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 9mo ago | 1 | ||||
| 9mo ago | 1 | ||||
| 9mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
|
R
v1.0
|
last yr. | 1 |
See the [GitHub README](https://github.com/lukaskabc/SimpleCustomEarlyLoading?tab=readme-ov-file#display-conditions) for references.
- This release is for Minecraft 1.20.1 Forge 47.4.12 and newer only!**
Added support for display conditions and rendering APNG frames based on the current loading progress percentage.
See the [GitHub README](https://github.com/lukaskabc/SimpleCustomEarlyLoading?tab=readme-ov-file#display-conditions) for references.
This should allow the game to proceed to start with the early window somehow initialized to default values.
Thanks to Samsterbam and Piotr1628 for reporting it and helping with investigating the issue [#7](https://github.com/lukaskabc/SimpleCustomEarlyLoading/issues/7).
Added an option to specify multiple images from which a random one will be picked.
Example:
"image": ["stellarview.png", "another.png", "yet_another.png"],
Thanks to Gabriel fresan for the suggestion [#6](https://github.com/lukaskabc/SimpleCustomEarlyLoading/issues/6)!
Added support for window resizing. The resolution will now update when the window is resized.
Updated image rendering to keep aspect ratio.
This can be disabled with
"keep_aspect_ratio": false, in the position element section.
This also resolves an issue where a black strips would display when the window switched to fullscreen, thanks to [pitersonix](https://www.curseforge.com/members/pitersonix) for reporting!
- This release is for Minecraft 1.20.1 Forge 47.4.12 and newer only!**
- If you are using 47.4.10 or older, use Simple Custom Early Loading v2.0, do not use this version
- If you are using 47.4.11, update forge and use this version
Added an option to specify multiple images from which a random one will be picked.
Example:
"image": ["stellarview.png", "another.png", "yet_another.png"],
Thanks to Gabriel fresan for the suggestion [#6](https://github.com/lukaskabc/SimpleCustomEarlyLoading/issues/6)!
Added support for window resizing. The resolution will now update when the window is resized.
Updated image rendering to keep aspect ratio.
This can be disabled with
"keep_aspect_ratio": false, in the position element section.
This also resolves an issue where a black strips would display when the window switched to fullscreen, thanks to [pitersonix](https://www.curseforge.com/members/pitersonix) for reporting!
- For forge 1.20.1 47.4.12+ use v2.1.1 !**
Added an option to specify multiple images from which a random one will be picked.
Example:
"image": ["stellarview.png", "another.png", "yet_another.png"],
Thanks to Gabriel fresan for the suggestion [#6](https://github.com/lukaskabc/SimpleCustomEarlyLoading/issues/6)!
Added support for window resizing. The resolution will now update when the window is resized.
Updated image rendering to keep aspect ratio.
This can be disabled with
"keep_aspect_ratio": false, in the position element section.
This also resolves an issue where a black strips would display when the window switched to fullscreen, thanks to [pitersonix](https://www.curseforge.com/members/pitersonix) for reporting!
- This release is for Minecraft 1.20.1 Forge 47.4.12 and newer only!**
- If you are using 47.4.10 or older, use Simple Custom Early Loading v2.0, do not use this version
- If you are using 47.4.11, update forge and use this version
Thanks to [Icosider](https://github.com/Icosider), Forge now allows loading a "mod" for replacing the early loading in the same way as NeoForge does [[PR](https://github.com/MinecraftForge/MinecraftForge/pull/10718)].
Thanks to [xg787](https://github.com/xg787) for reporting it [[issue](https://github.com/lukaskabc/SimpleCustomEarlyLoading/issues/8)].
No new features/changes, only a quick fix for compatibility.
This version now requires updating the
config/fml.toml in the same way as the NeoForge version does.
``
earlyWindowProvider = "SimpleCustomEarlyLoading"
``
Rename your current config file and let a new one be generated.
Or check the new default config [here](https://github.com/lukaskabc/SimpleCustomEarlyLoading/blob/main/src/main/resources/default_config.json).
# 2.0 Update
- The positioning system was reworked
- Added support for animations in APNG format
- Added option to set the window resolution
- Fixed compatibility with Sinytra connector
[See configuration description on GitHub.](https://github.com/lukaskabc/SimpleCustomEarlyLoading/tree/main?tab=readme-ov-file#configuration)
Rename your current config file and let a new one be generated.
Or check the new default config [here](https://github.com/lukaskabc/SimpleCustomEarlyLoading/blob/main/src/main/resources/default_config.json).
# 2.0 Update
- The positioning system was reworked
- Added support for animations in APNG format
- Added option to set the window resolution
- Fixed compatibility with Sinytra connector
[See configuration description on GitHub.](https://github.com/lukaskabc/SimpleCustomEarlyLoading/tree/main?tab=readme-ov-file#configuration)
# Usage may be unstable, and the game can crash unexpectically
Forge does not support custom early window (NeoForge does), so I tried to use an ugly "hack" to override it.
Unfortunately, the override is applied quite late, which may result in the original red early loading (or a white screen) to "flash" on the very game start. I can't do anything about that.
However, the red color of the original loading can be changed using
darkMojangStudiosBackground:true in options.txt.
# Installation
In contrast to NeoForge, this requires the default value in
fml.toml:
earlyWindowProvider = "fmlearlywindow"Please see the mod description and GitHub repository for details.