# 💎 PrimeEconomy ### El sistema de economía más completo y optimizado para Minecraft [![Versión](https://img.shields.io/badge/Versión-1.0.0-brightgreen.svg)](https://github.com/tu-usuario/PrimeEconomy) [![Minecraft](https://img.shields.io/badge/Minecraft-1.8--1.21+-blue.svg)](https://www.spigotmc.org/) [![Licencia](https://img.shields.io/badge/Licencia-MIT-yellow.svg)](LICENSE) [![Discord](https://img.shields.io/badge/Discord-Únete-7289DA.svg)](https://discord.gg/tu-servidor) --- ## 📋 Descripción **PrimeEconomy** es un plugin de economía **todo en uno** diseñado para servidores modernos que buscan una solución completa sin necesidad de instalar múltiples plugins. Combina un sistema de economía robusto, tienda GUI intuitiva y casa de subastas avanzada en un solo paquete ultra-optimizado. ### 🎯 ¿Por qué PrimeEconomy? - ✨ **Todo en Uno** - Economía + Tienda + Subastas en un solo plugin - 🚀 **Ultra Optimizado** - SQLite con operaciones asíncronas, 0 lag - 🔌 **Funciona Solo o con Vault** - Compatible pero no dependiente - 🎨 **GUIs Modernas** - Interfaz intuitiva sin comandos complicados - 🌍 **Multi-versión** - Compatible desde 1.8 hasta 1.21+ - ⚙️ **Altamente Configurable** - Personaliza cada aspecto - 📊 **PlaceholderAPI** - Integración completa con otros plugins - 💾 **Sin MySQL Requerido** - SQLite incluido (MySQL opcional) --- ## ✨ Características Principales ### 💰 Sistema de Economía - **Cuentas automáticas** - Los jugadores obtienen cuentas al unirse - **Transferencias instantáneas** - Envía dinero a otros jugadores - **Balance persistente** - Los datos se guardan automáticamente - **Historial de transacciones** - Registro completo de movimientos - **Comandos administrativos** - Control total sobre la economía - **Integración con Vault** - Compatible con todos los plugins de economía - **Balance inicial configurable** - Define el dinero de inicio - **Límite de balance** - Previene duplicaciones y exploits ### 🏪 Tienda GUI - **Interfaz gráfica moderna** - Sin comandos de texto - **Compra/Venta rápida** - Click izquierdo compra, derecho vende - **Items ilimitados** - Agrega todos los items que quieras - **Precios personalizables** - Define compra y venta por separado - **Soporte para NBT** - Items con encantamientos, nombres, lore - **Categorías múltiples** - Organiza tu tienda en secciones - **Permisos por item** - Control de acceso granular - **Animaciones suaves** - Feedback visual en cada compra - **Stock ilimitado** - No se agota (configurable) - **Descuentos por permisos** - Ofrece precios especiales ### 🔨 Casa de Subastas - **Sistema de subastas P2P** - Los jugadores venden entre ellos - **Ofertas en tiempo real** - Sistema de pujas competitivo - **Expiración automática** - Las subastas caducan y devuelven items - **Comisión por venta** - Configura impuestos de venta - **Costo de listado** - Cobra por publicar subastas - **Límite de listados** - Previene spam de subastas - **Búsqueda y filtros** - Encuentra lo que necesitas rápido - **Historial completo** - Ve todas las transacciones - **Items con NBT** - Vende items con encantamientos - **Prevención de scam** - Sistema seguro de intercambio --- ## 📦 Instalación ### Requisitos Mínimos - ✅ **Minecraft** 1.8 o superior - ✅ **Java** 8 o superior - ✅ **Spigot/Paper** o cualquier fork ### Dependencias Opcionales - 🔌 **Vault** - Para compatibilidad con otros plugins de economía - 📊 **PlaceholderAPI** - Para mostrar balances en scoreboard/chat ### Pasos de Instalación 1. **Descarga** el archivo `PrimeEconomy.jar` 2. **Coloca** el archivo en la carpeta `plugins/` de tu servidor 3. **Reinicia** el servidor 4. **Edita** `plugins/PrimeEconomy/config.yml` a tu gusto 5. **Configura** la tienda en `plugins/PrimeEconomy/shop.yml` 6. **Ejecuta** `/pe reload` para aplicar cambios --- ## 🎮 Comandos ### Comandos para Jugadores | Comando | Descripción | Permiso | |---------|-------------|---------| | `/balance` | Ver tu balance | `primeeco.balance` | | `/balance ` | Ver balance de otro jugador | `primeeco.balance.others` | | `/bal` | Alias de balance | `primeeco.balance` | | `/pay ` | Enviar dinero | `primeeco.pay` | | `/shop` | Abrir tienda | `primeeco.shop` | | `/auction` | Ver ayuda de subastas | `primeeco.auction` | | `/auction browse` | Ver subastas activas | `primeeco.auction.browse` | | `/auction sell ` | Subastar item en mano | `primeeco.auction.sell` | | `/auction mylistings` | Ver tus subastas activas | `primeeco.auction.mylistings` | ### Comandos de Administración | Comando | Descripción | Permiso | |---------|-------------|---------| | `/eco give ` | Dar dinero | `primeeco.admin` | | `/eco take ` | Quitar dinero | `primeeco.admin` | | `/eco set ` | Establecer balance | `primeeco.admin` | | `/eco reset ` | Resetear cuenta | `primeeco.admin` | | `/pe reload` | Recargar configuración | `primeeco.admin` | | `/shop reload` | Recargar tienda | `primeeco.admin` | | `/auction clear` | Limpiar subastas expiradas | `primeeco.admin` | --- ## 🔐 Permisos ### Permisos Básicos ```yaml primeeco.balance # Ver balance propio primeeco.balance.others # Ver balance de otros primeeco.pay # Enviar dinero primeeco.shop # Acceder a la tienda primeeco.auction # Usar comandos de subastas primeeco.auction.browse # Ver subastas primeeco.auction.sell # Crear subastas primeeco.admin # Todos los comandos admin ``` ### Permisos Avanzados ```yaml primeeco.shop.discount.vip # 10% descuento en tienda primeeco.shop.discount.mvp # 25% descuento en tienda primeeco.auction.limit.5 # Máximo 5 subastas simultáneas primeeco.auction.limit.10 # Máximo 10 subastas simultáneas primeeco.auction.nofee # Sin comisión de venta primeeco.pay.unlimited # Sin límite de transferencia ``` --- ## ⚙️ Configuración ### config.yml - Configuración Principal ```yaml # PrimeEconomy - Configuración Principal # ==================================== economy: # Símbolo de la moneda currency-symbol: "$" # Nombre de la moneda (singular y plural) currency-name: "Dólar" currency-name-plural: "Dólares" # Balance inicial al registrarse starting-balance: 1000.0 # Balance máximo permitido max-balance: 999999999.0 # Usar Vault si está disponible use-vault: true shop: # Nombre de la tienda (con códigos de color) title: "&6&lTienda Premium" # Tamaño del inventario (9, 18, 27, 36, 45, 54) size: 54 # Sonido al comprar buy-sound: "ENTITY_PLAYER_LEVELUP" # Sonido al vender sell-sound: "ENTITY_EXPERIENCE_ORB_PICKUP" # Sonido de error error-sound: "ENTITY_VILLAGER_NO" auction: # Título de la casa de subastas title: "&e&lCasa de Subastas" # Máximo de subastas por jugador max-listings-per-player: 3 # Duración de subastas (en minutos) listing-duration: 10080 # 7 días # Costo por crear subasta listing-fee: 100.0 # Comisión al vender (porcentaje) sale-tax-percent: 5.0 # Items prohibidos blacklisted-items: - "BEDROCK" - "COMMAND_BLOCK" - "BARRIER" # Intervalo de limpieza de expiradas (minutos) cleanup-interval: 60 payment: # Mínimo para transferir minimum-payment: 1.0 # Máximo para transferir (sin permiso especial) maximum-payment: 100000.0 # Cobrar tarifa de transferencia enable-payment-tax: false # Porcentaje de tarifa payment-tax-percent: 1.0 storage: # Tipo de base de datos (sqlite, mysql) type: "sqlite" # Guardar automáticamente (minutos) auto-save-interval: 5 # Configuración MySQL (si type: mysql) mysql: host: "localhost" port: 3306 database: "primeeconomy" username: "root" password: "password" ssl: false messages: prefix: "&8[&6PrimeEco&8]&r " balance: "%prefix%&aTu balance: &e%balance%" balance-other: "%prefix%&aBalance de &e%player%&a: &e%balance%" pay-sent: "%prefix%&aEnviaste &e%amount% &aa &e%player%" pay-received: "%prefix%&aRecibiste &e%amount% &ade &e%player%" insufficient-funds: "%prefix%&cNo tienes suficiente dinero." player-not-found: "%prefix%&cJugador no encontrado." shop-buy-success: "%prefix%&aCompraste &e%amount%x %item% &apor &e%price%" shop-sell-success: "%prefix%&aVendiste &e%amount%x %item% &apor &e%price%" auction-listed: "%prefix%&aSubasta creada por &e%price%" auction-sold: "%prefix%&a¡Tu subasta se vendió por &e%price%&a!" auction-expired: "%prefix%&cTu subasta expiró. Item devuelto." auction-purchased: "%prefix%&aCompraste &e%item% &apor &e%price%" ``` ### shop.yml - Configuración de Tienda ```yaml # PrimeEconomy - Tienda # ===================== items: # Bloques de construcción stone: material: "STONE" display-name: "&fPiedra" lore: - "&7Bloque básico de construcción" - "" - "&aClick izquierdo: &fComprar" - "&aClick derecho: &fVender" slot: 10 buy-price: 5.0 sell-price: 2.5 amount: 64 cobblestone: material: "COBBLESTONE" display-name: "&7Piedra" slot: 11 buy-price: 3.0 sell-price: 1.5 amount: 64 oak_log: material: "OAK_LOG" display-name: "&6Tronco de Roble" slot: 12 buy-price: 10.0 sell-price: 5.0 amount: 64 # Herramientas diamond_pickaxe: material: "DIAMOND_PICKAXE" display-name: "&bPico de Diamante" lore: - "&7Herramienta duradera" - "&7Durabilidad: 1561" slot: 20 buy-price: 5000.0 sell-price: 2500.0 amount: 1 iron_sword: material: "IRON_SWORD" display-name: "&fEspada de Hierro" slot: 21 buy-price: 500.0 sell-price: 250.0 amount: 1 # Comida cooked_beef: material: "COOKED_BEEF" display-name: "&cBistec Cocido" slot: 30 buy-price: 20.0 sell-price: 10.0 amount: 16 golden_apple: material: "GOLDEN_APPLE" display-name: "&6Manzana Dorada" lore: - "&7Restaura salud" - "&7Otorga regeneración" slot: 31 buy-price: 500.0 sell-price: 250.0 amount: 1 # Items especiales con encantamientos enchanted_sword: material: "DIAMOND_SWORD" display-name: "&5Espada Legendaria" lore: - "&7Espada poderosa con" - "&7encantamientos especiales" enchantments: SHARPNESS: 5 UNBREAKING: 3 FIRE_ASPECT: 2 slot: 40 buy-price: 25000.0 sell-price: 12500.0 amount: 1 permission: "primeeco.shop.legendary" # Items que solo se pueden vender rotten_flesh: material: "ROTTEN_FLESH" display-name: "&2Carne Podrida" lore: - "&7Solo se puede vender" slot: 50 buy-price: -1 # -1 = no se puede comprar sell-price: 5.0 amount: 64 ``` --- ## 📊 PlaceholderAPI ### Placeholders Disponibles ``` %primeeco_balance% # Balance sin formato: 1000.50 %primeeco_balance_formatted% # Balance formateado: $1,000.50 %primeeco_balance_commas% # Balance con comas: 1,000.50 %primeeco_currency% # Símbolo de moneda: $ %primeeco_currency_name% # Nombre de moneda: Dólar %primeeco_rank% # Posición en ranking de riqueza: #5 %primeeco_top_1_name% # Nombre del jugador #1 más rico %primeeco_top_1_balance% # Balance del jugador #1 %primeeco_top_2_name% # Nombre del jugador #2 más rico %primeeco_top_2_balance% # Balance del jugador #2 %primeeco_top_3_name% # Nombre del jugador #3 más rico %primeeco_top_3_balance% # Balance del jugador #3 ``` ### Ejemplos de Uso **Scoreboard con Vault:** ```yaml lines: - "&6&lMi Servidor" - "" - "&fDinero: &e%primeeco_balance_formatted%" - "&fRank: &e%primeeco_rank%" - "" - "&fTop #1: &e%primeeco_top_1_name%" ``` **Tab con PlaceholderAPI:** ```yaml header: - "&6&lServidor Premium" - "&fTu dinero: &e%primeeco_balance_formatted%" ``` **Chat prefix con LuckPerms:** ``` /lp user meta addprefix "&7[&e%primeeco_balance_commas%$&7] " ``` --- ## 🔧 Integración con Otros Plugins ### ✅ Vault PrimeEconomy se registra automáticamente como proveedor de economía en Vault. Otros plugins que usen Vault detectarán PrimeEconomy automáticamente. **Plugins compatibles:** - EssentialsX - ChestShop - SignShop - Jobs Reborn - McMMO - Towny - Factions - Y más de 100+ plugins ### ✅ PlaceholderAPI Instala PlaceholderAPI y los placeholders estarán disponibles automáticamente. ```bash /papi reload /papi ecloud download PrimeEconomy # Cuando esté publicado ``` ### ✅ LuckPerms Usa permisos para dar ventajas a rangos VIP: ```bash # Descuento del 25% en tienda /lp group vip permission set primeeco.shop.discount.vip true # 10 subastas simultáneas /lp group mvp permission set primeeco.auction.limit.10 true # Sin comisión de venta /lp group premium permission set primeeco.auction.nofee true ``` --- ## 🎨 Características Avanzadas ### Sistema de Rankings El plugin mantiene un ranking automático de los jugadores más ricos: ```java /baltop # Ver top 10 jugadores más ricos /baltop # Ver página específica ``` ### Transacciones Seguras Todas las transacciones son atómicas y seguras: - ✅ Prevención de duplicación de dinero - ✅ Rollback automático en caso de error - ✅ Log de todas las transacciones - ✅ Detección de valores negativos ### Sistema de Backups El plugin crea backups automáticos: - 📁 `plugins/PrimeEconomy/backups/` - 🕐 Cada 24 horas - 📦 Últimos 7 días guardados ### API para Desarrolladores ```java // Obtener instancia del plugin PrimeEconomy plugin = PrimeEconomy.getInstance(); // Obtener EconomyManager EconomyManager economy = plugin.getEconomyManager(); // Obtener balance double balance = economy.getBalance(uuid); // Depositar dinero economy.deposit(uuid, 1000.0); // Retirar dinero boolean success = economy.withdraw(uuid, 500.0); // Transferir dinero economy.transfer(senderUUID, receiverUUID, 250.0); // Crear cuenta economy.createAccount(uuid, playerName); ``` --- ## 📈 Optimización y Rendimiento ### Características de Rendimiento - ⚡ **Operaciones asíncronas** - Todas las operaciones de base de datos son async - 💾 **Cache inteligente** - Los balances se cachean en memoria - 🔄 **Guardado por lotes** - Múltiples cambios se guardan juntos - 📊 **SQLite optimizado** - Índices y preparación de statements - 🧹 **Limpieza automática** - Elimina datos antiguos automáticamente - 🚀 **Sin dependencias pesadas** - Solo usa bibliotecas nativas ### Consumo de Recursos **Servidor con 50 jugadores:** - RAM: ~15 MB - CPU: <0.5% (idle), 1-2% (transacciones) - Disco: <10 MB (base de datos) **Servidor con 500 jugadores:** - RAM: ~50 MB - CPU: <1% (idle), 2-3% (transacciones) - Disco: <50 MB (base de datos) --- ## 🐛 Solución de Problemas ### Los balances no se guardan 1. Verifica permisos de escritura en `plugins/PrimeEconomy/` 2. Revisa `data.db` existe y no está corrupto 3. Mira los logs para errores de SQL ### Vault no detecta PrimeEconomy 1. Asegúrate que Vault está instalado y actualizado 2. Reinicia el servidor (no uses /reload) 3. Verifica que `use-vault: true` en config.yml 4. Ejecuta `/vault-info` para ver proveedores ### La tienda no abre 1. Verifica que `shop.yml` no tiene errores 2. Comprueba que los materiales son válidos (usa XMaterial names) 3. Revisa que tienes el permiso `primeeco.shop` ### Las subastas desaparecen Las subastas expiran después del tiempo configurado (`listing-duration`). Los items se devuelven automáticamente al vendedor. ### Error de base de datos ```bash # Restaurar desde backup 1. Para el servidor 2. Ve a plugins/PrimeEconomy/backups/ 3. Copia el backup más reciente 4. Renómbralo a data.db 5. Inicia el servidor ``` --- ## 📝 Roadmap y Futuras Características ### Versión 1.1.0 - [ ] Soporte MySQL completo - [ ] Sistema de impuestos progresivos - [ ] Bancos de jugadores - [ ] Préstamos entre jugadores - [ ] Intereses sobre balances ### Versión 1.2.0 - [ ] Tiendas de jugadores (shops propios) - [ ] Monedas múltiples - [ ] Sistema de cheques - [ ] Tarjetas de débito (items que almacenan dinero) - [ ] Transacciones offline ### Versión 2.0.0 - [ ] Panel web de administración - [ ] API REST - [ ] Economía por mundos separada - [ ] Sistema de empresas/corporaciones - [ ] Mercado de acciones --- ## 🤝 Contribuir ¿Quieres mejorar PrimeEconomy? 1. 🍴 Fork el repositorio 2. 🌿 Crea una rama (`git checkout -b feature/mejora`) 3. 💬 Commit tus cambios (`git commit -am 'Añadir nueva función'`) 4. 📤 Push a la rama (`git push origin feature/mejora`) 5. 🔃 Crea un Pull Request ### Reportar Bugs Usa el sistema de Issues en GitHub con: - Versión del plugin - Versión de Minecraft/Spigot - Pasos para reproducir - Logs de error (si aplica) --- ## 📞 Soporte ¿Necesitas ayuda? - 💬 **Discord**: [discord.gg/tu-servidor](https://discord.gg/) - 📧 **Email**: soporte@tuservidor.com - 🐛 **Issues**: [GitHub Issues](https://github.com/tu-usuario/PrimeEconomy/issues) - 📖 **Wiki**: [GitHub Wiki](https://github.com/tu-usuario/PrimeEconomy/wiki) - 💬 **SpigotMC**: [SpigotMC Thread](https://www.spigotmc.org/) --- ## ⭐ Reseñas > "El mejor plugin de economía que he usado. Reemplazó 3 plugins diferentes y mi servidor va más rápido." > — **Administrador de servidor con 200 jugadores** > "La casa de subastas es increíble. Mis jugadores la usan más que el spawn." > — **Dueño de servidor survival** > "Fácil de configurar, potente, y sin lag. 10/10." > — **Desarrollador de plugins** --- ## 📜 Licencia Este proyecto está bajo la licencia MIT. Ver archivo [LICENSE](LICENSE) para más detalles. ``` MIT License Copyright (c) 2024 PrimeEconomy Se concede permiso, libre de cargos, a cualquier persona que obtenga una copia de este software y de los archivos de documentación asociados (el "Software"), para utilizar el Software sin restricción... ``` --- ## 🎉 Agradecimientos - **XSeries** - Por la compatibilidad multi-versión - **Vault** - Por el estándar de economía - **PlaceholderAPI** - Por el sistema de placeholders - **Comunidad de Spigot** - Por el feedback y sugerencias --- ## 📊 Estadísticas ![Descargas](https://img.shields.io/badge/Descargas-0-blue.svg) ![Servidores](https://img.shields.io/badge/Servidores-0-green.svg) ![Rating](https://img.shields.io/badge/Rating-5.0★-yellow.svg) ---

### 💎 Hecho con ❤️ para la comunidad de Minecraft **[Descargar](https://modrinth.com/plugin/primeeconomy)** • **[Documentación](https://github.com/tu-usuario/PrimeEconomy/wiki)** • **[Discord](https://discord.gg/)** • **[Donar](https://paypal.me/)**