proimpuestos

¿Qué es ProImpuestos?

ProImpuestos es un sistema avanzado de impuestos para servidores Minecraft orientados a economías roleplay, gobiernos, ciudades, facciones, tiendas, NPCs, bancos o sistemas administrativos.

El plugin administra una bolsa central de impuestos donde se pueden registrar ingresos, realizar egresos, consultar saldo, revisar historial y auditar movimientos con total seguridad usando MySQL, HikariCP y operaciones atómicas.

A diferencia de un sistema simple de “sumar y restar dinero”, ProImpuestos guarda el saldo actual en una wallet dedicada y registra cada movimiento con saldo anterior, saldo posterior, actor, UUID, motivo, estado y fecha.


Características principales

• Bolsa central de impuestos para economías RP.
• MySQL / MariaDB como almacenamiento persistente.
• HikariCP para pool real de conexiones.
• Consultas asíncronas, evitando bloquear el hilo principal del servidor.
• Egresos atómicos usando transacciones SQL y bloqueo de wallet.
• Protección contra duplicación de dinero en retiros simultáneos.
• Integración con Vault para depositar dinero a jugadores.
• API pública para integrar otros plugins.
• Historial paginado de movimientos.
• Webhooks de Discord mejorados con embeds.
• Sistema de quema de impuestos configurable.
• Permisos separados para administración segura.
• Compatibilidad legacy con permisos de AuroraImpuestos.
• Comando reload para recargar configuración.

Casos de uso

• Sistema de impuestos para gobiernos RP.
• Recaudación de tiendas, NPCs o mercados.
• Control financiero de ciudades o alcaldías.
• Bancos centrales o tesorerías públicas.
• Fondos comunitarios para eventos.
• Sistemas de economía avanzada.
• Integración con plugins de tiendas personalizados.
• Auditoría de ingresos y egresos administrativos.

Sistema seguro de egresos

ProImpuestos no descuenta dinero de forma insegura.

Cuando un jugador autorizado realiza un egreso:

1. El plugin bloquea la wallet en MySQL.
2. Verifica el saldo disponible.
3. Registra el egreso con saldo anterior y saldo nuevo.
4. Libera la transacción SQL.
5. Deposita el dinero al jugador usando Vault.
6. Si Vault falla, el egreso se revierte automáticamente.

Esto evita que dos jugadores retiren el mismo saldo al mismo tiempo.


Comandos

Alias:

[HR][/HR]

Permisos

Permisos legacy compatibles:


Integración para desarrolladores

ProImpuestos registra una API pública mediante el ServicesManager de Bukkit.

Ejemplo básico:

Métodos disponibles:

[HR][/HR]

Requisitos

• Paper 1.21.1
• Java 21
• Vault
• Un plugin de economía compatible con Vault, por ejemplo EssentialsX Economy
• MySQL o MariaDB

Ideal para servidores RP

ProImpuestos fue diseñado para servidores donde la economía necesita control, auditoría y narrativa. Puedes usarlo como tesorería del gobierno, fondo público, impuestos de tiendas, sistema bancario o registro económico centralizado.

What is ProImpuestos?

ProImpuestos is an advanced tax wallet system for Minecraft servers focused on roleplay economies, governments, cities, factions, shops, NPCs, banks, and administrative systems.

The plugin manages a central tax wallet where you can register income, process expenses, check balances, review history, and audit all financial movements safely using MySQL, HikariCP, and atomic SQL transactions.

Instead of simply adding and subtracting money from a growing transaction table, ProImpuestos uses a dedicated wallet table for the current balance and stores every transaction with previous balance, new balance, actor, UUID, reason, status, and date.

[HR][/HR]

Main Features

• Central tax wallet for RP economies.
• MySQL / MariaDB persistent storage.
• HikariCP real connection pooling.
• Async database operations to avoid blocking the server thread.
• Atomic withdrawals using SQL transactions and wallet locking.
• Protection against money duplication during simultaneous withdrawals.
• Vault integration for player deposits.
• Public API for other plugins.
• Paginated transaction history.
• Improved Discord webhooks with embeds.
• Configurable tax burn system.
• Separated permissions for safer administration.
• Legacy permission compatibility with AuroraImpuestos.
• Reload command for configuration updates.

[HR][/HR]

Use Cases

• Government tax systems for RP servers.
• Shop, NPC, or market tax collection.
• City or mayor office financial control.
• Central bank or public treasury.
• Community event funds.
• Advanced economy systems.
• Integration with custom shop plugins.
• Auditable admin income and expense logs.

[HR][/HR]

Safe Withdrawal System

ProImpuestos does not handle withdrawals in an unsafe way.

When an authorized player performs an expense:

1. The plugin locks the wallet in MySQL.
2. Checks the available balance.
3. Registers the expense with previous and new balance.
4. Commits the SQL transaction.
5. Deposits the money to the player using Vault.
6. If Vault fails, the expense is automatically reverted.

This prevents two players from spending the same wallet balance at the same time.

[HR][/HR]

Commands

Aliases:

[HR][/HR]

Permissions

Legacy compatible permissions:

[HR][/HR]

Developer Integration

ProImpuestos exposes a public API through Bukkit's ServicesManager.

Basic example:

Available methods:

[HR][/HR]

Requirements

• Paper 1.21.1
• Java 21
• Vault
• A Vault-compatible economy plugin, such as EssentialsX Economy
• MySQL or MariaDB

[HR][/HR]

Perfect for RP servers

ProImpuestos is designed for servers where the economy needs control, auditing, and roleplay depth. Use it as a government treasury, public fund, shop tax system, banking system, or centralized economy log.