🧭
Entrar y prepararse
Los jugadores usan el selector del lobby, /ptc join <arena> o /ptc join random para entrar a la arena en cuenta atrás o con más jugadores. La sala de espera organiza equipos y cuenta atrás.
Cómo se juega
El objetivo es conservar el núcleo propio y destruir el de los rivales. Una arena puede tener equipos configurados y capacidades propias.
🛡️
Defender el spawn y núcleo
La configuración global incluye protección de spawn de equipo con radio 2 y altura 2. Las regiones y reglas específicas dependen de la arena.
⚔️
Combatir y mejorar
La tienda, kits, encantamientos, eventos y mejoras del núcleo se controlan por configuración y estado de partida.
🧱
Restaurar el mapa
Guarda una copia base de la arena y utiliza el flujo de restauración/repair para devolver el área al estado guardado. La copia .ptcmap v3 usa paleta y repeticiones, conserva solo el cubo de la arena y verifica bloques e inventarios al aplicarse. Las copias v2 anteriores se siguen leyendo.
Las arenas PTC pueden estar en mundos Bukkit/Paper distintos. Se persisten el nombre y UUID del mundo para resolver ubicaciones sin confundir el nombre de arena con el del mundo. Multiverse-Core 5.x es opcional: PTC no lo necesita para guardar, reconstruir ni analizar, y la copia guardada nunca incluye el mundo completo. Las arenas PCW actualmente persisten apariciones; PCW no ofrece aún copia de bloques ni reparación de mapa.
Tienda de la arena
El catálogo usa una navegación por secciones y conserva el sistema de compras existente.
Secciones principales
Objetos y equipo, encantamientos, mejoras del núcleo y tiempo de partida. El catálogo de equipo agrupa kits, armaduras, armas, herramientas, bloques, alimentos, utilidad, movilidad y pociones.
Catálogo ampliado
Incluye siete armas y cinco herramientas preencantadas, 32 libros de encantamiento, tótem, elytra irrompible, cohetes, perlas, cargas de viento, botas de explorador y tridente con riptide. Todo se edita en PTC-Games/shop.yml.
Campos por artículo
Cada entrada admite enchantments, stored-enchantments (solo libros), unbreakable, potion-type, special, permission, enabled, slot, precio y cantidad. Si un artículo pide un encantamiento inexistente en tu versión, PTC lo avisa en consola y no rompe la tienda.
Kits
PTC-Games/kits.yml admite nombre, pociones, encantamientos de objetos y armor-enchantments.<pieza>. Además de los kits clásicos hay Berserker, Tirador y Asesino, configurables o eliminables.
Personalización
Administra títulos, iconos, ranuras, panel de relleno, precios y contenido en PTC-Games/shop.yml. La página actual, el precio y el saldo aparecen en la interfaz paginada. Los slots duplicados se avisan en consola y se colocan en el primer hueco libre.
Final de partida y lobbies
Las arenas, el lobby central de PTC y el lobby de Parkour son ubicaciones independientes.
Victoria y eliminación
Cuando solo queda un núcleo de equipo activo se declara ganador. Si el resto abandona la partida y queda un único jugador activo, su equipo gana y recibe la recompensa reducida configurable en economy.solo-survivor-win-reward. Los jugadores eliminados vuelven a la sala de espera de esa arena y después al lobby central; no quedan en modo espectador.
Restauración al quedar vacía
Si todos los jugadores y espectadores abandonan una partida ya iniciada, la arena entra automáticamente en restauración del mapa. Al completarse queda operativa otra vez en estado de espera.
Votación de tienda
Si nadie vota, la tienda queda habilitada por defecto. Al comenzar se ignoran votos de jugadores que ya abandonaron la arena.
Mensajes de arena
Los avisos de regeneración de recursos se muestran solo a los participantes que estén dentro del mapa de una arena en juego, no en la espera ni en otros lobbies.
Estadísticas en la espera
El libro de estadísticas de la hotbar abre una interfaz con asesinatos, muertes, asistencias, núcleos destruidos, victorias, derrotas y tiempo acumulado en partidas. Los nombres, títulos y descripciones de esta interfaz se editan en los mensajes globales en inglés o español.
Objetos del lobby
El lobby PTC fija la brújula en la ranura 1, recompensas en la 5 y clanes en la 9; Premium añade cosméticos en la 3. Free no incluye cosméticos. El lobby Parkour conserva sus propios objetos y posiciones.
Fases y configuración esencial
El flujo ayuda a diagnosticar por qué una arena no aparece o no inicia.
Lobby y espera
/ptc setlobby fija el lobby central; /ptc setspawnarena <arena> define la espera de una arena. Son puntos separados.
Equipo y núcleo
Define spawn de cada equipo y asigna su bloque de núcleo. Valida que los núcleos estén dentro de los límites y que cada equipo habilitado tenga su configuración.
Regiones y recursos
Usa detección y regiones compatibles para registrar recursos/minerales, bosques y zonas especiales. Revisa el mapa en juego: el análisis y la restauración dependen de los límites configurados. El análisis trabaja con instantáneas de chunk, omite secciones vacías y mantiene la revisión de todos los bloques reales; FREE y PREMIUM limitan su lote por arena-map.blocks-per-tick y el tiempo por tick con arena-map.analysis-max-millis-per-tick.
Copia base y mundo aislado
Guarda la arena con /ptc arena <arena> save. El plugin conserva una plantilla del cubo de la arena y prepara el destino ptc_<arena>. Si el mundo aislado no puede prepararse, la copia queda guardada y la arena sigue jugable en su mundo actual; repair reutiliza el mundo registrado o repara en el actual. Los límites verticales usan el Y real de la selección más selection-vertical-padding (24 por defecto).
Prueba de aceptación de una arena
Usa una instancia de pruebas y jugadores de prueba antes de habilitar el mapa público.
- Comprueba límites, mundo y sala de espera con
/ptc validate <arena>. - Verifica spawn de jugadores, núcleos, recursos, tiendas, granjas y protección de zonas.
- Prueba el ciclo de partida, condiciones de victoria y permisos de jugadores y espectadores.
- Termina la ronda y confirma la restauración del escenario y contenedores desde su copia base.
- Si hay una restauración incompleta, detén el acceso, revisa la consola y la copia; ejecuta
repairúnicamente con el mapa guardado correcto.
Ritmos configurables
Valores predeterminados del recurso de configuración global. Pueden cambiarse en config.yml.
| Sistema | Predeterminado | Ruta |
|---|---|---|
| Regeneración de recursos | 900 segundos (15 minutos) | defaults.resource-regeneration-seconds; ajuste por arena en arenas.<nombre>.resource-regeneration-seconds |
| Reposición de animales | Cada 5 segundos, solo los que faltan | farms.check-interval-seconds |
| Protección alrededor del spawn | Radio 2, altura 2 | arena-map.team-spawn-protection-radius y arena-map.team-spawn-protection-height |
| Materiales regenerables extra | Vacío (se detectan todos los troncos y minerales) | arena-map.regenerable-materials y arena-map.wood-materials |
Granjas exactas: si configuras 10 cerdos por equipo y quedan 4, PTC añade solo los 6 que faltan en el punto de
/ptc setfarmspawn. No vuelve a aparecer la manada completa hasta que se eliminan los animales de la ronda o se repone la diferencia. Los excesos se retiran en la siguiente comprobación.Troncos y minerales: todos los troncos (
_LOG, _STEM, _WOOD, _HYPHAE, planks, mosaic, bambú, tallo de hongo, raíces de mangle y los tipos nuevos como PALE_OAK), los minerales, la piedra y la deepslate se regeneran en el mismo ciclo. Al romperlos, sus drops pasan directamente al inventario del jugador; si no hay espacio, la rotura se cancela y se avisa. Puedes ampliar la lista con arena-map.regenerable-materials y arena-map.wood-materials; nunca se regeneran dentro de zonas protegidas, tiendas, núcleos o bases.Importante: son valores iniciales de configuración, no una promesa de que cada arena ya esté revisada en una sesión activa de Paper. Verifica copias, spawns, límites y disponibilidad real antes de abrir una partida al público.
Crear y revisar una arena
Secuencia completa con cuatro equipos. Sustituye el nombre y los colores por los de tu mapa y ejecútala como administrador.
# 1. Crear la arena y seleccionar sus límites /ptc create Clasica 4 /ptc wand /ptc select map Clasica # Clic izquierdo = Pos1 · clic derecho = Pos2 # Al segundo clic, PTC confirma, analiza y guarda los límites. # 2. Puntos de entrada /ptc setspawnarena Clasica /ptc setspectatorspawn Clasica /ptc setspawn Clasica rojo /ptc setspawn Clasica azul /ptc setspawn Clasica verde /ptc setspawn Clasica amarillo # 3. Núcleos: mira el bloque de diamante y ejecuta el comando /ptc core Clasica rojo set /ptc core Clasica azul set /ptc core Clasica verde set /ptc core Clasica amarillo set # 4. Tienda, mesas, granjas y presentación /ptc shop Clasica set /ptc protectenchant Clasica set /ptc protectcraft Clasica set /ptc setfarmspawn Clasica rojo pig 5 /ptc arena config Clasica /ptc selectmap-time Clasica day # 5. Validar, guardar y habilitar /ptc validate Clasica /ptc arena Clasica save /ptc enable Clasica
La varita ya confirma sola: tras el segundo clic no necesitas escribir
/ptc map confirm; PTC guarda los límites con el relleno vertical configurado (24 bloques por defecto) y analiza el mapa. El análisis detecta minerales, madera y mesas de encantamiento reales, y registra estas últimas como regiones protegidas.Núcleos y tienda:
/ptc core <arena> <equipo> set exige mirar un DIAMOND_BLOCK a menos de 10 bloques y dentro de los límites; crea la zona de núcleo automáticamente. /ptc shop <arena> set exige mirar END_STONE o END_PORTAL_FRAME. Los equipos admiten nombres visibles como rojo, azul, verde o amarillo, además de claves como RED o BLUE.Mesas protegidas:
/ptc protectenchant <arena> set y /ptc protectcraft <arena> set protegen todas las mesas de ese tipo que estén en las zonas de los equipos (alrededor de cada spawn, núcleo y región BASE), además de la mesa que estés mirando (a menos de 10 bloques) dentro de la arena. Las mesas registradas no pueden romperse, pero se usan con normalidad para encantar o craftear. Las mesas que coloquen los jugadores durante la partida no están registradas y pueden romperse; los bloques y mesas guardados con la arena siguen protegidos. Cada arena guarda sus propias listas en arenas.yml.Reparación:
/ptc arena <arena> repair inicia el flujo de reparación de la arena seleccionada. La arena debe estar vacía y en espera, y debe existir una copia base válida; antes de aplicarla, se verifica su checksum cuando está disponible./ptc delete <arena> elimina una arena PTC en espera, su configuración y sus plantillas; requiere el perfil Dueño (ptc.rank.owner), porque solo este hereda ptc.arena.delete. Administradores pueden crear, configurar, editar, guardar y reparar mapas, pero no eliminarlos. Si el mapa tiene un mundo dedicado PTC, también elimina ese mundo solo cuando no hay jugadores ni referencias desde otras arenas PTC/PCW o el lobby. La operación es asíncrona; espera el mensaje final antes de volver a crear una arena con el mismo nombre.
/ptc selectmap-time <arena> <day|noon|sunset|night|midnight|sunrise> establece la hora inicial y desactiva el ciclo día/noche. El menú /ptc arena config <arena> permite elegir la hora (día, mediodía, atardecer, noche, medianoche o amanecer), alternar el ciclo día/noche y configurar el clima: natural, despejado (sin lluvia ni nieve), lluvia o tormenta, además del ciclo de clima. La hora y el clima elegidos se aplican al iniciar la partida y se guardan por arena en arenas.yml. El modo de edición bloquea la arena hasta mapsave. La restauración valida BlockData e inventarios de bloques compatibles; en esta revisión pasó las pruebas automatizadas y los validadores del proyecto. Antes de abrir el mapa, confirma en staging los TileState propios de tu escenario (carteles, cofres, hornos y mesas).
Selector y ciclo de arena
El selector muestra modalidades y estados de arena. PTC Games y PCW aparecen como modos distintos del mismo plugin.
Estados visibles
El menú distingue arenas disponibles, en cuenta atrás, en partida o en mantenimiento/reconstrucción de acuerdo con su estado operativo.
Copias y límites
Selecciona y configura regiones con la PTC Wand, fija spawns y núcleos, guarda la copia y valida antes de habilitar.
Comandos de operación
/ptc arena <arena> start|pause|resume|stop|status da herramientas de control a personal con los permisos correspondientes.