Commands

Player Shops Commands

Player Commands - /ksshop

Aliases: /shop, /market

Shop management

Command	Description
/ksshop help	Short getting-started hint + command list
/ksshop create <name>	Create a new player shop at your position. Costs playerShops.creationCost
/ksshop edit	Open the drag-and-drop editor for the nearest owned shop
/ksshop delete <nameOrId> [confirm]	Delete an owned shop. Two-step confirm; items + balance go to mailbox
/ksshop open <nameOrId>	Set shop to open (visible to buyers)
/ksshop close <nameOrId>	Set shop to closed. NPC stays visible with [CLOSED] suffix
/ksshop rename <newName>	Rename the nearest owned shop (auto-resolved by proximity)
/ksshop myshops	Open the directory in “your shops” mode (no listing filter)

Customer flow

Command	Description
/ksshop browse	Open the public directory with cards, filters, sort, pagination
/ksshop search <query>	Item or shop-name search. Opens directory in search mode
/ksshop visit <nameOrId>	Open browse view of a specific shop directly
/ksshop rate <nameOrId> <stars>	Rate a shop 1..5 stars

Earnings

Command	Description
/ksshop collect	Collect any pending shop balance to your account
/ksshop deposit <amount>	Add funds to the nearest owned shop’s buyback pool
/ksshop history	Transaction log for your shops
/ksshop notifications	List your stored notifications
/ksshop stats	Aggregate stats: shops owned, total revenue, tax, sales, avg rating

Transfer

Command	Description
/ksshop transfer <nameOrId> <playerName>	Send a transfer request to another online player
/ksshop accepttransfer	Accept a pending incoming transfer
/ksshop declinetransfer	Decline a pending incoming transfer

Listing

Command	Description
/ksshop list <days>	Buy or extend the directory listing for the nearest owned shop

Rentals

Command	Description
/ksshop myrentals	Open self-service page for your rentals (extend, release early)
/ksshop releaserental <slotId>	Release a rental slot early. Items mailed back, gold refund per config
/ksshop rentalstations	Browse rental slots in your current world

Argument types

• <nameOrId> accepts both UUID and case-insensitive shop name - simpler to use names in chat
• <slotId> requires UUID. Find via /kssa listrentals

---

Admin Commands - /kssa

Alias: /ksshopadmin. All require the ks.shop.admin permission.

Shop management

Command	Description
/kssa admin	Open the admin panel UI (tabs: Shops, Players, Transactions, Rentals)
/kssa createadmin <title>	Create an admin shop at your position. No owner, unlimited stock
/kssa editadmin	Edit the nearest admin shop (drag-and-drop, no owner check)
/kssa deleteadmin <shopId>	Delete an admin shop. UUID only
/kssa deleteplayer <shopId>	Force-delete a player shop. Owner gets mailbox refund
/kssa closeplayer <shopId> [reason]	Force-close a player shop. Optional reason text
/kssa openplayer <shopId>	Re-open a force-closed player shop
/kssa settax <percent>	Live-adjust both buy + sell tax percent. Persists to config
/kssa feature <shopId> <days>	Mark a shop as Featured for N days
/kssa stats	Server-wide shop stats
/kssa log	Recent admin audit log
/kssa blacklist <add|remove|list> [itemId]	Manage item blacklist
/kssa reload	Reload config + i18n without restart

NPC management

Command	Description
/kssa respawnnpcs	Despawn + respawn all shop NPCs in current world (recovery)
/kssa deletenearest	Delete the nearest shop + its NPC

Rental stations

Command	Description
/kssa createrental <displayName> [pricePerDay] [maxDays]	Create a fixed-price rental slot at your position
/kssa createrentalauction <displayName> [minBid] [bidIncrement] [durationMinutes] [rentalDays]	Create an auction-mode slot, starts the first round immediately
/kssa deleterental <slotId>	Delete a slot. Active renter gets full mailbox refund
/kssa listrentals	List all rental slots in your current world (chat output with UUIDs)
/kssa forceexpirerental <slotId>	Run the normal expiry path immediately. Auction slots auto-rearm if onEmptyAuction = RESTART

---

Examples

Create a shop, fill it, set it up

/ksshop create FoodCorner
/ksshop edit
   (drag bread + apples + carrots into shop slots)
   (in Pricing tab: set buy price 5, daily quota 64, stock 200, mode Buy)
   (Save)
/ksshop list 7

Buy out a closed shop

/ksshop visit FoodCorner
   (closed - "Shop is closed" message)

(later, after owner re-opens:)
/ksshop visit FoodCorner
   (browse opens, pick item, click, confirm quantity)

Run an auction for a hotspot slot

/kssa createrentalauction MarketSquare 1000 50 60 14
   ^ minBid=1000g, +50g step, 60min auction, 14d rental

Force-clean a slot (test or admin override)

/kssa listrentals
   (note slot UUID)
/kssa forceexpirerental <uuid>
   (renter gets mailbox refund + slot becomes vacant immediately)