SMP2GoldMarket

Paper 端 T+0 黄金交易插件（Vault 经济对接，SQLite 持久化，1 分钟同步金价）。

功能

• 每 60 秒同步 https://www.guojijinjia.com/d/gold.js?code={} 的黄金价格。
• 仅北京时间 09:30-22:20 可交易。
• /gold buy [金额]：按元买入，0 手续费。
• /gold sell [金额]：按元卖出，收取手续费；手续费按“比例手续费”和“最低手续费”取大值。手续费会计入累计收益，但不会影响持仓成本和均价。
• /gold check：显示当前金价、持仓价值、持仓 oz 数、购买成本、持仓收益、累计收益。
• /gold top：显示累计收益前 5 名。
• /gold bar：开关 BossBar，显示当前金价、当前持有和持仓收益。
• SQLite 记录玩家持仓（oz/成本）与每笔交易，累计收益持久化。

环境要求

• Java 17+
• Maven 3.8+
• Paper 1.20.0+
• Vault + 任意 Vault 经济实现（SMP2： Vault 与 XConomy）

构建

mvn -DskipTests package

构建产物：

• target/gold-market-{version}.jar

部署

1. 将 target/gold-market-{version}.jar 放入服务器 plugins/。
2. 确保 Vault 与经济插件（如 XConomy）已加载。
3. 启动服务器后，修改 plugins/SMP2GoldMarket/config.yml（如需）。
4. 重载插件或重启服务器。

配置说明（config.yml）

• price.url：行情接口地址
• price.symbol：行情变量名（默认 hq_str_gds_AUTD）
• price.field-index：取值索引（默认 0）
• price.sync-interval-seconds：同步间隔，默认 60
• price.max-stale-seconds：价格过期阈值，默认 180
• trade.timezone：时区，默认 Asia/Shanghai
• trade.start / trade.end：交易时段，默认 09:30 / 22:20
• trade.sell-fee-rate：卖出手续费比例，默认 0.005
• trade.min-sell-fee：卖出最低手续费，默认 1.0
• trade.min-buy-oz：最低起购 oz 数，默认 0.1
• bossbar.update-interval-ticks：BossBar 刷新间隔，默认 60

权限

• goldmarket.use：使用 /gold（默认 true）
• goldmarket.trade：买卖（默认 true）
• goldmarket.check：查看持仓和收益排行（默认 true）