COMANDOS & PERMISOS

• Los alias registrados para el comando principal son /protectthecore y /ptcmd; para entregas Tebex, /ptcd es alias de /ptcdeliver.
• /ptc help [user|premium|staff|admin] [página] muestra ayuda paginada. La ayuda del servidor y el código de la versión instalada prevalecen sobre esta guía.
• La mayoría de las acciones técnicas de /ptc exigen OP o ptc.admin. La reparación manual admite el permiso específico ptc.arena.repair. El control de arenas de evento admite ptc.event; perks, chat de staff y funciones sociales usan controles específicos.
• Los subcomandos PCW y Parkour requieren que el emisor sea jugador. ptc.admin protege la configuración; los flujos de juego se controlan con estado, clan y alineación.

La incorporación tardía se habilita en arenas.yml → arenas.<nombre>.allow-late-join; config.yml → defaults.allow-late-join define el valor inicial para arenas que no lo sobrescriban.

Administrar saldo: permiso ptc.admin

/ptc coins
/ptc coins add <jugador> <cantidad>
/ptc coins give <jugador> <cantidad>
/ptc coins remove <jugador> <cantidad>
/ptc coins take <jugador> <cantidad>
/ptc coins set <jugador> <saldo>

• add/give son equivalentes: suman una cantidad entera positiva de Coins.
• remove/take son equivalentes: descuentan la cantidad si el saldo alcanza; si no alcanza, la operación se rechaza y el saldo no queda negativo. También se aceptan subtract, quitar y retirar.
• set establece el saldo exacto; admite cero y rechaza cantidades negativas.
• El jugador objetivo debe estar conectado. Así el saldo cargado en memoria se actualiza junto con el registro de la base de datos de la sesión activa.
• Estas operaciones administrativas no usan multicoins para multiplicar la cantidad entregada.

Asignar multiplicador temporal: permiso ptc.admin

/ptc multicoins <jugador> <x2-x250> <duración>
/ptc multicoins <jugador> reset
/ptc coins

Unidades válidas: minutos (20min o 20 minutos), horas (2h o 2 horas), días (30d o 30 días) y meses de 30 días (1mo o 1 mes). El multiplicador debe ser entero de x2 a x250; x1 es el valor normal y no se asigna como bono. reset retira el grant. Los grants se guardan en multipliers.yml y vencen también después de reiniciar el servidor.

Los grants individuales de multicoins son la única fuente de multiplicadores: los permisos o comodines ptc.booster.* no multiplican recompensas. El factor x1 se usa si no hay un grant vigente. Las recompensas de bajas válidas, hitos de racha y núcleo aplican el multicoins activo y no tienen límite diario ni tope histórico por evento. Compras, cambios administrativos de saldo y entregas de Tebex no se multiplican.

/ptc clan help
/ptc clan create <nombre> <tag>
/ptc clan apply <tag-o-nombre>
/ptc clan accept <jugador>
/ptc clan deny <jugador>
/ptc clan invite <jugador>
/ptc clan join <tag-o-nombre>
/ptc clan leave
/ptc clan kick <jugador>
/ptc clan disband
/ptc clan bank deposit <cantidad>
/ptc clan chat <mensaje>
/ptc clan c <mensaje>
/ptc clan info [tag-o-nombre]

La fundación exige el nodo ptc.clan.create más el saldo de Coins configurado; unirse requiere ptc.clan.join y el resto de comandos de miembro requieren ptc.clan. Ninguno se concede por defecto: se asigna con el rango de pago o como permiso temporal. help e info siguen disponibles para consultar cualquier clan.

apply (alias solicitar, pedir) manda al líder un bloque por chat con los comandos para responder; accept/deny (alias aceptar/denegar/rechazar) son exclusivos del líder. Con invitación vigente basta join y no hay que aceptar nada. Cada clan admite hasta 250 miembros (modules/clanes → settings.max-members) y las solicitudes caducan a los 120 segundos (settings.application-timeout-seconds).

El nombre admite códigos de color y hasta 18 caracteres visibles (&a&lDestru&c<ores); el tag se mantiene de 2 a 6 caracteres alfanuméricos. Solo líderes y oficiales pueden invitar; expulsar, disolver o administrar el banco depende del rol interno. Para ver comandos y mensajes actuales, usa /ptc clan help.

Ayuda paginada por perfil (igual que /ptc help): /pcw help user [página], /pcw help premium [página], /pcw help staff [página] y /pcw help admin [página]. Staff requiere ptc.staff; la categoría administrativa requiere ptc.admin.

Flujo de sala: líder o co-líder

/pcw create <clanes 2-15> <jugadores-por-clan 1-15> <arena>
/pcw inviteclan <tag-del-clan>
/pcw accept
/pcw confirm
/pcw invite <jugador-de-tu-clan>
/pcw join
/pcw leave

Ejemplo: /pcw create 4 3 DueloClanes abre una sala para cuatro clanes con tres participantes por clan. Invita los otros clanes con /pcw inviteclan; cada líder acepta, y una vez completo el cupo todos los líderes/co-líderes confirman con /pcw confirm. Luego un líder/co-líder invita miembros conectados de su clan y cada invitado acepta con /pcw join. La partida arranca automáticamente cuando todas las alineaciones están completas. Abandonar una partida activa cuenta como eliminación.

Crear y configurar arenas: ptc.admin

/pcw arena create <nombre>
/pcw arena setspawn <arena> <slot 1-15>
/pcw arena list
/pcw arena delete <nombre>
/pcw reload

Define una aparición por cada clan: desde la ubicación del primer equipo usa /pcw arena setspawn DueloClanes 1, y repite con los slots 2, 3 y siguientes. Los spawns deben estar separados al menos dos bloques si comparten mundo. Las apariciones antiguas red y blue se conservan como slots 1 y 2. La configuración está en PCW-Core/config.yml: máximo de clanes, jugadores por clan, partidas simultáneas, tiempo de expiración, fuego amigo, inventario inicial y recompensa de victoria.

Los participantes conversan en el canal PCW. Al acabar, gana el último clan con supervivientes; una partida sin ningún clan superviviente termina en empate. La recompensa se otorga a los jugadores ganadores y usa el multicoins. Las bajas válidas y las rachas también entregan Coins; no hay límite diario.

Se conserva /pcw challenge <clan> <tamaño> como ruta de duelo entre dos clanes; las salas multiclán se crean explícitamente con /pcw create. La selección de arena directa con /pcw arena select es opcional en ese flujo histórico. Las salas se administran por comandos, no mediante una GUI de confirmación.

Usa /pc help user, /pc help premium, /pc help staff o /pc help admin para abrir la guía paginada por perfil. Staff requiere ptc.staff; la ayuda de administrador requiere ptc.admin. La categoría Premium es informativa: Parkour no posee comandos exclusivos de rango.

/pc help | /pc list
/pc start <curso> | /pc stop
/pc create <curso> | /pc create <mapa> <curso>
/pc wand <curso> | /pc checkpoint <1-50>
/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

ptc.use permite correr o cancelar carreras, entrar al lobby Parkour y salir. ptc.admin permite crear/editar cursos, fijar el lobby, recargar y acreditar Coins. Crea el recorrido con /pc create <curso> (mapa General) o /pc create <mapa> <curso>; cambia el mapa con /pc setmap <curso> <mapa>.

/pc wand <curso> entrega dos placas de madera/fácil, dos de hierro/intermedio y dos de oro/difícil. Elige una sola dificultad y coloca ambas placas de ese tipo: primera inicio, segunda meta. La segunda placa guarda también la dificultad y retira las placas de selección restantes. Ejecutar el wand de nuevo borra inicio/meta, pero conserva los checkpoints.

Con el curso seleccionado por /pc wand, párate en cada punto y ejecuta /pc checkpoint 1, /pc checkpoint 2, etc., consecutivamente hasta 50. La alternativa es /pc setstart, /pc setfinish y /pc setcheckpoint <curso> <número>. El jugador inicia al pisar la placa de inicio, completa checkpoints en orden y termina al pisar la meta. Si cae, vuelve al último checkpoint; si muere, reaparece en ese punto. También puede iniciar por comando con /pc start <curso> y cancelar con /pc stop.

/pc coins add <jugador> <cantidad> <curso> acredita Coins inmediatamente (puede dirigirse a una cuenta offline existente) y anota el curso como referencia; no configura la recompensa automática. El premio por completar, el cooldown, el timeout, la distancia de caída y la XP por checkpoint se ajustan en Parkour-Core/config.yml. La carrera guarda el mejor tiempo por jugador y curso; las recompensas automáticas respetan el multicoins y no tienen límite diario.

El lobby Parkour es opcional: /pc setlobby lo configura; /pc lobby entra y /pc leave regresa al lobby PTC usando la estrella de salida. Si no existe lobby Parkour, el selector de modalidades abre la lista de mapas directamente. Los textos del módulo se editan en Parkour-Core/mensajes_es.yml.

/ptc a <mensaje>
/ptc staff <mensaje>
/ptc help staff

El perfil ptc.rank.helper concede ptc.staff. El chat también está disponible con OP o ptc.admin. Los permisos de espectador, eventos y reparación son independientes y se documentan en la matriz staff.

Crear y editar arenas

/ptc create <nombre> [cantidad-de-equipos]
/ptc map-time list
/ptc map-time create <sala>
/ptc map-time <sala> spawn
/ptc map-time <sala> status
/ptc map-time <sala> confirm <arena>
/ptc wand
/ptc select map <arena>
/ptc map confirm <arena>
/ptc wandmap-select confirmar <arena>
/ptc selectedit-arena <arena>
/ptc arena config <arena>
/ptc arena totalteams [<arena>] <cantidad>
/ptc setlobby
/ptc setspawnarena <arena>
/ptc setspectatorspawn <arena>
/ptc setspawn <arena> <equipo>
/ptc setfarmspawn <arena> <equipo> <animal> <cantidad>
/ptc setspawnanimals <arena> <equipo> <animal> <cantidad>
/ptc core <arena> <equipo> set
/ptc shop <arena> set
/ptc protectenchant <arena> <set|remove|list>
/ptc protectcraft <arena> <set|remove|list>
/ptc region <arena> <tipo> <equipo|none>
/ptc base <arena> <equipo>
/ptc center <arena>
/ptc corezone <arena> <equipo>
/ptc protect <arena> enchanting
/ptc validate <arena>

Mantenimiento y ciclo de partida

/ptc arena <arena> save
/ptc arena <arena> repair
/ptc enable <arena>
/ptc disable <arena>
/ptc arena <arena> start
/ptc arena <arena> pause
/ptc arena <arena> resume
/ptc arena <arena> stop
/ptc arena <arena> status
/ptc end <arena>
/ptc setminplayers <arena> <mínimo>
/ptc regen <arena>
/ptc setregen <arena> <segundos>
/ptc test start <arena> [jugadores-simulados]
/ptc test stop <arena>

/ptc protectenchant y /ptc protectcraft con 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 y dentro de los límites) para que no pueda romperse durante la partida. Los jugadores siguen usándolas con normalidad para encantar o craftear; las mesas que ellos colocan durante la partida no están protegidas y se pueden romper, mientras que los bloques guardados con la arena siguen protegidos. remove quita la protección de la mesa apuntada y list muestra mundo y coordenadas. Las mesas protegidas se guardan con la arena y sobreviven a save/repair. El comando /ptc arena config <arena> fija la hora (día, mediodía, atardecer, noche, medianoche o amanecer) y el clima (natural, despejado, lluvia o tormenta); al elegir una hora se desactiva el ciclo día/noche para que se mantenga durante la partida. Los troncos y tablones configurados en arena-map.wood-materials se pueden romper y regeneran junto con los minerales de regenerable-materials.

La reparación necesita una copia base existente creada con save. Guardar ya no bloquea la entrada a la arena: el guardado por lotes termina en segundo plano, prepara el mundo aislado ptc_<arena> si está configurado y solo entonces habilita la arena; si el mundo aislado no puede prepararse, la copia queda guardada y la arena sigue jugable en su mundo actual. La copia .ptcmap v3 guarda solo el cubo de la arena con paleta y tramos comprimidos, y la restauración verifica bloques e inventarios al aplicar; las copias v2 anteriores siguen siendo válidas. Tras editar el mundo, vuelve a guardar la copia antes de habilitar la arena. Si falla la autoreparación, solo usuarios conectados con ptc.arena.repair (o ptc.admin) reciben el aviso; los reintentos automáticos se espacian para evitar ciclos continuos. start/pause/resume/stop/status se usan para eventos y controles; ptc.event da acceso a esos controles, mientras que creación, edición y guardado de mapas requieren administración. El borrado de arenas PTC/PCW queda reservado al Dueño con ptc.arena.delete.

Otros comandos administrativos

/ptc coins add|give|remove|take|set <jugador> <cantidad>
/ptc multicoins <jugador> <x2-x250|reset> [duración]
/ptc level addxp <jugador-conectado> <xp>
/ptc level set <jugador-conectado> <nivel>
/ptc database
/ptc db
/ptc tebex status
/ptcdeliver <jugador> <transactionId> <productCode> <cantidad>
/ptc shop reload
/ptc kit reload
/ptc enchant reload
/ptc special <acción>
/ptc reload
/ptc rangos
/ptc debug

/ptc map-time es un flujo heredado para configurar/listar/vincular salas de espera; para una arena normal se recomienda /ptc setspawnarena <arena>. /ptc db es alias de /ptc database. Tebex requiere ptc.admin; entrega las transacciones desde la integración autorizada de Tebex/RCON y no compartas claves o datos privados en la web. special administra objetos especiales; consulta /ptc help admin para las acciones que exponen la versión instalada. El comando de diagnóstico alterna el registro de eventos.

Los objetos especiales disponibles incluyen demosword, thunderbow, bridgeegg, flashbang, gravity, freeze, shield, jetpack y boots; también existen alias. Ejemplo: /ptc special thunderbow Alex. El destino opcional debe estar conectado; sin destino se entrega al administrador que ejecutó el comando.

Usuarios: acceso gratuito y consultas

Rangos de pago: beneficios acumulativos

Cosméticos: diez estelas, un nodo por cosmético

Cada entrada de config.yml → lobby.cosmetics.list declara su propio permiso, su efecto y su precio en Coins. El permiso y la compra son alternativas: con el nodo el cosmético se equipa gratis; sin el nodo el menú permite comprarlo una vez con Coins y el desbloqueo queda guardado por cuenta. Todos los precios de serie superan los 5000 Coins y son distintos entre sí.

# config.yml → lobby.cosmetics
enabled: true          # false desactiva todo el módulo (útil con otro plugin de cosméticos)
list:
  happy_villager:
    material: EMERALD
    particle: HAPPY_VILLAGER
    effect: orbit
    permission: ptc.cosmetic.happy_villager
    price: 7500

Añade una clave nueva y PTC crea la entrada del menú con su permiso, su efecto y su precio; el nodo se declara en LuckPerms igual que los anteriores. Los efectos válidos son aura, fountain, orbit, spiral, wave, halo, vortex, twirl, burst y nova; un valor desconocido usa aura. La estela solo se emite en el lobby central (lobby.world) y en la edición Premium. Con lobby.cosmetics.enabled: false PTC no entrega el objeto, no abre el menú y no emite estelas; los desbloqueos guardados se conservan por si vuelves a activarlo.

Staff: perfiles internos, nunca a la venta

# 30 días para poder fundar y unirse a clanes
/lp user notch permission set ptc.clan true 30d
/lp user notch permission set ptc.clan.create true 30d
/lp user notch permission set ptc.clan.join true 30d

# un cosmético concreto, también con caducidad
/lp user notch permission set ptc.cosmetic.flame true 90d

• Los permisos temporales se revisan con /lp user notch permissions info y se revocan antes de tiempo con /lp user notch permission clear <nodo>.
• Si el pago es un rango completo, asigna el grupo con /lp user notch parent add vip3 30d en lugar de nodos sueltos.
• Un cosmético comprado con Coins queda desbloqueado en la cuenta y se puede equipar aunque el nodo se retire o caduque; el desbloqueo solo se pierde si se borra el progreso del jugador. Quien tenga el nodo no necesita comprarlo.

• Fundar (ptc.clan.create): sigue costando Coins (modules/clanes → settings.creation-cost), pero sin el nodo no se crea, aunque tengas saldo.
• Unirse (ptc.clan.join): obligatorio para solicitar la entrada (apply) y para aceptar una invitación (join). El permiso es la puerta, no el pase: entra quien el líder acepte.
• Comandos de miembro (ptc.clan): invite, leave, kick, bank, chat y disband lo exigen; help e info siguen abiertos para poder consultar fichas. accept y deny no tienen nodo propio: entran con cualquiera de los tres y solo los ejecuta el líder del clan.
• Nombre con diseño: hasta 18 caracteres visibles y códigos como &a o &l, por ejemplo &a&lDestru&c<ores. Los códigos no cuentan en la medida, se guardan tal cual en la base de datos y se colorean en chat, menús y fichas. La comprobación de duplicados usa el nombre sin color, así que &aPTC y &bPTC son el mismo clan.
• Los límites se ajustan en modules/clanes → settings.name-min-length y settings.name-max-length. El tag sigue siendo de 2 a 6 caracteres alfanuméricos, sin color, porque es la clave de salas y PCW.
• Tope de miembros: settings.max-members (250 por defecto) corta invitaciones, solicitudes y aceptaciones cuando el clan se llena; /ptc clan info muestra (249/250). Las solicitudes pendientes caducan en settings.application-timeout-seconds (120 s).

• ptc.rank.user es el perfil público predeterminado.
• ptc.rank.helper y ptc.rank.moderator son perfiles de vigilancia; Moderador también controla y repara arenas. ptc.rank.admin puede crear y administrar mapas, y ptc.rank.owner es el único perfil que incluye ptc.arena.delete.
• Los perfiles VIP acumulan los permisos declarados como hijos en plugin.yml. Si conviertes alguno en beneficio de pago, prueba el nodo en una cuenta no OP y revisa si afecta el equilibrio competitivo.

Crear los seis rangos recomendados con LuckPerms

/lp creategroup vip1
/lp group vip1 setweight 10
/lp group vip1 meta setprefix 10 "&7[VIP] "
/lp group vip1 permission set ptc.rank.vip-iron true
# vip2 → ptc.rank.vip-gold · vip3 → ptc.rank.vip-diamond · vip4 → ptc.rank.vip-emerald
# vip5 → ptc.rank.vip-netherite · vip6 → ptc.rank.vip-amethyst

/ptc rangos (alias /ptc ranks, requiere ptc.admin; también desde consola) muestra el proveedor de permisos detectado y esta guía de seis rangos. PTC no muestra los nombres de nivel en chat, TAB ni scoreboard: solo el prefijo de tu plugin de permisos, y si el grupo no tiene prefijo se muestra únicamente el nick. DevOP aparece para OP únicamente si no hay plugin de permisos. Revisa el alcance de cada nivel en la guía de rangos; un rango alto ya hereda el anterior y la expiración la gestiona LuckPerms/tu tienda.

• ptc.rank.helper: monitoreo como espectador, chat y ayuda staff.
• ptc.rank.moderator: hereda Ayudante; controla eventos y repara arenas, pero no configura mapas ni administra Coins.
• ptc.rank.admin: administración general de PTC, control de eventos y chat staff.
• ptc.rank.owner: hereda ptc.*, con todos los permisos actuales declarados por PTC, incluidos nodos VIP y técnicos.

Los Ayudantes y Moderadores monitorean partidas y comunican posibles trampas o abuso de bugs; PTC no sustituye un anticheat. Administradores pueden crear y configurar arenas, pero no borrarlas. Solo Dueño puede eliminar una arena. No des perfiles staff a compradores VIP y evita usar ptc.rank.owner para tareas rutinarias.

/ptc help user
/ptc help premium
/ptc help staff
/ptc help admin
/ptc help admin 2
/pcw help
/pc help
/ptc clan help

La categoría Admin requiere OP o ptc.admin; Staff requiere ptc.staff, administración u OP. Comparte el texto que devuelve el servidor si difiere de esta referencia para mantener la documentación alineada.

Toda la ayuda es editable en mensajes_es.yml → help: titles.* cambia el título de cada categoría, entries.* contiene las líneas de cada página y header, footer, title, categories, next-page y no-permission el resto del marco. Los mensajes de los comandos (creación, borrado, selección, protección, granjas, spawns, guardado, reparación, economía, estadísticas, niveles, votaciones, listado de arenas y subcomandos de clan) se editan en commands.*, economy.*, stats.* y levels.*; los marcadores como %arena%, %team%, %count% o %value% se sustituyen sin alterar el color que hayas escrito. Ninguno de estos cambios requiere recompilar: guarda el YAML y ejecuta /ptc reload.