中文
? ChaosPayCore
支付、余额与经济系统管理 —— 为你服务器上已有的经济插件提供的前台界面。
ChaosPayCore 是服务器的支付层:玩家用它互相转账,工作人员用它进行必要的修正。它不替代任何现有功能,而是位于你已运行的经济插件之前,使其余额变得可用、安全且易于阅读。
它没有自己的余额。 它通过 Vault 与你的经济系统交互。这是有意为之的设计,而非功能缺失。
- ? Minecraft 1.21.x
- ?️ 服务器软件:Folia · Spigot · Paper · Purpur
- ☕ Java 21
- ? 必需依赖:Vault 及任意 Vault 经济插件
- ? 可选依赖:PlaceholderAPI
- ? Folia 原生支持 —— 代码中没有任何 Bukkit 调度器调用
? 玩家获得的功能
? /pay (玩家) (金额)
这是大家真正需要的命令。金额的输入方式符合日常口语习惯:5000、10,000、1.5k 和 1,5k 都表示相同的数值;而 2.5m、1b 和 3t 只需按键一次,无需使用计算器。具体支持哪些后缀由你决定——字母作为键值,其对应的乘数由你配置。
? 两人之间不能同时重复发起转账。第二次尝试将被拒绝,而不是排队等待。
⚙️ 三个独立的开关选项
每位玩家都可以自行决定,每个选择都会被保存并在重启后保留:
- /payments — 完全阻止或允许接收转账。当被阻止时,其他人无法向其转账,并会收到相应提示。
- /payalerts — 静音或恢复到账时的聊天消息。资金依然会到账,只是消息显示与否的区别。
- /payconfirm — 为希望确认的玩家在每次转账前增加确认界面。
? 一个玩家的选择不会影响其他任何人。如果某个玩家曾因误操作损失了大量货币(例如手滑输入了 5m),管理员可以将 /payconfirm 默认关闭,仅让该特定玩家选择开启。
?️ 可自定义的确认界面
/payconfirm 会在资金转移前打开一个小菜单。默认提供三行布局——左侧取消,中间显示收款人头像,右侧确认——布局设计确保误点击会落在中间的头像上(无任何作用),而不是旁边的按钮。
? 它是一个普通的配置文件,而非代码:
- ? 每行布局为九个字符。每个字符代表一个物品的符号。只有动作才起作用——带有 confirm 动作的物品会将资金发送到你放置的位置。单行两按钮的菜单可行,将确认按钮移到最左侧也可行。无需更改其他内容。
- ? 头像显示收款人的真实皮肤。查找过程在本地完成,不会向 Mojang 发送请求。
- ? 名称、描述和标题支持颜色代码(包括十六进制)以及 PlaceholderAPI —— 因此排名前缀或经济系统的占位符可以在任意行中使用。
- ⏱️ 在极短时间内(窗口尚未完全显示时)进行的点击会被忽略,以防止误确认。在高延迟服务器上可适当调高此延迟。
?️ 该菜单中可用的占位符:%player%、%amount%、%balance% 和 %balance_after%。
? /balance
查看你自己的余额。配合玩家名称使用时,可查看指定玩家的余额,这需要单独的权限。
? 动作栏提示
任何消息都可以在动作栏(热键栏上方的一行)中显示副本,并与聊天消息同时发送,使用相同的占位符。开箱即用状态下仅有一项启用:金钱到账提示最容易在繁忙的聊天中被遗漏。在纯 CraftBukkit 环境下由于不支持动作栏,该提示将回退到聊天框显示。
?️ 工作人员获得的功能
? /eco
四个动词——give(给予)、take(扣除)、set(设置)和 clear(清除)——目标可以是玩家或 all(所有玩家):
- /eco give 1000 Notch
- /eco set 0 all
- /eco clear Notch
take 永远不会使余额低于零,受影响玩家会收到关于其资金变动的通知。
⚠️ all 和 clear all 默认关闭。all 会遍历索引所知的所有账户——在大型服务器上涉及数千个账户和数千次对经济插件的写入操作;clear all 会将所有余额清零且不可撤销。这两个功能存在,但不应成为意外触发的操作。仅在运行赛季重置时开启,完成后立即关闭。
? /pay reload
重新读取设置、所有消息文本和菜单配置,无需重启服务器。首先关闭已打开的确认菜单,因为基于不再存在的配置绘制的菜单比没有菜单更糟糕。
?️ 关键控制选项
- pay.enabled — 总开关。关闭时,/pay 命令拒绝执行,其他功能保持正常。适用于迁移经济系统期间不希望发生资金流动的情况。
- pay.minimum — 允许的最小转账金额。
- pay.maximum — 单笔交易允许的最大转账金额。0.0 表示无上限。
- pay.whole-amounts-only — 将 12.5 向下取整为 12。大多数经济系统本身只显示整数。
- pay.allow-self — 是否允许玩家给自己转账。虽无危险但显得多余,且会产生两条看起来像复制漏洞的聊天消息。
- pay.allow-offline — 是否允许向离线玩家转账。
- pay.cooldown-seconds — 每位玩家两次转账之间的最小间隔秒数。
- confirm.default-on — 从未使用过 /payconfirm 的玩家将获得的状态。
- confirm.click-delay-millis — 上述防误触延迟窗口时间。
- permissions.pay, permissions.balance, permissions.balance-others, permissions.toggle 和 permissions.admin — 全部五个权限名称均可重命名。留空表示无需权限。
? PlaceholderAPI
可选。即使没有 PlaceholderAPI 一切也能正常工作,只是缺少以下占位符:
- %chaospaycore_balance% — 玩家的余额,已格式化,例如 1.2K 或 3.4M
- %chaospaycore_balance_raw% — 相同的余额,未格式化
- %chaospaycore_minimum% — 配置的最小支付金额
- %chaospaycore_maximum% — 配置的最大支付金额,若无限额则显示为短横线
- %chaospaycore_accepting% — 玩家是否接受 incoming payments(接收付款)
- %chaospaycore_alerts% — 玩家是否希望收到付款提醒
- %chaospaycore_confirming% — 玩家是否希望在发送前看到确认界面
- %chaospaycore_economy% — 是否找到了 Vault 经济系统
- %chaospaycore_known_players% — 名称索引中记录的玩家数量
? 菜单文件有第二个独立的桥接机制:在 config.yml 中将 menus.placeholderapi 设置为 true,在此插件自身的占位符填充完毕后,所有菜单标题、物品名称和描述行都会传递给 PlaceholderAPI。这使得其他插件的值可以在本插件的菜单中生效。对于不包含百分号(%)的行不会产生额外开销;如果 PlaceholderAPI 出现异常行为,可以永久关闭此功能。
? 命令与权限
- /pay (player) (amount) — 发送金钱 —
chaospaycore.pay — 默认:所有人
- /pay reload — 重新加载配置、消息和菜单 —
chaospaycore.admin — 默认:管理员 (op)
- /balance — 查看你的余额 —
chaospaycore.balance — 默认:所有人
- /balance (player) — 查看其他人的余额 —
chaospaycore.balance.others — 默认:管理员 (op)
- /eco give take set clear (player or all) (amount) — 修改余额 —
chaospaycore.admin — 默认:管理员 (op)
- /payments — 允许或阻止接收付款 —
chaospaycore.toggle — 默认:所有人
- /payalerts — 显示或隐藏接收付款提示行 —
chaospaycore.toggle — 默认:所有人
- /payconfirm — 发送金钱前询问确认 —
chaospaycore.toggle — 默认:所有人
? 别名:/bal 和 /money 对应 /balance。
⌨️ Tab 补全功能支持 /pay、/balance 和 /eco 中的在线玩家,/eco 的四个动词,以及管理员可用的 reload。
? 存储
余额数据从不存储在此插件中,它们属于你的经济插件。本插件仅存储每个玩家的三个开关设置,以及使向离线玩家付款成为可能的“名称到 UUID”索引。
- yaml — 默认选项。一个可读的文件,你可以手动修复它。
- sqlite — 当你拥有数千名玩家时使用。单个数据库文件。
- mysql — 多个服务器共享相同的开关设置时使用。
? 以上任何一种都不需要额外安装,SQLite 和 MySQL 驱动程序随 Bukkit、Spigot、Paper 和 Folia 一同提供。如果无法访问数据库,插件会回退到 YAML 格式,并在控制台中提示,而不是将所有数据重置。
? 开关状态在更改时立即写入。定时器(默认为五分钟)是安全网,而非主要路径。
? 设计原理
? 没有第二钱包。 如果一个拥有独立余额的插件会导致玩家根据输入的命令不同而看到不同的金额,并且服务器上每个商店读取的数字都与 /balance 命令显示的不一致。这不是可以通过配置解决的 bug。本插件没有任何余额,也永远不会拥有。
?️ 无需通过 Mojang 往返解析即可获取离线玩家名称。 插件维护自己的名称到 UUID 的索引,随着玩家加入服务器而构建。让服务器解析未知名称可能会触发对 Mojang 的查询,而拼写错误的名称随后会导致整个服务器因 HTTP 超时而冻结。这种权衡是诚实且明确写在配置中的:离线玩家只有在安装此插件后至少登录过一次,才能被正确命名。
? 资金绝不会无声无息地丢失。 流程始终是“先扣款,再存款”,任何失败都会被显式处理。如果扣款已完成但存款被拒绝,发送者将全额收回款项并收到通知,控制台会指明是哪个经济插件拒绝了交易。如果退款也被拒绝,控制台会输出一行日志说明资金卡住,并附带双方的 UUID、名称和金额,以便操作员能够手动纠正。如果经济插件抛出异常,支付将被放弃,异常会在完整上下文中记录,发送者会收到通知,而不是让他们盲目猜测。
⌨️ 误触按键不会清空钱包。 每笔支付都有最大金额限制,因为金额是以文本形式输入的,一次误触可能将 5k 变成 5m 且无法挽回。默认情况下不设上限,因为在互信的服务器上是否设置上限由你决定。开关就在这里。
? 无需授权密钥,无需电话回家,无需网络调用。 配置重载、菜单渲染、名称查找和皮肤查找均为本地操作。无需激活任何东西,没有后台通信,也不会因为网络问题而崩溃。
? 从一开始就为 Folia 编写,而非事后修补。 所有计划任务,即保存定时器、延迟通知接收者以及菜单重绘,都通过一个小型调度器门面进行,该门面会根据运行时情况选择全局、异步、区域或实体调度器。代码中没有遗留任何未经保护的 Bukkit 调度器调用,因此插件可以在其 plugin.yml 中诚实地声明支持 Folia。
? 新选项的到来不会丢失你的配置。 当新版本添加新的配置键时,下次启动时你的配置文件只会补充这个新键。包含 YAML 错误的文件会被完全保留原样并报告,绝不会用默认值覆盖。
? 语言
?? 英语和 ?? 德语,两者均完整且持续维护。语言设置在 config.yml 中,所有包含文本的内容都位于 lang/EN 或 lang/DE 文件夹中,包括确认界面。因此,你可以为部分玩家提供英文菜单,而为其他玩家提供德文菜单。
⏳ 请在配置任何内容之前设置语言。稍后切换语言会从零开始创建另一个文件夹,且你的设置不会迁移过来,因为静默地移动服务器的配置并非任何人所愿。
? 每条消息都是单个文件中的一行。空字符串会完全关闭该消息,这是在不编辑其他内容的情况下静音某一行的预期方式。颜色代码(包括十六进制颜色)在所有地方都有效。
✅ 要求
- ☕ Java 21
- ? Minecraft 1.21.x (Folia, Spigot, Paper 或 Purpur)
- ? Vault 以及任何 Vault 经济插件,例如 EssentialsX Economy、CMI 或 BetaEconomy
- ? PlaceholderAPI — 可选,仅用于菜单内的占位符和第三方数值
ℹ️ Vault 是有意为之的软依赖。如果服务器忘记安装它,插件仍然会出现,并在控制台输出一行解释为什么 /pay 和 /balance 被拒绝的原因,而不是让插件在列表中静默消失。
⚔️ 如果你的经济插件也有 /pay 命令
两者中只有一个会生效,另一个必须输入为 /chaospaycore:pay。决定你想要哪组命令,并在那个插件中禁用另一组。
? 截图
添加你自己的:确认屏幕、/pay 的使用效果、/eco 的输出。
? 更新日志
1.0.0
- ? ChaosPayCore 首次发布
- 命令 /pay, /balance, /eco, /payments, /payalerts, /payconfirm 和 /pay reload
- ?️ 可配置的带有玩家头颅的确认屏幕
- ? PlaceholderAPI 扩展以及用于菜单文本的 PlaceholderAPI 桥接
- ? YAML、SQLite 和 MySQL 存储
- ? 原生 Folia 调度
GERMAN
? ChaosPayCore
支付、余额和经济管理 —— 服务于你服务器上现有经济的接待处。
ChaosPayCore 是你服务器的支付层:玩家用它互相转账,你的团队用它修复错误。它不替代任何东西。它叠加在你已有的经济系统之上,使其变得可用、安全且易读。
它没有自己的余额。 它通过 Vault 访问你的经济系统。这是有意识的决定,而非功能缺失。
- ? Minecraft 1.21.x
- ?️ 服务器软件:Folia · Spigot · Paper · Purpur
- ☕ Java 21
- ? 必需:Vault 和一个 Vault 经济插件
- ? 可选:PlaceholderAPI
- ? 原生 Folia 支持 —— 代码中没有任何 Bukkit 调度器调用
? 玩家获得的功能
? /pay (玩家) (金额)
这就是它的核心命令。金额按口语习惯输入:5000, 10.000, 1.5k 和 1,5k 意思相同,而 2.5m, 1b 和 3t 只需一次按键而非计算器。后缀有哪些由你决定 —— 字母是关键,数值是因子。
? 两个人永远不会同时向对方转账两次。第二次尝试会被拒绝,而不是排队等待。
⚙️ 三个开关,各自独立
每个玩家自行决定,并且每个决定都会被保存并经受住重启考验:
- /payments — 完全开启或关闭接收付款。如果关闭,任何人都无法给某人付款,接收者会收到提示。
- /payalerts — 静音或恢复金钱到账时的聊天行。钱仍然会到账,只是消息变了。
- /payconfirm — 在每次付款前显示一个确认屏幕,供想要此功能的玩家使用。
? 没有人会受到其他玩家选择的影响。如果一个服务器上曾经因为 5m 的拼写错误造成了损害,可以默认关闭 /payconfirm,只让特定那个人进行确认。
?️ 一个你可以重新设计的确认屏幕
/payconfirm 会在资金移动之前打开一个小菜单。默认提供三行布局 —— 左侧取消,中间收款人头像,右侧确认 —— 这样安排使得误触点击落在头像上而不会触发任何操作,而不是点击到其他按钮。
? 它是一个普通的配置文件,不是代码:
- ? 布局每行九个字符。每个字符代表一个物品符号。只有动作有意义 —— 具有 confirm 动作的物品会将资金发送到任何位置。单行菜单有两个按钮也是可行的,将确认移到最左边也没问题。否则无需更改任何东西。
- ? 头像显示收款人的真实皮肤。查找是本地进行的,不会向 Mojang 发送请求。
- ? 名称、描述和标题理解颜色代码(包括十六进制颜色)以及 PlaceholderAPI —— 因此排名系统的前缀或经济系统的占位符可以在每一行正常工作。
- ⏱️ 在第一秒内到达的点击将被忽略,以防止有人确认窗口甚至来不及显示的内容。高延迟用户可适当提高此阈值。
?️ 此菜单中的占位符:%player%, %amount%, %balance% 和 %balance_after%。
? /balance
查看你自己的余额。使用 /balance 加上玩家名字可以获取该玩家的余额 —— 这需要单独的权限。
? Action Bars (动作栏)
每条消息都可以在 Action Bar(热键栏上方的条形区域)中获得一行双倍的显示,除了聊天行之外,使用相同的占位符发送。默认只填充了一条:在混乱的聊天中,到帐的资金最容易被人忽视。在纯 CraftBukkit 上没有 Action Bar,该行会移动到聊天中。
?️ 管理团队获得的功能
? /eco
四个动词 —— give, take, set 和 clear —— 目标要么是玩家,要么是单词 all:
- /eco give 1000 Notch
- /eco set 0 all
- /eco clear Notch
take 永远不会使余额低于零,受影响玩家会被告知他们的钱发生了什么。
⚠️ all 和 clear all 默认处于关闭状态。all 会触及索引知道的所有账户 —— 在大型服务器上,这意味着成千上万的账户和对你经济插件的成千上万次写入操作 —— 而 clear all 将所有余额重置为零,且不可逆。提供这两个选项是为了防止意外发生。如果你要重置赛季,请开启它们,之后记得再次关闭。
? /pay reload
设置、每条消息和菜单在无需重启的情况下重新加载。如果存在来自已不存在配置文件的菜单,其危害大于没有菜单,因此会优先关闭所有打开的确认菜单。
?️ 关键调节项
- pay.enabled — 主开关。关闭时拒绝 /pay 命令,其他功能正常运行。这在迁移经济系统且不希望资金流动时非常实用。
- pay.minimum — 允许的最小支付金额。
- pay.maximum — 单次操作允许的最大支付金额。0.0 表示无上限。
- pay.whole-amounts-only — 将 12.5 向下舍入为 12。大多数经济系统本身也只显示整数。
- pay.allow-self — 是否允许玩家给自己付款。这毫无意义且充满风险,但会产生两行看起来像重复 Bug 的聊天信息。
- pay.allow-offline — 是否允许向离线玩家转账。
- pay.cooldown-seconds — 每个玩家两次支付之间的最小间隔时间(秒)。
- confirm.default-on — 从未使用过 /payconfirm 的玩家将获得的状态。
- confirm.click-delay-millis — 防止误触的时间窗口上限(毫秒)。
- permissions.pay, permissions.balance, permissions.balance-others, permissions.toggle 和 permissions.admin — 所有五个权限名称均可自定义。留空表示不需要任何权限。
? PlaceholderAPI
可选。没有 PlaceholderAPI 也能正常工作,只是缺少以下占位符:
- %chaospaycore_balance% — 玩家余额,格式化后显示,例如 1.2K 或 3.4M
- %chaospaycore_balance_raw% — 同上,但未格式化
- %chaospaycore_minimum% — 设定的最小支付金额
- %chaospaycore_maximum% — 设定的最大支付金额,若无上限则显示为短横线
- %chaospaycore_accepting% — 玩家是否接收 incoming payments(传入的支付)
- %chaospaycore_alerts% — 玩家是否希望收到支付通知
- %chaospaycore_confirming% — 玩家是否希望看到确认屏幕
- %chaospaycore_economy% — 是否找到了 Vault 经济系统
- %chaospaycore_known_players% — 名称索引中已知的玩家数量
? 为你的菜单文件提供了第二座独立的桥梁:在 config.yml 中将 menus.placeholderapi 设置为 true,那么在应用本插件自身的占位符后,每个菜单标题、物品名称和 Lore 行都会传递给 PlaceholderAPI。正是这一点使得本插件菜单中的第三方数值能够正常工作。在没有百分号符号的行上它不消耗性能,并且可以永久关闭,以防 PlaceholderAPI 出现故障。
? 命令与权限
- /pay (玩家) (金额) — 发送金钱 — chaospaycore.pay — 默认:所有人
- /pay reload — 重新加载配置、消息和菜单 — chaospaycore.admin — 默认:OP(管理员)
- /balance — 查看你的余额 — chaospaycore.balance — 默认:所有人
- /balance (玩家) — 查看他人的余额 — chaospaycore.balance.others — 默认:OP(管理员)
- /eco give take set clear (玩家或 all) (金额) — 修改余额 — chaospaycore.admin — 默认:OP(管理员)
- /payments — 开启或关闭传入支付通知 — chaospaycore.toggle — 默认:所有人
- /payalerts — 开启或关闭收款时的单行提示 — chaospaycore.toggle — 默认:所有人
- /payconfirm — 发送前进行询问 — chaospaycore.toggle — 默认:所有人
? 别名:/bal 和 /money 对应 /balance。
⌨️ Tab 补全支持对 /pay、/balance 和 /eco 的在线玩家进行补全,以及对 /eco 的四个动词和管理员的 reload 进行补全。
? 存储
余额永远不会在此处保存,它们属于你的经济插件。本插件存储的是每个玩家的三个开关以及名称到 UUID 的索引,后者是向离线玩家转账的前提条件。
- yaml — 默认。一个可读的文件,你可以手动修复。
- sqlite — 适用于数千名玩家。数据库文件。
- mysql — 多个服务器共享相同的开关数据。
? 以上任何一种都不需要额外安装任何东西,Bukkit、Spigot、Paper 和 Folia 都自带 SQLite 和 MySQL 驱动程序。如果无法访问数据库,插件会回退到 YAML 格式并在控制台中提示,而不是带着空数据启动。
? 开关会在更改时立即写入。定时器(默认为五分钟)是安全网,而非主要方式。
? 设计原理
? 没有第二个钱包。 如果一个拥有自己余额的插件意味着玩家根据输入的命令会有两个不同的余额,且服务器上的每个商店读取的数字都不是 /balance 显示的那个数字,那将是无法通过配置消除的错误。本插件没有余额,也不会添加余额。
?️ 无需 Mojang 往返查询的离线名称。 插件维护自己的名称到 UUID 索引,在玩家加入时增长。如果改为让服务器解析未知名称,可能会触发对 Mojang 的请求,而名称中的拼写错误会导致整个服务器在 HTTP 超时期间冻结。这个代价是诚实且记录在配置文件中的:只有自安装本插件以来至少加入过一次游戏的离线玩家才能被命名。
? 资金绝不会无声消失。 顺序始终是借记先于贷记,且每个错误都会明确处理。如果在借记之后贷记被拒绝,发送者将收回全额资金并收到通知,控制台也会指出是哪个经济插件拒绝了请求。如果退款也被拒绝,控制台将输出一行警告,表明资金卡住,并提供双方的 UUID、名称和金额,以便操作员手动解决。如果经济插件抛出异常,支付将被取消,异常及其完整上下文将被记录,并通知发送者,而不是让人猜测。
⌨️ Ein verschobener Buchstabe kann eine Geldbörse nicht leeren. Das Maximum pro Zahlung existiert, weil der Betrag als Text eingegeben wird und ein verschobener Buchstabe aus 5k schnell 5m machen kann, was sich nicht mehr rückgängig machen lässt. Standardmäßig gibt es keine Obergrenze, da eine Grenze auf einem vertrauenswürdigen Server deine Entscheidung ist. Der Schalter ist jedoch vorhanden.
? Kein Lizenzschlüssel, kein Phone-Home, kein Netzwerkverkehr. Config-Reload, Menü-Rendering, Namens- und Skin-Lookup laufen alle lokal. Es gibt nichts zu aktivieren, nichts, das nach Hause telefoniert, und nichts, was an einem Netzwerk kaputtgeht.
? Für Folia geschrieben, nicht dafür gepatcht. Jeder geplante Task, also der Speicher-Timer, die verzögerte Mitteilung an einen Empfänger und das Neuzeichnen eines Menüs, läuft über eine kleine Scheduler-Fassade, die zur Laufzeit zwischen globalem, asynchronem, Regions- und Entity-Scheduler wählt. Es gibt keinen ungeschützten Scheduler-Aufruf von Bukkit mehr im Code, und deshalb darf das Plugin ehrlich die Folia-Unterstützung in seine plugin.yml schreiben.
? Neue Optionen kommen, ohne deine zu verlieren. Wenn eine neue Version einen Config-Schlüssel ergänzt, wird deine Datei beim nächsten Start genau um diesen Schlüssel ergänzt. Eine Datei mit YAML-Fehler wird vollständig unangetastet gelassen und gemeldet, niemals mit Standardwerten überschrieben.
? Sprachen
?? Englisch und ?? Deutsch, beide vollständig, beide gepflegt. Die Sprache steht in der config.yml, und alles, was Text enthält, liegt in lang/EN oder lang/DE, auch der Bestätigungsbildschirm. Du kannst also einem Teil der Spieler ein englisches und einem anderen ein deutsches Menü geben.
⏳ Stelle die Sprache um, bevor du etwas einrichtest. Ein späterer Wechsel legt den anderen Ordner neu an, und deine Einstellungen wandern nicht mit, weil es niemandem hilft, die Konfiguration eines Servers hinterrum umzuziehen.
? Jede Nachricht ist eine einzelne Zeile in einer Datei. Eine leere Zeichenkette schaltet diese Nachricht komplett aus, das ist der vorgesehene Weg, eine Zeile zu schweigen, ohne sonst etwas anzufassen. Farbcodes, Hex eingeschlossen, funktionieren überall.
✅ Voraussetzungen
- ☕ Java 21
- ? Minecraft 1.21.x auf Folia, Spigot, Paper oder Purpur
- ? Vault und ein Vault-Economy-Plugin, etwa EssentialsX Economy, CMI oder BetaEconomy
- ? PlaceholderAPI — optional, nur für Platzhalter und Fremdwerte in Menüs
ℹ️ Vault ist absichtlich ein Softdepend. Ein Server, der ihn vergessen hat, bekommt das Plugin trotzdem plus eine Konsolenzeile, die erklärt, warum /pay und /balance ablehnen, statt eines Plugins, das einfach nie in der Liste auftaucht.
⚔️ Wenn dein Economy-Plugin auch /pay hat
Eines der beiden gewinnt, das andere muss als /chaospaycore:pay getippt werden. Entscheide dich, welche Befehle du willst, und schalte die anderen in dem Plugin ab.
? Screenshots
Eigene einfügen: der Bestätigungsbildschirm, /pay in Aktion, die /eco-Ausgabe.
? Änderungen
1.0.0
- ? Erstes Release von ChaosPayCore
- Die Befehle /pay, /balance, /eco, /payments, /payalerts, /payconfirm und /pay reload
- ?️ Konfigurierbarer Bestätigungsbildschirm mit Spielerköpfen
- ? PlaceholderAPI-Expansion und eine PlaceholderAPI-Brücke für Menütexte
- ? Speicher für YAML, SQLite und MySQL
- ? Native Folia-Planung
ENGLISH
? ChaosPayCore
Paying, balances and economy administration — the front desk for whatever economy already runs on your server.
ChaosPayCore is the payment layer for your server: the thing players use to hand money to each other, and the thing your staff uses when something has to be corrected. It replaces nothing. It sits in front of the economy plugin you already run and makes that one balance usable, safe and readable.
It has no balance of its own. It reaches your economy through Vault. That is a deliberate decision, not a missing feature.
- ? Minecraft 1.21.x
- ?️ Server software: Folia · Spigot · Paper · Purpur
- ☕ Java 21
- ? Required: Vault and any Vault economy plugin
- ? Optional: PlaceholderAPI
- ? Folia-native — no Bukkit scheduler call anywhere in the code
? What players get
? /pay (player) (amount)
The command everyone actually came for. Amounts are typed the way people talk: 5000, 10,000, 1.5k and 1,5k all mean the same thing, and 2.5m, 1b and 3t are one keystroke instead of a calculator. Which suffixes exist is yours to decide — the letter is the key, the value is what it multiplies by.
? Two people can never pay each other twice at once. The second attempt is refused rather than queued.
⚙️ Three switches, each one their own
Every player decides for themselves, and each choice is stored and survives a restart:
- /payments — blocks or allows incoming payments entirely. While blocked, nobody can pay them and they are told so.
- /payalerts — silences or restores the chat line when money arrives. The money arrives either way, only the message changes.
- /payconfirm — puts a confirmation screen in front of every payment, for the players who want one.
? Nothing about one player's choice touches anybody else's. A server where one person was burned by a fat-fingered 5m can leave /payconfirm off by default and let that one person opt in.
?️ A confirmation screen you can redesign
/payconfirm opens a small menu before the money moves. It ships with a three-row layout — cancel on the left, the receiver's head in the middle, confirm on the right — laid out so that a misaimed click lands on the head, which does nothing at all, rather than on the other button.
? It is a normal config file, not code:
- ? The layout is nine characters per row. Each character is an item's symbol. Only the actions matter — an item with the action confirm sends the money wherever you put it. A one-row menu with two buttons works, and moving confirm to the far left works too. Nothing else has to change.
- ? The head shows the receiver's real skin. The lookup is local, no request goes to Mojang.
- ? Names, lore and the title take colour codes, hex included, and PlaceholderAPI — so a rank prefix or your economy's own placeholders work in any line.
- ⏱️ Clicks that land within the first fraction of a second are ignored, so nobody confirms something the window was not even able to show yet. Raise it on a high-ping server.
?️ Placeholders available in that menu: %player%, %amount%, %balance% and %balance_after%.
? /balance
Your own balance. With /balance and a player's name you get that player's balance, and it needs its own permission.
? Action bars
Any message can have a twin in the action bar, the line above the hotbar, sent alongside the chat line with the same placeholders. Out of the box only one is filled: money arriving is the easiest line to miss in a busy chat. On plain CraftBukkit there is no action bar, so the line falls back to chat.
?️ What staff get
? /eco
Four verbs — give, take, set and clear — and as the target either a player or the word all:
- /eco give 1000 Notch
- /eco set 0 all
- /eco clear Notch
take never pushes a balance below zero, and the player affected is told what happened to their money.
⚠️ all and clear all are switched off by default. all reaches every account the index knows — on a large server that is thousands of accounts and thousands of writes into your economy plugin — and clear all sets every balance to zero with no undo. Both exist, but neither should be a thing you can do by accident. Turn them on when you are running a season reset, and turn them back off afterwards.
? /pay reload
Settings, every message and the menu are re-read without a restart. Open confirmation menus are closed first, because a menu drawn from a config that no longer exists is worse than no menu.
?️ Controls that actually matter
- pay.enabled — master switch. While off, /pay refuses and everything else keeps working. Useful while you migrate an economy and do not want money moving.
- pay.minimum — the smallest payment allowed.
- pay.maximum — the largest payment allowed per transaction. 0.0 means no cap.
- pay.whole-amounts-only — rounds 12.5 down to 12. Most economies show whole numbers anyway.
- pay.allow-self — whether a player may pay themselves. Pointless rather than dangerous, but it produces two chat lines that look like a duplication bug.
- pay.allow-offline — whether money may go to somebody who is not online.
- pay.cooldown-seconds — minimum delay between two payments per player.
- confirm.default-on — what a player who never touched /payconfirm gets.
- confirm.click-delay-millis — the anti-misfire window described above.
- permissions.pay, permissions.balance, permissions.balance-others, permissions.toggle and permissions.admin — all five permission names are renameable. An empty name means no permission required.
? PlaceholderAPI
Optional. Without PlaceholderAPI everything works, only these placeholders are missing:
- %chaospaycore_balance% — the player's balance, formatted, such as 1.2K or 3.4M
- %chaospaycore_balance_raw% — the same balance, unformatted
- %chaospaycore_minimum% — the configured smallest payment
- %chaospaycore_maximum% — the configured largest payment, or a dash when uncapped
- %chaospaycore_accepting% — whether the player accepts incoming payments
- %chaospaycore_alerts% — whether the player wants payment alerts
- %chaospaycore_confirming% — whether the player wants a confirmation screen
- %chaospaycore_economy% — whether a Vault economy was found
- %chaospaycore_known_players% — how many players the name index knows
? There is a second, separate bridge for your menu files: set menus.placeholderapi to true in config.yml and every menu title, item name and lore line is handed to PlaceholderAPI after this plugin's own placeholders are filled in. That is what makes another plugin's values work inside this plugin's menus. It costs nothing on lines that contain no percent sign, and it can be switched off permanently if PlaceholderAPI ever misbehaves.
? Commands and permissions
- /pay (player) (amount) — send money — chaospaycore.pay — default: everyone
- /pay reload — reload config, messages and menu — chaospaycore.admin — default: op
- /balance — your balance — chaospaycore.balance — default: everyone
- /balance (player) — somebody else's balance — chaospaycore.balance.others — default: op
- /eco give take set clear (player or all) (amount) — change balances — chaospaycore.admin — default: op
- /payments — allow or block incoming payments — chaospaycore.toggle — default: everyone
- /payalerts — show or hide the incoming-payment line — chaospaycore.toggle — default: everyone
- /payconfirm — ask before sending money — chaospaycore.toggle — default: everyone
? Aliases: /bal and /money for /balance.
⌨️ Tab completion knows the online players for /pay, /balance and /eco, the four verbs for /eco, and reload for admins.
? Storage
The balances are never written here, they belong to your economy plugin. What this plugin stores is the three per-player switches and the name-to-UUID index that makes paying offline players possible.
- yaml — default. One readable file you can fix by hand.
- sqlite — once you have thousands of players. One database file.
- mysql — several servers sharing the same switches.
? Nothing has to be installed for any of them, the SQLite and MySQL drivers ship with Bukkit, Spigot, Paper and Folia. If the database cannot be reached, the plugin falls back to YAML and says so in the console rather than starting with everything reset.
? The switches are written the moment they change. A timer, five minutes by default, is the safety net and not the main path.
? Why it works this way
? No second wallet. A plugin with a balance of its own would mean a player has two different amounts depending on which command they typed, and every shop on the server reading a number that is not the one in /balance. That is not a bug you can config your way out of. This plugin has no balances and never will.
?️ Offline names without a Mojang round-trip. The plugin keeps its own name-to-UUID index, built as players join. Letting the server resolve an unknown name instead can trigger a lookup at Mojang, and a mistyped name would then freeze the whole server for the length of an HTTP timeout. The trade-off is honest and stated in the config: an offline player can only be named if they have joined at least once since this plugin was installed.
? Money is never lost quietly. The sequence is always withdraw, then deposit, and every failure is handled explicitly. If the deposit is refused after the withdrawal went through, the sender gets the full amount back and is told, and the console names the economy plugin that said no. If the refund is refused as well, the console gets a line saying the money is stuck, along with both UUIDs, both names and both amounts, because an operator has to be able to put that right by hand. And if the economy plugin throws an exception, the payment is abandoned, the exception is logged with full context, and the sender is told rather than left guessing.
⌨️ A stray key cannot empty a wallet. The maximum amount per payment exists because the amount is typed as text, and a slipped key turns 5k into 5m with no way back. The default is uncapped because a cap on a trusting server is your decision to make. The switch is there.
? No licence key, no phone-home, no network calls. Config reload, menu rendering, name lookup and skin lookup are all local. There is nothing to activate, nothing that phones home, and nothing that breaks when a network does.
? Written for Folia from the start, not patched for it. Every scheduled task, meaning the save timer, the delayed notice to a receiving player and the menu redraw, goes through one small scheduler facade that picks the global, async, region or entity scheduler depending on what it finds at runtime. There is no unguarded Bukkit scheduler call left in the code, which is why the plugin can honestly declare Folia support in its plugin.yml.
? New options arrive without losing yours. When a new version adds a config key, your file is topped up with just that key on the next start. A file with a YAML error is left completely untouched and reported, never overwritten with defaults.
? Languages
?? English and ?? German, both complete, both maintained. The language is set in config.yml and everything with text in it lives in lang/EN or lang/DE, including the confirmation screen. So you can have an English menu for some players and a German one for others.
⏳ Set the language before you configure anything. Switching later creates the other folder from scratch, and your settings do not move across, because silently moving a server's configuration is not a surprise anybody wants.
? Every message is a single line in one file. An empty string switches that message off completely, which is the intended way to silence one line without editing anything else. Colour codes, hex included, work everywhere.
✅ Requirements
- ☕ Java 21
- ? Minecraft 1.21.x on Folia, Spigot, Paper or Purpur
- ? Vault and any Vault economy plugin, such as EssentialsX Economy, CMI or BetaEconomy
- ? PlaceholderAPI — optional, only for placeholders and third-party values inside menus
ℹ️ Vault is a soft dependency on purpose. A server that forgot it still gets the plugin, plus a console line explaining why /pay and /balance are refusing, instead of a plugin that silently never appears in the list.
⚔️ If your economy plugin also has /pay
One of the two wins and the other has to be typed as /chaospaycore:pay. Decide which set of commands you want and switch the other off in that plugin.
? Screenshots
Add your own: the confirmation screen, /pay in action, the /eco output.
? Changelog
1.0.0
- ? First release of ChaosPayCore
- The commands /pay, /balance, /eco, /payments, /payalerts, /payconfirm and /pay reload
- ?️ Configurable confirmation screen with player heads
- ? PlaceholderAPI expansion and a PlaceholderAPI bridge for menu text
- ? YAML, SQLite and MySQL storage
- ? Native Folia scheduling
GERMAN
? ChaosPayCore
Bezahlen, Kontostände und Economy-Verwaltung — die Rezeption für die Economy, die auf deinem Server schon läuft.
ChaosPayCore ist die Zahlungsebene deines Servers: das, womit Spieler einander Geld geben, und das, womit dein Team Fehler ausbessert. Es ersetzt nichts. Es legt sich vor die Economy, die du schon betreibst, und macht diese eine Zahl benutzbar, sicher und lesbar.
Es hat keinen eigenen Kontostand. Es greift über Vault auf deine Economy zu. Das ist eine bewusste Entscheidung und keine fehlende Funktion.
- ? Minecraft 1.21.x
- ?️ Server-Software: Folia · Spigot · Paper · Purpur
- ☕ Java 21
- ? Erforderlich: Vault und ein Vault-Economy-Plugin
- ? Optional: PlaceholderAPI
- ? Folia-nativ — kein einziger Bukkit-Scheduler-Aufruf im Code
? Was Spieler bekommen
? /pay (Spieler) (Betrag)
Der Befehl, um den es eigentlich geht. Beträge werden so getippt, wie man spricht: 5000, 10.000, 1.5k und 1,5k bedeuten dasselbe, und 2.5m, 1b und 3t sind ein Tastendruck statt eines Taschenrechners. Welche Suffixe es gibt, entscheidest du — der Buchstabe ist der Schlüssel, der Wert der Faktor.
? Zwei Leute können sich nie zweimal gleichzeitig bezahlen. Ein zweiter Versuch wird abgelehnt, nicht eingereiht.
⚙️ Drei Schalter, jeder für sich
Jeder Spieler entscheidet selbst, und jede Entscheidung wird gespeichert und überlebt einen Neustart:
- /payments — eingehende Zahlungen ganz an oder aus. Solange aus, kann niemand jemanden bezahlen, und der Empfänger wird darauf hingewiesen.
- /payalerts — die Chat-Zeile beim Geldempfang stumm schalten oder wieder einschalten. Das Geld kommt trotzdem an, nur die Nachricht ändert sich.
- /payconfirm — vor jeder Zahlung einen Bestätigungsbildschirm einblenden, für die Spieler, die das wollen.
? Niemand wird von der Wahl eines anderen Spielers betroffen. Ein Server, auf dem einmal ein 5m-Tippfehler Schaden angerichtet hat, lässt /payconfirm standardmäßig aus und lässt genau diese eine Person zustimmen.
?️ Ein Bestätigungsbildschirm, den du umgestalten kannst
/payconfirm öffnet ein kleines Menü, bevor das Geld bewegt wird. Ausgeliefert wird ein dreizeiliges Layout — Abbrechen links, der Kopf des Empfängers in der Mitte, Bestätigen rechts — so angeordnet, dass ein daneben getroffener Klick auf dem Kopf landet und gar nichts passiert, statt auf dem anderen Knopf.
? Es ist eine normale Config-Datei, kein Code:
- ? Das Layout ist neun Zeichen pro Zeile. Jedes Zeichen ist das Symbol eines Items. Nur die Aktionen zählen — ein Item mit der Aktion confirm sendet das Geld, wo immer du es hinstellst. Ein einzeiliges Menü mit zwei Knöpfen funktioniert, und Bestätigen ganz nach links verschieben auch. Sonst muss nichts geändert werden.
- ? Der Kopf zeigt den echten Skin des Empfängers. Der Lookup ist lokal, es geht keine Anfrage an Mojang.
- ? Namen, Lore und Titel verstehen Farbcodes, Hex-Farben eingeschlossen, und PlaceholderAPI — damit funktionieren der Prefix eines Rangen-Systems oder die Platzhalter deiner Economy in jeder Zeile.
- ⏱️ Klicks, die in den ersten Bruchteil einer Sekunde landen, werden ignoriert, damit niemand etwas bestätigt, was das Fenster noch gar nicht anzeigen konnte. Bei hohem Ping höher stellen.
?️ Platzhalter in diesem Menü: %player%, %amount%, %balance% und %balance_after%.
? /balance
Dein eigener Kontostand. Mit /balance und dem Namen eines Spielers bekommst du dessen Kontostand — dafür ist eine eigene Permission nötig.
? Action Bars
Jede Nachricht kann eine Zwillingszeile in der Action Bar bekommen, also der Leiste über der Hotbar, die zusätzlich zur Chat-Zeile mit denselben Platzhaltern gesendet wird. Ausgeliefert ist nur eine gefüllt: Geld, das ankommt, ist in einem wilden Chat am leichtesten zu übersehen. Auf reinem CraftBukkit gibt es keine Action Bar, dort wandert die Zeile in den Chat.
?️ Was das Team bekommt
? /eco
Vier Verben — give, take, set und clear — und als Ziel entweder einen Spieler oder das Wort all:
- /eco give 1000 Notch
- /eco set 0 all
- /eco clear Notch
take bringt einen Kontostand nie unter null, und der betroffene Spieler wird informiert, was mit seinem Geld passiert ist.
⚠️ all und clear all sind standardmäßig aus. all erreicht jedes Konto, das der Index kennt — auf einem großen Server sind das Tausende Konten und Tausende Schreibvorgänge in dein Economy-Plugin —, und clear all setzt jeden Kontostand auf null, ohne Rückweg. Beides gibt es, beides sollte aber nicht versehentlich passieren können. Einschalten, wenn du eine Saison zurücksetzt, und danach wieder ausschalten.
? /pay reload
Settings, jede Nachricht und das Menü werden ohne Neustart neu eingelesen. Offene Bestätigungsmenüs werden zuerst geschlossen, weil ein Menü aus einer Config, die es nicht mehr gibt, schlimmer ist als gar kein Menü.
?️ Stellschrauben, auf die es ankommt
- pay.enabled — Hauptschalter. Solange aus, lehnt /pay ab und alles andere läuft weiter. Praktisch, wenn du eine Economy umziehst und sich kein Geld bewegen soll.
- pay.minimum — die kleinste erlaubte Zahlung.
- pay.maximum — die größte erlaubte Zahlung pro Vorgang. 0.0 heißt keine Obergrenze.
- pay.whole-amounts-only — rundet 12.5 auf 12 ab. Die meisten Economies zeigen ohnehin ganze Zahlen.
- pay.allow-self — ob ein Spieler sich selbst bezahlen darf. Sinnlos statt gefährlich, aber es erzeugt zwei Chat-Zeilen, die wie ein Duplikat-Bug aussehen.
- pay.allow-offline — ob Geld an jemanden gehen darf, der nicht online ist.
- pay.cooldown-seconds — Mindestabstand zwischen zwei Zahlungen pro Spieler.
- confirm.default-on — was ein Spieler bekommt, der /payconfirm nie benutzt hat.
- confirm.click-delay-millis — das Fenster gegen Fehlklicks von oben.
- permissions.pay, permissions.balance, permissions.balance-others, permissions.toggle und permissions.admin — alle fünf Permission-Namen sind umbenennbar. Ein leerer Name heißt: keine Permission nötig.
? PlaceholderAPI
Optional. Ohne PlaceholderAPI funktioniert alles, nur diese Platzhalter fehlen:
- %chaospaycore_balance% — Kontostand des Spielers, formatiert, etwa 1.2K oder 3.4M
- %chaospaycore_balance_raw% — derselbe Kontostand, unformatiert
- %chaospaycore_minimum% — die eingestellte kleinste Zahlung
- %chaospaycore_maximum% — die eingestellte größte Zahlung, oder ein Strich wenn unbegrenzt
- %chaospaycore_accepting% — nimmt der Spieler eingehende Zahlungen an
- %chaospaycore_alerts% — will der Spieler Zahlungsmeldungen
- %chaospaycore_confirming% — will der Spieler einen Bestätigungsbildschirm
- %chaospaycore_economy% — ob eine Vault-Economy gefunden wurde
- %chaospaycore_known_players% — wie viele Spieler der Namensindex kennt
? Es gibt eine zweite, davon getrennte Brücke für deine Menüdateien: Setze menus.placeholderapi auf true in der config.yml, dann wird jeder Menütitel, jeder Item-Name und jede Lore-Zeile an PlaceholderAPI weitergegeben, nachdem die eigenen Platzhalter dieses Plugins eingesetzt sind. Genau das sorgt dafür, dass fremde Werte in den Menüs dieses Plugins funktionieren. Es kostet nichts in Zeilen ohne Prozentzeichen und lässt sich dauerhaft abschalten, falls PlaceholderAPI einmal Mist baut.
? Befehle und Permissions
- /pay (Spieler) (Betrag) — Geld senden — chaospaycore.pay — Standard: alle
- /pay reload — Config, Nachrichten und Menü neu laden — chaospaycore.admin — Standard: OP
- /balance — dein Kontostand — chaospaycore.balance — Standard: alle
- /balance (Spieler) — Kontostand von jemand anderem — chaospaycore.balance.others — Standard: OP
- /eco give take set clear (Spieler oder all) (Betrag) — Kontostände ändern — chaospaycore.admin — Standard: OP
- /payments — eingehende Zahlungen an oder aus — chaospaycore.toggle — Standard: alle
- /payalerts — Zeile beim Geldempfang an oder aus — chaospaycore.toggle — Standard: alle
- /payconfirm — vor dem Senden nachfragen — chaospaycore.toggle — Standard: alle
? Aliase: /bal und /money für /balance.
⌨️ Tab-Completion kennt die Online-Spieler für /pay, /balance und /eco, die vier Verben für /eco und reload für Admins.
? Speicher
Die Kontostände werden hier nie gespeichert, die gehören deinem Economy-Plugin. Was dieses Plugin speichert, sind die drei Schalter pro Spieler und der Name-zu-UUID-Index, der Bezahlungen an Offline-Spieler überhaupt erst möglich macht.
- yaml — Standard. Eine lesbare Datei, die du von Hand reparieren kannst.
- sqlite — ab tausenden Spielern. Eine Datenbankdatei.
- mysql — mehrere Server teilen sich dieselben Schalter.
? Für nichts davon musst du etwas installieren, SQLite- und MySQL-Treiber liefert Bukkit, Spigot, Paper und Folia mit. Ist die Datenbank nicht erreichbar, fällt das Plugin auf YAML zurück und sagt es in der Konsole, statt mit leeren Daten zu starten.
? Die Schalter werden geschrieben, sobald sie sich ändern. Ein Timer, standardmäßig fünf Minuten, ist das Sicherheitsnetz und nicht der Hauptweg.
? Warum es so gebaut ist
? Keine zweite Geldbörse. Ein Plugin mit eigenem Kontostand hieße, dass ein Spieler je nach getipptem Befehl zwei verschiedene Beträge hat und jeder Shop auf dem Server eine Zahl liest, die nicht die aus /balance ist. Das ist kein Fehler, den man wegkonfigurieren kann. Dieses Plugin hat keine Kontostände und wird auch keine bekommen.
?️ Offline-Namen ohne Mojang-Rundlauf. Das Plugin führt einen eigenen Name-zu-UUID-Index, der beim Join wächst. Lässt du stattdessen den Server einen unbekannten Namen auflösen, kann das eine Abfrage bei Mojang auslösen, und ein Tippfehler im Namen friert dann den ganzen Server für die Dauer eines HTTP-Timeouts ein. Der Preis dafür ist ehrlich und steht in der Config: Einen Offline-Spieler kann man nur benennen, wenn er seit der Installation dieses Plugins mindestens einmal gejoined ist.
? Geld geht nie lautlos verloren. Die Reihenfolge ist immer erst abbuchen, dann einzahlen, und jeder Fehler wird ausdrücklich behandelt. Wird die Einzahlung nach der Abbuchung abgelehnt, bekommt der Absender den vollen Betrag zurück und wird darauf hingewiesen, und die Konsole nennt das Economy-Plugin, das Nein gesagt hat. Wird auch die Erstattung abgelehnt, bekommt die Konsole eine Zeile mit der Warnung, dass Geld feststeckt, dazu beide UUIDs, beide Namen und beide Beträge, weil ein Operator das von Hand richten können muss. Und wirft das Economy-Plugin eine Exception, wird die Zahlung abgebrochen, die Exception mit vollem Kontext geloggt und der Absender informiert, statt zu raten.
⌨️ Ein verrutschter Buchstab kann keine Geldbörse leeren. Das Maximum pro Zahlung existiert, weil der Betrag als Text getippt wird und ein verrutschter Buchstabe aus 5k ein 5m macht, das sich nicht zurücknehmen lässt. Standardmäßig gibt es keine Obergrenze, weil eine Grenze auf einem vertrauenswürdigen Server deine Entscheidung ist. Der Schalter ist aber da.
? Kein Lizenzschlüssel, kein Phone-Home, kein Netzwerkverkehr. Config-Reload, Menü-Rendering, Namens- und Skin-Lookup laufen alle lokal. Es gibt nichts zu aktivieren, nichts, das nach Hause telefoniert, und nichts, was an einem Netzwerk kaputtbricht.
? Für Folia geschrieben, nicht dafür gepatcht. Jeder geplante Task, also der Speicher-Timer, die verzögerte Mitteilung an einen Empfänger und das Neuzeichnen eines Menüs, läuft über eine kleine Scheduler-Fassade, die zur Laufzeit zwischen globalem, asynchronem, Regions- und Entity-Scheduler wählt. Es gibt keinen ungeschützten Scheduler-Aufruf von Bukkit mehr im Code, und deshalb darf das Plugin ehrlich die Folia-Unterstützung in seine plugin.yml schreiben.
? Neue Optionen kommen, ohne deine zu verlieren. Wenn eine neue Version einen Config-Schlüssel ergänzt, wird deine Datei beim nächsten Start genau um diesem Schlüssel ergänzt. Eine Datei mit YAML-Fehler wird vollständig unangetastet gelassen und gemeldet, niemals mit Standardwerten überschrieben.
? Sprachen
?? Englisch und ?? Deutsch, beide vollständig, beide gepflegt. Die Sprache steht in der config.yml, und alles, was Text enthält, liegt in lang/EN oder lang/DE, auch der Bestätigungsbildschirm. Du kannst also einem Teil der Spieler ein englisches und einem anderen ein deutsches Menü geben.
⏳ Stelle die Sprache um, bevor du etwas einrichtest. Ein späterer Wechsel legt den anderen Ordner neu an, und deine Einstellungen wandern nicht mit, weil es niemandem hilft, die Konfiguration eines Servers hinterrück umzuziehen.
? Jede Nachricht ist eine einzelne Zeile in einer Datei. Eine leere Zeichenkette schaltet diese Nachricht komplett aus, das ist der vorgesehene Weg, eine Zeile zu schweigen, ohne sonst etwas anzufassen. Farbcodes, Hex eingeschlossen, funktionieren überall.
✅ Voraussetzungen
- ☕ Java 21
- ? Minecraft 1.21.x auf Folia, Spigot, Paper oder Purpur
- ? Vault und ein Vault-Economy-Plugin, etwa EssentialsX Economy, CMI oder BetaEconomy
- ? PlaceholderAPI — optional, nur für Platzhalter und Fremdwerte in Menüs
ℹ️ Vault ist absichtlich ein Softdepend. Ein Server, der ihn vergessen hat, bekommt das Plugin trotzdem plus eine Konsolenzeile, die erklärt, warum /pay und /balance ablehnen, statt eines Plugins, das einfach nie in der Liste auftaucht.
⚔️ Wenn dein Economy-Plugin auch /pay hat
Eines der beiden gewinnt, das andere muss als /chaospaycore:pay getippt werden. Entscheide dich, welche Befehle du willst, und schalte die anderen in dem Plugin ab.
? Screenshots
Eigene einfügen: der Bestätigungsbildschirm, /pay in Aktion, die /eco-Ausgabe.
? Änderungen
1.0.0
- ? Erstes Release von ChaosPayCore
- Die Befehle /pay, /balance, /eco, /payments, /payalerts, /payconfirm und /pay reload
- ?️ Konfigurierbarer Bestätigungsbildschirm mit Spielerköpfen
- ? PlaceholderAPI-Expansion und eine PlaceholderAPI-Brücke für Menütexte
- ? Speicher für YAML, SQLite und MySQL
- ? Native Folia-Planung
评论 0
登录后参与评分
还没有评论,来抢沙发吧