SyBank

# SyBank - Minecraft Banking System Plugin A fully-featured Minecraft banking plugin supporting deposits, withdrawals, loans, and more. ## Author **Shiyuan** ## Features - 💰 **Bank Account** - Players can deposit in-game currency to earn interest - 💸 **Loan System** - Support for loan applications with customizable interest rates and terms - 🖥️ **GUI Interface** - Beautiful graphical user interface - 📊 **Interest Calculation** - Monthly interest calculation for both deposits and loans - ⏰ **Overdue Penalties** - Slowness effect penalties for overdue loans - 🔐 **Permission Management** - Comprehensive permission system ## Commands | Command | Description | Permission | |---------|-------------|------------| | `/sbk` | Open bank GUI | sybank.use | | `/sbk open` | Open bank GUI | sybank.use | | `/sbk save <amount>` | Deposit to bank | sybank.use | | `/sbk wd <amount>` | Withdraw from bank | sybank.use | | `/sbk loan <amount> ` | Apply for a loan | sybank.loan | | `/sbk rp <amount>` | Repay loan | sybank.use | | `/sbk rpall` | Repay entire loan with cash | sybank.use | | `/sbk confirm` | Confirm loan application | sybank.loan | | `/sbk cancel` | Cancel loan application | sybank.loan | | `/sbk reload` | Reload plugin configuration | sybank.admin | | `/sbk op <player>` | View player's loan information | sybank.admin | ## Permissions - `sybank.use` - Allow basic banking functions (default: everyone) - `sybank.loan` - Allow loan applications (default: everyone) - `sybank.admin` - Allow administrative functions (default: OP) ## Installation 1. Download the `SyBank-1.0.0.jar` file 2. Place the JAR file in your server's `plugins` folder 3. Restart the server or load the plugin 4. Edit `plugins/SyBank/config.yml` to configure ## Dependencies - **Vault** - Economy system support (Required) - **Any Economy Plugin** - Such as EssentialsX, PlayerPoints, etc. (Supported through Vault) ## Configuration ### config.yml ```yaml # Bank Settings bank: # Default deposit interest rate (% per month) interest-rate: 2.0 # Default loan interest rate (% per month) loan-interest-rate: 2.5 # Default loan duration (months) loan-default-duration: 1 # Maximum loan duration (months) loan-max-duration: 3 # Maximum loan amount loan-max-amount: 100000 # Allow multiple loans simultaneously allow-multiple-loans: false # Overdue Settings overdue: # Grace period after overdue (months) grace-period: 1 # Enable slowness effect penalty enable-slow-effect: true # Slowness effect time period (24-hour format) slow-effect: # Start time (hour:minute) start-time: "17:00" # End time (hour:minute) end-time: "10:00" # Slowness level (1-4) level: 2 # GUI Settings gui: # GUI title title: "&6&lSyBank Banking System" # GUI size (must be a multiple of 9) size: 27 # Reminder Settings reminder: # Remind players of loan repayment on login enabled: true # Reminder message format message: "&c&l &eYou have an outstanding loan of &6{amount} &ecoins, please repay soon!" # Show quick repay button show-repay-button: true # Quick repay button text repay-button-text: "&a" ``` ### messages.yml All plugin messages can be customized in `messages.yml`. ## Loan System ### Applying for a Loan 1. Use `/sbk loan <amount> ` to apply for a loan 2. The system will display loan details (principal, interest, total amount due) 3. Click the **"Confirm Application"** button or type `/sbk confirm` to confirm 4. Click the **"Cancel Application"** button or type `/sbk cancel` to cancel ### Repayment Methods - **Partial Repayment**: `/sbk rp <amount>` - Repay a specified amount with cash - **Full Repayment**: `/sbk rpall` - Repay the entire loan with cash at once - **Balance Repayment**: Click the repay button in the GUI to use bank account balance ### Interest Calculation - Loan interest is calculated based on actual months borrowed - Minimum interest period is **1 month** - Early repayment does not incur interest for remaining months - Monthly interest = Principal × Monthly interest rate ### Overdue Penalties - After the loan due date, a **grace period** begins (default 1 month) - No additional penalties during the grace period - After the grace period ends, **slowness effect** penalty applies daily from **17:00-10:00** ## Notes 1. Loan duration cannot exceed the maximum duration in configuration (default 3 months) 2. If multiple loans are not allowed, current loan must be repaid before applying for a new one 3. Deposit and withdrawal operations require the player to be online 4. Plugin data is stored in the `plugins/SyBank/data/` directory ## Changelog ### v1.0.0 - ✨ Initial release - 💰 Bank deposit and withdrawal functions - 💸 Loan system - 🖥️ GUI interface - 📊 Interest calculation - ⏰ Overdue penalties ## Support & Feedback For issues or suggestions, please contact the autho