Eggify

!(https://cdn.modrinth.com/data/cached_images/2658d55676bac65d1cdce11d4f2b6a00930b8a0b.jpeg)

# 🥚 Eggify

Throw an egg… claim the mob.

Eggify is a Fabric mod for Minecraft that gives thrown eggs a configurable chance to convert a mob into its spawn egg.

When an eggify succeeds:

• the mob disappears with portal-style particles and a sound is played
• the mob drops its spawn egg
• the dropped spawn egg keeps useful variant data when possible

• `Gray Sheep` -> `Sheep Spawn Egg` with `Color: Gray`
• `Savanna Armorer Villager` -> `Villager Spawn Egg` with biome, profession and level
• `Screaming Goat` -> `Goat Spawn Egg` with `Type: Screaming`

## ✨ Features

• Configurable passive, hostile and boss drop chances for mobs with vanilla spawn eggs
• Craftable `Egg of No Escape` for guaranteed captures
• LuckPerms support through fabric-permissions-api
• Blacklist support for mobs that should never drop spawn eggs
• Variant preservation for many mobs
• Spawn egg tooltip details such as age, color, biome, profession, coat, personality or type

The `Egg of No Escape` recipe uses 8 diamonds around 1 egg. It shows up in the recipe book with its custom name, guarantees capture on a hit, and on a miss it has a 50% default chance to drop back intact instead of breaking.

Eggify can only capture mobs that have a vanilla spawn egg. For example, the Wither works, but the Ender Dragon does not because Minecraft does not provide a vanilla dragon spawn egg.

• --
• ## 🎮 Commands

• `/eggify info`
• Shows the current Eggify configuration.
• `/eggify held`
• Shows debug info for the item in your main hand.
• `/eggify reload`
• Reloads the config file.

## 🔄 Permissions

Eggify supports the following permission nodes when `useLuckPerms=true`:

• `eggify.use`
• Allows the player to eggify mobs.
• `eggify.command`
• Allows the player to use `/eggify info`.
• `eggify.debug`
• Allows the player to use `/eggify held`.
• `eggify.special.craft`
• Allows the player to craft the `Egg of No Escape`.
• `eggify.special.use`
• Allows the player to throw and use the `Egg of No Escape`.

• Without LuckPerms, eggifying is available to everyone.
• Without active LuckPerms integration, `/eggify info` is controlled by `allowCommandPermissionNode`.
• Without active LuckPerms integration, `/eggify held` is controlled by `allowDebugCommand`.
• `/eggify reload` is always OP-only.
• When `useLuckPerms=true` and LuckPerms is installed, `allowCommandPermissionNode` and `allowDebugCommand` are ignored.
• OP players can still use the admin commands even when LuckPerms support is enabled.

## ⚙️ Configuration

The config file is created at: `config/eggify.json`

The file includes inline comments to explain every option.

Default config:

```jsonc // Eggify configuration { // Chance in percent that a thrown egg converts a passive mob into its spawn egg. "passiveDropChancePercent": 30. 0,

// Chance in percent that a thrown egg converts a hostile mob into its spawn egg. "hostileDropChancePercent": 15. 0,

// Chance in percent that a thrown egg converts a configured boss mob into its spawn egg. "bossDropChancePercent": 5. 0,

// When true, Eggify requires LuckPerms permission nodes. "useLuckPerms": false,

// When true, non-OP players can use /eggify info with eggify.command. "allowCommandPermissionNode": false,

// When true, non-OP players can use /eggify held without LuckPerms. "allowDebugCommand": false,

// Enables the Egg of No Escape recipe and guaranteed capture effect. "enableSpecialEgg": true,

// Chance in percent that a missed Egg of No Escape drops back intact. "specialEggRecoveryChancePercent": 50. 0,

// Mobs in this list use the boss rarity. // Only mobs with a vanilla spawn egg can actually be captured. "bossMobs": [ "minecraft:wither" ],

// Mobs in this list can never be eggified. "blacklistedMobs": [] } ```

## 🌍 Variant Notes

Eggify tries to preserve useful identity data while stripping live runtime data like position, velocity, health, AI state, effects, inventory and trade state.

This means the mod aims to keep things like:

• baby vs adult
• sheep color
• rabbit coat
• mooshroom type
• frog type
• villager biome, profession and level
• wolf coat
• llama color and trader type
• cat coat
• goat type
• panda personality
• parrot color
• axolotl color

`Tropical Fish` is intentionally excluded from variant preservation.

## For Server Owners

Suggested LuckPerms examples:

```text /lp user permission set eggify.use true /lp user permission set eggify.command true /lp user permission set eggify.debug true /lp user permission set eggify.special.craft true /lp user permission set eggify.special.use true ```

If you want non-OP players to use `/eggify info` without LuckPerms, also set:

```jsonc "allowCommandPermissionNode": true ```

If you want non-OP players to use `/eggi