SynchroCatch [Catch players using Synchro]

# Syncro Catch

**Throw a Poké Ball at a player who's morphed as a Pokémon, and catch them.**

Syncro Catch is a server-friendly add-on for *Cobblemon: Synchro Machine*. Players who morph into Pokémon can be weakened, caught with a real Cobblemon ball, and kept in a realm of their own. Their trainer can then send them out, call them back, and work with them. It's built for roleplay servers.

---

## Features

### Catching
- Throw any Cobblemon Poké Ball at a morphed player. The catch plays Cobblemon's own animation: the ball absorbs the Pokémon, drops, shakes, and either clicks shut or breaks free.
- Odds come from Cobblemon's own catch formula, so a player morphed as a legendary is nearly impossible to catch, and better balls really are better.
- A player can only be caught when they're **at or below 75% HP** (configurable).

### The caught realm
- Caught players are sent to a private overworld-style dimension: **no mobs, no block breaking, but placing blocks and using chests are allowed**, so a trainer's Pokémon can build and store items together.
- Every trainer's team gets its own plot far from everyone else's. Teammates see each other, and nobody else does.
- Caught players stay morphed. They can't un-morph or switch Pokémon while caught.

### Your caught Pokémon, in a ball
- Catching a player gives the trainer a **copy of the ball they used**, labelled with the player's name.
- **Throw it** at the ground: the trainer gets the ball back, and the player is sent out where it landed.
- **Right-click it** to call them back to their realm.
- If a sent-out player faints, they're returned automatically. If the trainer logs out, everyone they have out is recalled.

### Chat
- **Proximity chat:** normal messages reach 40 blocks.
- **Yelling:** a message in ALL CAPS reaches 60 blocks.
- **Team chat:** `/t <message>` (or `/tc`) is a private channel for a trainer and everyone they've caught.
- All radii are configurable.

### Roles
- `/role <name>` lets a player play as a different trainer, changing their **name** (chat, tab list, and above their head) and **skin**. `/role reset` undoes it.
- Roles are defined in the config as `id;Display Name;wide|slim`, and each role's skin is a PNG at `assets/syncrocatch/textures/skins/<id>.png` (a resource pack works too).

---

## Commands

---

## Planned
- Forced battles after a catch
- Chances to escape (trainer defeated, or release by the trainer)
- Bonus XP for the caught Pokémon when it wins battles

---

## Requirements
- Minecraft **1.21.1**, **NeoForge**
- **Cobblemon** 1.8 or newer
- **Cobblemon: Synchro Machine**
- Architectury API
- Kotlin for Forge

Install the mod on **both the server and every client**.

---

## Credits
This mod is an unofficial add-on and does not include or redistribute any code from *Cobblemon: Synchro Machine*. Huge thanks to SappyEddie for the Synchro Machine and to the Cobblemon team.

## Notes
This is an early version. Please report bugs, with your log, in the issues section.