| |
| for-sale-system [2026/05/23 09:58] – created - external edit 127.0.0.1 | for-sale-system [2026/10/10 11:21] (current) – Plain punctuation instead of dashes www-data |
|---|
| ===== Commands ===== | ===== Commands ===== |
| |
| * ''[ForSale'' -- Player command. Prompts for a target, then opens the price-entry gump. | * ''[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. | * ''[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. | * ''[Purchase'': Player command. Targets an item flagged For Sale and opens the confirmation gump. |
| * ''[Buy'' -- Alias of ''[Purchase''. | * ''[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!" | * ''[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). | * ''[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. | * ''[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''. | * ''[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''. |
| |
| ===== Listing an Item ===== | ===== Listing an Item ===== |
| * **Gold**: | * **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." | * 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 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 titled "Sale Completed" is added to the seller's inbox: "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. | * 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. | * **Gameplay Points**: Requires Gameplay Points >= price; deducted on purchase. The item is delivered as a gift copy. |
| * **PvM Credits**: Requires PvM Credits >= price; deducted on purchase. | * **PvM Credits**: Requires PvM Credits >= price; deducted on purchase. |
| * **Daily Points**: Requires Daily Points >= 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. | * **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. | 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. |
| ==== Service / Commission Fee ==== | ==== Service / Commission Fee ==== |
| |
| 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. | 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. |
| |
| ===== Listing Attributes ===== | ===== Listing Attributes ===== |