原创 Endstone Ups And Downs 美股交易插件 2025-10-19

EndStone 股票交易插件 (Ups and Downs)​

一个基于 EndStone 框架的 Minecraft 股票交易模拟插件，支持实时美股数据交易，内置完整的股票知识教学系统。

系统要求​

• Python: 3.13+
• Minecraft 服务器: 支持 EndStone 框架
• 依赖插件: arc_core (经济系统)

依赖安装​

pip install endstone yfinance

安装方法​

1. 将插件文件放入服务器的 plugins 目录
2. 确保已安装 arc_core 经济插件
3. 重启服务器

主要功能​

股票交易系统​

• 实时数据: 同步美股市场实时价格
• 多种订单: 支持市价单和限价单
• 动态手续费: 可配置的手续费率（默认2%）
• 持仓管理: 自动计算平均成本和盈亏
• 多线程优化: 所有网络请求异步处理，不阻塞服务器

账户管理​

• 资金转入: 从游戏账户转入股票资金
• 资金转出: 将股票盈利转回游戏账户
• 余额查询: 实时查看账户余额和持仓

数据展示​

• 价格走势: 查看股票历史价格变化
• 持仓详情: 显示每只股票的盈亏情况
• 历史订单: 完整的交易记录

排行榜系统​

• 绝对盈亏榜: 按赚/亏金额排序
• 相对盈亏榜: 按盈亏百分比排序
• 实时更新: 动态显示玩家排名

教学系统​

• 基础知识: 股票概念、价格决定因素、重要指标
• 交易技巧: 买卖时机、订单类型、资金管理
• 风险管理: 风险类型、止损策略、心理控制
• 分页教学: 循序渐进的学习路径

个性化设置​

• 配色方案: 支持红涨绿跌（中国）和绿涨红跌（美国）
• 收藏夹: 收藏常用股票
• UI界面: 现代化的图形界面

使用方法​

基础命令​

/stock help # 显示帮助信息
/stock ui # 打开图形化界面（推荐
/stock transferin 将资金从服务器经济系统中转入股票账户
/stock transferout 将资金从股票账户中转入服务器经济系统
/stock show 股票代码 [时间范围] 查看股票变化， 时间范围选项: minute (10分钟), day (10天), month (10个月)，默认为day
/stock account 查看我的股票账户余额<br>/stock buy 股票代码 股份数 [价格] 购买股票，份数为整数，不填写价格则为市价单，填写价格则为限价单
/stock sell &lt;股票代码股份数 [价格] 出售股票，份数为整数，不填写价格则为市价单，填写价格则为限价单
/stock orders [页数] 查看我的历史订单，页数默认为1
/stock shares [页数] 查看我的持仓，页数默认为1

支持的股票​

• 美股: AAPL, TSLA, MSFT, GOOGL, AMZN 等
• 加密货币: BTC-USD, ETH-USD 等
• 其他: 支持 yfinance 库的所有股票代码

界面功能​

主面板​

• 账户概览
• 盈亏统计
• 快速操作入口

持仓管理​

• 实时市值计算
• 盈亏百分比显示
• 一键交易操作

股票搜索​

• 实时价格查询
• 价格走势图表
• 收藏功能

排行榜​

• 土豪榜（绝对盈亏前5）
• 高手榜（相对盈亏前5）
• 韭菜榜（亏损榜）

重要说明​

1. 模拟交易: 本插件为模拟交易，不会产生真实交易
2. 数据延迟: 价格数据可能有延迟，仅供参考
3. 风险提示: 投资有风险，请理性交易
4. 网络要求: 需要稳定的网络连接获取股票数据
5. 教育目的: 内置教学系统仅供学习参考，不构成投资建议

配置选项​

插件支持以下配置（配置文件：plugins/UpAndDown/stock_setting.yml）：

• 代理设置: 支持 HTTP/HTTPS 代理
• 颜色方案: 可自定义涨跌颜色
• 手续费率: 可配置的手续费率（默认2%）
• 数据更新间隔: 股票数据更新频率（默认60秒）

配置示例：

# 代理设置
proxy=127.0.0.1:5555
enable_proxy=true

# 交易手续费率（百分比，例如：2.0 表示2%）
trading_fee_rate=2.0

# 股票数据更新间隔（秒）
update_interval=60

Road Map​

• 获取股票价格，出售/购买股票
• 排行榜性能优化
• 限价单功能完善
• 多语言支持
• More...

更新日志​

v0.5.0 (最新)​

• 新增完整教学系统: 包含基础知识、交易技巧、风险管理三大模块
• 性能优化: 所有UI操作改为多线程异步处理，避免服务器卡顿
• 配置优化: 手续费率改为可配置选项，支持动态调整
• 教学指引: /stock help 改为UI形式，提供分页式详细教学
• UI改进: 主面板新增"教学指引"按钮，优化用户体验

v0.4.0​

• 新增图形化UI界面
• 优化排行榜显示
• 修复盈亏计算问题
• 支持玩家名字显示

贡献​

欢迎提交 Issue 和 Pull Request！

许可证​

本项目采用 MIT 许可证。

---

免责声明: 本插件仅供娱乐使用，不构成投资建议。请勿将虚拟货币与真实货币混淆。