Helios Documentation Portal

Market & Shop

Owner guide for product catalog, inventory, and market setup.

Overview

Market and Shop combine category/product management, player inventory (/bag), and market trading (/market).

Video Tutorials

Shop Setup

Watch on YouTube

Easy Shop Setup

Watch on YouTube

Keys & Chests

Watch on YouTube

Who This Is For

  • Owners setting economy governance
  • Admins building product catalogs
  • Moderators supporting purchase issues

Requirements

  • Economy configured (/economy, /set currency)
  • Shop and Market toggles enabled in /settings server
  • Linked accounts for wallet/bag flows
  • Premium for market and expanded limits

Setup

  1. Enable Shop and Market in /settings server.
  2. Create category structure with /category add.
  3. Add products with /product add, /product add-item, or /product add-cmd.
  4. Validate player flow in /shop and /bag.
  5. Validate listing/purchase behavior in /market.

Commands or Controls

/settings server
/category add|edit|remove
/product add|add-item|add-cmd|edit|remove|info|cooldown-reset
/shop
/bag
/market
/set inventory-limit

Chest and Treasure System

Chest and Treasure controls are part of the premium inventory ecosystem and are used for case-battle and loot reward flows.

Recommended Rollout

  1. Create chest types first with /chest add.
  2. Add weighted treasure rewards with /treasure add.
  3. Validate reward pools with /treasure list.
  4. Run a controlled test case battle with /battle chest.
  5. Publish drop-rate policy to staff before public rollout.

Chest and Treasure Commands

/chest add|edit|list|remove
/treasure add|edit|list|remove
/battle chest

Guardrails

  • Treat high-value rewards as approval-gated changes.
  • Keep chest images and names consistent with your category naming conventions.
  • Re-test weights after each major economy change or wipe.

Example Use Case

/category add name:"Weapons"
/product add-item category:"Weapons" name:"Pistol" item:"pistol.revolver" price:250 server:"US Main"
/shop category:"Weapons" server:"US Main"

Common Issues

Problem

Players cannot open market or create listings.

Likely Cause

Premium not active, or Market toggle disabled.

Fix

Run /premium status and recheck /settings server toggles.

Prevention

Include premium + toggle checks in owner launch checklist.

Tips / Best Practices

  • Free tier supports 1 category and 10 products in that category.
  • Market has a 19-listing cap and 24-hour listing expiration.
  • Review high-value products and cooldowns weekly to reduce abuse.