Season 2

Season 2 is a rewrite of my Minecraft mods. All Season 2 mods are developed and tested together, at the same time, in the same codebase.

During Season 1 (2018-2025), I developed all my mods separately. This made it difficult to start new projects, annoying to port projects between Minecraft versions, error-prone to maintain code shared between multiple projects, and switching between projects sometimes required long waiting periods as the development tooling got its act together. This factors combined caused me to burn out of Minecraft modding.

During Season 2 (2025-?), I aim to address these problems with new development tooling, such as the poorly-titled project sanity.

Scope

Season 2 includes:

• Packages for 1.20.1 and 1.21.1.
• Rebind Narrator for 1.20.1, 1.21.1, and 1.21.5.
• Crowmap for 1.20.1, 1.21.1, and 1.21.5.

Modder Name Lib

As part of project sanity, I have decided to use a library mod to reduce development time and cut down on duplicate copies of the things I keep cut-pasting between projects. You probably do not need to download Modder Name Lib separately. Modder Name Lib is included in all mods that use it, using the “jar-in-jar” systems in Fabric and NeoForge.

If you manually download it, modloaders will (probably!) prefer to load the version you installed instead of the bundled copies in each of the mods. Could be useful when debugging a problem.

It is called “Modder Name Lib” because “moddernamelib” is a derisive term for “libraries only intended to be used by their creator”.

Identification

Season 1 mods have a small version number (like 2.1 or something). If the mod has a logo visible in-game, it is probably a hand-drawn logo.

Season 2 mods have a large version number equal to the date they were released (such as 2025.08.21). The mod has a monospace-font icon with a colored triangle in the lower-right.

Changelog

v2025.11.13

(Only ModderNameLib and Crowmap were released.)

• Add a bunch of singleton nullchecks, just in case something like the previous race-condition happens again.

ModderNameLib

• Remove ResourceLocation from the version-independent code to prepare for changes in the next Minecraft version.
• (1.21.1, 1.21.5) Add tick-handler utilities used by the new Crowmap update.

Crowmap

• (1.21.1, 1.21.5) Maps now update when they are inside Bundles and Shulker Boxes.
  • Specifically, anything with a bundle_contents or container data component.
  • (1.21.1: Also compatiblity for packages from my Packages mod.)
  • Turn it on or off in the config file.
  • Sadly not possible to implement in a performant way on 1.20, due to lack of data components.

v2025.10.21

ModderNameLib

• (Forge, Neoforge) New mechanism to ensure dependent mods load after ModderNameLib, fixing a race condition.
• (Neoforge 1.21.1) Some 3d-model related classes were placed in the wrong package. They have been moved.
• Update issues/sources URLs to the new location.

Packages

• (Forge, Neoforge) Eliminate intermittent crash on startup caused by a mod loading race condition.
• (Neoforge 1.21.1) All of the Neoforge-specific classes were placed in the wrong package. They have been moved.
• Update issues/sources URLs to the new location.

Crowmap

• (Forge, Neoforge) Eliminate intermittent crash on startup caused by a mod loading race condition.
• Update issues/sources URLs to the new location.

Rebind Narrator

• (Forge, Neoforge) Eliminate intermittent crash on startup caused by a mod loading race condition.
• Update issues/sources URLs to the new location.

v2025.09.12

ModderNameLib

• “Latches”, a datatype MNL uses to refer to things it’s going to register, are now deduplicated
• (1.20.1) Backport the “retexturable model” code from 1.21.1

Packages

• Remove usage of a deprecated fabric-rendering-api method
• (1.20.1) Backport the improved model retexturing engine from 1.21.1
• (1.20.1) Fix horrible dupe bug lmao

v2025.09.11

• In-game version number is now zero-padded, just like it is on mod hosting platforms. GH#1
• Update bundled copy of ModderNameLib to 2025.09.11.

ModderNameLib

• (1.20.1) Fix Fabric 1.20.1 mods crashing on startup when using Java 17. Sorry about that. GH#7
• (1.21.1) Include a small amount of code for working with “retexturable models”.
  • This will come to 1.20.1 at a later time.

Packages

• (1.20.1) Fix a scenario where if a mod forgets to call Package#canPlaceItem, it can lead to a dupe bug. It will now void the offending items instead (there isn’t much else I can do). GH#8
• (1.21.1) Restructure the package and package-crafter retexturing logic. It’s a lot simpler now (and uses some of the new moddernamelib code).
  • This will come to 1.20.1 at a later time

v2025.08.21

This is a test release of mods created with my new modding pipeline. Please report any bugs/crashes.

Crowmap

• Rewrite the mod.
• There is now a config file for the tooltip behavior.
  • If you don’t like the tooltip, you can turn it off.
  • You can disable the “this tooltip will now hide itself” feature.
• 1.21.5: Remove a horrible mixin used to display the tooltip, in favor of a standard modloader tooltip event.
• Fabric: Now depends on Fabric API.

Rebind Narrator

• Rewrite the mod.
• Fabric 1.21.1+: Integrate with “AMECS Reborn”.
• Fabric: New config file.
  • Enable/disable mod integrations.
  • If AMECS is not installed, configure whether you’re required to hold CTRL to activate the narrator keybind.

This isn’t strictly needed on Neoforge, because you’ve always been able to configure key modifiers through the Neoforge keybindings screen.

Packages

• Now available for 1.21.1 Fabric as well as 1.20.1.
• Now available for 1.21.1 Neoforge as well as Forge 1.20.1.
• New item: Sticky Syrup. Apply it to a package to make it sticky. Sticky packages remember their item even when they are empty.
  • This replaces the old system of packages becoming sticky when they are next to a slime/honey block. Not many people knew about it!
  • The old system is available behind a config option.
• Tweak interactions with regard to sticky packages. (For example, you can insert items into an empty, sticky package, even if they aren’t items from your hand.)
• Remove the annoying honey particles from sticky packages. Sticky packages can now be distinguied by “sticky” text that appears when shifting.
  • It is behind a client config option, if you want them back for some reason…
• Stickiness might actually work on Forge!!!!! (lmao) it wasn’t being enforced through the IItemHandler.
• Slightly less willing to be placed vertically. You have to look up/down a bit farther.
• Fix an issue where items which stacked to 16 could be deleted using Packages inventory interactions.
• On Fabric, a nonnull RenderMaterial is passed when working with fabric-api, possibly fixing some clientside mod-compat issues.
• On 1.20.1, migrate off of a deprecated fabric-api method for registering custom models.
• On 1.21.1, PackageBlockEntity no longer implements vanilla Container! Instead, modloader-specific inventory mechanisms are used.
  • On NeoForge, the Package exposes an ItemHandler capability. On Fabric, the Package exposes an ItemStorage API.
  • This was a rather large change so I’d like to test it before backporting it to 1.20.1.
• On 1.21.1, the Package item also exposes these modloader-specific inventories.
  • This means other mods which can, e.g., pull blocks out of shulker boxes in your inventory, may be able to pull items out of Packages too.
  • This feature needs more testing.

On NeoForge, enable the “NeoForge Light Pipeline” in Mods -> NeoForge -> Client settings -> NeoForge Light Pipeline. This will improve the apperance of the Package Crafter.

On Fabric 1.20.1, if you have Sodium remember to install Indium. No longer necessary as of Sodium for 1.21.1.