Skip to content
KyuubiSoft Wiki
News & Patchnotes

Player Shops

Player Shops

Section titled “Player Shops”

kyuubisoft

A standalone NPC-based shop system for Hytale: player-owned shops, admin shops, paid directory listings, and a rental-station system with both fixed-price and auction modes.

Independent from the Core “Shop System” (token / quest-currency shop). This is the player marketplace - a separate plugin, separate database, separate economy flow.

Features

Section titled “Features”

Player Shops with Standalone NPCs

Section titled “Player Shops with Standalone NPCs”
  • /ksshop create spawns a fully interactive NPC at the player’s position
  • Each shop has its own NPC with the owner’s skin (via PlayerDB lookup)
  • NPC nameplate shows the shop name, status ([CLOSED]), or rental remaining time
  • F-key on the NPC opens the customer browse view (or the editor for the owner)

Drag-and-Drop Editor

Section titled “Drag-and-Drop Editor”
  • Multi-tab editor: Settings / Pricing / Revenue / History
  • Native ItemGrid drag from inventory + hotbar into shop slots
  • Per-slot pricing: separate buy + sell, daily quota, stock cap, mode (Buy / Sell / Both)
  • Item icons via 24-tile picker for the shop’s directory card
  • In-editor directory-listing buy / extend (slider + live cost)

Customer Browse View

Section titled “Customer Browse View”
  • 9x5 grid (45 slots) preserving the exact slot positions the owner placed items in
  • BUY / SELL mode toggle if both are configured
  • Tooltip per slot: name, price, stock (color-graded), click hint
  • Click confirms with quantity slider, then commits

Public Directory

Section titled “Public Directory”
  • /ksshop browse opens a full directory page (8 cards/page, pagination)
  • Filters: tabs (All / Player / Admin / Featured), category, rating, sort
  • Item search across all listed shops (/ksshop search <query>)
  • Cards show shop avatar, owner, rating, item count, distance, listing remaining time

Rental Stations

Section titled “Rental Stations”
  • Admins place persistent leasable shop slots at fixed positions
  • Fixed mode: pay price * days for exclusive use
  • Auction mode: timed bidding rounds, anti-sniping, auto-restart between rounds
  • Vacant-slot NPC + nameplate signal availability without F-key
  • Self-service for renters: extend, release-early, view remaining time

Mailbox Integration

Section titled “Mailbox Integration”
  • Items + balance from expired rentals mailed back to the renter
  • Offline sales accumulate in the owner’s mailbox until they collect

Multi-Language Support

Section titled “Multi-Language Support”
  • 9 shipped languages: en, de, fr, es, pt, ru, pl, tr, it
  • Versioned migration system bumps per-locale files when keys change

Admin Tools

Section titled “Admin Tools”
  • Full admin panel: shops, players, transactions, rentals tabs
  • Force-close, delete, feature, settax, item blacklist
  • /kssa respawnnpcs recovers stuck NPCs without restart
Section titled “Quick Links”