✨
Overview :
AdvancedBillPlugin is a premium-quality, lightweight billing and fine system designed specifically for **RolePlay (RP)** and city-simulator servers. It allows your server's authority figures (Police Officers, Medics, or Government Officials) to issue fines and bills to citizens in a highly interactive way. Instead of boring instant text, invoices land in the player's chat with a beautiful, line-by-line typewriter animation and retro sound effects!
##
Key Features:
---------------------------------------
Dual-Language Support
Fully supports both
English (en) and
Persian/Finglish (fa) out of the box. Switch instantly via `config.yml`!
Animated Typewriter Invoices
Bills are rendered line-by-line in chat with satisfying mechanical sound effects to guarantee roleplay immersion.
⏰ Automated Debt Reminders
Automatically reminds forgetful citizens about their unpaid bills at highly configurable intervals.
Robust Vault Integration
Seamlessly connects with your economy backend using Vault to handle withdrawals and check balances.
⌨ Smart Language Tab-Completion
Commands dynamically switch arguments based on your configuration (e.g., suggesting issue/pay in English and sader/pardakht in Persian).
------------------------------------------
## Commands & Dynamic Subcommands
Depending on the language set in your config.yml, the plugin will adapt its help menu and tab-completion format:
English Mode (lang: en)
/bill ➔ View your active unpaid bills and total debt.
/bill pay ➔ Pay off a specific bill using your bank balance.
/bill issue ➔ Issue a new fine/bill to a citizen.
Persian Mode (lang: fa)
/ghabz ➔ Moshahedeye liste ghabzhaye pardakht nashode va bedehi kol. /ghabz pardakht ➔ Pardakht kardane yek ghabze khas az hesab.
/ghabz sader ➔ Sadere ghabze jadid baraye player.
Built-in Aliases: /fine, /jarime, and /bill work interchangeably as main commands!
------------------------------------------
## Permissions
ghabz.use ➔ Allows players to view, track, and pay their own bills. (Default: true)
ghabz.sader ➔ Allows official staff/law enforcement to issue bills to others. (Default: op)
------------------------------------------
⚙ Default Configuration (config.yml)
Code (Text):
```yaml
# GhabzPlugin Configuration
# Available languages: 'fa' (Persian / Pinglish) or 'en' (English)
lang: "fa"
# Dynamic Message Settings
settings:
# Reminder interval for unpaid bills (in ticks) - 12000 ticks = 10 Minutes
reminder-interval-ticks: 12000
Support & Bug Reports
Found a bug? Please do not report bugs or ask for help in the review section! Instead, feel free to contact me directly or join my community so I can fix it for you immediately. Your 5-star ratings help keep this plugin updated!