2.2.0

Requires NeoForge: 21.1.181 or higher

Added

• Annotated every method in the codebase with relevant annotations (@NotNull, @Nullable, @Experimental, @Internal, @OverrideOnly)
• Developers can now manually exclude custom mods in the LoadedModsEvent
• Moved ReloadHandler to the common package for shared access

Changed

• All dependencies updated to latest versions
• Set "Thank You" event priority to lowest (NeoForge only)

Variant Loader

• Fully rewritten and modernized the Variant Loader

• Introduced performance improvements like smarter caching and new utility methods

• Switched from String to ResourceLocation for saving entity identifiers

  • Allows multiple mods to use the Variant Loader without name conflicts

• Replaced getVariantName() and setVariantName() default interface methods (which relied on unstable casting to IVariantAccessor)

  • New generic interface: IVariantEntity<T>
  • Entities now implement IVariantEntity<YourClass> and override getEntity() to return this

  @Override
  public @NotNull YourEntityClass getEntity() {
      return this;
  }
  

  • This change improves type safety and eliminates the need to implement get/setVariantName() manually

Fixed

• Fixed crash when Scheduler failed to load without Variant Loader
• Made blue logging text lighter and easier to read
• Logging now works correctly when enabled in config
• Corrected a language inconsistency in the "Mods Loaded" message
• "Thank You" message now shows after loading is complete
• Resolved conflict where Minecraft reported a duplicate packet registration

2.1.0

Added

Datapack Driven Brewing Stand Recipe's

• Added a way for Users to add new Recipes to Minecrafts Brewing Stand using Datapacks!
• Provided Build in JEI Support into Vanilla Brewing Stand Recipes
• Remained Compatible with hardcoded Recipes!

Bug Fixes

• Rejoining a Fabric World doesnt crash due to Configs anymore

Bug Fixes

• Fixed an issue where Packet Registration was frozen before addons could add packets

This version brings Breaking Changes.

Updating might make your mod incompatible with previous versions of the Library.

2.0.0

Added

Variant Loader

• Added a fallback variant parameter to getParameterDataFromVariant, allowing shared data to be centralized in a single JSON instead of duplicating it per variant.
• Reworked the entire Loading system to have the Events on the Library side and allow Developers to just inject the path and entities.
  • Instead of handling everything themself.
  • All Developers can now remove their ReloadHandler since it became redundant and has been replaced with a way cleaner and more optimized system.
  • For more details, visit the Wiki.
• onReload has been modified to onDatapackSync.

Logging

• Added a new /log command accessible to users with a permission level of 3 or higher (/op).
  • This command opens an in-game menu displaying console logs, allowing developers to monitor output directly without needing terminal access.
  • Supports log levels with color-coded formatting for easier readability.
• isLoggingEnabled has been moved to a server sided config.
• All Logging is now translatable through Minecrafts Component System!
• Added a ton more ways to Log stuff to match the slf4j system.

Network Handler

• Introduced a streamlined network registration system.
  • Simplifies the use of custom packets by automatically handling registration internally via BlueLib.
  • Packet definitions and handlers are now separated into two distinct classes for better structure and maintainability.
  • For more details, visit the Wiki.

Packets

Variant Data Synchronization

• AllDataPacket – Sends a Map<String, JsonObject> containing all variant data from the server to the client.
• ParameterDataPacket – Sends specific parameter data for a given variant as a JsonElement.
• VariantsPacket – Sends a Set<String> representing all available variant identifiers for an entity. :warning: These packets are not registered by default; they must be registered on the S2C side, with the handler provided as a lambda defining the logic to execute when the packet is received.:warning:

Changed

• onReload has been modified to onDatapackSync.

Bug Fixes

• Cleaned up all of the Logging we had in place.

Deleted

• Removed IVariantEntityBase since it has become redundant!

This version brings Breaking Changes.

Updating might make your mod incompatible with previous versions of the Library.

2.0.0

Added

Variant Loader

• Added a fallback variant parameter to getParameterDataFromVariant, allowing shared data to be centralized in a single JSON instead of duplicating it per variant.
• Reworked the entire Loading system to have the Events on the Library side and allow Developers to just inject the path and entities.
  • Instead of handling everything themself.
  • All Developers can now remove their ReloadHandler since it became redundant and has been replaced with a way cleaner and more optimized system.
  • For more details, visit the Wiki.
• onReload has been modified to onDatapackSync.

Logging

• Added a new /log command accessible to users with a permission level of 3 or higher (/op).
  • This command opens an in-game menu displaying console logs, allowing developers to monitor output directly without needing terminal access.
  • Supports log levels with color-coded formatting for easier readability.
• isLoggingEnabled has been moved to a server sided config.
• All Logging is now translatable through Minecrafts Component System!
• Added a ton more ways to Log stuff to match the slf4j system.

Network Handler

• Introduced a streamlined network registration system.
  • Simplifies the use of custom packets by automatically handling registration internally via BlueLib.
  • Packet definitions and handlers are now separated into two distinct classes for better structure and maintainability.
  • For more details, visit the Wiki.

Packets

Variant Data Synchronization

• AllDataPacket – Sends a Map<String, JsonObject> containing all variant data from the server to the client.
• ParameterDataPacket – Sends specific parameter data for a given variant as a JsonElement.
• VariantsPacket – Sends a Set<String> representing all available variant identifiers for an entity. ⚠️ These packets are not registered by default; they must be registered on the S2C side, with the handler provided as a lambda defining the logic to execute when the packet is received.⚠️

Changed

• onReload has been modified to onDatapackSync.

Bug Fixes

• Cleaned up all of the Logging we had in place.

Deleted

• Removed IVariantEntityBase since it has become redundant!

This version brings Breaking Changes.

Reworked the Structure of the mod, some files changed location and need to be re-imported.

1.9.0

Added

Events

• ModLoadedEvent

  • Triggered during game startup when BlueLib is loaded.
  • Called once for each mod found in the mods folder (excluding BlueLib itself).
  • Provides detailed metadata for the respective mod.

• AllModsLoadedEvent

  • Triggered during startup after scanning all external mods (excluding BlueLib).
  • Provides a list of all loaded mod metadata.
  • Returns null if no other mods are loaded besides BlueLib.

• VariantLoadedEvent
  Called when a variant is loaded.

  • Pre (NeoForge) / ALLOW_VARIANT_TO_LOAD (Fabric)
    Fired before loading the variant.
    Can be cancelled to prevent loading.
  • Post (NeoForge) / POST (Fabric)
    Fired after the variant has loaded.
    Cannot be cancelled.

• AllVariantsLoadedEvent
  Called when all variants are loaded.

  • Pre (NeoForge) / ALLOW_ALL_VARIANTS_TO_LOAD (Fabric)
    Fired before loading all variants.
    Can be cancelled to prevent loading.
  • Post (NeoForge) / POST (Fabric)
    Fired after all variants have loaded.
    Cannot be cancelled.

• Added a Config Builder

  • Due to NeoForge having their own Config System
  • We decided to connect NeoForges build in Config System into our new Fabric Config System so even the Multi Loader only needs to make 1 Config System.
  • We even made Server Only Config for Fabric

• Added a Config for various systems, including Markdown.

Changed

• Reworked the entire Markdown Enabling/Disabling by migrating it to a Server Sided Config.
• Reworked the Markdown Prefix/Suffixes by migrating it to a Server Sided Config.
• Refactored a lot of the packages as preperations to 2.0

Deleted

• Removed the previously added EntityStateManager since it did not interact with Minecrafts system.

1.8.0 1.21.4-1.21.5

Added

• Support for 1.21.5

Updated

• Updated Fabric to:
  • 0.120.0+1.21.5
• Updated Neoforge to:
  • 21.5.40-beta

Bug Fixes

• Fixed an issue where the first Color in the Color Markdown sequence didnt get parsed.

Deleted

• Since the Removal of the @GameTest Annotation, the Game Tests have been removed
  • For Now

1.8.0 1.21.3-1.21

Updated

• Updated Fabric to:
  • 0.115.4+1.21.1
• Updated Neoforge to:
  • 21.1.148

Bug Fixes

• Fixed an issue where the first Color in the Color Markdown sequence didnt get parsed.

In 21.4.84 Neoforge Changed the AddReloadListenersEvent to AddAddServerReloadListenersEvent, This Minor Update Fixes Bluelib to match that change.

1.7.0

Added

• Gradients onto the color markdown
  • ex. -#000000,#FFFFFF,#00FF00-(text) will print text in a gradiant from Black to White to Green.
  • By: MeAlam
• Added 3 Interfaces, IFlyingEntity ISwimmingEntity ITamableEntity which help streamline development by having preset Methods an Logic to help developers code their entities!
  • By: Kyradjis

Changed

• Refactored Variant Loader to use a general JSON parser, enabling support for custom user-defined JSONs.
  • By: MeAlam

Updated

• Updated neoforged.moddev to:
  • 2.0.73
• Updated Fabric to:
  • 0.114.2+1.21.4
• Updated Fabric Loader to:
  • 0.16.10
• Updated Neoforge to:
  • 21.4.50-beta
• Updated Parchment to:
  • 2024.12.22

Bug Fixes

• Fixed /reload not reloading the Variants Correctly
  • By: MeAlam
  • Cause: The event registering /reload was never made. oops
• Fixed DataGen not working on Fabric
  • By: MeAlam
  • Cause: DataGen on Fabric tried to execute Client code thru the server which broke it.