StockMarket [BETA] - StockMarket

StockMarket 是一款允许玩家使用游戏内货币在全球各大证券交易所买卖股票的插件。它为玩家提供了一种基于所购股票表现来赚取或亏损资金的途径，同时也为玩家提供了一个无风险学习股票市场的机会。

💡前置需求

• Vault 及兼容 Vault 的经济插件 - 用于经济系统集成。
• Citizens - 可选 - 用于生成股票经纪人 NPC。
• PlaceholderAPI - 可选 - 用于提供占位符。

🎮占位符

如果安装了 PlaceholderAPI，你可以使用以下占位符：

• %sm_portfolio-value% - 显示玩家的投资组合总价值。

股票信息占位符

格式为 %sm_sd-<股票代码>-<信息点>%。首次启动使用时可能会显示“N/A”，直到数据加载完成。

可用信息点

• name - 示例：%sm_sd-ba-name% - 返回公司全名。
• volume - 示例：%sm_sd-ba-vol% - 返回股票交易量。
• cap - 示例：%sm_sd-ba-cap% - 返回股票市值。
• server price - 示例：%sm_sd-ba-sp% - 返回股票在服务器内的价格。

> 注：以上示例中，BA 是股票代码，代表波音公司。

🔧权限

• stockmarket.use - 任何需要使用股票市场命令的玩家都必须拥有此权限。
• stockmarket.commandbypass - 当启用“强制玩家通过经纪人交易”的限制时，拥有此权限的玩家可以绕过该限制。

⭐命令

命令别名：/sm, /stock, /stocks

• /stockmarket 或 /stockmarket help - 显示可配置的帮助信息。
• /stockmarket list - 权限：stockmarket.list - 显示热门股票的 GUI 界面。
• /stockmarket tutorial - 权限：stockmarket.tutorial - 显示教程 GUI。
• /stockmarket lookup {symbol} - 权限：stockmarket.lookup - 查询指定股票。
• /stockmarket compare {symbol1,symbol2,...} - 权限：stockmarket.compare - 比较一系列股票。
• /stockmarket portfolio - 权限：stockmarket.portfolio - 查看自己的投资组合。
• /stockmarket portfolio {player} - 权限：stockmarket.portfolio.other - 查看其他玩家的投资组合。
• /stockmarket transactions - 权限：stockmarket.transactions - 查看自己的交易历史。
• /stockmarket transactions {player} - 权限：stockmarket.transactions.other - 查看其他玩家的交易历史。
• /stockmarket history - 权限：stockmarket.history - 查看服务器最近的 100 条交易记录。
• /stockmarket history {symbol} - 权限：stockmarket.history - 查看指定股票的交易历史。
• /stockmarket buy {symbol} {数量，可选，默认为1} - 购买指定数量的股票。
• /stockmarket sell {symbol} {数量，可选，默认为1} - 出售指定数量的股票。
• /stockmarket spawnsimplebroker - 权限：stockmarket.spawnbroker - 在执行者位置生成一个简单经纪人（打开股票列表界面）。

❓配置与支持

如果需要更新配置文件，最新版本可以在此处找到

https://github.com/maldahleh/mc-stockmarket/blob/master/src/main/resources/config.yml

配置文件本身应易于理解，如有任何问题，欢迎发帖或私信我，我会尽快回复。

注意事项

• 本插件目前处于测试版，可能存在漏洞。如有任何问题或建议，请私信我或在讨论区发帖，我会尽量在 12-24 小时内回复。
• 我欢迎所有功能建议，请随时提出你的想法。

✨开发者信息

可监听的事件

• StockPurchaseEvent - 当玩家购买股票时触发。
• StockSaleEvent - 当玩家出售股票时触发。

可调用的 API 方法

• getPortfolioValue(UUID uuid) - 获取指定玩家的投资组合价值。
• getProfitMargin(UUID uuid) - 获取指定玩家的利润率。
• getPlayerStocks(UUID uuid) - 获取指定玩家持有的股票。

特别鸣谢

• Java Profiler