鹅卵石市场

鹅卵石市场

CobbleMarket是一个用于Cobblemon（Fabric）的玩家间交易市场模组。

CobbleMarket —— 面向宝可梦服务器的一款玩家间交易市场模组

Minecraft Fabric

CobbleMarket 是一款用于 Cobblemon（Fabric）的玩家间交易市场模组。 玩家可以从自己的队伍或电脑中上架宝可梦，以及从物品栏中上架物品， 供整个服务器浏览、筛选和购买。它附带一整套完整的市场工具链：上架费用、自动到期退回、卖家待领取余额、封禁与黑名单管理，以及交易历史审计。

  • Minecraft 版本：1.21.1 (Fabric)
  • 依赖：Fabric API、Fabric Language Kotlin、Cobblemon ≥ 1.7.0
  • 可选依赖：CobbleDollars（虚拟货币）、Cobblemon Smartphone（游戏内应用入口）
  • 许可证：MIT

该模组目前处于 Beta 阶段。所有功能均可正常使用，但仍可能存在未知问题。在推广到正式服务器之前，请先在测试服务器上进行测试。

1. 打开市场

有三种方式可以打开市场：

  • 快捷键 K：默认按键，可在 设置 → 按键绑定 → "打开市场" 中重新绑定
  • 指令：/market gui
  • Cobblemon 智能手机：如果安装了智能手机模组，市场入口会自动出现在游戏内的应用列表中

image

2. 市场入口界面

入口界面提供以下按钮：

  • 宝可梦市场：进入宝可梦交易市场
  • 物品市场：进入物品交易市场
  • 交易记录：查看自己的交易记录
  • 管理面板：仅限 OP（权限等级 ≥ 2）

image

3. 宝可梦市场主界面

主界面分页列出服务器上所有活跃的宝可梦上架信息。点击"▼ 筛选"可展开完整的筛选面板。

image

3.1 筛选面板

筛选条件可以自由组合：

  • 名称搜索：按宝可梦种类名称或 ID 进行模糊匹配
  • 闪光开关：仅显示闪光宝可梦
  • 性别：任意 / 雄性 / 雌性
  • 属性：按属性筛选（主要属性或次要属性）
  • 个体值：对六项个体值（HP/攻击/防御/特攻/特防/速度）进行精确匹配；留空则忽略
  • 排序：价格 ↑ / 价格 ↓ / 等级 ↑ / 等级 ↓ / 最新上架
  • 我的：仅显示自己上架的物品

3.2 上架信息提示

将鼠标悬停在任一上架物品上即可查看宝可梦的详细信息：属性、精灵球、性格、特性、个体值、携带物品、卖家及价格。

3.3 购买

点击上架物品旁的"购买"按钮，打开确认界面，显示等级和价格。确认后，将扣除货币并把宝可梦加入你的队伍（如果队伍已满，则会自动转移至电脑）。

3.4 待领取余额与到期退回

主界面顶部显示你的待领取余额；点击"领取"即可提取。已到期的上架物品会进入"到期退回"列表，可随时领取（如果存储空间已满，剩余部分将保留，可在之后领取）。

4. 上架宝可梦

在主界面点击"出售"按钮，打开选择界面：

  • 队伍中的宝可梦固定在顶部（标记为 [队伍]）；电脑中的宝可梦在下方加载并支持翻页（标记为 [电脑]）
  • 提供搜索、闪光和属性筛选功能
  • 选择一只宝可梦，输入价格，确认后即可上架
  • 上架时会收取可配置的上架费用（默认 5%）
  • 上架物品在默认 14 天后过期（可配置），并自动进入退回列表——任何物品都不会丢失
  • 队伍中必须至少保留一只宝可梦
  • 每位玩家活跃上架数量受配置上限限制（默认：无限制）

5. 物品市场

物品市场的机制与宝可梦市场类似：

  • 按名称搜索物品
  • 可购买任意数量：买家选择数量（不超过上架库存）；上架物品会保留，直至剩余库存售完
  • 批量出售：一条上架记录可放置一组相同的物品（例如 64 个钻石）；买家可分批次购买
  • 取消与取回：卖家可随时取消上架，物品将退回其物品栏

image

6. 到期退回

到期的上架物品绝不会丢失——它们会进入你的"到期退回"列表：

  • 宝可梦上架：一键领取；宝可梦会返回你的队伍（如果队伍已满，则进入电脑）
  • 物品上架：一键领取；物品会返回你的物品栏
  • 支持部分领取：当存储空间已满时，可领取能容纳的部分，剩余部分将保留
  • 退回物品默认保留 30 天（可配置；0 = 永久保留）。逾期未领取的退回物品将被永久删除——请及时领取！

7. 交易记录与审计

  • 游戏内记录界面：记录五种事件类型——已上架、已售出、已购买、已取消、已退回；可查看自己的记录
  • 完整记录（仅限 OP）：审计服务器上的每一笔交易
  • CSV 日志：每笔交易都会追加到 config/cobblemarket/history/ 目录下的 CSV 文件中（同时包含 zh_cn 和 en_us 两份副本）；"打开文件夹"按钮可直接跳转至该目录

image

8. 管理面板（仅限 OP）

权限等级 ≥ 2 的玩家可以看到"管理面板"入口，其中包含：

  • 所有宝可梦上架：浏览并强制取消任何玩家的宝可梦上架（支持按卖家搜索）
  • 所有物品上架：浏览并强制取消任何玩家的物品上架
  • 封禁管理：封禁/解封玩家交易权限（见第 9 节）
  • 完整交易记录：全服审计
  • 宝可梦黑名单 / 物品黑名单：管理禁止交易的种类/物品（见第 10 节）

9. 封禁系统

管理员可以通过指令或管理面板封禁玩家的交易权限：

  • 指令：/market ban <玩家> [时长] [原因] 时长格式：7d（天）、12h（小时）、30m（分钟），可组合使用（例如 1d12h）；不填时长 = 永久封禁
  • 解封：/market unban <玩家>
  • 封禁列表：/market banlist
  • 封禁仅限制交易行为（上架、购买）；绝不会冻结资产：被封禁的玩家仍然可以取消自己的上架、领取退回物品以及提取余额

10. 黑名单系统

黑名单用于禁止特定种类/物品进入市场。它们会立即生效——已被列入黑名单的内容，即使已有上架也无法再被购买。

10.1 宝可梦黑名单

通过以下条件组合限制：

  • 种类：输入宝可梦种类名称或 ID
  • 个体值：六个可选个体值字段；留空 = 忽略
  • 形态：所有形态 / 默认形态 / 特定形态（阿罗拉、伽勒尔、洗翠、帕底亚、季节形态等）

image

10.2 物品黑名单

按名称或 ID 添加物品，支持模糊匹配选择。

image

11. 指令

/market gui 打开市场入口界面 /market ban <玩家> 永久封禁玩家的交易权限（OP） /market ban <玩家> <时长> 限时封禁，例如 7d / 12h / 30m /market ban <玩家> <时长> <原因> 限时封禁并附带原因 /market unban <玩家> 解封玩家 /market banlist 列出所有生效中的封禁

12. 配置

配置文件：config/cobblemarket.json（首次启动时生成）

配置项 默认值 说明
currency.cobbledollars auto 使用 CobbleDollars 货币（安装该模组时自动启用）
currency.item minecraft:diamond 物品货币 ID（未使用 CobbleDollars 时启用）
pokemonListingFeePercent 5.0 宝可梦上架费用百分比（0 = 无费用）
itemListingFeePercent 5.0 物品上架费用百分比（0 = 无费用）
maxPokemonListingsPerPlayer 0 每位玩家最大活跃宝可梦上架数（0 = 无限制）
maxItemListingsPerPlayer 0 每位玩家最大活跃物品上架数（0 = 无限制）
listingDurationDays 14 上架物品过期天数
pendingReturnRetentionDays 30 未领取退回物品的保留天数；逾期将被永久删除（0 = 永久保留）

13. 经济系统

  • 货币：默认使用钻石，可配置为任意物品；如果安装了 CobbleDollars，则会自动使用其作为虚拟货币，无需占用物品栏空间
  • 费用：在上架时向卖家收取（按百分比）；买家支付标价
  • 待领取余额：销售所得进入卖家的待领取余额，需手动领取；即使物品栏已满也绝不会损失金钱——剩余金额会保留在账本上，直到有空间可以领取
  • 离线收益：离线期间获得的收益将在下次登录时通知
  • 防损失保障：任何无法发放的退款或找零（如物品栏已满等）都会转入待领取余额账本——玩家的金钱绝不会被无声销毁

14. 数据安全

市场数据（上架、余额、记录）存储在 world/data/cobblemarket*.dat 中。该模组内置存档自修复系统：

  • 启动时自动校验：每次启动都会验证文件完整性；损坏的文件会自动从 .bak 备份中恢复（仅丢失自上次备份以来的更改）
  • 损坏文件保留：若没有可用备份，损坏的文件会保留为 .dat.corrupt 以供手动恢复，服务器将使用全新数据启动
  • 日志信息：请留意服务器日志中的"已从备份恢复"（已恢复）或"已保留为 .corrupt"（需要手动处理）提示

15. 常见问题

问：购买界面提示"你的队伍和电脑都已满"？ 答：请腾出队伍/电脑空间后再次购买。如果已扣除金钱，系统会自动退款或将其转入你的待领取余额——绝不会丢失。

问：被封禁的玩家还能拿回自己的上架物品吗？ 答：可以。封禁仅限制交易行为（上架、购买）。取消上架、领取退回物品和提取余额始终允许。

问：我可以购买物品上架记录中的一部分吗？ 答：可以。选择所需数量即可；上架记录会保留，剩余库存继续出售。

问：如何防止违禁内容进入市场？ 答：使用管理面板的黑名单：宝可梦黑名单支持"种类+个体值+形态"组合，物品黑名单按物品 ID 操作。两者都会立即生效，包括对已有上架记录。

问：交易记录保存多长时间？ 答：游戏内保留最近 200 条记录；CSV 日志按日期归档在 config/cobblemarket/history/ 下，用于长期留存。