Módulo de recorridos, checkpoints y cronómetro

PARKOUR CORE

Crea recorridos por mapa con placas de inicio y meta, niveles de dificultad, checkpoints ordenados, récords y recompensas integradas con las Coins y la XP PTC.

Mapas y cursos

Parkour no utiliza las arenas PTC. Un mapa puede contener varios cursos; el menú permite elegir el mapa y luego uno de sus recorridos listos.

🗺️

Separación por mapa

Un mapa puede alojar varios cursos; el selector organiza los cursos según el mapa asignado.

⏱️

Carrera y checkpoints

La carrera empieza al pisar la placa de inicio. Los checkpoints se activan en orden y la meta solo completa el recorrido cuando todos fueron alcanzados.

🏆

Récords y recompensas

Se conserva el mejor tiempo por jugador y curso. Coins y XP PTC se calculan al completar según la configuración del módulo, los checkpoints y los límites económicos globales.

Crear y configurar un curso

Se requiere ptc.admin. Las placas identificadas guardan automáticamente inicio, meta y dificultad del recorrido.

Secuencia corta para crear un Parkour:
/pc create Bosque Noob1 → /pc wand Noob1 → colocar 2 placas iguales (inicio y meta) → ir a cada checkpoint y usar /pc checkpoint 1, 2, 3...
Los jugadores pueden empezar pisando la placa o usar /pc start Noob1. Ayuda por perfil: /pc help user, /pc help premium, /pc help staff, /pc help admin.
  1. Crea un recorrido independiente con /pc create Noob1, que lo asigna al mapa General, o créalo directamente dentro de un mapa con /pc create <mapa> <curso>. Los nombres admiten letras, números, guion y guion bajo.
  2. Si hace falta cambiar el mapa después, usa /pc setmap Noob1 <mapa>. Para ver los cursos registrados, ejecuta /pc list.
  3. Ejecuta /pc wand Noob1. Recibirás dos placas de madera (fácil), dos placas de hierro (intermedio) y dos placas de oro (difícil). Elige solo una dificultad y coloca sus dos placas: primero el inicio, después la meta.
  4. Al colocar la segunda placa se guarda la meta y la dificultad; las placas de selección restantes se retiran del inventario. El bloque permanece en el mundo como punto del recorrido.
  5. Configura cada checkpoint desde el bloque/posición deseada con /pc checkpoint 1, después /pc checkpoint 2 y así consecutivamente, hasta 50. No omitas números: un curso solo está listo si el orden es continuo. Importante: /pc checkpoint usa el curso seleccionado por el último /pc wand <curso>.
  6. Cuando un jugador pisa la placa de inicio comienza el cronómetro automáticamente. Debe alcanzar cada checkpoint en secuencia y luego pisar la placa de meta. Si cae más allá de la distancia configurada, regresa al último checkpoint; al morir reaparece allí.
  7. Como alternativa a las placas, configura el inicio y la meta con /pc setstart Noob1 y /pc setfinish Noob1; fija checkpoints con /pc setcheckpoint Noob1 <número>. Para iniciar manualmente una carrera usa /pc start Noob1.
Al volver a ejecutar /pc wand <curso>: se borran los puntos guardados de inicio y meta y se retira del inventario la selección anterior de placas de ese curso; los checkpoints se conservan. No se puede reiniciar la configuración mientras alguien corre ese curso. Recoloca ambas placas antes de volver a publicar el recorrido.
El curso debe tener inicio, meta y checkpoints válidos en el mismo mundo. Los valores iniciales son 10 Coins por finalización, cooldown de recompensa de 1800 segundos, timeout de carrera de 1800 segundos, caída máxima de 8 bloques y 10 XP PTC por checkpoint. Se pueden ajustar los valores globales en Parkour-Core/config.yml; un curso también puede sobrescribir su recompensa. Las recompensas de carrera aplican el multicoins activo y no tienen límite diario.

Ayuda por perfil y comandos

Usa la ayuda interactiva dentro del servidor para ver comandos por nivel de acceso, igual que en /ptc help.

/pc help user [página]
/pc help premium [página]
/pc help staff [página]
/pc help admin [página]

Sin categoría, /pc help abre la guía de jugador. Las categorías user y premium sirven como referencia; staff requiere ptc.staff y admin requiere ptc.admin. Las páginas largas muestran el comando para avanzar. Parkour no implementa comandos exclusivos para VIP/Premium; esa categoría explica las funciones disponibles para todos.

Los comandos de creación/configuración requieren ptc.admin; los comandos de juego y lobby usan ptc.use.

/pc help
/pc list
/pc create <curso> | /pc create <mapa> <curso>
/pc wand <curso>
/pc checkpoint <1-50>
/pc start <curso> | /pc stop
/pc setmap <curso> <mapa>
/pc setstart <curso> | /pc setfinish <curso>
/pc setcheckpoint <curso> <1-50>
/pc setlobby | /pc lobby | /pc leave
/pc coins add <jugador> <cantidad> <curso>
/pc delete <curso> | /pc reload

Los jugadores usan /pc start <curso>, /pc stop, /pc lobby y /pc leave con ptc.use. La creación/edición de cursos, configuración del lobby, recarga y abono administrativo requieren ptc.admin. Durante una carrera, /pc stop cancela y devuelve al jugador a su ubicación previa.

El lobby Parkour es opcional. Si se configura con /pc setlobby, al seleccionar Parkour se usa ese lobby: la brújula abre los mapas/cursos y la estrella de Nether permite volver al lobby central PTC. /pc lobby también permite entrar manualmente. Si no se configuró un lobby Parkour, el selector muestra directamente los mapas; la estrella de salida no se necesita.

/pc coins add <jugador> <cantidad> <curso> acredita el saldo inmediatamente y registra el curso como referencia de transacción; no establece el premio por completar. La recompensa automática se entrega al terminar, una vez por cooldown, aplica el multicoins activo y no tiene límite diario. Los récords guardan el mejor tiempo por jugador y curso; los puntos de checkpoint alcanzados otorgan XP PTC conforme a xp-per-checkpoint.

Configuración alternativa: setstart, setfinish y setcheckpoint siguen disponibles para administrar ubicaciones sin placas.

Hologramas y clasificaciones Top 10

Los hologramas se guardan en la configuración del módulo y se actualizan periódicamente. Colócate en el lugar deseado antes de ejecutar el comando.

/pc coreholograms <curso>
/pc coreholograms topcoins
/pc coreholograms topcompletions
/pc coreholograms topstreak
/pc coreholograms topeasy
/pc coreholograms list
/pc coreholograms remove <id>

El tablero de un curso muestra los diez mejores tiempos. Los rankings globales muestran Coins realmente obtenidas por completar cursos, carreras completadas, mejor racha de finalizaciones consecutivas y cantidad de cursos fáciles distintos completados. Una carrera abandonada, cancelada, desconectada o agotada por timeout reinicia la racha; repetir un curso fácil no aumenta la cuenta de cursos únicos.

Tras crear un tablero, usa list para ver su ID y remove para borrarlo. Los hologramas se renderizan en chunks cargados y se recuperan desde la ubicación persistida cuando el área vuelve a cargarse. Los títulos, subtítulos y líneas se pueden editar bajo holograms en los mensajes Parkour en inglés o español.

Archivos, datos y mensajes

Los recursos predeterminados vienen dentro del JAR en modules/parkour/. En el servidor, la configuración y los catálogos se guardan en plugins/ProtectTheCore/Parkour-Core/.

Configura cursos, ubicaciones, recompensas, cooldown, timeout, distancia de caída, XP y lobby en Parkour-Core/config.yml. Los mensajes editables están en Parkour-Core/mensajes_es.yml; también se pueden personalizar títulos, lore y objetos de navegación en los mensajes generales. No instales otro plugin Parkour: este módulo forma parte de Protect The Core y comparte su economía, persistencia y XP.

Checklist antes de publicar un curso

Un recorrido publicado con checkpoints incompletos o placas mal colocadas genera carreras que nunca terminan.

Puntos completos

Inicio, meta y checkpoints en el mismo mundo. Los checkpoints deben ser consecutivos desde 1 hasta el último, sin huecos. La meta solo completa la carrera cuando se alcanzaron todos.

Prueba real del recorrido

Haz la carrera completa con un jugador real: salto inicial, cada checkpoint, caída al último punto y meta. Comprueba que la altura y la distancia de caída no expulsen al jugador de la zona.

Recompensa y cooldown

Revisa completion-reward-coins, completion-cooldown-seconds, run-timeout-seconds y xp-per-checkpoint. Un cooldown corto permite farmear Coins; uno largo puede frustrar a los jugadores.

Lobby y salida

Si usas lobby Parkour, configura /pc setlobby y prueba la brújula de cursos y la estrella de salida. Sin lobby, el selector debe seguir mostrando los mapas correctamente.

Hologramas y récords

Coloca los hologramas en zonas cargadas y comprueba que el Top 10 se actualiza tras una carrera válida. Una carrera cancelada o agotada por timeout no debe contar como récord.

Mensajes y permisos

Verifica los mensajes de Parkour-Core/mensajes_es.yml y que los jugadores tengan ptc.use, mientras la creación y edición quedan en ptc.admin.