Ore Market - 矿石股票市场

💡OreMarket 矿石市场插件

OreMarket 是一个模拟动态市场的插件，允许玩家买卖矿石。矿石的价值会根据供需关系实时波动，为你的服务器增添独特的经济体验。

🎮配置文件详解

config.yml

主要配置文件，用于控制市场核心机制。

基础设置

• prefix: 插件消息前缀，默认为 &bOreMarket
• tax: 交易税 (%)，默认为 10。每次买卖都会按此比例加税。
• multiplier: 价值波动乘数 (%)，默认为 0.01。此值决定了每次交易后矿石价值变化的幅度。服务器规模越大，建议将此值调低。

价值广播消息

• valuemessage.time: 广播矿石当前价值的间隔时间（分钟），默认为 5。
• valuemessage.format: 广播消息的格式。支持以下变量：

- `[name]`: 矿石名称

- `[value]`: 当前价值

- `[change]`: 价值变化量

- `[percent]`: 价值变化百分比

- `[cost]`: 原始成本

- `[stock]`: 剩余库存

市场崩溃事件（实验性功能）

• marketcrash.enabled: 是否启用市场崩溃事件，默认为 false。建议在服务器人数较多时禁用。
• marketcrash.time: 事件触发间隔（小时），默认为 8。
• marketcrash.amount: 矿石价值下跌的最大百分比，默认为 80。
• marketcrash.message: 崩溃事件发生时的广播消息。支持 [amount] 变量。

gui.yml

用于自定义插件的图形用户界面 (GUI)。

GUI 布局

• gui.title: GUI 窗口的标题，默认为 &4OreMarket。
• gui.rows: GUI 的行数，默认为 3。

物品槽位配置

每个物品由其槽位编号（从 0 开始）定义。主要配置项包括：

• item: 在 GUI 中显示的 Minecraft 物品类型（如 DIAMOND, GOLD_INGOT）。
• name: 物品的显示名称。
• lore: 物品的描述文本，支持变量如 [value], [cost], [stock], [percent], [balance]。
• cost: 矿石的初始成本。
• value: 矿石的当前价值（初始应与 cost 相同）。
• stock: 矿石的初始库存量。
• commands: 点击物品时执行的命令（如 [close] 用于关闭 GUI）。
• hide: 是否隐藏物品的属性标志，通常设为 true。

预置槽位示例

• 槽位 0-2: 分别对应钻石、金锭、铁矿石的交易物品。
• 槽位 5: 放置一个名为“关闭”的屏障，点击可关闭 GUI。
• 槽位 6: 放置一个显示玩家当前余额的纸。

❓使用与提示

• 首次添加新矿石时，请确保其 cost（成本）和 value（价值）设置为相同的数值。
• 市场波动乘数 (multiplier) 的默认值 0.01 是推荐设置，可根据服务器经济活跃度调整。
• 市场崩溃是实验性功能，可能对经济造成剧烈影响，请谨慎启用。
• 如需更高级的 GUI 自定义功能，请查阅插件的 GitHub Wiki 页面。

🔧下载说明

如果页面提供的直接下载链接不可用，请点击“Source Code”（源代码）链接，前往项目的发布 (Releases) 页面下载插件的最新版本。

以下是该 Minecraft 插件的文档。

💡简介

这是一个用于管理 Minecraft 服务器中玩家背包的插件。它允许管理员查看、编辑、保存和加载任何在线或离线玩家的物品栏内容，为服务器管理和物品恢复提供了强大的工具。

🎮功能特性

• 查看玩家背包：检查在线或离线玩家的物品栏、末影箱、盔甲栏和副手物品。
• 编辑玩家物品：直接添加、移除或修改玩家背包中的物品。
• 保存与加载配置：将玩家的完整物品栏状态保存为配置文件，并可随时重新加载。
• 支持离线玩家：即使玩家不在线，也能管理其物品数据。
• 跨世界支持：无论玩家在哪个世界，都能正常使用功能。
• 权限管理：通过细致的权限节点控制命令访问。

🔧命令与权限

主要命令

所有命令都需要使用 /inv 或 /inventory 作为基础。

• /inv see <玩家名> - 查看指定玩家的背包。

- 权限: `inventory.see`

• /inv edit <玩家名> - 进入指定玩家背包的编辑模式。

- 权限: `inventory.edit`

• /inv save <配置名> <玩家名> - 将指定玩家的当前物品栏保存为一个命名的配置文件。

- 权限: `inventory.save`

• /inv load <配置名> <玩家名> - 将指定配置文件中的物品栏加载到目标玩家身上。

- 权限: `inventory.load`

• /inv list - 列出所有已保存的物品栏配置文件。

- 权限: `inventory.list`

• /inv delete <配置名> - 删除指定的物品栏配置文件。

- 权限: `inventory.delete`

• /inv reload - 重载插件的配置文件。

- 权限: `inventory.reload`

• /inv help - 显示命令帮助信息。

- 权限: `inventory.help`

权限节点总结

• inventory.see - 允许查看玩家背包。
• inventory.edit - 允许编辑玩家背包。
• inventory.save - 允许保存玩家物品栏配置。
• inventory.load - 允许加载物品栏配置到玩家。
• inventory.list - 允许列出已保存的配置。
• inventory.delete - 允许删除已保存的配置。
• inventory.reload - 允许重载插件配置。
• inventory.help - 允许查看帮助。
• inventory.* - 授予所有上述权限（管理员权限）。

✨安装与使用

安装步骤

• 确保服务器运行的是 Paper、Spigot 或兼容的 Bukkit 服务端（1.13+）。
• 将下载的 Inventory.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 插件会自动生成配置文件和文件夹。

基本使用流程

• 查看背包：使用 /inv see <玩家名> 打开一个只读的背包界面。
• 编辑背包：使用 /inv edit <玩家名> 进入编辑模式。您可以：

- 直接拖拽物品进行移动。

- 从您的光标中取出物品放入。

- 将物品拖出界面以删除。

• 保存配置：使用 /inv save <配置名> <玩家名>。配置文件将保存在 /plugins/Inventory/saves/ 目录下。
• 加载配置：使用 /inv load <配置名> <玩家名> 将保存的物品栏状态应用到玩家身上。

❓常见问题

支持离线玩家吗？

是的，插件通过直接读取玩家数据文件来支持离线玩家管理。

保存的配置文件在哪里？

所有保存的配置都位于服务器目录的 plugins/Inventory/saves/ 文件夹中，以 .yml 格式存储。

编辑时物品会实时保存吗？

是的，在编辑界面关闭时，所有更改会自动保存到玩家数据中。

支持模组物品吗？

这取决于服务端核心。在 Paper/Spigot 上，通常可以保存和加载大多数物品的序列化数据，但极度自定义的模组物品可能无法完美兼容。

⭐注意事项

• 在对玩家背包进行重大编辑（尤其是加载配置）前，建议先使用保存功能进行备份。
• 请谨慎使用 inventory.* 权限，建议根据需要分配合适的具体权限。
• 确保对插件配置文件夹 (plugins/Inventory/) 有定期备份。
• 加载配置会完全覆盖目标玩家当前的物品栏、末影箱、盔甲和副手物品。