TopHyconomy

💰 TopHyconomy – Sistema Económico Modular, Escalable y Seguro para Hytale

TopHyconomy es un plugin de economía avanzado, de alto rendimiento y orientado a desarrolladores diseñado para actuar como el núcleo económico central de un servidor Hytale y como una API estandarizada para otros plugins.

Está construido para entornos de producción, soportando infraestructuras de múltiples instancias, alta concurrencia y operaciones de dinero seguras.

Para soporte, errores o solicitudes de características únete a nuestro discord de soporte!

🚀 Características Clave

• ✅ Sistema de cuentas basado en jugadores con balances persistentes
• ✅ API pública limpia y extensible para integración de plugins
• ✅ Soporte de persistencia MongoDB
• ✅ Cache distribuido Redis (opcional)
• ✅ Cache local de alto rendimiento usando Caffeine
• ✅ Listo para múltiples instancias
• ✅ Operaciones económicas seguras para hilos
• ✅ Protección contra interbloqueos y condiciones de carrera
• ✅ Archivos de configuración y lenguaje recargables en caliente
• ✅ Sistema de lenguaje completamente personalizable
• ✅ Uso de memoria optimizado para prevenir sobrecarga de RAM

⚡ Arquitectura de Datos y Rendimiento

TopHyconomy utiliza una arquitectura de datos de múltiples capas para lograr el mejor equilibrio entre velocidad, consistencia y escalabilidad.

🗄️ MongoDB

• Almacenamiento de datos persistente primario
• Ahorro de balance seguro y confiable
• Diseñado para servidores a gran escala

🚀 Redis (Opcional)

• Cache distribuido para configuraciones de múltiples instancias
• Mantiene balances de jugadores sincronizados entre servidores
• Permite transferencias de dinero más rápidas y seguras

⚙️ Cache Caffeine

• Cache local en memoria de alto rendimiento
• Reduce el acceso innecesario a MongoDB y Redis
• TTL configurable para evitar un uso excesivo de RAM

Esta arquitectura permite operaciones económicas rápidas, incluso bajo una carga pesada del servidor, sin comprometer la integridad de los datos.

🔐 Concurrencia y Seguridad

• Operaciones de cuentas totalmente seguras para hilos
• Acceso concurrente controlado a los balances de los jugadores
• Protección contra interbloqueos
• Prevención de condiciones de carrera durante transferencias simultáneas
• Seguro para tareas asíncronas y entornos distribuidos

Los balances de los jugadores permanecen consistentes y seguros en todo momento.

🔧 API para Desarrolladores

AccountManager

• getAccount(playerId)
• createAccount(playerId, playerName, initialBalance)
• deleteAccount(playerId)
• accountExists(playerId)
• transfer(from, to, amount)
• saveAll()

Account

• give(amount)
• withdraw(amount)
• take(amount)
• getBalance()

Diseñado para integrarse sin problemas con tiendas, trabajos, minijuegos, recompensas, subastas y sistemas personalizados.

🧑‍💼 Comandos Administrativos

• /eco give <player> <amount>
• /eco take <player> <amount>
• /eco set <player> <amount>
• /eco info <player>
• /eco reset <player>
• /eco reload

👤 Comandos de Jugador

• /bal – Ver tu balance actual
• /pay <player> <amount> – Enviar dinero a otro jugador

⚙️ Configuración Flexible

• Balance inicial configurable
• Modo de depuración
• Habilitar o deshabilitar MongoDB y Redis
• Configuración de TTL de cache
• Archivos de lenguaje completamente editables
• Recarga en caliente sin reiniciar el servidor

📦 Construido para Servidores Serios

• Servidores medianos y grandes
• Infraestructuras de múltiples instancias
• Desarrolladores que requieren una API de economía confiable
• Entornos de alta concurrencia y alta carga