原创 开源 娱乐 经济 MineStock - 在MC里体验真实股票系统 1.2.3

[MD]# MineStock **一个让玩家在 Minecraft 中交易真实 A 股与美股的经济插件** 接入东方财富与公开美股 API，实时行情、聊天框内 K 线图表、完整买卖流程，所有交易直接结算为服务器金币。 --- > [!WARNING] > **免责声明 / Disclaimer** > > 本插件提供的所有股票交易功能**仅为 Minecraft 游戏内的虚拟娱乐玩法**，与真实金融市场、证券交易行为无任何关联。 > > - 插件内的"买入""卖出""持仓""盈亏"等操作**仅消耗/增加服务器虚拟货币**，不涉及任何真实资金。 > - 插件展示的行情数据来源于公开接口，**存在延迟、缺失或不准确的情况**，不构成任何投资参考或建议。 > - **请勿将游戏内的虚拟交易策略用于真实股票市场。** 真实投资有风险，入市须谨慎。 > - 服务器管理员及插件作者对玩家因参考本插件内容而做出的任何真实世界投资决策**不承担任何责任**。 > > 本插件的唯一目的是为 Minecraft 服务器增添趣味性经济玩法，请理性游戏，**切勿将娱乐与真实投资混淆**。 --- ## 功能 **实时行情** 对接东方财富数据源（A 股）与公开美股 API，支持查询任意代码的实时价格与涨跌幅。多个 API Key 按 round-robin 均匀分配请求，降低单 Key 触发频率限制的风险。 **K 线图表** 在聊天框内渲染块状 K 线图，支持 30 天 / 90 天 / 365 天周期切换。将鼠标悬停（hover）在每根 K 线上可查看当日 OHLC（开高低收）详细数据。 **今日推荐** 内置精选股票列表，点击代码可直接跳转到该股票的详情页，适合不熟悉股票代码的玩家快速上手。 **完整交易流程** 聊天框内完成下单：输入命令 → 显示当前价格与手续费 → 二次确认 → 成交。余额不足时给出明确提示，避免扣款失败。 **我的持仓** 展示所有持仓的股数、买入均价、当前价格，以及基于均价计算的浮盈浮亏金额与涨跌幅。点击股票名称可直接查看详情，点击卖出按钮快速发起卖出操作。 **Vault 经济集成** 所有买入/卖出直接结算为服务器 Vault 金币余额，无需独立货币体系，与服务器现有经济无缝融合。 --- ## 支持的股票代码 | 市场 | 格式 | 示例 | |------|------|------| | A 股 | 6 位数字 | `600519`（贵州茅台）、`000001`（平安银行） | | 美股 | 英文字母 | `AAPL`、`TSLA`、`NVDA` | --- ## 依赖 | 依赖 | 最低版本 | |------|----------| | Paper / Spigot | 1.20.1 | | Vault | 1.7 | | Java | 21 | --- ## 命令 | 命令 | 说明 | 权限节点 | |------|------|----------| | `/mstock` | 显示帮助信息 | `minestock.use` | | `/mstock <代码>` | 查看实时行情与 K 线图 | `minestock.use` | | `/mstock recommended` | 今日推荐列表 | `minestock.use` | | `/mstock buy <代码> <数量>` | 买入股票 | `minestock.use` | | `/mstock sell <代码> <数量>` | 卖出股票 | `minestock.use` | | `/mstock portfolio` | 查看我的持仓 | `minestock.use` | | `/mstock reload` | 重载配置文件 | `minestock.admin` | --- ## 安装 1. 将 `MineStock-x.x.x.jar` 放入服务器 `plugins/` 目录 2. 确保已安装 **Vault** 及任意与其兼容的经济插件（如 EssentialsX Economy） 3. 启动服务器，插件会自动生成 `config.yml` 4. 在 `config.yml` 中填写美股 API Key（支持多个，按列表填写） 5. 执行 `/mstock reload` 使配置生效 --- ## 数据存储 持仓数据使用 **SQLite（H2 嵌入式数据库）** 本地持久化，无需额外部署数据库服务，开箱即用。 --- ## 构建 ```bash mvn clean package ``` 构建产物位于 `target/MineStock-*.jar`。 --- ## 作者 **oneLiLi** — 如有问题或建议，欢迎提 Issue。 [/MD]
### 股票详情页 & K 线图表

### 今日推荐列表

### 买入 / 卖出确认流程

### 我的持仓