PTC Games
Partidas por equipos, arenas, núcleos, recursos, tienda, kits, encantamientos y restauración de mapas.
Ver PTC Games →Una instalación, módulos independientes
Protect The Core se distribuye como un solo plugin. Sus módulos comparten servicios, economía y persistencia; cada modalidad mantiene su propia guía y configuración.
PCW-Core y clanes
Guerras de 2 a 15 clanes, alineaciones parejas, aceptación de líderes y una aparición independiente por clan.
Ver PCW y clanes →Parkour-Core
Cursos agrupados por mapa, checkpoints, récords y recompensas configurables.
Ver Parkour-Core →PTC-Clanes
Creación de clanes con coste en Coins, invitaciones, solicitudes aprobadas por el líder, nombres con color y hasta 250 miembros.
Ver comandos de clanes →Ficha técnica y dependencias
Estos son los datos declarados por el proyecto y los requisitos reales para que el JAR cargue en el servidor.
| Dato | Valor | Detalle |
|---|---|---|
| Nombre y versión | ProtectTheCore · 2.0.1-SNAPSHOT | Un solo plugin con cuatro módulos internos. |
| Artefactos | ProtectTheCore-Free-2.0.1-SNAPSHOT.jarProtectTheCore-Premium-2.0.1-SNAPSHOT.jar | Instala una sola edición por servidor. |
| Plataforma | Paper 26.1.2 o superior | API 26.1; compilado contra paper-api 26.1.2.build.74-stable. |
| Java | 25 | El proyecto usa maven.compiler.release=25; una Java anterior no carga las clases. |
| Comandos raíz | /ptc, /ptcdeliver, /pcw, /pc | Administración, entregas Tebex, guerras de clanes y parkour. |
| Almacenamiento | SQLite por defecto; MySQL/MariaDB opcional | storage.type: SQLITE | MYSQL | MARIADB en config.yml. |
| Carpeta de datos | plugins/ProtectTheCore/ | Configuración, módulos, base de datos y copias .ptcmap. |
| Idioma | Español editable | Mensajes, TAB, scoreboard, ayuda y catálogos en YAML. |
| Componente | ¿Obligatorio? | Versión de referencia | Uso dentro de PTC |
|---|---|---|---|
| Paper | Sí | 26.1.2 o superior | API del servidor, mundos, scoreboard y entidades de texto. |
| Java | Sí | 25 | Requisito de ejecución del JAR compilado. |
| Multiverse-Core | No | 5.8.1 (compilación) | Integración opcional; PTC crea y carga sus mundos con Bukkit/Paper y guarda solo la región de la arena. |
| LuckPerms | No, recomendado | Proveedor de permisos | Rangos, pesos del TAB y permisos de staff y VIP. |
| Vault | No | API de economía/permisos | Puente opcional para prefijos y economía externa. |
| PlaceholderAPI | No, recomendado | 2.11.6 (compilación) | Prefijos de rango y placeholders en TAB, nametags y scoreboard. |
| SQLite JDBC | Incluido | 3.49.1.0 | Controlador embebido para la base local por defecto. |
| MySQL Connector/J | Incluido | 9.3.0 | Controlador embebido para modo multiserver. |
| Tebex | No | Servicio externo | Entrega de Coins mediante /ptcdeliver por RCON. |
Arranque sin dependencias: Multiverse-Core, LuckPerms, Vault y PlaceholderAPI son
softdepend. El plugin inicia sin ellas y activa cada integración cuando la detecta. Para una red con rangos y TAB completo se recomiendan LuckPerms y PlaceholderAPI.Cómo está compuesto el plugin
El código se organiza por responsabilidades. Los módulos de juego no son plugins separados: comparten el mismo ciclo de vida y los mismos servicios.
| Paquete / capa | Responsabilidad |
|---|---|
commands, listeners, editor | Comandos, eventos, varita de selección y análisis de la arena al confirmar los límites. |
modules.games.arena | PTC Games: arenas, equipos, núcleos, espera, partida, tienda, kits y restauración. |
modules.clans | PTC-Clanes: creación, invitaciones, solicitudes, miembros, banco y etiquetas. |
modules.pcw | PCW-Core: salas multiclán, alineaciones, apariciones numeradas y victoria. |
modules.parkour | Parkour-Core: cursos, placas de inicio/meta, checkpoints, récords y premios. |
modules.shared.economy, database | Economía de Coins, multicoins temporales y persistencia SQLite/MySQL. |
presentation | TAB, belowname, scoreboard, menús, anuncios, cosméticos y lobby. |
combat, victory, stats, levels | Combate, condiciones de victoria, estadísticas y progresión. |
shop, kits, enchant, special | Catálogo de tienda, kits, encantamientos y objetos especiales. |
tebex, integration, network | Entregas Tebex, integraciones externas y modo red BungeeCord. |
config, resources | Gestión de archivos, mensajes, módulos y migraciones no destructivas. |
Un ciclo de vida único
Un solo JAR arranca todos los módulos, la base de datos, las tareas de TAB y los servicios compartidos. No hay que instalar PTC Games, Clanes, PCW y Parkour por separado.
Economía compartida
PTC, PCW y Parkour usan los mismos Coins y el mismo saldo. Las compras, los ajustes administrativos y Tebex no reciben el multiplicador de recompensas.
Configuración por módulo
Cada carpeta (PTC-Games/, PTC-Clanes/, PCW-Core/, Parkour-Core/) tiene sus propios YAML y mensajes.
Recarga no destructiva
/ptc reload aplica lo guardado y nunca reescribe tus archivos con valores de fábrica. Si falta una clave, el valor empaquetado se usa solo en memoria.
El detalle de cada paquete, la estructura completa de carpetas y los valores iniciales están en instalación y composición.
Cómo funciona Protect The Core
PTC Games es un modo de equipos con una fase de preparación, una partida y una restauración del mapa entre rondas.
1. Elegir modalidad
Desde el selector del lobby, el jugador elige PTC Games, PCW Clanes o Parkour. PTC y PCW permiten acceder a arenas; Parkour muestra mapas y recorridos, o su lobby dedicado si está configurado.
2. Preparar la arena
En PTC, se reúnen jugadores en espera, se distribuyen equipos y se inicia la cuenta atrás cuando se cumple el mínimo configurado.
3. Defender y atacar
Los equipos reúnen recursos, compran objetos y protegen sus núcleos. La vida del núcleo y las reglas de victoria dependen de las condiciones del modo.
4. Finalizar y restaurar
Tras concluir la ronda, el plugin usa la copia base persistente de la arena para restaurar el mapa. Mantén la copia actualizada después de editar el escenario.
PCW-Core organiza guerras multiclán: cada clan tiene su aparición y la última alineación con supervivientes gana. Parkour-Core es un modo de recorridos, no una arena PTC; ambos usan servicios compartidos del plugin.
Empieza por aquí
Una puesta en marcha segura evita arenas incompletas y problemas al restaurar mapas. La guía completa amplía cada paso con comandos copiables.
- Instala una sola edición en Paper 26.1.2+ con Java 25 y conserva una copia de seguridad antes de actualizar.
- Inicia el servidor y revisa la consola. Confirma edición, versión, base de datos, TAB y proveedor de permisos antes de configurar modos.
- Crea y valida una arena con la varita, los spawns, los núcleos y una copia base. No la habilites hasta que
/ptc validateesté limpio. - Prueba en un entorno de desarrollo. Verifica permisos, restauración, recompensas y visualización con clientes reales.
Importante: compilar correctamente no demuestra que cada función sea compatible con tu servidor o con otros plugins. Haz pruebas reales en la misma versión de Paper y con las dependencias que utilizarás en producción.
Qué comparten los módulos
Los directorios separan la configuración; no son plugins ni economías independientes.
| Módulo | Directorio de datos | Responsabilidad |
|---|---|---|
| PTC Games | PTC-Games/ | Arenas, tienda, kits, encantamientos, TAB y scoreboard. |
| Clanes | PTC-Clanes/ | Datos, configuración y mensajes de clanes. |
| PCW-Core | PCW-Core/ | Arenas y ajustes de guerras de clanes. |
| Parkour-Core | Parkour-Core/ | Cursos, configuración y mensajes de parkour. |
| Servicios compartidos | Shared/ | Persistencia y servicios utilizados por más de un módulo. |
El plugin crea sus carpetas dentro de plugins/ProtectTheCore/. Los mundos, mapas guardados y archivos de datos pueden ubicarse en rutas distintas según la función; consulta la guía de instalación antes de mover o borrar archivos.
Recomendaciones del proyecto
Prácticas que evitan pérdida de datos, permisos regalados y diferencias entre el servidor de pruebas y producción.
Prueba en staging primero
Usa la misma versión de Paper, Java y plugins externos. Los problemas de TAB, nametags y restauración suelen depender de la combinación exacta, no solo del JAR.
Copia de seguridad antes de actualizar
Guarda plugins/ProtectTheCore/, la base de datos y Mapas/. Las copias .ptcmap contienen el estado base de cada arena y son difíciles de reconstruir.
Guarda la copia base tras editar
Si cambias el mapa, vuelve a guardar la arena antes de habilitarla. Una copia antigua restaura el diseño anterior al terminar la partida.
Permisos mínimos
No entregues ptc.*, ptc.admin, ptc.event, ptc.arena.repair ni ptc.arena.delete a compradores o grupos VIP. Usa los nodos ptc.rank.* y los permisos comerciales concretos.
Una sola edición
Free y Premium no deben convivir en plugins/: dos JAR del mismo plugin duplican comandos, tareas y avisos. Sustituye el archivo, no lo agregues.
SQLite o MySQL según la red
SQLite es suficiente para un servidor único. Usa MySQL/MariaDB cuando varios servidores compartan Coins, clanes o estadísticas. No publiques credenciales de base de datos.
Prueba el TAB con clientes reales
La lista, el belowname y la placa vanilla dependen del cliente y de otros plugins de TAB. Verifica lobby, espera, partida y espectador con cuentas reales.
Mantén Multiverse opcional
PTC no necesita Multiverse para guardar o restaurar arenas. Instálalo solo si ya lo usas para gestionar tus mundos y evita mover mapas mientras hay partidas activas.
Seguridad: la configuración puede contener la contraseña de MySQL. No compartas
config.yml completo en capturas, soporte o repositorios públicos. Rota la contraseña si el archivo se expuso.Ajustes que suelen requerir atención
Estos son valores iniciales; revisa la configuración de cada arena y los archivos que el plugin genera.
| Área | Valor inicial consultado | Archivo/clave |
|---|---|---|
| Regeneración de recursos PTC | 900 s (15 minutos) | config.yml → defaults.resource-regeneration-seconds |
| Intervalo de granjas | 5 s | config.yml → farms.check-interval-seconds; repone solo los animales que faltan. |
| Protección horizontal del spawn | Radio 2 | config.yml → arena-map.team-spawn-protection-radius |
| Recompensa por baja | 1 Coin base; cada 5 asesinatos seguidos, +5 Coins | Valores base fijos en código; claves de configuración antiguas se conservan por compatibilidad |
| Daño y destrucción de núcleo | 1 Coin por golpe efectivo; +10 por destrucción final | Valores base fijos en código; claves de configuración antiguas se conservan por compatibilidad |
| Victoria / MVP de PTC | 10 / 3 Coins | config.yml → economy.win-reward y economy.mvp-reward |
| Recompensa de completado Parkour | 10 Coins | Parkour-Core/config.yml → settings.completion-reward-coins |
| Recompensa de victoria PCW | 15 Coins | PCW-Core/config.yml → settings.winner-reward-coins |
| PCW | 2-15 clanes; 1-15 participantes por clan | PCW-Core/config.yml → settings.maximum-clans-per-match / maximum-team-size |
| XP Parkour por checkpoint | 10 XP PTC | Parkour-Core/config.yml → settings.xp-per-checkpoint |
Un multicoins individual y vigente multiplica el premio base una sola vez (por ejemplo, +1 con x2 pasa a +2, no +3); sin un grant activo la recompensa es x1. Las recompensas de juego no aplican límite diario ni el antiguo tope por evento. Las compras, los cambios administrativos de saldo y Tebex no se multiplican. Los precios de PTC-Games/shop.yml son independientes de rangos externos. Consulta las páginas PTC Games, PCW y Parkour.
Documentación por tema
Usa estas páginas como referencia; la configuración activa del servidor y la ayuda del plugin prevalecen si difieren.
Guía completa
De cero a producción: requisitos, instalación, arena, partida de prueba, PCW, Parkour, permisos y problemas frecuentes, con ejemplos copiables.
Abrir la guía completa →Instalación y composición
Dependencias, arquitectura, ediciones, estructura de carpetas, configuración y actualización segura.
Abrir instalación →Administración
Comandos, subcomandos y permisos declarados.
Abrir comandos y permisos →Rangos de tienda
Propuesta opcional de hasta seis niveles, con permisos reales y límites claros.
Consultar guía de rangos →Rangos staff
Permisos de Ayudante, Moderador, Administrador y Dueño, con su alcance y recomendaciones de seguridad.
Consultar perfiles staff →Presentación
Prefijos, etiquetas sobre jugadores, animaciones, TAB y sidebar.
Abrir guía visual →Historial
Resumen de mejoras, correcciones y estado de verificación de la versión.
Ver actualizaciones →Alcance de esta documentación
Esta web describe el proyecto y ayuda a configurarlo; no puede garantizar por sí sola el comportamiento de una instancia activa.
- Los nombres de comandos y rutas se basan en los archivos fuente y recursos de esta versión.
- Los valores indicados como predeterminados pueden cambiarse en los YAML del servidor.
- La compatibilidad depende de la versión de Paper, las integraciones instaladas y la configuración de la red.
- Antes de publicar cambios, prueba el flujo completo con jugadores y copias de seguridad recuperables.