玩家市场

Marketplace 是一个用于 Minecraft 的玩家间市场，包含物品上架、硬币钱包、手续费、过期机制以及游戏内邮箱。

功能特性

• 专用市场 GUI 中的购买 / 出售 / 邮件标签页
• 按单价和数量上架物品（支持合并上架）
• 搜索、价格范围、稀有度筛选、排序和分页
• 可配置的上架和出售手续费
• 上架物品会过期，物品会通过邮件退回
• 内置硬币钱包（初始余额、玩家转账、可选被动收入）
• 物品黑名单（ID 或标签）
• 禁止自我购买
• 语言：英语、捷克语

运行需求

• Minecraft 1.21.1
• NeoForge 21.1.x

使用方法

• 使用按键（默认为 O）或输入 /marketplace / /market 打开
• 购买： 鼠标左键 = 选择数量，鼠标右键 = 购买 1 个 → 物品将发送到邮箱
• 出售： 创建交易 → 选择物品 → 设置单价和数量 → 支付上架费
• 邮箱： 鼠标左键领取 / 鼠标右键删除

命令

别名：/marketplace、/market

玩家

• /marketplace - 打开市场
• /marketplace coins - 查看你的余额
• /marketplace coins send <玩家> <金额> - 发送硬币

管理员（权限 3+）

• /marketplace open <玩家> - 为某位玩家打开市场
• /marketplace coins <玩家> - 查看余额
• /marketplace coins add <玩家> <金额> - 增加玩家余额
• /marketplace coins set <玩家> <金额> - 设置玩家余额

配置文件

首次启动后在 config/ 目录下生成。主要选项如下：

• startingBalance - 首次加入时给予的硬币数
• dealPlacementFeePercent / dealSaleFeePercent - 上架费/出售费百分比
• dealExpireTimeHours - 交易过期时间（小时）
• maxDealsPerPlayer、priceMaxValue - 每位玩家最大上架数量、最大售价
• itemBlacklist - 例如 minecraft:bedrock 或 #minecraft:beds
• enableMarketAccessClientSide - 若设为 false，则只有管理员可为玩家打开市场
• passiveIncome.* - 可选的基于游玩时间的被动收入

集成支持

• 供其他模组使用的 API - cz.marketplace.api.MarketplaceAPI（获取/设置/存入/取出余额，格式化辅助方法）
• TAB（可选，软依赖） - 当安装了 TAB 时可使用以下占位符：
  • %marketplace_balance% - 硬币余额
  • %marketplace_balance_short% - 简短的硬币余额