Petting - Tame any mob!

---

Petting is a Minecraft mod that lets you tame virtually any mob in the game — hostile or passive, ordinary or boss. Tamed pets follow your commands, defend you in combat, carry your items, ride alongside you, and respawn at a dedicated bed when they die. Every behavior is deeply configurable, making the mod suitable for survival, adventure maps, and modpacks alike.

---

Features at a Glance

• Tame almost any mob, including Withers, Ender Dragons, and Wardens
• Full riding support for land, flying, and swimming mobs
• Per-pet inventory with armor slots, hand slots, and 14 item storage slots
• Four AI modes: Following, Sitting, Waiting, Wandering
• Combat modes: Aggressive, Defensive, Guard
• Pet Bed block for infinite respawning — pets teleport to their bed on death, even across dimensions
• Per-pet control mapping system with custom actions and conditions
• Passive immunities: no fall damage, fire, or lava damage for tamed pets
• Global whistle via Goat Horn to instantly recall all pets
• Category system for grouping pets and enforcing per-group limits
• Full server and modpack configuration via petting-common.toml

---

Getting Started

Installation

1. Download the latest release from CurseForge or Modrinth.
2. Place the .jar file in your mods/ folder.
3. Launch the game. A default config file will be generated at config/petting-common.toml.

---

Taming

Taming is how you acquire a pet. By default, right-click a mob while holding Golden Wheat (petting:golden_wheat) to attempt taming it. The item is consumed on every attempt. Heart particles appear on success; smoke particles appear on failure. The taming item is fully configurable via tamingItem.

When tamed, all three combat modes — Aggressive, Guard, and Defensive — are enabled by default. The pet is also automatically named "[YourName]'s [mob type]" with the name tag hidden above their head.

Holding Golden Wheat in either hand (main or offhand) causes nearby untamed animals within 12 blocks to follow you.

Success Factors

| Factor | Config Key | Description | | :--- | :--- | :--- | | Base chance | tameChance | Default 33% per attempt | | Weakness scaling | healthScalesTamingChance | Lower HP increases success chance | | Health threshold | tameHealthThreshold | Mob must be missing a certain % of HP to be tameable | | Kill requirement | requireKillToTame | Must have killed at least one of that mob type first | | Custom items | customTamingItems | Assign specific taming items per mob (format: entity_id\|item_id) | | Whitelist | whitelistOnly, tamingWhitelist | Only listed mobs can be tamed | | Blacklist | blacklistEnabled, tamingBlacklist | Listed mobs cannot be tamed (supports modid:* wildcards) | | Cooldown | interactionCooldown | Ticks between allowed taming attempts on the same mob (default: 20) |

---

Controls & Pet Management

Empty Hand (Default Mappings)

By default, the control system uses per-pet mappings. Fresh pets have these defaults:

| Input | Default Action | | :--- | :--- | | Right-Click | Toggle Sit on/off | | Shift + Right-Click | Cycle follow/teleport distance presets (5/10 → 10/20 → 20/50 blocks) |

> These are fully remappable per-pet or globally via the Pet Settings Screen (press P while looking at a pet, or bind controls.petting.open_settings in Controls).

Pet Settings Screen (P Key)

Press P while targeting your pet to open the settings GUI. From here you can:

• Toggle AI modes: Sitting, Waiting, Aggressive, Guard, Self-Defense, Ignore Whistle
• Set exact follow and teleport distances
• Open the Control Mappings sub-screen to customize right-click and shift+right-click actions

Control Mapping System

Each pet (and player default) supports a chain of ordered rules for right-click and shift+right-click. Rules follow the format ACTION|CONDITION and are evaluated top-to-bottom; the first matching rule is executed.

Available Actions

| Action | Description | | :--- | :--- | | SIT | Toggle Sitting on/off | | TOGGLE_WAIT | Toggle Waiting on/off | | RIDE | Mount the pet | | OPEN_INV | Open the pet inventory | | CYCLE | Cycle through distance presets (5/10 → 10/20 → 20/50) | | TOGGLE_FOLLOW_TELEPORT | Swap the follow and teleport distance values | | OPEN_SETTINGS | Open the Pet Settings screen | | RUN_COMMAND | Run a server command (requires the owner to have permission for it) | | NONE | Do nothing |

Available Conditions

| Condition | When it passes | | :--- | :--- | | NONE | Always | | SADDLE | Pet has a saddle equipped | | SNEAK | Owner is crouching | | HEALTH_LT_50 | Pet is below 50% HP | | HOLD_ITEM | Owner is holding any item |