Petting is a mob-taming mod for Minecraft that allows players to tame various entities. Tamed mobs can guard locations, carry items, and follow the player.

📖 Table of Contents

1. 🤝 Core Mechanics: Taming
2. 🕹️ Smart Controls & Movement
3. 🎒 Pet Inventory & Scaling
4. 🦮 Interaction Tools
5. 🧬 Entity Conversion
6. 🛡️ Pet Safety & Pet Beds
7. 💀 Hidden Combat Mechanics
8. 🐉 Boss Pets
9. ⚙️ Advanced: Categories & Attributes
10. 🕹️ Administrative Core & NBT
11. ⚙️ Complete Configuration Guide

🤝 Core Mechanics: Taming

Taming is the process of acquiring a pet. By default, crouching (Shift) and Right-Clicking a compatible mob with Golden Wheat will attempt to tame it.

🌾 Golden Wheat Attraction

While holding Golden Wheat (petting:golden_wheat), nearby animals will follow the player at an increased speed (1.25x).

🎲 Taming Success Factors

• Base Chance: Default 33% success rate (Configurable).
• Weakness Scaling: Mobs with lower HP are easier to tame! (healthScalesTamingChance).
• Health Thresholds: Some mobs might require you to lower their HP below a certain percentage before they can be tamed at all (tameHealthThreshold).
• Kill Requirements: You may be required to have killed at least one mob of that type before being allowed to tame them (requireKillToTame).
• Custom Taming Items: Configure specific items for specific mobs (e.g. Skeletons eating Bones, Creepers needing Gunpowder) in the customTamingItems config using the entity|item format.

🕹️ Smart Controls & Movement

Petting uses an interaction system to manage pet states.

Empty Hand Actions (Owner Only)

• Right-Click: Cycles through high-priority actions:
  1. Stand Up: If your pet is sitting, it will stand.
  2. Mount: If the pet has a Saddle, you'll hop on!
  3. Sit Down: If standing, the pet will sit and relax.
• Shift + Right-Click: Opens the Pet Inventory.

🏇 Riding Physics

Riding supports movement control for all mob types:

• Space Bar: Swim or Fly upwards.
• S Key: Backwards movement (Land) or Swim/Fly downwards.
• Sprint (Ctrl): Adds a 1.3x speed boost while riding.
• Neutral Buoyancy: Flyers and Swimmers will maintain their current height/depth when you stop moving.
• Rotation Sync: The pet's rotation is synchronized with the player's view.

🎒 Pet Inventory & Equipment Scaling

Every pet has a dedicated inventory accessible via Shift + Right-Click.

• Armor Slots: Give your pets full protection.
• Hand Slots: Equip your pet with Swords or Shields (mobs physically hold and use them!).
• Detection: The mod automatically detects supported equipment slots for each mob type.
• Stat Scaling: All tamed pets receive a global bonus to Base Armor (petBaseArmor) and Armor Toughness (petBaseArmorToughness) via config.
• Storage: 14 slots for your pet to carry your loot.

🦮 Interaction Tools

Specific tools are used to manage pet behaviors. All tool items are configurable.

🧬 Entity Conversion

When a pet entity converts to another type (e.g., Zombie to Drowned), all pet data is transferred to the new entity.

• Data transferred: Owner UUID, Custom Names, AI Modes, Follow/Teleport distances, Saddles, Equipped Items, and even Pet Bed Bindings.

🛡️ Pet Safety & Pet Beds

The mod includes systems for pet protection and respawning.

🛏️ The Pet Bed Block

The Pet Bed allows pets to respawn at a fixed location.

• Binding Mode: Right-click a Pet Bed to enter Binding Mode, then right-click your pet. They are now linked!
• Infinite Respawn: If a bound pet dies, the death is canceled. They instead teleport safely to their bed, heal fully, and wait for you in a sitting pose.
• Cancellation: Right-click the air while in Binding Mode to cancel the process.

🛡️ Environmental Protections & QoL

• Passive Immunities: All tamed pets are immune to Fall Damage, Fire, and Lava.
• Mutual Pacifism: Your pets will never attack each other (including accidental projectile hits).
• Sit Heal: Tamed pets regenerate health while sitting (Default: 1.0 health every 2 seconds).

💀 Hidden Combat Mechanics

The mod includes automated AI modifications for combat safety.

• Wither Peace: Tamed Withers will not fire skulls while in an idle state.
• Aura Protection: Pets will clear the target of nearby hostile entities that are targeting the pet's owner.
• Warden Management: Tamed Wardens have their anger levels towards owners and other pets continuously cleared.

💀 Boss Pets

• Wither: Skull projectiles are neutralized while idle.
• Ender Dragon: Health bar is hidden once tamed and supports riding combat.
• Boss Bar Stealth: Option to hide health bars for tamed bosses (hideTamedBossBars).

⚙️ Advanced: Categories & Attributes

System for managing multiple pets and limits.

🏷️ Categories

Group mobs into categories to set shared limits (e.g., "Undead" or "Dragons").

• Format: SlotID|DisplayName|MobList|DefaultLimit
• Example: 1|Undead|minecraft:zombie,minecraft:skeleton|5

⚡ Custom Attributes

Players can have their pet count increased via custom attributes compatible with gear mods:

• petting:max_pets: Increases the global pet limit.
• petting:max_pets_category_1 through 20: Increases limits for specific categories defined in the config.

🕹️ Administrative Core & NBT

Admins and map-makers can use these tools for deep integration.

Admin Commands

• /pet <target_mob> <target_player>: Instantly tames any mob for the specified player.

Instant Taming via /summon (NBT)

You can spawn pre-tamed mobs using vanilla commands by adding the standard NBT tags:

/summon zombie ~ ~ ~ {ForgeData: {pettingtamed: 1b, ownerUUID: "YOUR-UUID-HERE"}}

Note: Mobs summoned this way will automatically have their hostile AI disabled and be linked to you.

⚙️ The Complete Configuration Guide

Edit config/petting-common.toml for total control.

🛡️ Taming & Persistence

🧠 AI & Survival

🏇 Riding & Movement

🎒 Inventory & Base Stats

🛠️ Interaction Toggles