TransactionsPlugin Documentation
Overview
TransactionsPlugin is a Bukkit/Spigot plugin for Minecraft servers that tracks and displays player economic transactions (income, expenses, and balance changes) in a user-friendly GUI. It integrates with Vault to monitor balance changes, supports multi-language translations, and provides administrative tools to view other players' transactions. The plugin also supports tagging transactions (e.g., "pay", "admin", "shop") for better categorization, including transactions from VillagerMarket.

Features

• Transaction Tracking: Records player transactions (income, expenses, and balance resets) with timestamps and details.
• GUI Interface: Displays transactions in a paginated inventory with filtering by type (income, expense, all) and time period (all time, last 7 days, last 30 days).
• Search by Nickname: Allows players to search their transactions by another player's nickname (disabled for admin viewing of others' transactions).
• Statistics: Shows income and expense statistics for a configurable period.
• VillagerMarket Integration: Tags transactions from VillagerMarket as "shop" based on player interaction with villagers.
• Multi-language Support: Supports translations via YAML files (e.g., lang/ru.yml, lang/en.yml).
• Admin Tools: Admins can view other players' transactions with restrictions on nickname search.
• Configurable Settings: Customizable colors, time periods, and balance display options.

Requirements

• Minecraft Version: 1.13+ (tested up to 1.20.4).
• Dependencies:
  • Vault: For economy integration.
  • Bukkit/Spigot/Paper: Server software.
• Optional: VillagerMarket for shop transaction tagging.

Installation

1. Download the TransactionsPlugin.jar file.
2. Place it in the plugins folder of your server.
3. Ensure Vault and an economy plugin (e.g., EssentialsX) are installed.
4. Restart the server to generate configuration files (config.yml, lang/*.yml).
5. Configure settings in config.yml and translations in lang/ folder as needed.

Commands

Command Description Permission
/transactions Opens the player's transaction GUI. transactions.view
/transactions <player> Opens another player's transaction GUI (admin only). transactions.view.others
/transactions reload Reloads configuration and language files. transactions.admin
/transactions clean Clears all transactions older than the configured period. transactions.admin
/transactions gmt <offset> Sets the player's GMT offset for transaction timestamps. transactions.gmt
/transactions balance <on/off> Toggles balance display in the transaction GUI. transactions.balance
/transactions update Updates configuration and language files to the latest version. transactions.admin
Permissions

Permission Description
transactions.view Allows players to view their own transactions.
transactions.view.others Allows admins to view other players' transactions.
transactions.admin Grants access to reload, clean, and update commands.
transactions.gmt Allows players to set their GMT offset.
transactions.balance Allows players to toggle balance display (if enabled in config).