
股市
这是一个允许玩家向全球市场买卖特定物品的模组。
股市模组
版本 2.1.0 是一个测试版本——请预期存在缺陷和破坏性更改。在生产环境中使用风险自负。稳定版本:v1.3.1。
StockMarket 是一个为 Minecraft 带来虚拟股票市场的模组。玩家通过一个实时撮合引擎交易物品,具备 K 线图、订单簿以及市价/限价订单——就像真实的交易所一样。价格会对玩家实际买卖的行为作出反应,而模块化插件系统则补足了其余部分:基准流动性、波动率、目标价格机器人,以及一个完整的新闻事件系统,推送能影响市场的头条新闻。管理员可以使用游戏内管理控制台来管理市场、插件、预设和设置;服务器网络通过主/从架构共享单一市场,并采用基于信任的访问控制。
更多信息与文档:GitHub
需要 BankSystem 2.1.0 或更高版本 以及 Architectury。ModUtilities 随模组一同发布——你不需要单独下载它(Quilt 用户是例外,仍需要将 ModUtilities 作为独立的 jar 文件)。服务端和客户端都需要安装本模组。

特性
- 实时交易,包含 K 线图、订单簿深度以及每根 K 线的成交量柱
- 完整图表历史——图表会随着你滚动而向前加载更早的 K 线,一直追溯到市场的第一根 K 线,只加载你实际查看的部分
- 市价订单(即时)和限价订单(目标价格),图表上带有可拖动的订单标记,可将订单移动到新的价格
- 跨市场交易——直接以物品兑换其他物品进行交易(例如用铁换钻石),无需先卖出再买入的往返
- 公司股票——通过 BankSystem 发行的公司股票与普通物品一同交易,交易方块上带有商品/公司筛选器,显示真实公司名称,整个 UI 中显示带色调的股票图标
- 待处理订单面板,支持实时更新和一键取消;每个市场都有完整的订单历史和市场交易日志
- 交易界面上的银行账户选择器——选择用于每笔交易的银行账户;余额和未结订单列表均限定于该账户
- 收藏夹——将你经常交易的市场标星以便快速访问;每个玩家恢复上次选择的市场
- 新闻事件系统,包含可合成报纸、72 个默认双语事件、每个事件专属的木刻插图、多阶段影响序列(飙升 → 衰减 → 恢复)、触发条件、事件链以及可通过 JSON 配置的自定义事件
- 村民交易集成——村民/流浪商人对市场所列物品的报价会根据实时股市重新定价,买卖利润率可配置;商人的货币费用可以用任意面额组合支付
- 模块化插件系统——VolatilityPlugin(含玩家流动价格均衡)、TargetPriceBot(PID)、DefaultOrderbookVolumeDistribution 和 NewsPlugin。所有插件均可独立启用/禁用,可按市场订阅,并提供用于自定义插件的开发者 SDK
- 游戏内模组设置界面——每个
settings.json值均可实时编辑,在服务端进行验证和范围限制;需要重启的设置会有标注 - 管理 GUI——创建市场,浏览 32 个默认预设类别(方块、矿石、食物、工具、盔甲、附魔书、药水、药箭……),内联编辑预设,管理插件并带有每插件性能分析条,以及管理新闻系统
- 按市场控制虚拟订单簿——可为单个市场关闭模拟订单簿,使其价格完全由真实玩家交易驱动,其余市场则提供清除和重置操作
- 多服务器支持——主/从架构。不受信任的从服务器被锁定为只读浏览;每个变更请求(订单、插件更改、预设编辑、模组设置、新闻操作)都会在主服务器上被拒绝
- 专属于 StockMarket 的管理员权限标志——仅凭管理员等级不再授予管理访问权限
- 安全的数据库备份——仅限 op 的
/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,每个均可独立启用/禁用,可按市场订阅,并提供用于自定义插件的双类开发者 SDK(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 <market> remove在 GUI 之外删除市场(v2.0.1 / v2.0.3) - 区域设置强化——UI 中的每个数字格式都固定为
Locale.ROOT,修复了在逗号小数分隔符区域设置下 TradeScreen 的崩溃(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——仅限 op 的数据库暂停,以便外部备份脚本捕获干净的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 个默认预设类别创建市场、内联浏览和编辑预设、管理插件、编辑模组设置以及管理新闻系统——全部无需离开游戏。
带性能分析器的插件管理

启用、禁用和重新排序插件。每个插件都有自己的设置 UI(内联或全屏)和一个可订阅的市场列表。顶部的性能分析条显示每插件、每轮次的执行时间相对于有效服务器 tick 预算的情况,并在插件负载过高时显示溢出警告。
合成配方

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

股市显示屏——在世界中显示选定市场实时图表的显示器。

报纸——面向玩家的新闻阅读器。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。