# Cobblemon Characters

Run `/character` and a full-screen picker opens — a row of characters, each shown as a **posed 3D model of its own skin** that turns to follow your cursor. Pick one, hit **SELECT**, and the server takes it from there: teleports you, sets your gamemode, hands you buffs — whatever that character is wired to do. Choose once, and that's who you are.

**Not just a menu — the server acts on your choice.** The client draws the screen and renders the 3D skins; the server runs the commands and keeps the buffs applied. It's one jar, `environment: "*"` — the *same file* on both sides.

---

## Features

- **Command-opened character select** — `/character` *(or `/choose character`)* opens an enclosed panel, one bordered card per character: name banner, live 3D skin, a `SLIM` / `CLASSIC` model toggle, and a **SELECT** button.
- **Real 3D skin previews** — each card renders the character's actual **64×64 Minecraft skin** as a standing player model *(head tracks the mouse)*. Skins live on the server and are streamed to the client on open — players don't need the files.
- **Selection runs commands** — every character carries its own command list, run from the server console *(op-level 4, so `/tp`, `/gamemode`, `/give`, `/lp…` just work)* with placeholders `{player}` · `{uuid}` · `{character}` · `{display_name}`. Commands fire **once**, the moment you pick.
- **Persistent buffs** — potion effects re-applied every second, beacon-style, for as long as you're that character. They survive relog *(and re-apply themselves on join)*. Strategy is the config — pick the kit that fits the character.
- **One-time by default** — reopen the menu as much as you like *until* you commit; **selecting locks you in**, server-authoritative and saved to the world. A modified client can't bypass it. Grant `goodcharacters.reselect` to let someone choose again.
- **Drop-in characters** — a new character is just a folder with a `character.json` and a skin `texture.png`; switch it on and order it in `menu.json`. **No code.**
- **Admin tools** — `/character reload` *(hot-reload config)* and `/character select <id> <player>` *(force-apply)*. Per-character `permission` gates optional VIP characters.

## Config *(config/cobblemon-characters/)*

- **`menu.json`** — `title`, `subtitle`, and `active` *(the ordered list of character ids that show in the picker)*.
- **`characters/<id>/character.json`** — `display_name`, `texture`, `slim` *(Alex 3px vs Steve 4px arms)*, `description`, `permission`, `commands[]`, and `buffs[]` *(each `effect` + `amplifier`)*.
- **`characters/<id>/texture.png`** — the character's **64×64** Minecraft skin.
- Selections persist per world in `data/cobblemon_characters_selections.json` — delete an entry to free a player's one-time choice.

---

## Requirements

**Minecraft 1.21.1 — Fabric** · Fabric API · needed on **server & client**

| | Fabric |
|---|---|
| Required | Fabric API |

*No Kotlin, no hard Cobblemon dependency — it runs on any Fabric 1.21.1 server, and drops straight into a Cobblemon pack (Fabric API is already there).*

---

All Rights Reserved · Dev: **igorbescobar**

Cobblemon Characters

Run /character and a full-screen picker opens — a row of characters, each shown as a posed 3D model of its own skin that turns to follow your cursor. Pick one, hit SELECT, and the server takes it from there: teleports you, sets your gamemode, hands you buffs — whatever that character is wired to do. Choose once, and that's who you are.

Not just a menu — the server acts on your choice. The client draws the screen and renders the 3D skins; the server runs the commands and keeps the buffs applied. It's one jar, environment: "*" — the same file on both sides.

Features

• Command-opened character select — /character (or /choose character) opens an enclosed panel, one bordered card per character: name banner, live 3D skin, a SLIM / CLASSIC model toggle, and a SELECT button.
• Real 3D skin previews — each card renders the character's actual 64×64 Minecraft skin as a standing player model (head tracks the mouse). Skins live on the server and are streamed to the client on open — players don't need the files.
• Selection runs commands — every character carries its own command list, run from the server console (op-level 4, so /tp, /gamemode, /give, /lp… just work) with placeholders {player} · {uuid} · {character} · {display_name}. Commands fire once, the moment you pick.
• Persistent buffs — potion effects re-applied every second, beacon-style, for as long as you're that character. They survive relog (and re-apply themselves on join). Strategy is the config — pick the kit that fits the character.
• One-time by default — reopen the menu as much as you like until you commit; selecting locks you in, server-authoritative and saved to the world. A modified client can't bypass it. Grant goodcharacters.reselect to let someone choose again.
• Drop-in characters — a new character is just a folder with a character.json and a skin texture.png; switch it on and order it in menu.json. No code.
• Admin tools — /character reload (hot-reload config) and /character select <id> <player> (force-apply). Per-character permission gates optional VIP characters.

Config (config/cobblemon-characters/)

• menu.json — title, subtitle, and active (the ordered list of character ids that show in the picker).
• characters/<id>/character.json — display_name, texture, slim (Alex 3px vs Steve 4px arms), description, permission, commands[], and buffs[] (each effect + amplifier).
• characters/<id>/texture.png — the character's 64×64 Minecraft skin.
• Selections persist per world in data/cobblemon_characters_selections.json — delete an entry to free a player's one-time choice.

Requirements

Minecraft 1.21.1 — Fabric · Fabric API · needed on server & client

No Kotlin, no hard Cobblemon dependency — it runs on any Fabric 1.21.1 server, and drops straight into a Cobblemon pack (Fabric API is already there).

All Rights Reserved · Dev: igorbescobar