UltimatePlayerCounter

# UltimatePlayerCounter

*Plugin de Velocity que personaliza dinámicamente el listado de servidores (MOTD): jugadores máximos, contador con "boost", mensaje de bienvenida, icono y versión — todo configurable y recargable sin reiniciar el proxy.*

---

## Español

### ¿Qué hace este plugin?

**UltimatePlayerCounter** te da control total sobre lo que ven los jugadores en la lista de servidores de Minecraft (server list), sin tocar `velocity.toml` ni reiniciar tu proxy cada vez que quieras cambiar algo.

### ✨ Características

- **Máximo de jugadores dinámico**: define rangos según los jugadores conectados (ej. si hay menos de 10, muestra máx. 10; si hay menos de 20, muestra máx. 20...). Totalmente configurable, tantos rangos como quieras.
- **Boost de jugadores**: suma un número extra (fijo o aleatorio dentro de un rango) al conteo real, para que tu servidor se vea más activo. Se puede activar/desactivar.
- **MOTD personalizado**: dos líneas con soporte completo de colores (`&c`, `&a`, `&l`, etc.), listas para copiar y pegar tu propio diseño.
- **Icono del servidor (favicon)**: solo coloca tu imagen PNG en la carpeta del plugin y el resto es automático.
- **Recarga en caliente**: comando `/upc reload` — aplica todos los cambios de configuración al instante, sin reiniciar el proxy.
- **Config en UTF-8**: soporte completo para tildes, símbolos (✦ • ¡ ¿) y caracteres especiales sin que se corrompan.
- **Auto-generación de configuración**: si no existe el archivo, se crea solo con valores de ejemplo la primera vez que arranca.

### Instalación

1. Descarga el `.jar` y colócalo en la carpeta `plugins/` de tu proxy Velocity.
2. Inicia el proxy — se generará automáticamente `plugins/ultimateplayercounter/config.properties`.
3. Edita el archivo a tu gusto (MOTD, rangos, boost, icono, versión).
4. (Opcional) Agrega tu icono como `icon.png` en la misma carpeta.
5. Ejecuta `/upc reload` para aplicar los cambios sin reiniciar.

### ⚙️ Comandos y permisos

| Comando | Descripción | Permiso |
|---|---|---|
| `/upc reload` | Recarga la configuración desde el disco | `upc.reload` |

### Requisitos

- Velocity 3.3.0 o superior
- Java 11 o superior

### Ejemplo de configuración

```properties
threshold.10=10
threshold.20=20
default-max=120

boost.enabled=true
boost.min=5
boost.max=15

motd.line1=&d&l✦ &5&lMiServidor &d&l✦
motd.line2=&7¡Conéctate ya! &8| &a¡Bienvenido!

icon.enabled=true
icon.file=icon.png

```

---

## English

### What does this plugin do?

**UltimatePlayerCounter** gives you full control over what players see in the Minecraft server list, without touching `velocity.toml` or restarting your proxy every time you want to change something.

### ✨ Features

- **Dynamic max players**: define ranges based on how many players are online (e.g. under 10 online → show max 10; under 20 → show max 20...). Fully configurable, as many ranges as you want.
- **Player count boost**: adds an extra number (fixed or random within a range) to the real player count, making your server look more active. Can be enabled or disabled.
- **Custom MOTD**: two lines with full color code support (`&c`, `&a`, `&l`, etc.), ready to paste your own design.
- **Server icon (favicon)**: just drop a PNG image in the plugin folder and it's applied automatically.
- **Hot reload**: `/upc reload` command — applies all config changes instantly, no proxy restart needed.
- **UTF-8 config**: full support for accents, symbols (✦ • ¡ ¿) and special characters without corruption.
- **Auto-generated config**: if the file doesn't exist, it's created with sample values the first time the proxy starts.

### Installation

1. Download the `.jar` and drop it into your Velocity proxy's `plugins/` folder.
2. Start the proxy — `plugins/ultimateplayercounter/config.properties` will be generated automatically.
3. Edit the file to your liking (MOTD, ranges, boost, icon, version).
4. (Optional) Add your icon as `icon.png` in the same folder.
5. Run `/upc reload` to apply changes without restarting.

### ⚙️ Commands & permissions

| Command | Description | Permission |
|---|---|---|
| `/upc reload` | Reloads the configuration from disk | `upc.reload` |

### Requirements

- Velocity 3.3.0 or higher
- Java 11 or higher

### Config example

```properties
threshold.10=10
threshold.20=20
default-max=120

boost.enabled=true
boost.min=5
boost.max=15

motd.line1=&d&l✦ &5&lMyServer &d&l✦
motd.line2=&7Join now! &8| &aWelcome!

icon.enabled=true
icon.file=icon.png

```

---

**Autor / Author:** Dev_SrFernando