Advance

插件

· 作者 modpotato

添加了一个图形界面,建造者可以提前获取方块用于建造,但需要支付利息。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.5 · 1.21.11 · Folia / Paper

一键开服(送7天)

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          # 记录交易金额

工作原理

  1. 请求:玩家选择物品、数量和期限 → 计算总欠款(本金 + 利息)
  2. 审批:管理员审核 → 批准/拒绝 → 向玩家发放物品
  3. 还款:玩家通过手动指令或自动收取功能进行还款
  4. 完成:债务还清 → 进度关闭 → 玩家可以再次发起请求
  5. 惩罚:错过截止日期 → 宽限期 → 逾期利息 → 生命值损失 → (可选)死亡

状态流程:PENDING → APPROVED → PAID(或 DENIED、EXPIRED)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源