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

[MD]# MineStock 持仓 GUI 功能说明 ## 新增功能 ### 持仓 GUI 界面 - **命令**: `/mstock pg` 或 `/stock pg` 或 `/st pg` - **功能**: 以图形界面（箱子 GUI）方式展示玩家的股票持仓 ### 功能特点 1. **直观展示** - 每只持仓股票显示为一个物品 - 绿色染料（上涨）或红色染料（下跌）区分盈亏状态 - 物品名称显示股票代码和名称 2. **详细信息** - 持仓数量 - 持仓成本（平均买入价） - 当前价格（实时获取） - 持仓盈亏百分比（▲/▼） - 浮动盈亏金额 3. **交互功能** - 点击任意股票物品：关闭 GUI 并自动执行 `/mstock <股票代码>` 查看该股票详情 - 点击右下角红色屏障：关闭 GUI 4. **空状态** - 如果没有持仓，显示灰色玻璃板提示"暂无持仓" ## 与原有功能的关系 - **原有命令保持不变**: `/mstock portfolio` 和 `/mstock p` 仍然以文字方式显示持仓列表 - **新增 GUI 命令**: `/mstock pg` 是全新的命令，专门用于图形界面展示 - **互不干扰**: 两种方式可以根据玩家喜好自由选择使用 ## 技术实现 ### 新增文件 1. `src/main/java/dev/onelili/mstock/ui/PortfolioGUI.java` - 负责构建和打开持仓 GUI 界面 - 异步获取所有持仓的实时股价 - 计算盈亏状态并渲染物品 2. `src/main/java/dev/onelili/mstock/listener/PortfolioGUIListener.java` - 监听 GUI 点击事件 - 处理股票物品点击和关闭按钮 - 自动清理 viewer 状态 ### 修改文件 1. `MStockCommand.java`: 添加 `pg` 子命令处理和 Tab 补全 2. `MineStock.java`: 注册 `PortfolioGUIListener` 事件监听器 3. `plugin.yml`: 更新命令用法说明 ## 使用示例 ``` /mstock pg # 打开持仓 GUI /stock pg # 同上（别名） /st pg # 同上（别名） /mstock portfolio # 传统文字方式查看持仓（保持原样） /mstock p # 同上（简写） ``` ## Tab 补全 输入 `/mstock ` 后按 Tab 键，会显示： ``` buy sell portfolio pg recommended reload ``` ## 版本信息 - **插件版本**: 1.2.3 - **新增于**: 2026-07-16 - **兼容性**: Bukkit/Spigot/Paper 1.20.1+, Folia[/MD]

MineStock v1.2.2​

新功能​

• 新增 MineStock 行情告示牌：
  • [minestock] / recommend / 推荐序号：显示今日第 N 支推荐股票。
  • [minestock] / code / 股票代码：显示指定股票行情。
• 告示牌显示股票代码、名称、当前价格和涨跌幅，并自动定时刷新。
• 新增推荐池 auto 模式：自动从沪深 A 股候选中筛选股票。
  • 综合涨幅、成交额、换手率和量比评分。
  • 自动过滤 ST、退市、停牌及极端涨跌股票。
• 原有 recommended-pool YAML 股票代码列表配置继续支持。
• 每日推荐结果保持稳定，命令 /mstock recommended 与告示牌共用同一份每日推荐。

优化与修复​

• 告示牌信息持久化保存至 signs.yml。
• 告示牌被编辑、挖掘、爆炸或因依附方块失效而脱落时，自动删除对应存储记录。
• 支持告示牌正反两面独立显示。
• 兼容 Paper/Spigot 与 Folia 的区域线程调度。
• 新增推荐、评分与告示牌持久化测试。

配置项​

recommended-pool: auto<br>recommended-count: 3<br>auto-candidate-count: 100<br>sign-refresh-seconds: 300

MineStock 1.2.0 更新内容​

• 新增港股市场支持，可查询行情、查看 K 线并进行买卖。
• 港股代码支持 1 至 5 位数字，例如 700、9988。
• 港股行情使用新浪财经，并提供腾讯财经备用数据源，无需配置 API Key。
• 新增 /stock 命令，与原有 /mstock 完全等价。
• 新增 /st 动态命令：启动时检测命令冲突，无冲突时自动注册。
• 新增 Folia 支持，根据服务器环境自动选择 Folia 或 Bukkit/Paper 调度器。
• 聊天输入监听迁移至 Paper AsyncChatEvent，完善异步环境兼容性。
• 新增公开的 MineStockAPI，其他插件可以查询行情和持仓、管理玩家持仓及操作输入会话。
• 新增行情查询、持仓查询、交易前置和交易完成等 Bukkit 事件；交易前事件支持取消。
• 股票数据源从 api 包迁移至独立的 stockio 包，明确公开 API 与内部数据源的职责。
• 优化线程安全与交易可靠性，包括并发缓存、输入会话、冷却记录以及原子化卖出扣减。
• 修正港股行情编码、字段解析和 K 线数据解析，并为港股接口及持仓扣减增加单元测试。