Economy Plugin

💵 PLUGIN DE ECONOMÍA – DESCRIPCIÓN COMPLETA DE CURSEFORGE
Resumen

Economía es el sistema financiero completo para los servidores de Hytale. Basado en la API de almacenamiento Vault, proporciona a los administradores de servidores y jugadores una economía robusta y flexible que incluye gestión de saldos, transacciones seguras, tablas de clasificación competitivas y controles administrativos integrales.

🎯 ¿Qué es Economía?

Economía convierte tu servidor de Hytale en un próspero mercado. Los jugadores ganan, gastan e intercambian moneda. Los administradores mantienen el control con potentes herramientas de gestión. Todos los datos persisten de manera confiable a través de la infraestructura de Vault.

Ya sea que estés ejecutando un pequeño servidor de supervivencia o una economía multijugador masiva, Economía se adapta a ti.

✨ Características Principales
💰 Gestión de Saldos de Jugadores

Cada jugador recibe automáticamente un saldo inicial al unirse a tu servidor. Consulta los saldos en cualquier momento con /balance. Los administradores pueden establecer, dar, quitar o restablecer saldos al instante. Los saldos son persistentes: los jugadores mantienen su dinero a través de las sesiones.

📊 Tablas de Clasificación y Rankings

Ve a los jugadores más ricos de tu servidor con /baltop. Las tablas de clasificación paginadas muestran a los mejores ganadores de un vistazo. Ve tu rango en comparación con otros. Competitivo, motivador y siempre actualizado con almacenamiento en caché inteligente.

💸 Transacciones de Jugador a Jugador

Los jugadores envían dinero entre sí con /pay. Simple, seguro y registrado. Los tiempos de espera opcionales previenen el spam. Un sistema de impuestos opcional apoya las políticas económicas del servidor. La protección contra fondos insuficientes previene deudas.

⚙️ Conjunto de Comandos de Administrador

Gestión completa del servidor a través de comandos /eco. Establece saldos exactos para emergencias o pruebas. Da recompensas a jugadores activos. Quita moneda como castigo por violaciones de reglas. Restablece economías para reinicios estacionales. Recarga la configuración sin reiniciar.

🔒 Sistema de Permisos

Control detallado sobre quién puede acceder a qué. Los jugadores obtienen verificaciones de saldo básicas por defecto. Los administradores tienen acceso completo a los comandos. Personaliza los permisos a través de tu plugin de permisos. Sin acceso a comandos que no otorgues.

📈 Registro de Transacciones

Cada transacción se registra con marcas de tiempo y nombres de jugadores. Registro de auditoría para disputas. Sigue las tendencias económicas. Registro detallado opcional para investigar anomalías.

🎨 Moneda Personalizable

Cambia el nombre de la moneda, el símbolo y el formato de número. Usa dólares, euros, monedas, gemas o cualquier otra cosa. El formato de visualización es completamente configurable. Colores y estilos disponibles.

⚡ Totalmente Asíncrono

Sin retraso en el servidor por operaciones de base de datos. Todas las verificaciones de saldo, guardados y transacciones ocurren fuera del hilo principal. El servidor se mantiene receptivo incluso durante picos económicos.

🚀 Alto Rendimiento

El almacenamiento en caché inteligente de saldos reduce las consultas a la base de datos. El almacenamiento en caché de tablas de clasificación previene el recálculo en cada solicitud. Operaciones por lotes para comandos de administrador. Ajuste de configuración para el tamaño de tu servidor.

🔄 Configuración de Recarga en Caliente

Actualiza la configuración de economía sin reiniciar. Cambia el saldo inicial, el símbolo de la moneda, los límites de pago, todo sin tiempo de inactividad. Los nuevos ajustes se aplican de inmediato.

🎮 Casos de Uso
Para Propietarios de Servidores

Economía te da control total sobre el sistema financiero de tu servidor. Establece el valor de la moneda a través del saldo inicial. Usa impuestos para financiar características del servidor. Crea tiendas exclusivas o sistemas de subastas. Sigue la salud económica a través de los registros de transacciones.

Para Jugadores

Los jugadores tienen una razón para involucrarse con tu servidor. Gana moneda a través de actividades. Compite en las tablas de clasificación. Intercambia con amigos. Siente la progresión a medida que crece su riqueza.

Para Desarrolladores de Plugins

La API de Economía permite a los plugins personalizados interactuar con la economía. Consulta los saldos de los jugadores. Deduce moneda por servicios. Recompensa logros. Todo a través de APIs limpias y amigables con lo asíncrono.

🏆 ¿Por Qué Elegir Economía?

Economía está lista para producción desde el primer momento. Sin configuración compleja. Sin dependencias externas más allá de Vault. Un archivo de configuración controla todo. La fiabilidad de grado profesional se encuentra con la facilidad de uso.

El rendimiento escala de 10 jugadores a 10,000. El almacenamiento en caché inteligente significa que las tablas de clasificación se mantienen rápidas. Las operaciones asíncronas nunca bloquean tu servidor. Ya sea que estés ejecutando supervivencia vanilla o un servidor de economía complejo, Economía lo maneja.

La extensibilidad significa que no estás bloqueado. Úsalo con tiendas, casinos, plugins de trabajos o sistemas personalizados. La arquitectura limpia de Vault significa que Economía se lleva bien con todo lo demás.

🚀 Inicio Rápido
Instalación

Descarga Economy-1.0.0.jar de CurseForge o GitHub Releases. Colócalo en tu carpeta server/mods/ junto a Vault. Reinicia tu servidor. Economía genera la configuración automáticamente.

Personaliza economy-plugin/config.yml con tus ajustes de moneda, saldo inicial y características. Reinicia y estarás listo para comenzar.

Primeros Comandos

Consulta tu saldo: /balance

Ve a los mejores jugadores: /baltop

Envía dinero a un amigo: /pay PlayerName 100

Comandos de administrador (solo ops): /eco give PlayerName 500

📋 Comandos
Comandos de Jugador

/balance [jugador] – Consulta tu saldo o el saldo de otro jugador. Alias: /bal, /money

/pay <jugador> <cantidad> – Envía dinero a otro jugador. Alias: /send

/baltop [página] – Ve la tabla de clasificación de los jugadores más ricos. Soporta paginación para servidores grandes.

Comandos de Administrador

/eco set <jugador> <cantidad> – Establece un saldo exacto. Útil para emergencias o pruebas.

/eco give <jugador> <cantidad> – Da dinero a un jugador. Alias: /eco add

/eco take <jugador> <cantidad> – Quita dinero a un jugador. Alias: /eco remove

/eco reset <jugador> – Restablece al jugador a su saldo inicial.

/eco reload – Recarga la configuración sin reiniciar.

/eco rebuildcache – Reconstruye manualmente los datos en caché. Alias: /eco rebuild

⚙️ Configuración

Economía se controla a través de un único archivo de configuración con valores predeterminados sensatos:

Ajustes de Moneda – Define nombre, símbolo y formato de número. Usa cualquier emoji o símbolo de texto.

Ajustes de Cuenta – Controla el saldo inicial, saldo mínimo y saldo máximo. Previene explotaciones con límites de saldo.

Ajustes de Tabla de Clasificación – Personaliza el tamaño de página, color de resaltado y duración de caché.

Ajustes de Pago – Establece cantidades mínimas y máximas de pago. Impuestos opcionales. Tiempo de espera opcional para prevenir spam.

Rendimiento – Configuración de caché para servidores grandes. Ajusta los intervalos de actualización según tu número de jugadores.

🔐 Seguridad

Las declaraciones preparadas previenen ataques de inyección SQL. Los límites de saldo previenen explotaciones. El sistema de permisos previene accesos no autorizados. Los tiempos de espera previenen spam y bombardeo de transacciones. El registro de auditoría opcional rastrea todos los cambios.

📊 Base de Datos

Economía almacena todos los datos a través de Vault, soportando MySQL para producción o H2 para servidores pequeños. Los datos son persistentes, confiables y respaldados por tu configuración de Vault.

📚 Documentación

Referencia completa de comandos con ejemplos. Guía de configuración explicando cada ajuste. Referencia de permisos para administradores. Documentación de API para desarrolladores que construyen integraciones.

🤝 Soporte

Comunidad de Discord para ayuda en tiempo real. Problemas de GitHub para informes de errores y solicitudes de funciones. Wiki para preguntas comunes. Soporte por correo electrónico disponible.

📜 Licencia

Licencia MIT – completamente de código abierto y gratuita. Uso en proyectos comerciales. Modificar y redistribuir. Sin obligaciones.

🎯 Requisitos

Plugin Vault 1.0.0+ (requerido), Servidor Hytale 1.0+, Java 17+, MySQL 8.0+ (opcional, para uso en producción con Vault)

💡 Ejemplos del Mundo Real
Servidor de Supervivencia

Los nuevos jugadores aparecen con 100 monedas. Ellos minan, cultivan e intercambian para ganar más. Usa /baltop para ver quién es el más rico. La economía surge naturalmente de la actividad de los jugadores.

Servidor de Minijuegos

Gana minijuegos para obtener moneda. Gasta moneda en la tienda por cosméticos. Las tablas de clasificación crean competiciones estacionales. Los jugadores regresan regularmente para subir de rango.

Servidor de Facciones

Las facciones ganan dinero como colectivo. Usa /eco give para recompensar actividades de facción. Los jugadores pueden intercambiar recursos a través de la economía. Los botines de guerra pueden distribuirse de manera justa.

Servidor de Rol

Los jugadores ganan dinero a través de trabajos y negocios. Los impuestos financian características del servidor. Las tablas de clasificación crean jerarquías de prestigio. La economía impulsa la profundidad del rol.

🌟 Testimonios de Jugadores

“Economía es tan fluida. Nunca bloquea el servidor incluso durante picos económicos.” – Administrador del Servidor

“¡La tabla de clasificación me hace querer ganar más. Gran competencia!” – Jugador

“El sistema de permisos me da exactamente el control que necesito. Me encanta.” – Propietario del Servidor

“Integrar con nuestra tienda personalizada fue trivial. API limpia.” – Desarrollador de Plugins

🎉 Comienza Hoy

Descarga desde CurseForge. Coloca Economy-1.0.0.jar en server/mods/. Asegúrate de que Vault también esté instalado. Reinicia tu servidor. Personaliza config.yml. Reinicia nuevamente. Tu economía está activa.

🙏 Créditos

Construido por Bakhaow para la comunidad de Hytale. Impulsado por la API de almacenamiento Vault. Inspirado en las mejores prácticas de la industria en diseño de sistemas económicos.

Hecho con ❤️ para Administradores y Jugadores de Servidores de Hytale