# Online PatPat

A cross-server synchronization addon for the popular [PatPat](https://modrinth.com/mod/patpat) mod. 

## 🌐 The Problem
PatPat is an amazing mod that lets you pat other players and entities! However, its networking relies on standard Minecraft proximity packets. This means that if you are playing on a server network using **Velocity**, **BungeeCord**, or **Waterfall**, players often cannot see each other's pats because the proxy intercepts or isolates the packets. Also, many servers refuse to install the server-side mod required for players to sync pats.

## ✨ The Solution
**Online PatPat** solves this by routing your pat animations through a lightweight external WebSocket server! 

- **Cross-Server Syncing:** Works flawlessly on proxy servers (Velocity/Bungee).
- **No Server Mod Required:** The Minecraft server does NOT need the PatPat mod installed.
- **Auto-Detection:** The mod automatically reads the IP of the server you're playing on and creates an invisible "Room", seamlessly syncing you with everyone else on the same server.
- **Client-Side Only:** Just drop it into your mods folder alongside the original PatPat mod, and you're good to go!

## ⚙️ Configuration
The mod includes a beautifully integrated ModMenu screen where you can:
- Enable/Disable the WebSocket sync.
- Specify your own custom Relay Server Host and Port.
- (Optional) Manually set a Room ID if you want to sync with friends across entirely different servers!

## 🛠️ Hosting your own Relay Server
By default, you can run the included Node.js server to host your own WebSocket relay for your players or community. The server is extremely lightweight and handles all the routing natively! Check out the [GitHub Repository](https://github.com/) for the server source code and setup instructions.

## 📦 Requirements
- Fabric API
- [PatPat](https://modrinth.com/mod/patpat) (Required Dependency)
- ModMenu (Highly Recommended for Configuration)

Online PatPat

A cross-server synchronization addon for the popular PatPat mod.

🌐 The Problem

PatPat is an amazing mod that lets you pat other players and entities! However, its networking relies on standard Minecraft proximity packets. This means that if you are playing on a server network using Velocity, BungeeCord, or Waterfall, players often cannot see each other's pats because the proxy intercepts or isolates the packets. Also, many servers refuse to install the server-side mod required for players to sync pats.

✨ The Solution

Online PatPat solves this by routing your pat animations through a lightweight external WebSocket server!

• Cross-Server Syncing: Works flawlessly on proxy servers (Velocity/Bungee).
• No Server Mod Required: The Minecraft server does NOT need the PatPat mod installed.
• Auto-Detection: The mod automatically reads the IP of the server you're playing on and creates an invisible "Room", seamlessly syncing you with everyone else on the same server.
• Client-Side Only: Just drop it into your mods folder alongside the original PatPat mod, and you're good to go!

⚙️ Configuration

The mod includes a beautifully integrated ModMenu screen where you can:

• Enable/Disable the WebSocket sync.
• Specify your own custom Relay Server Host and Port.
• (Optional) Manually set a Room ID if you want to sync with friends across entirely different servers!

🛠️ Hosting your own Relay Server

By default, you can run the included Node.js server to host your own WebSocket relay for your players or community. The server is extremely lightweight and handles all the routing natively! Check out the GitHub Repository for the server source code and setup instructions.

📦 Requirements

• Fabric API
• PatPat (Required Dependency)
• ModMenu (Highly Recommended for Configuration)