Advance
一个 Minecraft 插件,允许玩家为大型建筑项目借入材料并支付利息。玩家申请物品,管理员审核批准,并通过可配置的逾期惩罚机制追踪还款情况。
主要功能
- 管理员审批贷款:玩家申请材料 → 管理员审核 → 批准后发放物品(或启用自动批准模式)
- 可配置的预支限额:设置每个玩家同时存在的预支数量上限(默认:1)
- 基于利息的系统:欠款金额根据数量和还款期限增加
- 灵活的期限:支持 1 小时、1 天、1 周或 1 个月的还款周期
- 灵活的方块配置:可选择使用特定物品列表、所有可获取的方块或所有方块
- 搜索功能:在 GUI 中快速通过名称查找物品
- 新手引导教程:
/advance onboard 命令指导新玩家了解系统
- 自动收款:可选的自动付款功能,拾取匹配物品时自动抵扣债务
- 逾期惩罚:宽限期 → 生命值损失 → 可选的死亡惩罚
- GUI 界面:基于库存的菜单,用于申请、管理和批准预支
- 玩家黑名单:阻止有问题的玩家使用预支系统
- 审计日志:记录所有管理员操作以确保责任追溯
- 持久化存储:SQLite 数据库追踪所有预支和交易记录
快速开始
对于玩家
0. 初次接触 Advance?
/advance onboard
获取交互式教程,解释系统工作原理、利率以及如何还款。
1. 申请预支
/advance → Request New Advance → Pick item → Select amount → Choose term → Confirm
提示:在物品菜单中使用 Search 按钮快速按名称查找特定方块!
2. 查看状态
/advance status
显示:物品类型、欠款金额、已还金额、剩余余额、剩余时间、自动收款状态
3. 进行还款
- 手动:
/advance pay <amount>(需要背包中有相应物品)
- 自动:
/advance autocollect on(自动将拾取的物品应用于债务抵扣)
4. 避免惩罚
- 在截止日期前还款
- 宽限期(默认:24 小时)后才开始施加惩罚
- 逾期 = 债务增加 + 每日生命值损失
对于管理员
审核请求
/advance admin
- 左键点击:批准(如果玩家在线则直接发放物品,否则暂存供领取)
- 右键点击:拒绝
管理允许的物品
/advance items list
/advance items add <material>
/advance items add inventory # 添加你背包中的所有物品
/advance items remove <material>
玩家黑名单
/advance block <player> [reason] # 禁止某玩家使用预支系统
/advance unblock <player> # 解除对某玩家的禁令
/advance blocklist # 查看所有被禁用的玩家
审计日志
/advance auditlog # 查看最近 10 条记录
/advance auditlog <limit> # 查看最近 N 条记录
/advance auditlog <player> # 查看某玩家的记录
重载配置
/advance reload
命令
| 命令 |
描述 |
权限 |
默认值 |
/advance |
打开主菜单 |
advance.use |
所有玩家 |
/advance onboard |
学习如何使用 Advance |
advance.onboard |
所有玩家 |
/advance status |
查看预支详情 |
advance.status |
所有玩家 |
/advance pay <amount> |
手动还款 |
advance.pay |
所有玩家 |
/advance autocollect <on|off> |
切换自动收款 |
advance.autocollect |
所有玩家 |
/advance admin |
管理员审批面板 |
advance.admin |
操作员 (OP) |
/advance items <list|add|remove> |
管理允许的物品 |
advance.admin.items |
操作员 (OP) |
/advance block <player> [reason] |
禁止玩家使用预支 |
advance.admin.blocklist |
操作员 (OP) |
/advance unblock <player> |
解除玩家禁令 |
advance.admin.blocklist |
操作员 (OP) |
/advance blocklist |
查看被禁用的玩家 |
advance.admin.blocklist |
操作员 (OP) |
/advance auditlog [player|limit] |
查看审计日志 |
advance.admin.auditlog |
操作员 (OP) |
/advance reload |
重载配置 |
advance.admin.reload |
操作员 (OP) |
权限
| 权限 |
描述 |
默认值 |
advance.use |
基本命令(授予 advance.request + advance.status + advance.onboard) |
true |
advance.request |
申请预支 |
true |
advance.status |
查看状态 |
true |
advance.pay |
进行还款 |
true |
advance.onboard |
使用新手引导命令 |
true |
advance.autocollect |
使用自动收款 |
true |
advance.admin |
管理员面板(授予所有 advance.admin.*) |
op |
advance.admin.approve |
批准请求 |
op |
advance.admin.deny |
拒绝请求 |
op |
advance.admin.items |
管理允许的物品 |
op |
advance.admin.blocklist |
管理玩家黑名单 |
op |
advance.admin.auditlog |
查看审计日志 |
op |
advance.admin.reload |
重载配置 |
op |
配置
编辑 plugins/Advance/config.yml:
允许的物品
你可以使用以下三种方法配置玩家可申请哪些方块:
选项 1:特定物品列表(默认)
allowed-items:
- STONE
- DIRT
- NETHERRACK
- WHITE_WOOL
advance:
allow_all_obtainable_blocks: false
allow_all_blocks: false
使用 Bukkit Material 名称(例如 DIAMOND_ORE,而不是 minecraft:diamond_ore)。可通过游戏内命令 /advance items add/remove 进行管理。
选项 2:所有可获取的方块
advance:
allow_all_obtainable_blocks: true # 允许所有生存模式下可获取的方块
allow_all_blocks: false
自动允许任何可以在生存模式中获取的方块(排除指令方块、屏障等)。
选项 3:所有方块(谨慎使用)
advance:
allow_all_obtainable_blocks: false # 当 allow_all_blocks 为 true 时此设置无效
allow_all_blocks: true # 警告:允许获取包括无法获得方块在内的所有方块
允许游戏内的每一个方块,包括通常无法获得的物品如命令方块和屏障。请谨慎使用!
优先级:allow_all_blocks > allow_all_obtainable_blocks > allowed-items 列表
自动审批模式
advance:
# 当设为 true 时,进度请求将无需管理员审核即可自动批准。
# 如果玩家被屏蔽或已达到最大进度数,请求仍会失败。
auto_accept: false
最大并发进度数
advance:
# 玩家同时拥有的活跃进度的最大数量。
# 设为 1 以启用传统的单进度行为(界面保持不变)。
# 设高一些以允许多个并发进度。
max_advances: 1
请求限制
max-request-amount: 512 # 每次请求的最大物品数量
利率
interest-calculation:
base-rate: 0.05 # 5%
term-multipliers:
"1h": 1.0 # 1 小时无额外利息
"1d": 1.5 # 1 天增加 50% 利息
"1w": 2.0 # 1 周增加 100% 利息
"1m": 4.0 # 1 个月增加 300% 利息
quantity-multiplier-per-stack: 0.01 # 每组(64 个物品)增加 1%
公式:利息 = 本金 × 基础利率 × 期限乘数 × (1 + 组数 × 数量乘数)
示例(64 个石头,1 天):
- 利息 = 64 × 0.05 × 1.5 × 1.01 = 4.85
- 总欠款:69 个物品(64 + 四舍五入后的 5)
惩罚机制
penalties:
overdue-interest-increase: 0.10 # 逾期时立即增加 10% 债务
grace-period-hours: 24 # 开始生命值惩罚前的宽限时间
health-penalty:
enabled: true
hearts-lost-per-day: 1 # 每天逾期扣除 1 颗心(0.5 HP)
minimum-health-hearts: 1 # 不会低于 0.5 HP
final-death-penalty:
enabled: false # 危险:在最大天数后杀死玩家
max-overdue-days: 10
dangerous-actions-enabled: false # 必须设为 true 才能启用死亡惩罚
自动收取
autocollect:
enabled-by-default: false
notification-style: "ACTION_BAR" # 或 "CHAT"
日志记录
logging:
level: "INFO" # INFO、WARNING 或 SEVERE
log-player-names: false # 隐私保护:如果为 false,仅记录 UUID
log-amounts: true # 记录交易金额
工作原理
- 请求:玩家选择物品、数量和期限 → 计算总欠款(本金 + 利息)
- 审批:管理员审核 → 批准/拒绝 → 向玩家发放物品
- 还款:玩家通过手动指令或自动收取功能进行还款
- 完成:债务还清 → 进度关闭 → 玩家可以再次发起请求
- 惩罚:错过截止日期 → 宽限期 → 逾期利息 → 生命值损失 → (可选)死亡
状态流程:PENDING → APPROVED → PAID(或 DENIED、EXPIRED)
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> [reason] # 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> [reason] |
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 [player|limit] |
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.yml:
Allowed Items
You can configure which blocks players can request using three methods:
Option 1: Specific Item List (Default)
allowed-items:
- STONE
- DIRT
- NETHERRACK
- WHITE_WOOL
advance:
allow_all_obtainable_blocks: false
allow_all_blocks: false
Use Bukkit Material names (e.g., DIAMOND_ORE, not minecraft:diamond_ore). Managed in-game via /advance items add/remove.
Option 2: All Obtainable Blocks
advance:
allow_all_obtainable_blocks: true # Allows all survival-obtainable blocks
allow_all_blocks: false
Automatically allows any block that can be obtained in survival mode (excludes command blocks, barriers, etc.).
Option 3: All Blocks (Use with Caution)
advance:
allow_all_obtainable_blocks: false # Ignored when allow_all_blocks is true
allow_all_blocks: true # WARNING: Allows ALL blocks including unobtainable ones
Allows every block in the game, including normally unobtainable items like command blocks and barriers. Use with caution!
Precedence: allow_all_blocks > allow_all_obtainable_blocks > allowed-items list
Auto-Approve Mode
advance:
# When true, advance requests are automatically approved without admin review.
# The request will still fail if the player is blocked or at max advances.
auto_accept: false
Maximum Concurrent Advances
advance:
# Maximum number of active advances a player can have at once.
# Set to 1 for traditional single-advance behavior (UI remains unchanged).
# Set higher to allow multiple concurrent advances.
max_advances: 1
Request Limits
max-request-amount: 512 # Maximum items per request
Interest Rates
interest-calculation:
base-rate: 0.05 # 5%
term-multipliers:
"1h": 1.0 # No extra interest for 1 hour
"1d": 1.5 # 50% more interest for 1 day
"1w": 2.0 # 100% more for 1 week
"1m": 4.0 # 300% more for 1 month
quantity-multiplier-per-stack: 0.01 # +1% per stack (64 items)
Formula: Interest = Amount × Base Rate × Term Multiplier × (1 + Stacks × Quantity Multiplier)
Example (64 stone, 1 day):
- Interest = 64 × 0.05 × 1.5 × 1.01 = 4.85
- Total Owed: 69 items (64 + 5 rounded)
Penalties
penalties:
overdue-interest-increase: 0.10 # +10% debt immediately when overdue
grace-period-hours: 24 # Time before health penalties start
health-penalty:
enabled: true
hearts-lost-per-day: 1 # Hearts (0.5 HP) lost per day overdue
minimum-health-hearts: 1 # Won't go below 0.5 HP
final-death-penalty:
enabled: false # DANGER: Kills player after max days
max-overdue-days: 10
dangerous-actions-enabled: false # MUST be true to enable death penalty
Autocollect
autocollect:
enabled-by-default: false
notification-style: "ACTION_BAR" # or "CHAT"
Logging
logging:
level: "INFO" # INFO, WARNING, or SEVERE
log-player-names: false # Privacy: log only UUIDs if false
log-amounts: true # Log transaction amounts
How It Works
- Request: Player selects item, amount, and term → calculates total owed (principal + interest)
- Approval: Admin reviews → approves/denies → items given to player
- Repayment: Player pays with manual commands or autocollect
- Completion: Debt paid → advance closes → player can request again
- Penalties: Miss deadline → grace period → overdue interest → health loss → (optional) death
Status Progression: PENDING → APPROVED → PAID (or DENIED, EXPIRED)
评论 0
登录后参与评分
还没有评论,来抢沙发吧