⭐ New Features

Added Modded Mob Compatibility API
Other mods can now register their own mobs as valid companion entities. Other mods can block unsafe or unwanted entities from being captured. Other mods can define custom companion food rules. Added public API class: com.mki.loyalcompanions.api.LoyalCompanionsApi
Added Config Whitelist and Blacklist
Modpack creators can now enable specific modded mobs without requiring direct API support from the other mod. Added companion_entity_whitelist Added companion_entity_blacklist Blacklist entries always take priority over whitelist and API registrations.
Added Config Food Overrides
Added companion_food_overrides Modded companions can now have custom food items defined through config. Single food item entries now display the actual item name in the companion menu. Multiple food items can be configured with a generic or custom translation label.

🧩 Mod Compatibility Example

Example setup for a mod such as WildCreatures:

companion_entity_whitelist=wildcreatures:crab
companion_entity_blacklist=wildcreatures:shark,wildcreatures:jellyfish,wildcreatures:mussel
companion_food_overrides=wildcreatures:crab=minecraft:wheat

wildcreatures:crab can now be captured as a companion. wildcreatures:shark, wildcreatures:jellyfish, and wildcreatures:mussel are blocked. The crab accepts Wheat as companion food.

🧪 API Example

LoyalCompanionsApi.allowCompanionEntity("wildcreatures:crab");

LoyalCompanionsApi.setCompanionFood(
    "wildcreatures:crab",
    "food.wildcreatures.crab",
    "minecraft:wheat",
    "minecraft:apple"
);

LoyalCompanionsApi.blockCompanionEntity("wildcreatures:shark");
LoyalCompanionsApi.blockCompanionEntity("wildcreatures:jellyfish");

🍖 Food System Improvements

Configured modded food rules are now used by the companion feeding system. Configured food now appears correctly in the companion menu. Single-item food configs now show the item name directly, such as Wheat. Custom translation keys are still supported for more advanced food labels. The system falls back to vanilla or modded animal food logic if no override exists.

🖥️ UI Improvements

Modded entity names are now displayed in a readable format. Instead of showing raw translation keys like Names with underscores are formatted more cleanly, such as Blue Crab for example.

📘 Documentation

Added documentation for the compatibility API. Added documentation for entity whitelist and blacklist configuration. Added documentation for companion food override configuration. Added WildCreatures-style examples for modpack creators.