PlayerCredit
为你的玩家提供真实的银行体验——申请贷款、协商利率与期限、以抵押品作为担保,并由你的员工进行审批。
PlayerCredit 为你的服务器添加了一个完整的玩家主导的贷款/信用系统。玩家通过 /playercredit 打开简洁的图形界面(GUI),申请贷款,提出自己的利率、期限和理由,并可选择用物品或书面说明作为抵押品。工作人员(可通过权限或名称配置)直接从菜单中审查、调整并批准或拒绝请求——无需记忆任何命令。
/playercredit 主菜单 GUI 截图,显示了“Request a Loan”、“My Loans”、“Loan Policy”、“Pending Requests”和“Seized Collateral”按钮。
✨ 功能特性
/playercredit 主菜单 — 一条命令,一个 GUI,玩家所需的一切:申请贷款、查看/管理现有贷款、阅读服务器的贷款政策。工作人员还会看到“待处理请求”和“被扣押抵押品”。
- 玩家提议利率 — 配置文件定义了默认利率,但玩家可以在可配置的最小/最大范围内提出自己的利率(或者你可以完全禁用此功能)。
- 玩家选择贷款期限 — 玩家可以选择贷款运行多少天(在可配置的最小/最大范围内),而不是仅使用固定的全服值。
- 必需的理由 — 玩家必须说明他们需要贷款的原因(完全可配置,可以设为可选)。
- 多种抵押物品 — 玩家可以在请求 GUI 中放置多个物品(最多达到可配置的限制)作为贷款的担保,而不仅仅是一个。
- 书面抵押说明 — 无法将房屋、领地或土地放入你的背包?玩家可以输入自由文本描述,代替(或与)实物物品一起作为抵押。
“Request a Loan” GUI,显示了金额、利率、期限和理由按钮
- 可配置的审批人 — 设置一个权限节点和/或允许审查请求的玩家姓名列表。
- 完整的审查工作流 — 审批人会收到聊天通知,打开带有申请人真实头像/皮肤的审查 GUI,调整金额/利率/期限(按钮或直接输入确切数值),检查提供的抵押物品和说明,然后点击一次接受或拒绝。
工作人员“Review Request” GUI,显示了申请人的玩家头像、可编辑的金额/利率/期限按钮、展示的抵押物品以及接受/拒绝按钮。
- 自动发放与还款 — 已批准的贷款会通过你的经济插件(Vault)立即发放资金。玩家可以从“My Loans”菜单按 25%/50%/100% 或自定义金额进行还款。
- 到期日与违约 — 每个已批准的贷款都会根据其选择的期限设定到期日。逾期未还的贷款会自动标记为违约;工作人员会收到通知,并可以通过
/playercredit collateral 扣押相关的抵押品。
“My Loans”概览(几个不同状态的贷款:pending, active, paid, defaulted)旁边或紧接着是单个贷款的详情屏幕,带有还款按钮。
- 管理员的游戏内政策编辑器 — 管理员可以直接从“Loan Policy”菜单打开服务器的贷款政策作为一本真正可编辑的书,像编辑 Minecraft 书籍一样编辑它,并通过一次点击将其保存回配置文件——无需重启服务器或编辑文件。
管理员手持/阅读打开的可写书籍,其中包含贷款政策文本,这是在 Loan Policy 菜单中点击“Edit Policy”之后。
- 完全可配置的政策 — 最小/最大贷款金额、利率范围、期限范围、每位玩家的最大活跃贷款数、必需字段、最大抵押物品数,以及在申请前显示给玩家的自由文本政策列表。
- 开箱即用的双语支持 — 默认为英语,只需在配置文件中更改一行即可切换为德语。所有 GUI 文本和消息都存储在可编辑的语言文件中,因此你可以翻译成任何语言。
- Vault 经济支持 — 适用于任何兼容 Vault 的经济插件(EssentialsX、CMI 等)。
- 持久化存储 — 所有贷款(包括序列化的抵押物品)都保存在
loans.yml 中,重启后依然存在。
? 要求
- Paper 或 Spigot/Bukkit 服务器,Minecraft 1.20 – 1.21.x
- Vault + 任何兼容 Vault 的经济插件(用于贷款发放和还款所必需)
?️ 命令与权限
| 命令 |
描述 |
权限 |
/playercredit |
打开主菜单 |
playercredit.use (默认: true) |
/playercredit collateral |
打开被扣押抵押品的领取菜单 |
playercredit.approve |
/playercredit reload |
重新加载配置文件和语言文件 |
playercredit.admin (默认: op) |
别名: /credit, /pc, /kredit
| 权限 |
描述 |
默认值 |
playercredit.use |
申请和管理自己的贷款 |
true |
playercredit.approve |
审查、编辑、接受、拒绝请求及领取抵押品 |
op |
playercredit.admin |
重新加载插件 & 编辑贷款政策书籍 |
op |
⚙️ 配置
所有限制和规则都在 config.yml 中:
language: en # 或使用 "de" 切换为德语
interest:
default-percent: 5.0
min-percent: 0.0
max-percent: 25.0
allow-player-custom-rate: true
loan:
min-amount: 100.0
max-amount: 100000.0
max-active-loans-per-player: 1
default-duration-days: 7
min-duration-days: 1
max-duration-days: 30
allow-player-custom-duration: true
require-reason: true
require-collateral: false
max-collateral-items: 5
approvers:
permission: "playercredit.approve"
players: [] # 除了拥有权限外,明确允许审批的玩家姓名列表
```yaml
default:
seize-collateral: true # 贷款违约时自动没收抵押物
所有面向玩家的消息和 GUI 标签均位于 lang/en.yml / lang/de.yml 中,可以自由编辑或翻译。贷款政策文本本身可以直接在 config.yml 中编辑,或者更方便地通过游戏内的书本编辑器进行修改(见上文)。
?️ 工作原理
- 玩家运行
/playercredit 并点击 申请贷款。
- 他们使用 GUI 按钮设置金额、提议的利率和贷款期限,也可以为每一项输入确切数值。
- 他们填写原因,并可选地将物品放入抵押槽位,以及/或为非库存物品编写抵押说明。
- 提交后,所有在线审批者会在聊天频道收到通知。
- 审批者打开
/playercredit,进入 待处理请求,审查详情(包括申请人的头像、抵押物品和说明),如有需要可调整金额/利率/期限,然后点击 接受 或 拒绝。
- 一旦接受,贷款金额将立即支付到玩家的余额中,并根据商定的期限设定到期日。
- 玩家从 我的贷款 中分期或一次性还款。全部还清后,任何抵押物都会自动返还。
- 如果贷款超过到期日仍未偿还,将被标记为违约,审批者会收到通知,抵押物(如果有)可通过
/playercredit collateral 进行没收。
? 支持
发现 bug 或有功能建议?请在项目页面提交 issue,或直接联系作者。
PlayerCredit
Give your players a real banking experience — request loans, negotiate interest and duration, back them with collateral, and let your staff decide.
PlayerCredit adds a full player-driven loan/credit system to your server. Players open a clean GUI with /playercredit, apply for a loan, propose their own interest rate, duration and reason, and optionally back the loan with items and/or a written note as collateral. Staff members (configurable per-permission or by name) review, adjust and approve or deny requests directly from a menu — no commands to memorize.
A screenshot of the /playercredit main menu GUI, showing the "Request a Loan", "My Loans", "Loan Policy", "Pending Requests" and "Seized Collateral" buttons.
✨ Features
/playercredit main menu — one command, one GUI, everything a player needs: request a loan, view/manage existing loans, read the server's loan policy. Staff additionally see "Pending Requests" and "Seized Collateral".
- Player-proposed interest rates — the config defines a default rate, but players can propose their own within a configurable min/max range (or you can disable this entirely).
- Player-chosen loan duration — players pick how many days the loan should run (within a configurable min/max range), not just a fixed server-wide value.
- Required reason — players must justify why they need the loan (fully configurable, can be made optional).
- Multiple collateral items — players can place several items (up to a configurable limit) into the request GUI as security for the loan, not just one.
- Written collateral notes — can't put a house, a claim, or land into your inventory? Players can type a free-text description instead of (or alongside) physical items.
The "Request a Loan" GUI with the amount, interest, duration and reason buttons visible
- Configurable approvers — set a permission node and/or an explicit list of player names who can review requests.
- Full review workflow — approvers get notified in chat, open a review GUI with the requester's real head/skin, tweak the amount/interest/duration (buttons or type an exact value), inspect the offered collateral items and note, then accept or deny with one click.
The staff "Review Request" GUI, showing the requester's player head, the editable amount/interest/duration buttons, the collateral items on display, and the Accept/Deny buttons.
- Automatic payout & repayment — accepted loans instantly pay out through your economy plugin (Vault). Players repay 25%/50%/100% or a custom amount from the "My Loans" menu.
- Due dates & defaults — every accepted loan gets a due date based on its chosen duration. Overdue loans are automatically marked as defaulted; staff are notified and can seize the attached collateral via
/playercredit collateral.
The "My Loans" overview (a few loans with different statuses: pending, active, paid, defaulted) next to or followed by a single loan's detail screen with the repay buttons.
- In-game policy editor for admins — admins can open the server's loan policy as a real, editable book directly from the "Loan Policy" menu, edit it like any Minecraft book, and save it back into the config with one click — no server restart or file editing needed.
An admin holding/reading the open writable book with the loan policy text, right after clicking "Edit Policy" in the Loan Policy menu.
- Fully configurable policy — min/max loan amount, interest bounds, duration bounds, max active loans per player, required fields, max collateral items, and a free-text policy list shown to players before they apply.
- Bilingual out of the box — English by default, switch to German with one line in the config. All GUI text and messages are stored in editable language files, so you can translate to any language.
- Vault economy support — works with any Vault-compatible economy plugin (EssentialsX, CMI, etc.).
- Persistent storage — all loans (including serialized collateral items) are saved to
loans.yml and survive restarts.
? Requirements
- Paper or Spigot/Bukkit server, Minecraft 1.20 – 1.21.x
- Vault + any Vault-compatible economy plugin (required for loan payouts and repayments)
?️ Commands & Permissions
| Command |
Description |
Permission |
/playercredit |
Opens the main menu |
playercredit.use (default: true) |
/playercredit collateral |
Opens the seized-collateral claim menu |
playercredit.approve |
/playercredit reload |
Reloads config and language files |
playercredit.admin (default: op) |
Aliases: /credit, /pc, /kredit
| Permission |
Description |
Default |
playercredit.use |
Request and manage your own loans |
true |
playercredit.approve |
Review, edit, accept, deny requests & claim collateral |
op |
playercredit.admin |
Reload the plugin & edit the loan policy book |
op |
⚙️ Configuration
All limits and rules live in config.yml:
language: en # or "de" for German
interest:
default-percent: 5.0
min-percent: 0.0
max-percent: 25.0
allow-player-custom-rate: true
loan:
min-amount: 100.0
max-amount: 100000.0
max-active-loans-per-player: 1
default-duration-days: 7
min-duration-days: 1
max-duration-days: 30
allow-player-custom-duration: true
require-reason: true
require-collateral: false
max-collateral-items: 5
approvers:
permission: "playercredit.approve"
players: [] # explicit player names allowed to approve, in addition to the permission
default:
seize-collateral: true # claim collateral automatically when a loan defaults
Every player-facing message and GUI label lives in lang/en.yml / lang/de.yml and can be freely edited or translated. The loan policy text itself can either be edited in config.yml directly or, more conveniently, through the in-game book editor (see above).
?️ How it works
- A player runs
/playercredit and clicks Request a Loan.
- They set the amount, their proposed interest rate and the loan duration using the GUI buttons, or type an exact value for each.
- They write a reason and, optionally, place items in the collateral slots and/or write a collateral note for anything that doesn't fit in an inventory.
- On submit, all online approvers are notified in chat.
- An approver opens
/playercredit, goes to Pending Requests, reviews the details (including the requester's head, the collateral items and note), tweaks amount/interest/duration if needed, and clicks Accept or Deny.
- On acceptance, the loan amount is instantly paid to the player's balance and a due date is set based on the agreed duration.
- The player repays over time (or in full) from My Loans. Once fully repaid, any collateral is automatically returned.
- If a loan passes its due date unpaid, it's marked as defaulted, approvers are notified, and the collateral (if any) becomes claimable via
/playercredit collateral.
? Support
Found a bug or have a feature request? Open an issue on the project's page or reach out to the author directly.
评论 0
登录后参与评分
还没有评论,来抢沙发吧