Item List Integrations

Myotus exposes a small annotation set for item-list integrations in both supported lines.

The goal is not to hide JEI, EMI, or REI completely. The goal is to keep loader-gated registration code discoverable and safe when optional dependencies are absent.

Public markers

Loader markers:

• @JEI
• @EMI
• @REI

Additional item-list markers:

• @RecipeAdd
• @RecipeCategory
• @RecipeTransfer
• @JEIGuiHandler

Subscriber marker:

• @MyotusSubscriber

Dispatch flow

ItemListModLoadHelper.invokeItemListMod(...) is the bridge that runs integration subscribers.

At runtime it:

1. scans mod annotation metadata for classes carrying the requested loader marker
2. resolves those classes through SafeClass
3. keeps classes when at least one declared integration annotation resolves active
4. invokes static methods marked with @MyotusSubscriber
5. requires the subscriber method to declare exactly one parameter of the requested registration type

That keeps optional item-list code out of the common bootstrap path while still allowing automatic discovery.

Authoring shape

@JEI
@RecipeCategory
public final class ExampleJeiCategoryRegistration {
    @MyotusSubscriber
    public static void register(IRecipeCategoryRegistration registration) {
        // Register JEI categories or catalysts here.
    }
}

The important rule is not the extra category marker. The important rule is that the class carries the loader marker and the method carries @MyotusSubscriber.

Practical rules

• Subscriber methods must be static.
• Subscriber methods must declare exactly one parameter.
• The parameter type must match the registration type requested by the loader bridge.
• SafeClass is used on the class boundary so missing optional classes fail soft instead of crashing discovery.
• RecipeAdd, RecipeCategory, RecipeTransfer, and JEIGuiHandler are classification markers for the registration code, not separate loader gates by themselves.

Relationship to optional integrations

These item-list hooks still depend on the same integration registry described in Optional Integrations.

The 1.21.1 line does not change the basic dispatch model. It mainly adds better source Javadocs around the same public markers.