Petting

Turn any mob into your loyal, protective companion!

GitHub • Wiki • Issues • Discord

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

🤝 Core Mechanics: Taming
🕹️ Smart Controls & Movement
🎒 Pet Inventory & Scaling
🦮 Interaction Tools
🧬 Entity Conversion
🛡️ Pet Safety & Pet Beds
💀 Hidden Combat Mechanics
🐉 Boss Pets
⚙️ Advanced: Categories & Attributes
🕹️ Administrative Core & NBT
⚙️ 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.

Tool	Default Item	Action
Status Stick	`minecraft:stick`	Right-Click: Follow/Wait/Wander. Shift+Right-Click: Detailed Status Report.
Whistle	`petting:follow_whistle`	Cycles follow distance (5-50 blocks).
Orb	`petting:teleport_orb`	Cycles teleport triggering distance (10-100 blocks).
Clock	`minecraft:clock`	Toggles whether the pet responds to global Whistles (Goat Horns).
Sword	`any sword`	Toggles Aggressive Mode: Attack if owner attacks.
Shield	`minecraft:shield`	Toggles Defense Mode: Attack if self-attacked.
Cookie	`minecraft:cookie`	Toggles Guard Mode: Attack if owner is attacked.
Tether	`petting:pet_tether`	Binds a pet to a 10-block roam radius around its current position.
Shears	`minecraft:shears`	Crouch + Right-Click to release the pet back to the wild.
Goat Horn	`any goat horn`	Crouch + Use to teleport ALL your owned pets to your side instantly.

🧬 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

Option	Default	Description
`tameChance`	`0.33`	Success rate per attempt.
`healthScalesTamingChance`	`false`	Lower HP = better success chance.
`tameHealthThreshold`	`0.0`	Required % of missing health.
`requireKillToTame`	`false`	Must have 1 kill in stats type.
`whitelistOnly`	`false`	Only IDs in `tamingWhitelist` can be tamed.
`tamingWhitelist`	`[]`	List of allowed IDs for taming.
`blacklistEnabled`	`false`	Enable global mod blacklist.
`tamingBlacklist`	`[]`	IDs to COMPLETELY ignore.
`allowGoldenWheat`	`true`	Enables universal taming item.
`disableRespawnOnTame`	`true`	Mobs keep original gear/NBT instead of respawning.

🧠 AI & Survival

Option	Default	Description
`followDistance`	`10.0`	Blocks away before following starts.
`teleportDistance`	`20.0`	Blocks away before snapping to owner.
`maxPetsPerPlayer`	`-1`	Soft-cap for pet ownership (-1 is infinite).
`allowOwnerToHurtPets`	`false`	Enable Friendly Fire.
`sitHealEnabled`	`true`	Regen health while sitting.
`sitHealAmount`	`1.0`	Half-hearts healed per interval.
`sitHealInterval`	`40`	Ticks between heals (20 ticks = 1s).
`enableGoatHornWhistle`	`true`	Allows Crouch+Horn to summon all pets.
`whistleTeleportsTethered`	`false`	Area-bound pets also teleport to whistle.
`hideTamedBossBars`	`true`	Hide Wither/Ender Dragon health bars.
`preventPetToOwnerDamage`	`true`	Pets cannot damage their owners.

🏇 Riding & Movement

Option	Default	Description
`allowPetRiding`	`true`	Master toggle for mounting pets.
`mountRequireSaddle`	`false`	If true, MUST have a saddle to ride.
`landRidingSpeedMultiplier`	`1.0`	Land speed bonus.
`flyingRidingSpeedMultiplier`	`1.0`	Flying speed bonus.
`swimmingRidingSpeedMultiplier`	`1.0`	Swimming speed bonus.
`ridingWhitelistOnly`	`false`	Only IDs in `ridingWhitelist` can be ridden.
`ridingBlacklistEnabled`	`false`	Enable riding blacklist.
`manualFlyingMobs`	`[]`	Force 3D Flight for specific mob IDs.
`manualSwimmingMobs`	`[]`	Force 3D Swimming for specific mob IDs.
`allowPetAttackWhileRiding`	`true`	Fire projectiles while riding Wither/Dragon.

🎒 Inventory & Base Stats

Option	Default	Description
`petBaseArmor`	`0.0`	Global armor bonus for all tamed pets.
`petBaseArmorToughness`	`0.0`	Global toughness bonus.
`extraEquippableMobs`	`[]`	Force equipment slots on specific IDs.
`alwaysShowEquipmentSlots`	`false`	Force Armor/Hand slots on all mobs.
`inventoryWhitelistOnly`	`false`	Only whitelisted mobs get an inventory.
`inventoryBlacklistEnabled`	`false`	Disable inventory for blacklisted IDs.
`petPortraitRenderScale`	`45.0`	Render scale in the inventory screen.

🛠️ Interaction Toggles

Option	Default	Description
`allowPerPetStatus`	`true`	Enable Stick (Status).
`allowPerPetAggression`	`true`	Enable Sword (Aggressive).
`allowPerPetSelfDefense`	`true`	Enable Shield (Defense).
`allowPerPetGuard`	`true`	Enable Cookie (Guard).
`allowPerPetFollowDist`	`true`	Enable Whistle (Follow Dist).
`allowPerPetTeleportDist`	`true`	Enable Orb (Teleport Dist).
`allowPerPetWhistleToggle`	`true`	Enable Clock (Whistle response).
`allowPetTethering`	`true`	Enable Tether (Area Bind).
`allowPetReleasing`	`true`	Enable Shears (Release).

🚀 Enjoy the mod!
Made with ❤️ by Yigit Guven

Petting - Tame any mob!