• [ForSale – Player command. Prompts for a target, then opens the price-entry gump.
• [NotForSale – Player command. Removes the For Sale flag from a targeted item.
• [Purchase – Player command. Targets an item flagged For Sale and opens the confirmation gump.
• [Buy – Alias of [Purchase.
• [Preview – Player command. Currently only previews Ethereal Body Modifications and Walking Effect Deeds; other items are rejected with the message “This currently only works on Ethereal Body Mods. More coming soon!”
• [ForDonation – Administrator-only. Marks an item for sale in the alternate currency mode (Sosarian Dollars / Sosarian Scrolls; see Currencies below).
• [ShopSetPrice <amount> – Administrator-only. Re-prices an existing listing on the targeted item.
• [ShopSetUses <currency> – Administrator-only. Switches the currency on an existing listing. Accepted tokens: gold, gpp/gameplaypoints, es (Sosarian Dollars), rp/referralpoints, daily/dailypoints, pvm/pvmpoints.

When you run [ForSale you will be prompted to target an item:

• The target must be an item.
• Players must target an item inside their own backpack. Staff are exempt from this restriction.
• The price-entry gump opens, showing the item's name, a single “Price” text field, and the notice: “Setting the item for sale allows players to purchase it by using the [purchase command.”

On confirmation (“Set For Sale”):

• Empty input is rejected: “You must enter a price. To make the item free, use 0.”
• Input longer than 16 characters is rejected: “This item is priced far too high. Try again.”
• Non-integer input is rejected: “Price must be a number.”
• A valid integer flags the item as For Sale and blocks normal use of the item while the listing is active.

Once listed, the item shows a “Sale” tooltip on mouseover:

Price: <formatted price> <currency label>
Target With "[Purchase" Command

If the entered price is 0 or less, the item is tagged “Free” instead and no “Sale” tooltip is generated.

[NotForSale clears the listing. As with listing, players must target an item inside their own backpack; administrators are exempt.

Clearing a listing removes:

• Any “Sale”, “SaleDescription”, “GoldRaffleDescription”, “OnSale”, or “LimitedItem” tooltip from the item.
• All For Sale and use-block flags on the item.

[Purchase (or [Buy) prompts you to target an item. If the targeted item is flagged For Sale, the confirmation gump opens; otherwise you see “That is not marked as For Sale.”

The gump displays:

• The title “Purchase <item name>?” (or “Purchase this item?” when the item has no name).
• An item icon (a placeholder graphic; the item's actual art is not used directly).
• “Price: <formatted price> <currency>” where the currency is selected in this priority order: Daily Points, Referral Points, PvM Points, Gameplay Points, Gold, otherwise Sosarian Scrolls. (Note: the listing's mouseover tooltip labels the non-gold/non-points fallback as “Sosarian Dollars” rather than “Sosarian Scrolls”.)
• The listing's description, or “No description available.” if none was set.
• Two radio buttons (“yes”/“no”) and a confirm button.

If the listing has an “On Sale” price set, that overrides the base price. If an “On Sale” percentage is set instead, that percentage is subtracted from the base price.

Before any funds change hands, the system runs the following checks in order:

• The item must still be visible.
• If the listing has an expiration set and the end time has passed, the item is hidden and you are told: “The sale of this particular item has expired, check back soon!”
• If the listing has a stock limit and the number sold has reached it, the item is hidden and you are told: “This particular item is sold out, check back soon!”
• PvM rank and/or minimum-kill requirements are checked against your PvM record.
• Race gates: Gargoyle Only, Human Only, Elf Only, Gargoyles Not Allowed, Humans Not Allowed. (Elf-Not-Allowed and Reds-Only flags exist on listings but are not enforced at purchase time.)
• Young Player gates: Young Not Allowed / Young Only.
• Reds Not Allowed: blocks players with 5 or more kills.
• Karma and Fame requirements: a positive value sets a minimum required Karma or Fame.
• Luck requirement: a minimum Luck value is required.

Currency handling depends on which currency the listing uses:

• Gold:
  • The price is withdrawn from your bank. If you do not have enough, you see: “You do not have enough funds in your bank to cover this purchase.”
  • For a normal player-to-player sale, the seller is credited the full price (see Service / Commission Fee note below) into their bank box. A Knives' Chat message is added to the seller's inbox: “Sale Completed – Your item has sold via the [forsale command. <price> gold has been placed in your bank box.” The item is unlocked/unsecured if needed, made movable, and moved into your backpack. The listing is then cleared. The transaction is also posted to a Discord channel tagged “The Gold Shop”.
  • For an administrator stock listing (one that sells duplicates), a fresh copy of the item is created and placed either in your bank (if the listing is flagged to drop in bank and you have a bank box) or in your backpack. The listing's Number Sold, Gross Earnings, and Last Sold On are updated, and the listing itself is not cleared.
• Gameplay Points: Requires Gameplay Points >= price; deducted on purchase. The item is delivered as a gift copy.
• Referral Points: Requires Referral Points Available >= price; both Available and Spent totals are updated.
• PvM Credits: Requires PvM Credits >= price; deducted on purchase.
• Daily Points: Requires Daily Points >= price; deducted on purchase.
• Sosarian Dollars (default for administrator listings): The price is consumed in Sosarian Coins from your backpack. After a successful purchase the Gold Raffle prize pool is increased – by the listing's “Adds Gold To Gold Raffle” value if set, otherwise by price * 20000. If the price is 100 or more, a Gift Box of bonus items is added to your backpack, with tiered contents at thresholds 100, 400, 1000, and 2000.

The bonus Gift Box (“Bonus Reward For Purchasing Items In Store”) only drops on Sosarian Dollars purchases. Gold and points purchases do not produce a bonus box.

A service fee of 5% is intended for gold sales, and 0% for other currencies. In the current build, however, the fee value is not actually applied to new listings – a freshly created listing records a fee of 0.0, so the gold seller receives the full price with no commission deducted.

Staff can configure a wide range of optional flags on a listing. Selected attributes:

• Seller, Price, Gold-or-not, Description.
• Active, Sells Duplicate, Drops In Bank, Donation Mode.
• On Sale Price, On Sale Percentage Off (discount overrides).
• Expires + Scheduled End Date/Time (timed listings).
• Limited To Sell, Number Sold, Last Sold On (stock counter, shown as “Limited Item: N/M Sold”).
• Gross Earnings (total currency taken in over the lifetime of the listing).
• Adds Gold To Gold Raffle (bonus contribution per sale in the Sosarian Dollars branch).
• Comes In Gift Box / Comes In Gift Box Hue (persisted on the listing but not currently used during purchase).
• Race / age / karma / fame / luck / PvM rank gates (see Eligibility Check).

• Currencies (Gold, Sosarian Dollars, Sosarian Scrolls, Gameplay Points, Referral Points, PvM Credits, Daily Points)
• Gold Raffle
• Knives' Chat inbox messages