INSTALACIÓN & CONFIGURACIÓN

# Compilación desde el repositorio (Maven Wrapper incluido)
.\mvnw.cmd clean verify -Pfree
.\mvnw.cmd clean verify -Ppremium

# Instalación: detén el servidor, copia UN solo JAR y arranca
plugins/
└─ ProtectTheCore-Premium-2.0.1-SNAPSHOT.jar

plugins/ProtectTheCore/
├─ config.yml                 configuración global
├─ mensajes_es.yml            mensajes, prefijo, ayuda y anuncios
├─ chat_es.yml                formato del chat
├─ lobby-progress.yml         misiones, recompensas y rachas del lobby
├─ PTC-Games/
│  ├─ arenas.yml              arenas, equipos, núcleos, regiones, mesas
│  ├─ shop.yml                catálogo de la tienda
│  ├─ kits.yml                kits iniciales
│  ├─ enchants.yml            niveles y efectos de encantamiento
│  ├─ special_items.yml       objetos especiales de la tienda
│  ├─ levels.yml              progresión de nivel
│  ├─ tab_es.yml              lista TAB y belowname
│  └─ scoreboard_es.yml       sidebar por contexto
├─ PTC-Clanes/
│  ├─ config.yml
│  └─ mensajes_es.yml
├─ PCW-Core/
│  ├─ config.yml
│  └─ mensajes_es.yml
├─ Parkour-Core/
│  ├─ config.yml
│  └─ mensajes_es.yml
├─ Shared/
│  └─ ptc_database.db         base SQLite cuando storage.type = SQLITE
└─ Mapas/
   └─ <arena>.ptcmap         copia base de cada arena

Red y valores por defecto

Almacenamiento y economía

Arena, análisis y restauración

Granjas, lobby y anuncios

Tebex

# Ejemplo de entrega Tebex por RCON / Online Commands:
/ptcdeliver {player} {transaction} coins_{amount} {amount}

# El comando requiere ptc.admin y usa la ventana anti-fraude de config.yml.
# Para jugadores desconectados, activa Offline Commands en Tebex.

• Configura la ubicación exacta con /ptc setlobby. Los jugadores que conectan y quienes salen de una actividad vuelven a ese punto.
• Los materiales, ranuras y activación de objetos de la hotbar se editan en config.yml, bajo lobby.items.* y waiting-room.items.*.
• En mensajes_es.yml, personaliza server-welcome.lines, server-events.join y server-events.quit. Las plantillas aceptan %player_name%, %rank% y %clan%.
• La bienvenida pública y los mensajes de conexión/salida son funciones Premium; los anuncios por contexto están disponibles en ambas ediciones.
• Cada anuncio puede ser una línea o un bloque YAML de varias líneas. Las líneas vacías como - '&f ' se envían tal cual. El prefijo es opcional con announcements.use-prefix: true.
• La frecuencia se ajusta por contexto en announcements.intervals.general|lobby|waiting|ptc|pcw|parkour; si un contexto no tiene intervalo propio usa announcements.interval-seconds.
• La configuración antigua premium-announcements.* se mantiene por compatibilidad; no vuelve exclusivos de Premium los anuncios por contexto.
• El prefijo visible se transcribe exactamente como lo escribas y termina en un reset; el cuerpo conserva su propio color después de >>.
• Mensajes de comandos y ayuda: commands.*, economy.*, stats.* y levels.* cubren las respuestas; help.titles.* y help.entries.* editan la ayuda paginada. Los marcadores se sustituyen al enviar y el archivo nunca se reescribe con valores de fábrica.
• TAB y scoreboard: PTC-Games/tab_es.yml define list-format por contexto, list-nick-color, nametag.contexts y las hasta tres filas de belowname. PTC-Games/scoreboard_es.yml guarda el sidebar.

lobby:
  items:
    selector: {enabled: true, material: COMPASS, slot: 0}
    cosmetics: {enabled: true, material: TOTEM_OF_UNDYING, slot: 2}
    rewards: {enabled: true, material: WRITTEN_BOOK, slot: 4}
    clans: {enabled: true, material: FIREWORK_ROCKET, slot: 8}
    mode-ptc: {enabled: true, material: IRON_SWORD, slot: 11}
    mode-pcw: {enabled: true, material: SHIELD, slot: 13}
    mode-parkour: {enabled: true, material: RABBIT_FOOT, slot: 15}
  cosmetics:
    enabled: true
    interval-ticks: 4
    particles: 6
    list:
      heart:
        material: POPPY
        particle: HEART
        effect: aura
        permission: ptc.cosmetic.heart
        price: 6500
      flame:
        material: FIRE_CHARGE
        particle: FLAME
        effect: fountain
        permission: ptc.cosmetic.flame
        price: 7000
      # soul (spiral, 8000), note (wave, 8500), happy_villager (orbit, 7500),
      # enchant (halo, 9000), portal (vortex, 10000), cherry (twirl, 11000),
      # snow (burst, 12000) y totem (nova, 15000): diez precios distintos.

Añade una clave nueva bajo list y el menú del lobby crea la entrada con su permiso, efecto y precio; no hace falta recompilar. Un effect desconocido usa aura. El permiso y la compra son alternativas: con el nodo se equipa gratis; sin él se compra una vez con Coins y queda desbloqueado en la cuenta.

Se recomienda crear exactamente seis grupos en tu plugin de permisos, uno por nivel ptc.rank.vip-iron … ptc.rank.vip-amethyst, cada uno con su prefijo. Ejecuta /ptc rangos para ver la guía en el servidor y consulta la página de rangos. Ninguno viene activado como paquete de pago: configura precios, expiración, impuestos y términos por separado. Los nodos de cliente no deben incluir permisos administrativos.

1. Detén el servidor de forma limpia y copia plugins/ProtectTheCore/, los mapas y la base de datos.
2. Verifica que no haya dos ediciones del plugin en plugins/; instala solo Free o Premium.
3. Inicia en staging y revisa logs de carga, migración, YAML, TAB y conexión. Conserva la configuración personalizada.
4. Prueba saldo y multiplicadores por separado: abona y retira Coins, y luego verifica el factor y expiración de multicoins.
5. Prueba modalidades, arenas, restauración, permisos y economía antes de actualizar el servidor de producción.
6. Si una arena no está disponible, lee el motivo exacto y ejecuta /ptc validate; no borres archivos para “empezar de cero” sin backup.