RANGOS DE TIENDA

1. Instala LuckPerms (o tu plugin de permisos). Al arrancar, PTC indica en consola qué proveedor detectó; si no encuentra ninguno, avisa que los rangos VIP no se mostrarán.
2. Crea los seis grupos con el nombre comercial que prefieras y dales un peso ascendente.
3. Asigna a cada grupo su prefijo: ese prefijo es lo único que verán los jugadores en chat, TAB y scoreboard.
4. Da a cada grupo su nodo de nivel (tabla de abajo). No otorgues nodos de staff ni ptc.*.
5. Agrega un jugador de prueba no OP al grupo y comprueba prefijo y beneficios.

/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

/lp creategroup vip2
/lp group vip2 setweight 20
/lp group vip2 meta setprefix 20 "&e[VIP+] "
/lp group vip2 permission set ptc.rank.vip-gold true

# Repite para vip3..vip6 con vip-diamond, vip-emerald, vip-netherite y vip-amethyst
/lp user Alex parent add vip1

1. Rangos con prefijo (pagos, VIP y staff): la lista TAB compone el prefijo del rango y el nick, y la primera fila sobre la cabeza usa nametag.contexts.<contexto>.prefix ({rank_prefix}), así que se lee rango + nick. El nick de la lista va en blanco por defecto y se cambia con list-nick-color (por ejemplo team para el color del equipo). El prefijo viene de los placeholders de PlaceholderAPI configurados, de la meta de LuckPerms o del prefijo del chat de Vault. No es opcional: quien compra un rango o pertenece a un grupo de staff siempre ve su rango junto al nick.
2. Sin prefijo (grupo default/usuario): sobre la cabeza se aplica default-prefix, que viene vacío, de modo que solo se ve el nick; en la lista TAB tampoco se añade ninguna etiqueta. No aparece "default" ni "usuario". Si prefieres que también lean una palabra, escribe {rank} en default-prefix y dale texto a ranks.none de mensajes_es.yml (viene con ""; pon &fUSUARIO o lo que quieras).
3. DevOP: solo para operadores cuando el servidor no tiene ningún plugin de permisos; también lo usa {rank} antes de recurrir a ranks.none. Si existe LuckPerms con un rango como Owner, se muestra ese prefijo en lugar de DevOP.

• Preseleccionar equipo, entrar tarde, espectar, usar mesa/yunque o comprar un kit pueden afectar la experiencia competitiva. Prueba las funciones con una cuenta sin OP y decide si deben ser gratuitas, deshabilitarse en partidas competitivas o no incluirse en paquetes de pago.
• PTC no aplica automáticamente los descuentos de 5%, 10%, 15%, 20% o 25% que aparecen en la imagen: no existe un permiso ni lógica de descuento de tienda integrada. Si los ofreces, calcúlalos y muéstralos en la plataforma de venta externa, con sus condiciones explícitas.
• No concedas a clientes ptc.admin, ptc.event, ptc.staff, ptc.arena.repair, ptc.* ni perfiles de staff como Ayudante, Moderador, Administrador o Dueño. Revisa sus alcances en la guía separada para staff.
• Los niveles VIP están anidados: asigna solo el nodo del nivel comprado y valida que el proveedor de permisos herede sus hijos. Evita otorgar manualmente todos los nodos si la herencia ya los concede.
• Explica duración, renovación automática, reembolso, beneficios, restricciones, disponibilidad del servidor y cambios de producto antes del pago. No anuncies una ventaja hasta comprobarla en la versión y configuración que vas a publicar.

Rangos temporales

/lp user Alex parent addtemp vip3 30d

PTC no gestiona la duración: la expiración la aplica LuckPerms o tu tienda. Al vencer el grupo, el prefijo y los beneficios desaparecen juntos; prueba la retirada antes de publicar.

Clanes y cosméticos dentro del rango de pago

Los nodos sociales y estéticos nacen en false, así que son el relleno natural de un rango o de una venta suelta. Se asignan solos al grupo comprado o con caducidad individual:

# grupo de pago: clanes completos
/lp group vip3 permission set ptc.clan true
/lp group vip3 permission set ptc.clan.create true
/lp group vip3 permission set ptc.clan.join true

# venta suelta con caducidad, sin cambiar de rango
/lp user Alex permission set ptc.cosmetic.flame true 90d

• Clanes: ptc.clan abre los comandos de miembro, ptc.clan.create permite fundar (sigue costando Coins) y ptc.clan.join permite unirse. Un usuario normal sin estos nodos solo puede ver /ptc clan info.
• Cosméticos: diez nodos, uno por estela (ptc.cosmetic.heart, flame, soul, note, happy_villager, enchant, portal, cherry, snow y totem). El nodo permite equipar la estela gratis; sin el nodo, el jugador puede comprarla una sola vez con Coins (precios de 6500 a 15000, todos distintos) y el desbloqueo queda guardado en su cuenta. Cada cosmético tiene un efecto propio (aura, fountain, orbit, spiral, wave, halo, vortex, twirl, burst y nova). Si prefieres otro plugin de cosméticos, el dueño puede apagar el módulo con lobby.cosmetics.enabled: false.
• Anuncia siempre si el beneficio es el permiso, el precio en Coins, o ambos, y revisa la matriz de permisos.

1. Crea los seis grupos en tu plugin de permisos, con prefijo propio, y revisa /ptc rangos y la consola para confirmar el proveedor detectado.
2. Confirma el nodo en plugin.yml del JAR que piensas publicar y consulta la referencia de permisos.
3. Prueba cada beneficio en staging con jugadores no OP, primero durante espera y luego en una partida.
4. Verifica que los permisos de staff nunca se hereden en los grupos VIP; inspecciona también herencias globales de LuckPerms.
5. Configura temporalidad, renovación, impuestos y devolución en tu tienda externa; prepara los mensajes y términos legales de tu jurisdicción.
6. Usa exactamente el mismo beneficio en la página de venta, en la configuración y en la versión desplegada. No publiques la categoría de descuentos como función de PTC.