Conquest Auction House

Características Principales
1. Sistema de Casa de Subastas
– **Listados Persistentes** – Todos los listados de subastas se guardan en JSON y persisten a través de reinicios del servidor
– **Vistas Previas de Artículos** – Iconos visuales de artículos con indicadores de cantidad
– **Información del Vendedor** – Cada listado muestra el nombre de usuario del vendedor con insignias de reputación
– **Sistema de Precios** – Precios flexibles con límites máximos configurables
– **Soporte de Metadatos** – Preserva la durabilidad del artículo, encantamientos y datos personalizados
– **Filtrado Inteligente** – Buscar por nombre de artículo, vendedor o filtrar por favoritos
– **Modos de Vista Dual** – Cambiar entre Vista de Lista (6 artículos/página) o Vista de Cuadrícula (12 artículos/página)
– **Inteligencia de Precios** – Herramienta de comparación de precios en tiempo real que muestra el porcentaje frente al promedio del mercado
2. Sistema de Monedero y Economía
– **Monederos por Jugador** – Cada jugador tiene un saldo de monedas persistente
– **Transacciones Automáticas** – Transferencias de monedas instantáneas en compras
– **Persistencia de Saldo** – Datos del monedero guardados en formato JSON
– **Transferencias de Jugador a Jugador** – Enviar monedas directamente a otros jugadores
– **Controles de Administrador** – Agregar/quitar monedas del monedero de cualquier jugador
– **Protección contra Desbordamiento** – Prevención de desbordamiento de enteros en depósitos
3. Panel de Inteligencia de Mercado
– **Estadísticas de Mercado en Vivo** – Visualización en tiempo real de:
  – Conteo de Listados Activos
  – Ventas Totales procesadas
  – Volumen Total negociado (en monedas)
– **Seguimiento del Historial de Precios** – Cálculo automático del precio promedio para cada tipo de artículo
– **Tendencias del Mercado** – Indicadores visuales para artículos con precios por encima/debajo del promedio del mercado
4. Sistema de Notificaciones
– **Alertas en Tiempo Real** – 5 tipos de notificaciones:
  – **Venta** – Cuando tu artículo se vende
  – **Compra** – Cuando compras un artículo
  – **Alerta** – Alertas de precios en artículos favoritos
  – **Expirado** – Cuando tu listado expira
  – **Pago** – Cuando recibes monedas
– **Centro de Notificaciones** – Contador de insignias que muestra notificaciones no leídas
– **Almacenamiento Inteligente** – Limpieza automática (máx. 50 notificaciones por jugador)
– **Datos Persistentes** – Guardados en `notifications.json`
5. Sistema de Reputación del Vendedor
– **Sistema de Insignias Automático** – 6 niveles de reputación basados en ventas totales:
  – 🔲 **[NUEVO]** – 1-9 ventas (gris)
  – 🟨 **[ACTIVO]** – 10-49 ventas (amarillo)
  – 🟩 **[EXPERIMENTADO]** – 50-99 ventas (verde)
  – 🔷 **[CONFIABLE]** – 100-499 ventas (cian)
  – 🟪 **[MAESTRO]** – 500-999 ventas (púrpura)
  – 🟨 **[LEGENDARIO]** – 1000+ ventas (oro)
– **Seguimiento de Estadísticas del Vendedor** – Conteo total de ventas y ingresos totales ganados
– **Datos Persistentes** – Guardados en `seller_stats.json`
6. Sistema de Caja de Colección
– **Almacenamiento Seguro de Artículos** – Artículos de compras/cancelaciones almacenados de forma segura
– **Colección Persistente** – Sobrevive a los reinicios del servidor
– **Contador de Insignias** – Indicador visual de artículos esperando ser recogidos
– **Acceso Rápido** – Recogida con un clic desde la interfaz principal
– **Protección de Inventario** – Artículos almacenados de forma segura si el inventario está lleno
7. Historial de Transacciones
– **Registros Completos** – Rastrear todas las compras y ventas
– **Registros Detallados** – Artículo, precio, comprador, vendedor, marca de tiempo
– **Vista Específica del Jugador** – Ver solo tus propias transacciones
– **Almacenamiento Persistente** – Guardado en `transactions.json`
 8. Sistema de Favoritos
– **Marcar Artículos** – Marcar artículos para un filtrado rápido
– **Filtro Rápido** – Un clic para ver solo artículos favoritos
– **Alertas de Precios** – Recibir notificaciones cuando se listan artículos favoritos
– **Datos Persistentes** – Guardados en `favorites.json`
Interfaz de Usuario Personalizada
Cinco Páginas de UI Dedicadas
**1. Navegador de Subastas** 
– Barra de Estadísticas del Mercado (Activos/Ventas/Volumen)
– Barra de Acciones Rápidas (Actualizar, Favoritos, Colección, Notificaciones, Alternar Vista)
– Visualización de artículos paginada (6 o 12 artículos por página según el modo de vista)
– Visualización del saldo en tiempo real
– Funcionalidad de búsqueda para artículos y vendedores
– Opciones de ordenación (Más Nuevos, Precio: Bajo a Alto, Precio: Alto a Bajo)
– Botones de Comprar/Cancelar contextualizados a la propiedad
– Herramientas de comparación de precios
– Insignias de reputación del vendedor

Comandos
Comandos de jugador
| Comando | Descripción | Permiso |
|———|————-|————|
| `/hdv` | Abre el navegador de la casa de subastas | Predeterminado |
| `/hdv collect` | Recoge todos los artículos de tu caja de colección | Predeterminado |
| `/auction` | Alias para `/hdv` | Predeterminado |
| `/auctionhouse` | Alias para `/hdv` | Predeterminado |
| `/balance` | Verifica tu saldo de monedas | Predeterminado |
| `/pay <jugador> <cantidad>` | Envía monedas a otro jugador | Predeterminado |

### Comandos de Administrador
| Comando | Descripción | Permiso |
|———|————-|————|
| `/coins add <jugador> <cantidad>` | Agregar monedas al monedero de un jugador | OP |
| `/coins remove <jugador> <cantidad>` | Quitar monedas del monedero de un jugador | OP |
| `/coins set <jugador> <cantidad>` | Establecer el saldo de monedas de un jugador | OP |

## Persistencia de Datos

Todos los datos se almacenan en formato JSON en:
`C:Users[NombreDeUsuario]AppDataRoamingHytaleUserDataMods`

**Archivos de Datos:**
– `auctions.json` – Listados de subastas activos
– `wallets.json` – Saldos de monedas de los jugadores
– `transactions.json` – Historial de transacciones
– `collection_box.json` – Artículos no reclamados
– `favorites.json` – Artículos favoritos de los jugadores
– `seller_stats.json` – Datos de reputación del vendedor
– `price_history.json` – Promedios de precios del mercado
– `notifications.json` – Notificaciones del jugador
– `config.json` – Configuración del plugin

## Configuración

Configuraciones predeterminadas en `config.json`:
“`json
{
  “maxListingPrice”: 1000000,
  “maxActiveListings”: 10,
  “listingDuration”: 604800,
  “listingFee”: 10
}
“`

**Opciones de Configuración:**
– `maxListingPrice` – Precio máximo por listado (predeterminado: 1,000,000 monedas)
– `maxActiveListings` – Listados máximos por jugador (predeterminado: 10)
– `listingDuration` – Duración del listado en segundos (predeterminado: 604,800 = 7 días)
– `listingFee` – Tarifa para crear un listado (predeterminado: 10 monedas)