# Advance<\/p>\n
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.<\/p>\n
## Key Features<\/p>\n
– **Admin-Approved Loans**: Players request materials \u2192 admins review \u2192 items granted on approval (or auto-approve mode)
\n– **Configurable Advance Limits**: Set max concurrent advances per player (default: 1)
\n– **Interest-Based System**: Amount owed increases based on quantity and repayment term
\n– **Flexible Terms**: 1 hour, 1 day, 1 week, or 1 month repayment periods
\n– **Flexible Block Configuration**: Choose between specific item lists, all obtainable blocks, or all blocks
\n– **Search Functionality**: Quick search in the GUI to find items by name
\n– **Onboarding Tutorial**: `\/advance onboard` command guides new players through the system
\n– **Autocollect**: Optional automatic payment when picking up matching items
\n– **Overdue Penalties**: Grace period \u2192 health loss \u2192 optional death penalty
\n– **GUI Interface**: Inventory-based menus for requesting, managing, and approving advances
\n– **Player Blocklist**: Block problematic players from using the advance system
\n– **Audit Logging**: Track all admin actions for accountability
\n– **Persistent Storage**: SQLite database tracks all advances and transactions<\/p>\n
## Quick Start<\/p>\n
### For Players<\/p>\n
**0. New to Advance?**
\n“`
\n\/advance onboard
\n“`
\nGet an interactive tutorial explaining how the system works, interest rates, and how to make payments.<\/p>\n
**1. Request an Advance**
\n“`
\n\/advance \u2192 Request New Advance \u2192 Pick item \u2192 Select amount \u2192 Choose term \u2192 Confirm
\n“`
\n**Tip**: Use the **Search** button in the item menu to quickly find specific blocks by name!<\/p>\n
**2. Check Status**
\n“`
\n\/advance status
\n“`
\nShows: item type, amount owed, amount paid, remaining balance, time left, autocollect status<\/p>\n
**3. Make Payments** **4. Avoid Penalties** ### For Admins<\/p>\n **Review Requests** **Manage Allowed Items** **Player Blocklist** **Audit Log** **Reload Config** ## Commands<\/p>\n | Command | Description | Permission | Default | ## Permissions<\/p>\n | Permission | Description | Default | ## Configuration<\/p>\n Edit `plugins\/Advance\/config.yml`:<\/p>\n ### Allowed Items<\/p>\n You can configure which blocks players can request using three methods:<\/p>\n **Option 1: Specific Item List (Default)** advance: **Option 2: All Obtainable Blocks** **Option 3: All Blocks (Use with Caution)** **Precedence**: `allow_all_blocks` > `allow_all_obtainable_blocks` > `allowed-items` list<\/p>\n ### Auto-Approve Mode ### Maximum Concurrent Advances ### Request Limits ### Interest Rates **Formula**: `Interest = Amount \u00d7 Base Rate \u00d7 Term Multiplier \u00d7 (1 + Stacks \u00d7 Quantity Multiplier)`<\/p>\n **Example** (64 stone, 1 day): ### Penalties health-penalty: final-death-penalty: dangerous-actions-enabled: false # MUST be true to enable death penalty ### Autocollect ### Logging ## How It Works<\/p>\n 1. **Request**: Player selects item, amount, and term \u2192 calculates total owed (principal + interest) **Status Progression**: `PENDING` \u2192 `APPROVED` \u2192 `PAID` (or `DENIED`, `EXPIRED`)<\/p>\n","protected":false},"excerpt":{"rendered":" adds a gui where builders can get block in advance for builds, but they have to pay interest<\/p>\n","protected":false},"featured_media":6584,"template":"","meta":{"_minecraft_slug":"advance","_minecraft_project_id":"ab7RsjrW","_minecraft_author":"modpotato","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":48,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"advance.zip","_minecraft_size_bytes":721316,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T21:12:28.764490Z","_minecraft_date_created":"2026-01-24T22:52:58.061832Z","_minecraft_date_modified":"2026-01-26T00:10:53.722556Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/advance","_minecraft_icon_attachment_id":6584,"_minecraft_imported_at":"2026-05-31T14:21:43+00:00","_minecraft_import_hash":"de405f56ac24bd36ad16fad674457c36","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,125,89,126,127,128,867,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-6583","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Manual**: `\/advance pay
\n– **Auto**: `\/advance autocollect on` (auto-applies picked-up items to debt)<\/p>\n
\n– Pay before deadline
\n– Grace period (default: 24h) before penalties start
\n– Overdue = increased debt + daily health loss<\/p>\n
\n“`
\n\/advance admin
\n“`
\n– Left-click: Approve (items given to player if online, otherwise held for pickup)
\n– Right-click: Deny<\/p>\n
\n“`
\n\/advance items list
\n\/advance items add
\n\/advance items add inventory # Add all items from your inventory
\n\/advance items remove
\n“`<\/p>\n
\n“`
\n\/advance block
\n\/advance unblock
\n\/advance blocklist # View all blocked players
\n“`<\/p>\n
\n“`
\n\/advance auditlog # View last 10 entries
\n\/advance auditlog
\n\/advance auditlog
\n“`<\/p>\n
\n“`
\n\/advance reload
\n“`<\/p>\n
\n|———|————-|————|———|
\n| `\/advance` | Open main menu | `advance.use` | All players |
\n| `\/advance onboard` | Learn how to use Advance | `advance.onboard` | All players |
\n| `\/advance status` | View advance details | `advance.status` | All players |
\n| `\/advance pay
\n| `\/advance autocollect
\n| `\/advance admin` | Admin approval panel | `advance.admin` | Operators |
\n| `\/advance items
\n| `\/advance block
\n| `\/advance unblock
\n| `\/advance blocklist` | View blocked players | `advance.admin.blocklist` | Operators |
\n| `\/advance auditlog [player|limit]` | View audit log | `advance.admin.auditlog` | Operators |
\n| `\/advance reload` | Reload configuration | `advance.admin.reload` | Operators |<\/p>\n
\n|————|————-|———|
\n| `advance.use` | Basic commands (grants `advance.request` + `advance.status` + `advance.onboard`) | true |
\n| `advance.request` | Request advances | true |
\n| `advance.status` | View status | true |
\n| `advance.pay` | Make payments | true |
\n| `advance.onboard` | Use onboard command | true |
\n| `advance.autocollect` | Use autocollect | true |
\n| `advance.admin` | Admin panel (grants all `advance.admin.*`) | op |
\n| `advance.admin.approve` | Approve requests | op |
\n| `advance.admin.deny` | Deny requests | op |
\n| `advance.admin.items` | Manage allowed items | op |
\n| `advance.admin.blocklist` | Manage player blocklist | op |
\n| `advance.admin.auditlog` | View audit logs | op |
\n| `advance.admin.reload` | Reload config | op |<\/p>\n
\n“`yaml
\nallowed-items:
\n – STONE
\n – DIRT
\n – NETHERRACK
\n – WHITE_WOOL<\/p>\n
\n allow_all_obtainable_blocks: false
\n allow_all_blocks: false
\n“`
\nUse Bukkit Material names (e.g., `DIAMOND_ORE`, not `minecraft:diamond_ore`). Managed in-game via `\/advance items add\/remove`.<\/p>\n
\n“`yaml
\nadvance:
\n allow_all_obtainable_blocks: true # Allows all survival-obtainable blocks
\n allow_all_blocks: false
\n“`
\nAutomatically allows any block that can be obtained in survival mode (excludes command blocks, barriers, etc.).<\/p>\n
\n“`yaml
\nadvance:
\n allow_all_obtainable_blocks: false # Ignored when allow_all_blocks is true
\n allow_all_blocks: true # WARNING: Allows ALL blocks including unobtainable ones
\n“`
\nAllows every block in the game, including normally unobtainable items like command blocks and barriers. **Use with caution!**<\/p>\n
\n“`yaml
\nadvance:
\n # When true, advance requests are automatically approved without admin review.
\n # The request will still fail if the player is blocked or at max advances.
\n auto_accept: false
\n“`<\/p>\n
\n“`yaml
\nadvance:
\n # Maximum number of active advances a player can have at once.
\n # Set to 1 for traditional single-advance behavior (UI remains unchanged).
\n # Set higher to allow multiple concurrent advances.
\n max_advances: 1
\n“`<\/p>\n
\n“`yaml
\nmax-request-amount: 512 # Maximum items per request
\n“`<\/p>\n
\n“`yaml
\ninterest-calculation:
\n base-rate: 0.05 # 5%
\n term-multipliers:
\n “1h”: 1.0 # No extra interest for 1 hour
\n “1d”: 1.5 # 50% more interest for 1 day
\n “1w”: 2.0 # 100% more for 1 week
\n “1m”: 4.0 # 300% more for 1 month
\n quantity-multiplier-per-stack: 0.01 # +1% per stack (64 items)
\n“`<\/p>\n
\n– Interest = 64 \u00d7 0.05 \u00d7 1.5 \u00d7 1.01 = 4.85
\n– **Total Owed: 69 items** (64 + 5 rounded)<\/p>\n
\n“`yaml
\npenalties:
\n overdue-interest-increase: 0.10 # +10% debt immediately when overdue
\n grace-period-hours: 24 # Time before health penalties start<\/p>\n
\n enabled: true
\n hearts-lost-per-day: 1 # Hearts (0.5 HP) lost per day overdue
\n minimum-health-hearts: 1 # Won’t go below 0.5 HP<\/p>\n
\n enabled: false # DANGER: Kills player after max days
\n max-overdue-days: 10<\/p>\n
\n“`<\/p>\n
\n“`yaml
\nautocollect:
\n enabled-by-default: false
\n notification-style: “ACTION_BAR” # or “CHAT”
\n“`<\/p>\n
\n“`yaml
\nlogging:
\n level: “INFO” # INFO, WARNING, or SEVERE
\n log-player-names: false # Privacy: log only UUIDs if false
\n log-amounts: true # Log transaction amounts
\n“`<\/p>\n
\n2. **Approval**: Admin reviews \u2192 approves\/denies \u2192 items given to player
\n3. **Repayment**: Player pays with manual commands or autocollect
\n4. **Completion**: Debt paid \u2192 advance closes \u2192 player can request again
\n5. **Penalties**: Miss deadline \u2192 grace period \u2192 overdue interest \u2192 health loss \u2192 (optional) death<\/p>\n