股市

股市

StockMarket是一个Minecraft模组，为游戏带来了更好的交易方式。它让玩家能在虚拟股票市场上交易物品，非常适合拥有活跃经济的多人服务器。

经济

股市预览查看大图

股票市场模组

版本 2.1.0 是测试版本 — 可能存在错误和破坏性更改。在正式存档中使用风险自负。稳定版本：v1.3.1。

StockMarket 是一个为 Minecraft 带来虚拟股票市场的模组。玩家可以在实时撮合引擎上交易物品，配有K线图、订单簿以及市价/限价订单——就像一个真正的交易所。价格会随着玩家实际的买卖行为而变动，模块化的插件系统补全了其余功能：基础流动性、波动性、目标价机器人，以及一个完整的新闻事件系统来推动影响市场的头条新闻。管理员可以拥有一个游戏内的管理控制台来管理市场、插件、预设和设置；服务器网络通过主从架构和基于信任的访问控制共享单一市场。

更多信息和文档：GitHub

需要 BankSystem 2.1.0 或更高版本 和 Architectury。ModUtilities 已内置在模组中——您无需单独下载（Quilt 用户除外，他们仍然需要将 ModUtilities 作为单独的 jar 文件）。服务器和客户端都需要安装此模组。

功能特性

  • 实时交易，配有K线图、订单簿深度以及每个K线的成交量柱状图
  • 完整的历史图表 — 滚动图表页面时可翻看更早的K线，一直回溯到市场首根K线，只加载您实际查看的内容
  • 市价订单（即时）和限价订单（目标价格），图表上带有可拖动的订单标记，可将订单移动到新的价格
  • 跨市场交易 — 直接以物品对物品进行交易（例如铁换钻石），无需经过卖出→买入的往返过程
  • 公司股票 — 通过 BankSystem 发行的公司股票与普通物品一同交易，交易面板上带有商品/公司筛选器，显示真实公司名称，以及整个界面上带有色调的股票图标
  • 待处理订单面板，支持实时更新和一键取消；每个市场都有完整的订单历史和市场交易日志
  • 交易界面上的银行账户选择器 — 选择用您的哪个银行账户为每笔交易提供资金；余额和未成交订单列表均与该账户绑定
  • 收藏夹 — 为您经常交易的市场加星以便快速访问；每个玩家都会记住上次选择的市场
  • 新闻事件系统，带有可合成的报纸、72 个默认双语事件、每个事件配有木刻版画插图、多步影响序列（飙升→衰减→恢复）、触发条件、事件链和可 JSON 配置的自定义事件
  • 村民交易集成 — 市场上所列物品的村民/流浪商人报价会从实时股票市场重新定价，并带有可配置的买卖差价；商人货币费用可以任何面额组合支付
  • 模块化插件系统 — VolatilityPlugin（带玩家流价格平衡）、TargetPriceBot（PID）、DefaultOrderbookVolumeDistribution 和 NewsPlugin。全部可独立启用/禁用，可按市场订阅，并提供用于自定义插件的开发工具包
  • 游戏内模组设置界面 — settings.json 中的每个值都可以实时编辑，在服务器端验证并限制范围；需要重启才能生效的设置会有标签标注
  • 管理 GUI — 创建市场，浏览 32 个默认预设类别（方块、矿石、食物、工具、盔甲、附魔书、药水、药箭……），就地编辑预设，使用带每个插件性能分析器条的管理插件，以及管理新闻系统
  • 单市场虚拟订单簿控制 — 可为单个市场关闭模拟订单簿，使其价格完全由真实玩家交易驱动，其余市场提供清除和重置操作
  • 多服务器支持 — 主/从架构。不受信任的从服务器锁定为只读浏览；每个修改请求（订单、插件更改、预设编辑、模组设置、新闻操作）在主服务器上都会被拒绝
  • 专用于 StockMarket 的管理员权限标志 — 仅拥有操作员权限级别不再授予管理权限
  • 安全的数据库备份 — 仅限操作员的 /stockmarket backup pause|resume|status 命令可让 SQLite 数据库静止，使外部备份脚本能够捕获干净的快照，并带有 120 秒自动恢复的安全网
  • 公共集成 API — 其他模组可以通过文档化的服务器端服务在进程内创建、暂停、恢复和删除市场

2.1.0 版本的新内容

需要 BankSystem 2.1.0 或更高版本。 此版本围绕 BankSystem 的新公司功能构建 — 旧版 BankSystem 将无法加载。

  • 公司股票可交易 — 通过 BankSystem 发行的公司股票像其他标的物一样出现在市场上。交易界面、订单簿标题、收藏夹和悬停提示均显示真实的公司名称，而不是原始的物品 ID，股票行会渲染公司带有色调的股票图标
  • 交易面板上的商品/公司筛选器 — 在交易模式按钮下方有一个分段控件，可同时筛选货币模式和物品换物品配对模式，使流程变为 模式 → 分组 → 物品，每个分组都有实时计数
  • 按名称、价格、发行股票数或 24 小时成交量排序市场列表
  • 单市场虚拟订单簿开关 — 可为单个市场关闭模拟订单簿，使其价格完全来自真实玩家交易。附带清除和重置操作，以及相应的按预设标志和“无插件自动订阅”预设选项
  • 供其他模组使用的公共集成 API — 文档化的服务器端服务，用于在进程内创建、暂停、恢复和删除市场。暂停市场会停止交易并退还每个未完成玩家订单的资金，且不会破坏其价格历史
  • 预设编辑器：直接从您的物品栏中选取物品 — 一个“+ 从物品栏”选取器，以熟悉的 3×9 + 快捷栏网格布局呈现，可以选择带有数据组件的物品（例如带印记的公司股票），这是扁平注册表列表无法实现的
  • 修复 — 没有流动性的市价订单现在会取消并释放其预留的资金，在选取器中点击物品时预设编辑器不再崩溃，交易界面首次打开时能正确显示“市场已关闭”标签
  • 2.0.1 → 2.1.0 的完整更新日志见 GitHub

自上一个稳定版本（1.3.1）以来的新内容

  • 模块化插件系统取代了旧的单一机器人 — VolatilityPlugin、TargetPriceBot、DefaultOrderbookVolumeDistribution 和 NewsPlugin，每个都可独立启用/禁用、按市场订阅，并提供双类开发工具包以用于自定义插件（v2.0.1）
  • 插件管理 GUI，带有K线图和订单簿叠加层、每个插件的自定义设置界面以及市场订阅/取消订阅控件（v2.0.1）
  • 32 个默认预设类别，覆盖原版 1.21.1 物品 — 方块、矿石、食物、作物、工具、盔甲、红石、生物掉落物、酿造、所有最高等级附魔书、药水、喷溅/滞留药水以及药箭（v2.0.1）
  • 端到端的成交量跟踪 — SQL 历史记录中每根K线的累计成交量、实时流式传输到客户端、以及图表中的红绿成交量柱（v2.0.1）
  • 图表上可拖动的订单标记 — 待处理的限价订单渲染为水平价格线，带有拖动手柄来移动订单，以及 [X] 来取消订单（v2.0.1）
  • 交易界面上的待处理订单面板、订单历史和市场交易日志标签页（v2.0.1）
  • 每个玩家的收藏夹和上次访问市场记忆，在服务器端持久化（v2.0.1）
  • 跨市场交易 — 在配对图表上直接以物品对物品进行交易（v2.0.1）
  • 预设编辑器 GUI和管理员命令 — /stockmarket preset add 可将手持物品捕获为预设，/stockmarket <市场> remove 可在 GUI 之外删除市场（v2.0.1 / v2.0.3）
  • 区域设置强化 — 界面上所有数字格式都固定在 Locale.ROOT，修复了使用 , 作为小数分隔符的区域设置下的交易界面崩溃问题（v2.0.2）
  • 市场生命周期修复 — 删除的市场会立即传播到每个客户端，漂移或无法解析的市场仍可选中/删除，BankSystem ItemID 合并产生的重复市场会自动整合（v2.0.3）
  • 新闻事件系统 — 可合成的报纸、72 个默认双语事件、每个事件配有木刻版画艺术、多步序列、条件、链条和可 JSON 配置的自定义事件（v2.0.4）
  • 村民交易 — 报价从实时市场重新定价，支持任意面额的货币付款（v2.0.4）
  • 主服务器上管理员的游戏内模组设置界面（v2.0.4）
  • VolatilityPlugin 价格平衡，具有玩家流自动平衡和按物品丰度缩放功能（v2.0.4）
  • 插件管理窗口中的插件性能分析器条（v2.0.4）
  • 交易界面上的银行账户选择器 — 使用您拥有完全权限的任何账户进行交易（v2.0.4）
  • 基于信任的访问控制和专用 StockMarket 管理员权限标志 — 不受信任的从服务器为只读；管理权限不再仅跟随操作员级别（v2.0.4）
  • Fabric 构建修复 — 恢复 Fabric 构建上的 BankSystem 依赖（v2.0.5）
  • 分页图表历史 — 图表只加载您正在查看的窗口，向后滚动时会翻页加载更早的K线，因此您可以回溯到市场的第一根K线，而不是停在约五天前。交叉汇率图表以相同方式分页，重新访问某范围不会产生网络流量（v2.0.7）
  • 更快的世界加入速度 — 加载时不再为每个市场获取图表数据；以前一个有 125 个市场的世界在您打开单个图表前就会触发 750 次 SQL 往返查询（v2.0.7）
  • /stockmarket backup pause|resume|status — 仅供操作员使用的数据库静止命令，使外部备份脚本能捕获干净的 stockdata.db，带有 120 秒自动恢复的安全网，暂停期间无数据丢失（v2.0.7）
  • 公司股票交易 — 来自 BankSystem 的公司股票与物品一同交易，带有商品/公司筛选器、真实公司名称、带色调的股票图标，以及按名称/价格/发行股票数/24 小时成交量排序市场（v2.1.0）
  • 单市场虚拟订单簿开关，带有清除和重置操作，以及相应的预设标志（v2.1.0）
  • 公共集成 API，供其他模组在进程内创建、暂停、恢复和删除市场（v2.1.0）
  • 预设编辑器物品栏选取器 — 选择带有数据组件的物品，例如带印记的公司股票（v2.1.0）

股市终端方块

实际的终端方块。右键打开完整的交易界面 — 图表、订单簿、订单控制、收藏夹、待处理订单和历史记录 — 全部与您当前选择的银行账户绑定。

实时价格图表

K线图，下方带成交量直方图。成交量按每根K线的方向显示为红/绿色，并从服务器实时流式传输。支持平移、缩放和切换时间周期。

新闻事件系统

可合成的报纸是面向玩家的信息流。条目按游戏内日期分组，带有“第 N 天”分隔符，每个事件都配有自己 384×384 的灰度木刻版画插图。可从您的物品栏、交易或管理界面打开报纸，或通过 /stockmarket news 命令。

点击任何头条新闻即可查看完整事件：类别、受影响的市场及各市场的百分比影响、实时更新的序列分解（上升中→保持中→恢复中→已过期），带有每个阶段的持续时间和下一步倒计时。

新闻管理控制

进行中 — 当前正在运行的事件，带有各市场影响行、图片缩略图以及每个事件的跳过阶段/停止控制。

所有事件 — 完整的事件列表，带有详细信息弹窗、每个事件的启用/禁用以及手动触发。

计划任务 — 控制发布频率并查看即将发生的事件时间线及预计触发时间。

管理 GUI

管理员控制台。从 32 个默认预设类别创建市场、浏览和就地编辑预设、管理插件、编辑模组设置以及管理新闻系统 — 一切均可不出游戏完成。

带性能分析器的插件管理

启用、禁用和重新排序插件。每个插件都有自己的设置界面（内联或全屏）和一个可订阅的市场列表。顶部的性能分析器条显示每个插件每次执行的用时与有效的服务器刻预算的对比，并在插件负载过高时显示溢出警告。

合成配方

交易终端 — 打开交易界面的方块。

股市显示器 — 在游戏世界中渲染选定市场实时图表的显示方块。

报纸 — 面向玩家的新闻阅读器。