Advance

# Advance A Minecraft plugin enabling players to borrow materials with interest for large builds. Players request items, admins approve, and repayment is tracked with configurable penalties for missed deadlines. ## Key Features - **Admin-Approved Loans**: Players request materials → admins review → items granted on approval (or auto-approve mode) - **Configurable Advance Limits**: Set max concurrent advances per player (default: 1) - **Interest-Based System**: Amount owed increases based on quantity and repayment term - **Flexible Terms**: 1 hour, 1 day, 1 week, or 1 month repayment periods - **Flexible Block Configuration**: Choose between specific item lists, all obtainable blocks, or all blocks - **Search Functionality**: Quick search in the GUI to find items by name - **Onboarding Tutorial**: `/advance onboard` command guides new players through the system - **Autocollect**: Optional automatic payment when picking up matching items - **Overdue Penalties**: Grace period → health loss → optional death penalty - **GUI Interface**: Inventory-based menus for requesting, managing, and approving advances - **Player Blocklist**: Block problematic players from using the advance system - **Audit Logging**: Track all admin actions for accountability - **Persistent Storage**: SQLite database tracks all advances and transactions ## Quick Start ### For Players **0. New to Advance?** ``` /advance onboard ``` Get an interactive tutorial explaining how the system works, interest rates, and how to make payments. **1. Request an Advance** ``` /advance → Request New Advance → Pick item → Select amount → Choose term → Confirm ``` **Tip**: Use the **Search** button in the item menu to quickly find specific blocks by name! **2. Check Status** ``` /advance status ``` Shows: item type, amount owed, amount paid, remaining balance, time left, autocollect status **3. Make Payments** - **Manual**: `/advance pay <amount>` (requires items in inventory) - **Auto**: `/advance autocollect on` (auto-applies picked-up items to debt) **4. Avoid Penalties** - Pay before deadline - Grace period (default: 24h) before penalties start - Overdue = increased debt + daily health loss ### For Admins **Review Requests** ``` /advance admin ``` - Left-click: Approve (items given to player if online, otherwise held for pickup) - Right-click: Deny **Manage Allowed Items** ``` /advance items list /advance items add <material> /advance items add inventory # Add all items from your inventory /advance items remove <material> ``` **Player Blocklist** ``` /advance block <player> # Block a player from using advances /advance unblock <player> # Unblock a player /advance blocklist # View all blocked players ``` **Audit Log** ``` /advance auditlog # View last 10 entries /advance auditlog <limit> # View last N entries /advance auditlog <player> # View entries for a player ``` **Reload Config** ``` /advance reload ``` ## Commands | Command | Description | Permission | Default | |---------|-------------|------------|---------| | `/advance` | Open main menu | `advance.use` | All players | | `/advance onboard` | Learn how to use Advance | `advance.onboard` | All players | | `/advance status` | View advance details | `advance.status` | All players | | `/advance pay <amount>` | Manual payment | `advance.pay` | All players | | `/advance autocollect <on\|off>` | Toggle autocollect | `advance.autocollect` | All players | | `/advance admin` | Admin approval panel | `advance.admin` | Operators | | `/advance items <list\|add\|remove>` | Manage allowed items | `advance.admin.items` | Operators | | `/advance block <player> ` | Block player from advances | `advance.admin.blocklist` | Operators | | `/advance unblock <player>` | Unblock a player | `advance.admin.blocklist` | Operators | | `/advance blocklist` | View blocked players | `advance.admin.blocklist` | Operators | | `/advance auditlog ` | View audit log | `advance.admin.auditlog` | Operators | | `/advance reload` | Reload configuration | `advance.admin.reload` | Operators | ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `advance.use` | Basic commands (grants `advance.request` + `advance.status` + `advance.onboard`) | true | | `advance.request` | Request advances | true | | `advance.status` | View status | true | | `advance.pay` | Make payments | true | | `advance.onboard` | Use onboard command | true | | `advance.autocollect` | Use autocollect | true | | `advance.admin` | Admin panel (grants all `advance.admin.*`) | op | | `advance.admin.approve` | Approve requests | op | | `advance.admin.deny` | Deny requests | op | | `advance.admin.items` | Manage allowed items | op | | `advance.admin.blocklist` | Manage player blocklist | op | | `advance.admin.auditlog` | View audit logs | op | | `advance.admin.reload` | Reload config | op | ## Configuration Edit `plugins/Advance/config