| API | 参数 | 返回值 | 用途说明 |
|---|---|---|---|
GetPlayerListings(ulong playerId) | 玩家SteamID | List<Dict> 含 OwnerID, Grid, OriginalPrice, CurrentPrice, ExpiryTime | 查询指定玩家当前正在出售中的所有房源 |
GetPlayerSoldHistory(ulong playerId) | 玩家SteamID | List<Dict> 含 OwnerID, Grid, OriginalPrice, SoldPrice, BuyerID, Time | 查询指定玩家的所有已售记录 |
HasPlayerBoughtFrom(ulong buyerId, ulong ownerId) | 买家ID, 卖家ID | bool true=购买过, false=未购买过 | 检查某玩家是否购买过另一玩家的建筑 |
IsPlayerBuildingForSale(BasePlayer player) | 玩家对象 | null=玩家不在领地柜授权范围内, true=当前所在建筑正在出售, false=不在售 | 检查玩家当前脚下建筑是否在售中,需要玩家在领地柜授权范围内才能判断 |
IsPlayerBuildingPurchased(BasePlayer player) | 玩家对象 | null=不在领地柜授权范围, false=非购买所得, Dict{IsPurchased, SourceType, SellerID}=购买所得 | 检查玩家当前所在建筑是否通过购买获得 |
| Hook | 参数 | 触发时机 |
|---|---|---|
| OnPlayerHouseListed | ownerID, grid, price, expiryDays | 玩家挂牌出售 |
| OnSystemHouseListed | ownerID, grid, price, expiryDays | 系统挂牌出售 |
| OnPlayerHouseCancelled | ownerID, grid, originalPrice | 玩家取消/拾取/摧毁告示牌 |
| OnPlayerBuyPlayerHouse | buyerID, ownerID, grid, originalPrice, soldPrice | 买玩家建筑 |
| OnPlayerBuySystemHouse | buyerID, grid, originalPrice, soldPrice | 买系统建筑 |
| OnPlayerBuyNewbieHouse | buyerID, grid, originalPrice, soldPrice | 买萌新建筑 |
| OnPlayerHouseTransferred | oldOwnerID, newOwnerID, cupNetId, grid | 玩家建筑过户完成 |
| OnPlayerHouseCollect | playerID, amount | 提款 |
| OnPlayerTeleportPlayerHouse | playerID, ownerID, grid | 传送到玩家建筑 |
| OnPlayerTeleportSystemHouse | playerID, grid | 传送到系统建筑 |
| OnPlayerTeleportNewbieHouse | playerID, grid | 传送到萌新建筑 |