- 版权类型
- 转载
- 插件中文名
- SimpleCryptoWebCashier
- 插件英文名
- SimpleCryptoWebCashier
- 支持的核心 [服务端]
- Spigot
- 语言支持
- 中文(简体)
- 适配Minecraft版本 [Java]
- 1.21
[MD]
# SimpleCryptoWebCashier
> 分类：资源 / Java 版多人游戏 / 服务端插件
SimpleCryptoWebCashier 是一款用于接收稳定币支付的 Minecraft 服务端插件。相比可能收取手续费、或需要自行投入较多开发工作的传统方案，稳定币支付为服务器捐赠提供了 Stripe 等传统平台之外的另一种选择。
本项目并非旨在取代银行卡等成熟、广泛使用的支付方式，而是一个探索性项目，用于展示稳定币支付现已具备可用性。它并不以生产环境服务为定位。
插件不内置商城、权益发放、优惠券等功能。你只需指定支付金额及可接受的代币；支付完成后，插件可发送 Discord 通知、执行游戏内命令，或由你自行编写代码处理支付完成事件。推荐监听支付完成事件，并在自己的代码中实现后续逻辑。
除你自行配置的 API 密钥外，插件不会连接任何云平台，也没有高级功能或注册流程。
## 功能特点
- 非托管模式：插件不会持有或处理你及玩家的资金。
- 提供支付结算网页。
- 支持 SQLite 账本，也可通过 JDBC 使用 PostgreSQL、MySQL 或 MariaDB。
- 无需配置 Paymaster 等 Gas 费赞助服务。
- 支持 Discord Webhook、游戏内命令，以及自定义事件处理器集成。
## 支付流程
1. 玩家访问支付网站，输入游戏内用户名并连接钱包。
2. 玩家选择支付网络和代币，并在钱包中签名确认交易。
3. 支付完成。
## 前置条件
1. 用于 x402 Facilitator 的 Coinbase Developer Portal API 密钥。
2. 用于接收代币的钱包，例如 MetaMask、Phantom 等。
3. （可选）用于接收支付完成通知的 Discord。
## 安装与配置
1. 将插件文件拖放至服务端的 `plugins` 文件夹。
2. 重启服务端，然后打开 `plugins/SimpleCryptoWebCashier/config.yml`。
3. 启用需要支持的区块链网络和代币，并填写收款钱包地址及 CDP API 密钥。
4. （可选）配置 Discord Webhook URL 和账本 JDBC URL。
5. 再次重启服务端，然后在浏览器中打开 [http://127.0.0.1:28742/](http://127.0.0.1:28742/) 进行本地测试。请勿直接将该本地地址提供给玩家。
插件基于 Java 17 或更高版本构建，至少需要 Spigot 16.5。
## 测试方法
1. 启用 `BASE_SEPOLIA` 等测试网，并使用 [https://faucet.circle.com/](https://faucet.circle.com/) 等水龙头获取测试网代币。
2. 完整测试支付流程及插件功能。
3. **重要：**部署到生产环境前，请移除测试网相关配置。
## 扩展性与性能
目前，支付网页嵌入在插件中。启动安装该插件的服务端时，需要为 API 和网站指定端口，并将其暴露给玩家访问。此设计主要用于简化插件配置和服务端使用体验。
对于规模较大的服务器，不建议将 HTTP 服务直接运行在游戏服务端内部。更合适的方案是将网站独立部署，并仅将其作为自动发放游戏内权益的接口。
如需将网站和后端 API 部署在其他位置，可克隆项目仓库。该项目可较容易地与 Bukkit 平台解耦。API 调用采用异步方式，插件本身几乎完全在主线程之外运行。
## 工作原理
在许多区块链网络中，发送交易通常需要使用原生代币支付 Gas 费，除非由钱包或第三方为用户赞助该费用。x402 推出了 Facilitator 机制，可代表付款方提交交易，从而简化加密货币支付流程并降低使用复杂度。
本插件对相关 Facilitator 进行封装。部分 Facilitator 在额度范围内可提供免费交易，因此手续费最低可降至 0%。不过，将加密货币兑换回法定货币仍需另行处理。
## 支持的区块链与代币
支持范围可能会随 Coinbase Developer 文档更新而变化，请以官方最新文档为准。
目前，CDP Facilitator 支持其 EVM 网络上的所有 ERC-20 代币，可通过 EIP-3009 或 Permit2 完成支付；同时也支持 Solana 上的 SPL 代币。默认配置文件中提供了示例配置。
[/MD]
# SimpleCryptoWebCashier
> 分类：资源 / Java 版多人游戏 / 服务端插件
SimpleCryptoWebCashier 是一款用于接收稳定币支付的 Minecraft 服务端插件。相比可能收取手续费、或需要自行投入较多开发工作的传统方案，稳定币支付为服务器捐赠提供了 Stripe 等传统平台之外的另一种选择。
本项目并非旨在取代银行卡等成熟、广泛使用的支付方式，而是一个探索性项目，用于展示稳定币支付现已具备可用性。它并不以生产环境服务为定位。
插件不内置商城、权益发放、优惠券等功能。你只需指定支付金额及可接受的代币；支付完成后，插件可发送 Discord 通知、执行游戏内命令，或由你自行编写代码处理支付完成事件。推荐监听支付完成事件，并在自己的代码中实现后续逻辑。
除你自行配置的 API 密钥外，插件不会连接任何云平台，也没有高级功能或注册流程。
## 功能特点
- 非托管模式：插件不会持有或处理你及玩家的资金。
- 提供支付结算网页。
- 支持 SQLite 账本，也可通过 JDBC 使用 PostgreSQL、MySQL 或 MariaDB。
- 无需配置 Paymaster 等 Gas 费赞助服务。
- 支持 Discord Webhook、游戏内命令，以及自定义事件处理器集成。
## 支付流程
1. 玩家访问支付网站，输入游戏内用户名并连接钱包。
2. 玩家选择支付网络和代币，并在钱包中签名确认交易。
3. 支付完成。
## 前置条件
1. 用于 x402 Facilitator 的 Coinbase Developer Portal API 密钥。
2. 用于接收代币的钱包，例如 MetaMask、Phantom 等。
3. （可选）用于接收支付完成通知的 Discord。
## 安装与配置
1. 将插件文件拖放至服务端的 `plugins` 文件夹。
2. 重启服务端，然后打开 `plugins/SimpleCryptoWebCashier/config.yml`。
3. 启用需要支持的区块链网络和代币，并填写收款钱包地址及 CDP API 密钥。
4. （可选）配置 Discord Webhook URL 和账本 JDBC URL。
5. 再次重启服务端，然后在浏览器中打开 [http://127.0.0.1:28742/](http://127.0.0.1:28742/) 进行本地测试。请勿直接将该本地地址提供给玩家。
插件基于 Java 17 或更高版本构建，至少需要 Spigot 16.5。
## 测试方法
1. 启用 `BASE_SEPOLIA` 等测试网，并使用 [https://faucet.circle.com/](https://faucet.circle.com/) 等水龙头获取测试网代币。
2. 完整测试支付流程及插件功能。
3. **重要：**部署到生产环境前，请移除测试网相关配置。
## 扩展性与性能
目前，支付网页嵌入在插件中。启动安装该插件的服务端时，需要为 API 和网站指定端口，并将其暴露给玩家访问。此设计主要用于简化插件配置和服务端使用体验。
对于规模较大的服务器，不建议将 HTTP 服务直接运行在游戏服务端内部。更合适的方案是将网站独立部署，并仅将其作为自动发放游戏内权益的接口。
如需将网站和后端 API 部署在其他位置，可克隆项目仓库。该项目可较容易地与 Bukkit 平台解耦。API 调用采用异步方式，插件本身几乎完全在主线程之外运行。
## 工作原理
在许多区块链网络中，发送交易通常需要使用原生代币支付 Gas 费，除非由钱包或第三方为用户赞助该费用。x402 推出了 Facilitator 机制，可代表付款方提交交易，从而简化加密货币支付流程并降低使用复杂度。
本插件对相关 Facilitator 进行封装。部分 Facilitator 在额度范围内可提供免费交易，因此手续费最低可降至 0%。不过，将加密货币兑换回法定货币仍需另行处理。
## 支持的区块链与代币
支持范围可能会随 Coinbase Developer 文档更新而变化，请以官方最新文档为准。
目前，CDP Facilitator 支持其 EVM 网络上的所有 ERC-20 代币，可通过 EIP-3009 或 Permit2 完成支付；同时也支持 Solana 上的 SPL 代币。默认配置文件中提供了示例配置。
[/MD]