适用源码：9da0beb8e8fdad85f50d7039408c3d98494e91c7；内容核实：2026-11-02。
开发状态：本文列举能力有源码证据；设计状态：未决规则单列；验证状态：仅定向源码核对，未执行自动测试或实服验收。默认值不代表生产配置。文档获准发布不表示技术问题已经解决。

入口与资格

普通玩家从交易所核心进入市场 Dialog，使用交易大厅、创建订单、我的订单和领取暂存；交易所受设施使用权限、Towny 地块与访问规则约束。/sellgui（别名 /sellwindow、/marketgui）打开出售窗口，需要 flrv.market.use，插件声明默认 true。/market、/mkt 要求 flrv.market.admin，默认 OP，不是普通玩家通用入口。

订单与物品

只支持按 Material 和数量记录的普通原版物品，不支持附魔、改名、自定义模型等复杂装备；不能与自己订单成交。玩家主动选择挂单执行，不是自动撮合平台。

浏览交易大厅、进入详情、选择数量、核对总支出或净收益再确认。不要把界面预览当作成交完成凭证。UI 限制不代表所有接口统一上限。

配送费用

令数量 n、单价 p、同世界 X/Z 区块欧氏距离 d、免费半径 r、费率 k。d≤r 时 F=0，否则 F=n×d×k；超出后计完整距离，不减 r、不向下取整。跨世界或位置无法确定时使用配置距离 D，F=n×D×k。

仓库默认 r=3、k=0.2、D=400；例如 d=4、n=10，F=8。单位及实际参数以服务器为准。购买卖单支出 np+F；向买单出售净收益 np−F，负数需要补付差额。费用按订单记录区块与执行者当前位置计算，订单世界无法取得时存在位置回退；以确认界面和实际结果核对。市场配送费不同于驿站运费。

接收与订单管理

购买卖单需要背包容纳本次全部物品，不会因满包自动改投邮箱。向买单交货时，正常路径向在线且有空间的买家发货，否则写入市场暂存；领取暂存逐条检查容量。

交易所 UI 尚无完整取消、改价及取回 STORED 物品入口；相关命令受管理员命令权限及资产本人归属约束。取消卖单正常路径将剩余托管物转回 STORED，不直接放回背包；取消买单尝试退还剩余托管资金。

已知限制与异常处理

**当前结算、交付和补发的一致性仍需完善与验证。不能保证异常后必然自动退款、补发必达或反复提交无风险。**系统有 SQL 回滚、邮箱和付款补发，但不能把这些机制理解为所有外部资产操作的完整保证。

发生失败、断线或结果不明时停止重复操作，保留时间、订单标识、数量和提示，联系管理人员核对。不要尝试自行删除记录或以其他交易抵消未知结果。

来源与继续阅读

路径均相对仓库根：folia_plugin/src/main/resources/plugin.yml及config.yml；docs/玩家与设施指南.md市场章节。代码根 folia_plugin/src/main/java/com/flrv/：logic/market/DeliveryPricing.java#quote、logic/market/service/MarketOrderExecutionService.java、MarketOrderService.java、MarketMailboxService.java（同 service 目录）。
阅读：资产常见问题、银行与存储区别。