
Headpat a Friend!
Give headpats to other players!
Screenshots

About this Mod
Headpat a Friend!
Attention!
Despite Modrinth classifying this as a plugin, it is primarily a Fabric mod!
The plugin download only exists to provide a bridge between clients on PaperMC servers.
Ever been in a situation where you wanted to take your arm,
put it on a little goober's head, and rub it back and forth in a sign of affection?
Well, now you can!
This mod lets you headpat other players by holding right-click on their head.
Cute critters of all shapes and sizes rejoice!

Setup
For this mod to function properly, it needs to be installed on both the client and server. A plugin version is available for Paper server owners.
When using the mod on a server that doesn't have it installed, you'll still be able to headpat,
but it won't be visible to other players, even if they do have the mod.
Joining a server that has this mod loaded without having it on your client is also fully supported. Players that do have it will see and be able to give headpats, while players that don't cannot.

Configuration
This mod can make use of Mod Menu
and YACL to let you modify its config ingame.
A few small tweaks can be made based on preference:
- First-person sway strength
- Petted players make purr sounds
Credits
Mod icon and general concept by Goober. (See project members)
Available Versions
How to Install Headpat a Friend! on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
Install Mod
Open the mod browser in the dashboard and search for "Headpat a Friend!". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.2, 26.1.1, 26.1 (+10 more)
Server-side
~ OptionalRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Headpat a Friend! server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.
Is Headpat a Friend! compatible with fabric and paper?
Headpat a Friend! officially supports fabric, paper for Minecraft 26.1.2, 26.1.1, 26.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Headpat a Friend! – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Headpat a Friend! consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Rent Modded Server
Install Headpat a Friend! with just one click on your server.