Descripción general

Pendiente de aprobación v1.3.0

Plataformas

Paper, Spigot, Folia

Minecraft

1.21 o superior

Java

21

Obligatorio

Ninguno

Opcional

Vault, PlaceholderAPI, HeadDB

ReferralTrack muestra qué lista de servidores, vídeo, invitación de Discord o amigo trajo a cada jugador a tu servidor. Los jugadores indican al servidor de dónde vienen con /referral o introducen el código de invitación permanente de un amigo, y pueden ganar una recompensa por ello. Todo se almacena en tu propia base de datos (SQLite o MySQL/MariaDB). Nada sale del servidor salvo el webhook de Discord que configures.

Requisitos #

• Minecraft 1.21 o superior, Java 21.
• Paper, Spigot o Folia.
• Vault y un plugin de economía compatible con Vault son opcionales y solo se necesitan para las recompensas en dinero.
• PlaceholderAPI es opcional.
• HeadDB y Head Database son opcionales y añaden cabezas personalizadas a los menús. Sin ellos se usa un material normal de Bukkit.

Las bibliotecas de base de datos van dentro del jar, así que el primer arranque no descarga nada.

Instalación #

1. Copia ReferralTrack.jar en plugins/ e inicia el servidor.
2. Edita plugins/ReferralTrack/config.yml: tus orígenes, las recompensas y el webhook de Discord.
3. Ejecuta /referraltrack validate y después /referraltrack reload.
4. Ejecuta /referraltrack doctor para comprobar la base de datos, las recompensas y las integraciones.

Qué hace #

• Códigos de origen. Los jugadores escriben /referral youtube (o cualquier código que definas). Un código conocido mal escrito, como yotube, se asocia al más cercano.
• Códigos personales permanentes. Cada jugador recibe un código de invitación a prueba de colisiones (por ejemplo RT-AB12CD3) vinculado a su UUID, de modo que sobrevive a un cambio de nombre. Los nombres de amigos y los códigos de origen siguen funcionando.
• Recompensas. Dinero mediante Vault y/o comandos de consola, con un límite por dirección IP, una comprobación de misma IP en las invitaciones de amigos, topes de recompensa e hitos de invitación.
• Referidos verificados (opcional). Las recompensas y el crédito de la clasificación pueden retenerse hasta que el jugador nuevo alcance un umbral de tiempo de juego y de conexiones. Desactivado por defecto.
• Revisión de fraude (opcional). Las señales de riesgo explicables pueden retener un referido para que el personal lo apruebe o lo rechace.
• Campañas (opcional). Campañas con límite de tiempo con sus propias fechas, códigos, multiplicadores, recompensas e hitos.
• Centro del jugador. /referral abre un menú personal con el código del jugador, el origen, el estado de validación y las recompensas. En los servidores que lo admiten, el centro puede abrirse como un diálogo nativo de Java.
• Herramientas del personal. Panel, analítica, clasificación de crecimiento, Reward Rescue, validación de la configuración y un informe de estado.
• Discord. Tarjetas instantáneas, informes diarios y semanales y un mensaje de estadísticas en vivo, cada uno dirigible a su propio canal.
• Preajustes y temas. Siete preajustes iniciales y tres temas visuales, que solo se aplican con confirmación y una copia de seguridad.
• Idiomas. Inglés, turco, español, alemán y portugués de Brasil.

Redes #

En una red, establece settings.join-tracking-enabled en true en un servidor de entrada (por ejemplo el lobby) y en false en los demás, y apunta todos los servidores a la misma base de datos MySQL/MariaDB. Establece settings.reward-delivery-enabled en true solo en el servidor donde esté tu economía real. Las recompensas reclamadas en otros sitios se guardan como pendientes y se entregan en el siguiente inicio de sesión allí. Cada fila de recompensa tiene un único propietario de entrega activo entre todos los servidores.

Detrás de BungeeCord o Velocity, activa el reenvío de IP en el proxy. Sin él, todos los jugadores aparecen con la dirección del proxy y las comprobaciones por IP bloquearían a todo el mundo. SQLite no es un almacenamiento compartido; una red necesita MySQL/MariaDB.

Actualización #

ReferralTrack nunca reemplaza en silencio un config.yml personalizado. Cuando cambia la versión de la configuración, conserva el original como config.yml.bak-v<old>, escribe la nueva referencia completa en config.new-v<new>.yml, cambia solo la marca de versión de tu archivo y lista las rutas que faltan al arrancar. Los valores predeterminados incluidos mantienen las opciones nuevas funcionando hasta que las copies. Los archivos de idioma que hayas editado no se sobrescriben; las claves que faltan recurren al texto en inglés incluido.