Cómo migrar la tienda de tu servidor desde Tebex

Migrar la tienda de un servidor tiene tres partes: llevar el catálogo (categorías, paquetes, precios y comandos), volver a conectar los pagos en la plataforma nueva y cambiar el plugin de entrega en el servidor. El catálogo es lo rápido, porque varias plataformas importan directo desde Tebex. Lo demás es donde fallan las migraciones: comandos que no se copian, suscripciones que siguen cobrando en la plataforma vieja y entregas que siguen en cola cuando el plugin viejo sale del servidor.

Los ejemplos usan un servidor de Minecraft. Los mismos pasos sirven para CentralCart, una plataforma de tiendas común en servidores de Brasil.

Qué se trae y qué se queda

Antes de empezar, separa lo que trae una importación de lo que rehaces a mano.

En Gamecart, la página de migración muestra justo esto: de CentralCart trae categorías, productos, precios, descripciones y comandos; de Tebex, todo eso menos los comandos. Las variables, los descuentos y la configuración de servidores se rehacen.

Haz un inventario primero

Exporta o anota, paquete por paquete:

• los comandos de cada evento (compra, expiración, renovación, contracargo, reembolso);
• las variables que el paquete pide en el checkout, como el color de una etiqueta o el nombre de un kit;
• los cupones y descuentos activos;
• cuántos jugadores tienen una suscripción activa y cuándo se renueva cada una.

Ese inventario es tu lista de control al revisar la tienda nueva. Sin él, un comando olvidado solo aparece cuando un jugador paga y no recibe nada.

Consigue la credencial correcta

Tebex. La importación usa el Public Token. La documentación de Tebex dice dónde está: entra en creator.tebex.io y abre Integrations > API Keys. Según Tebex, ese token está pensado para ser visible y "only allows reading store data and managing baskets", sin acceso a datos financieros. No lo confundas con la clave secreta del plugin, que Tebex reserva "for server-to-API use only".

CentralCart. CentralCart usa claves de API por tienda. Su documentación de autenticación (en portugués) indica que la clave se crea en Configurações > Integrações, se eligen los permisos y se copia en el momento, porque se muestra una sola vez. Cada clave se puede revocar por separado, así que crea una solo para la migración y revócala al terminar.

Importa el catálogo

En Gamecart, la importación está en Your store > Products, en el botón Import:

1. Elige el origen (Tebex o CentralCart) y pega la credencial. Solo se usa para leer el catálogo y no se guarda.
2. Revisa la vista previa. Los productos aparecen agrupados por categoría, con avisos de lo que no se va a copiar.
3. Marca lo que quieres traer e importa. Las categorías y los productos se crean juntos.

Tres detalles que sorprenden:

• Moneda. Cada precio conserva el número en la moneda de la tienda nueva. Un paquete de 4,99 EUR pasa a ser 4,99 USD en una tienda en dólares. Corrige los precios antes de importar si las monedas son distintas.
• Límite del plan. Lo que importas cuenta para el límite de productos. El plan Gratis de Gamecart permite hasta 3 categorías y 50 productos (mira los planes).
• Duplicados. Puedes importar por partes, pero Gamecart no revisa duplicados entre importaciones. Deja fuera lo que ya trajiste.

Revisa cada comando

Aunque los comandos se copien, los placeholders cambian de una plataforma a otra. Un comando con el placeholder viejo se ejecuta con el texto literal en lugar del nombre del jugador, y el rango no le llega a nadie.

En la importación desde CentralCart, Gamecart ya sustituye {client_identifier} por {identifier} en los comandos. Aun así, abre cada comando y revísalo: otros placeholders, eventos y el texto del comando en sí necesitan un repaso. Los comandos de Tebex no vienen en la importación, así que los escribes de nuevo con {identifier} (por ejemplo, lp user {identifier} parent add vip).

Los eventos también necesitan su par. Tebex tiene comandos de compra, expiración, renovación, contracargo y reembolso. Gamecart tiene On Purchase, On Expiration y On Dispute, y este último también cubre reembolsos, rechazos y cancelaciones. Para que On Expiration se ejecute, define la duración del producto en días.

Dos ajustes por comando, en el ícono de engranaje:

• Offline delivery: actívalo solo si el comando funciona con el jugador fuera del servidor. Un give no funciona; un comando de permisos suele funcionar.
• Ignore quantity: actívalo cuando el comando deba ejecutarse una sola vez, aunque el jugador compre dos unidades.

Antes de armar los paquetes en la tienda nueva, revisa qué puedes vender en tu servidor de Minecraft según las reglas de Mojang.

Pagos y suscripciones

Las cuentas de pago no se migran. En Gamecart, el dinero llega directo a tu propia cuenta en cada proveedor, así que conectas cada una en Settings > Gateways. Stripe, PayPal y cripto con NOWPayments funcionan en cualquier moneda de la tienda, según la guía de pasarelas.

Las suscripciones piden más cuidado. En Tebex, la página Recurring Payments muestra cada suscripción con su próxima fecha de cobro, y el estado Active significa que "will automatically renew at the next billing date". Ninguna importación se lleva ese cobro. El jugador cancela en el portal de historial de pagos de Tebex, como explica la página de suscripciones.

En la práctica hay dos caminos: mantener la tienda vieja activa hasta que venzan las suscripciones, o avisar a los suscriptores, darles una fecha y pedirles que cancelen allá y se suscriban de nuevo en la tienda nueva. No apagues la tienda vieja con suscripciones activas sin decidir esto antes.

Cambia el plugin sin perder entregas

El cambio de plugin es donde se pierden rangos. Por defecto, Tebex solo ejecuta un comando cuando el cliente está conectado, según su página de solución de problemas. Quien compró y todavía no entró al servidor tiene un comando esperando en la cola de Tebex. Si quitas el plugin de Tebex antes, ese comando no se ejecuta.

El orden que lo evita:

1. Instala el plugin de Gamecart. Crea el servidor en Integrations > Servers, descarga el JAR de tu plataforma (Spigot, Paper, Folia, BungeeCord, Velocity o Fabric) y pega el token en serverToken, como indica la guía del conector.
2. Ejecuta gamecart status en la consola y haz una compra de prueba de cada tipo de producto.
3. Deja de vender en la tienda vieja: oculta los paquetes o desactiva la tienda, sin borrar nada.
4. Espera a que la cola vieja se vacíe y revisa en su panel si quedan comandos pendientes.
5. Solo entonces quita el plugin viejo.

Usa un token de Gamecart por instalación. Dos servidores con el mismo token se disputan los mismos comandos.

Dominio y anuncio

En el plan Gratis, la tienda funciona en un subdominio gamecart.shop. El dominio propio empieza en Pro, y la guía de dominio pide dos registros: un CNAME a dns.gamecart.gg y un TXT de verificación. En Cloudflare, deja los dos en DNS only.

Si el dominio de la tienda apuntaba a la plataforma vieja, cambia el DNS al final, después de las compras de prueba. Así el enlace que los jugadores ya conocen abre la tienda nueva sin caídas. Después, actualiza el enlace en Discord, en el MOTD y en el comando /tienda del servidor.

Si todavía estás decidiendo a dónde ir, Gamecart vs Tebex compara comisiones y cobros lado a lado, y la página de Minecraft lista las plataformas de servidor compatibles.