プレイヤーマーケット：取引とオークション

プレイヤーに見えるもの

• タブ：マーケット、出品中、入札中、直接トレード、受け取り待ち、履歴。
• 最安値付きでまとめたアイテム。1つのアイテムの出品は安い順。
• 出品：アイテム、出品かオークション、価格、期間、手数料を選びます。
• 次の最低入札額が出る入札、直接トレードの承認や拒否。

仕組み

• 売れるのは取引可能なアイテムだけで、装着中のものは決して売れません。
• 価格は、ダッシュボードで決めたプレイヤー間で取引できる通貨で付けます。
• サーバーがエスクローを預かってすべての取引を精算し、手数料は取引時に差し引かれます。

開発者向け

マーケットは @idosgames/core の client.marketplace で動きます。

// マーケット：最安値でまとめたアイテムを取り、出品を1つ購入する
const market = await client.marketplace.getGroupedOffers()
const res = await client.marketplace.buy(offerID)
if (!res.ok) return showError(res.error)

• 入札額は、サーバーが示す次の最低入札額以上である必要があります。
• 終わったオークションや戻ってきたアイテムは claimAuction と claimBack で受け取ります。

すべてのフィールドは、SDK の MCP サーバーが配るスキル marketplace-system に説明があります。