Admin Panel

Admin Panel

Open with /kssa admin (requires ks.shop.admin).

The panel is a tabbed UI with four sections.

---

Shops tab

Server-wide shop list with search + filters.

• Search field — partial match on shop name (case-insensitive)
• Filter buttons — toggle visibility:
  • ALL — every shop
  • PLAYER — only player-owned
  • ADMIN — only admin shops
  • OPEN — only currently open
• Pagination — 10 rows per page, prev/next buttons

Per row: shop name, type badge, owner name, rating, item count, status. Click a row to drill into shop details (planned), or use chat commands for actions.

Players tab

Per-player roll-up.

• Player name, total shops owned, total revenue, last seen
• Useful for monitoring marketplace concentration (“who owns 30 shops?”)

Transactions tab

Recent buy/sell history server-wide.

• Buyer / seller, item, quantity, total, timestamp
• Filter by shop name, item, or time window

Useful for forensics (“did this player exploit a price?”).

Rentals tab

Full rental-slot management.

• Search field — partial match on slot display name
• Filter buttons:
  • ALL — every slot
  • VACANT — currently no renter
  • AUCTION — auction round running
  • RENTED — actively rented
• Pagination — 8 rows per page

Per row:

• Slot name + mode badge (FIXED green / AUCTION gold)
• State + renter username + remaining time, OR auction ends-in
• Price/day or current high bid

Per-row actions:

• EXPIRE (orange) — runs the normal expiry path immediately. For a rented slot: renter gets mailbox refund, slot becomes vacant. For an auction slot in a round: forces a finalisation as if auction_ends_at had elapsed
• DELETE (red) — removes the slot entirely. If currently rented, refunds the renter via the normal expiry path first

---

Common admin workflows

Force-close an abusive shop

1. Open admin panel -> Shops tab
2. Search for the shop name, note its UUID
3. Chat: /kssa closeplayer <shopId> Reason: economy abuse
4. Owner can no longer sell. Shop nameplate shows [CLOSED].

Refund + delete a player’s shop

/kssa deleteplayer <shopId>

Owner gets all items + balance via mailbox. NPC despawns. Shop row deleted.

Take over a hot spot for a server event

/kssa forceexpirerental <slotId>     -> tenant gets refund
/kssa deleterental <slotId>           -> slot removed entirely
/kssa createrental NewEventSlot 0 1   -> 0g/day for 1 day, free for the event

Audit recent activity

1. /kssa admin -> Transactions tab
2. Filter by time window
3. Look for outliers (very high prices, repeated identical sales, etc.)

Bulk-respawn stuck NPCs after a chunk corruption

/kssa respawnnpcs

Despawns all tracked NPCs in the current world, then respawns them from the persisted shop data. Recovers from chunk-restored ghost NPCs without a full server restart.