All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Simple Custom Early Loading

Simple Custom Early Loading

by lukaskabc • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

This mod allows the customization of Neoforge's early loading screen.

GitHub repository Curseforge

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.

Custom Early Loading Preview

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:

  1. place the jar in the mods folder
  2. modify the config/fml.toml file
# Early window provider
earlyWindowProvider = "SimpleCustomEarlyLoading"
# ... Other options ...
# Optionally set the window to be maximized
earlyWindowMaximized = true

Installation - Forge:

  1. place the jar in the mods folder
  2. forge version requires default config/fml.toml value
#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
1.21.x
Neoforge
7mo ago 1
1.20.1
Forge
7mo ago 1
1.21.x
Neoforge
9mo ago 1
1.20.1
Forge
9mo ago 1
1.20.x
Forge
9mo ago 1
1.20.1
Forge
11mo ago 1
1.21.x
Neoforge
last yr. 1
1.20.x
Forge
last yr. 1
1.20.x
Forge
last yr. 1
1.21.x
Neoforge
last yr. 1
[2.2-neoforge] v2.2 - NeoForge by lukaskabc on Mar 19, 2026
Download
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.
[2.2-forge] v2.2 - Forge by lukaskabc on Mar 19, 2026
Download
  • This release is for Minecraft 1.20.1 Forge 47.4.12 and newer only!**
If you are using an older version of Forge, update.

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.
[2.1-neoforge] v2.1 - Neoforge by lukaskabc on Jan 19, 2026
Download
Added exception handling when the initialization of the neoforge early window fails (e.g. due to invalid options file).
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!
[2.1-forge] v2.1 - Forge by lukaskabc on Jan 19, 2026
Download
  • For forge 1.20.1 47.4.12+ use v2.1.1 !**
This version is only for forge 1.20.1 47.4.10 or older. Or a different supported version of Minecraft forge (other than 1.20.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"
``


[2.0-neoforge] v2.0 - NeoForge by lukaskabc on Apr 19, 2025
Download
## Warning: old configuration is not compatible!
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)
[2.0-forge] v2.0 - Forge by lukaskabc on Apr 19, 2025
Download
## Warning: old configuration is not compatible!
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)
[1.0-forge] v1.0-forge by lukaskabc on Mar 15, 2025
Download
This is an attempt to override Forge's early loading screen.

# 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"
[1.0] v1.0 by lukaskabc on Mar 06, 2025
Download
The first release.
Please see the mod description and GitHub repository for details.
Simple Custom Early Loading Icon
Download Simple Custom Early Loading
Select game version
Select platform