RuaRua

AI was used extensively during the development of this mod. Issues may still occur with different mod combinations and environments. If you do not trust AI-assisted projects, please think carefully before downloading and using it.

Overview

Pick up, pet, throw and catch your companions.

Petting a wolf in third person, Minecraft 1.20.1.

Usage

• Craft a reusable Petting Glove from four wool blocks in a 2×2 grid. Mixed colors work.
• Hold the glove in your main hand. Left-click a nearby companion to pet its head; right-click to pick it up or catch it in flight.
• While carrying, left-click to pet, hold right-click to charge a throw, then release. Sneak + right-click gently places the companion down.
• Press V for the carry-pose wheel: front, cradle, shoulder or head. Use the mouse or number keys 1–4; right-click or Esc cancels.
• Scroll to adjust distance; sneak + scroll adjusts height. R resets placement. Hold Alt to show extra controls.
• Carried players can sneak to escape. Switching away from the glove releases the companion.

Thrown companions do not take fall damage. Impacts with other creatures cause visual and sound effects without dealing damage.

Install

Install the matching loader build on both client and server.

Configuration

Files in the world folder: serverconfig/ruarua-server.json (Fabric) or serverconfig/ruarua-server.toml (Forge / NeoForge). Forge and NeoForge settings are under [interaction]. Reopen the world or restart the server after editing.

• reach: pickup and catch distance.
• chargeTicks: time needed to fully charge a throw, in ticks.
• throwSpeed: maximum throw speed.
• tumbleTicks: landing recovery animation duration, in ticks.
• playerInteractions: allow interactions with other players.
• heldDistanceReference: reference size used to calculate carrying distance.
• heldDistanceFactors: carrying-distance multipliers for specific entity IDs.
• excludedEntities: entity IDs excluded from interaction.

Interaction rules

Interact with your own pets, unowned creatures and players when player interactions are enabled. Other players' owned pets cannot be borrowed. Leashed entities, passengers and entities carrying passengers cannot be picked up. AI is paused during interaction and restored afterward.

Some modded models and custom pet-ownership systems may require separate compatibility support.

Source and license

Project code is MIT licensed. Artwork has separate terms in LICENSE-ASSETS.md; source notices are in SOURCES.md. Source and issue reports: GitHub.

If you encounter any issues, please leave a comment or join our QQ group. Include your Minecraft version, mod version, mod loader, and logs whenever possible to help us investigate.

Suggestions are also welcome! Your feedback will help guide improvements in future updates.

QQ group: 1095622706 · Support the author: Afdian