Jump to content

Alathra:Player shops: Difference between revisions

Created page
 
m Added category and navigation
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
1
Alathra allows players to create custom shops to buy and sell items with others. This is a great way to generate income, as long as your shop is stocked and priced competitively.
 
===How to Create a Shop===
To set up your shop:
# Hold the item you want to sell.
# Right-click on a chest or barrel.
# Type the price per item in chat.
# (Optional) Set a bulk quantity, which defines the minimum amount buyers must purchase.
 
If your shop runs out of items and you're online, you'll get a notification.
 
===Finding Shops===
Use this command to search for a shop selling a specific item:<code>/qs finditem TO_BUY [item name]</code> or <code>/qs finditem TO_BUY [item name]</code>.
 
===Changing Shop Prices===
* It costs 5 coins to change the price of a shop.
* You can set prices per item or in bulk.
 
===Sharing Shop Profits===
You can split the income from your shop with other players:
 
Example:
<code>/quickshop benefit add Player1 50%</code>
<code>/quickshop benefit add Player2 30%</code>
 
This splits profits as:
*50% to Player1
*30% to Player2
*20% to Shop Owner
 
'''Related Commands:'''
* View beneficiaries: <code>/quickshop benefit query</code>
* Remove a beneficiary: <code>/quickshop benefit remove [player]</code>
 
===Managing Staff===
You can assign players as staff to restock and help manage your shop:
* Add staff: <code>/qs staff <player></code>
* Apply staff to all shops: <code>/qs staffall</code>
 
===Shop Commands Reference===
{| class="wikitable sortable"
! Command !! Description
|-
| <code>/qs about</code> || Shows information about the plugin.
|-
| <code>/qs amount</code> || Sets the price per item or bulk.
|-
| <code>/qs benefit add [player] [percentage]</code> || Splits shop income with other players.
|-
| <code>/qs benefit query</code> || Shows current beneficiaries.
|-
| <code>/qs benefit remove &lt;player&gt;</code> || Removes a player from shop benefits.
|-
| <code>/qs browse</code> || Opens a GUI to browse existing shops.
|-
| <code>/qs buy</code> || Converts the shop into a buying shop.
|-
| <code>/qs create [price]</code> || Creates a new shop with the specified price.
|-
| <code>/qs currency</code> || Sets shop to use default currency.
|-
| <code>/qs discount create [code] PLAYER_ALL_SHOPS [amount]</code> || Creates a discount code.
|-
| <code>/qs fetchmessage</code> || Displays unread shop messages.
|-
| <code>/qs finditem [TO_BUY or TO_SELL] [item]</code> || Finds a shop that buys or sells a specific item.
|-
| <code>/qs help</code> || Lists plugin help information.
|-
| <code>/qs history</code> || Shows the shop transaction history.
|-
| <code>/qs item</code> || Changes the shop's item.
|-
| <code>/qs limit</code> || Limits how many times the shop can be purchased from.
|-
| <code>/qs name</code> || Sets a custom name for the shop.
|-
| <code>/qs permission</code> || Sets shop permissions (e.g. staff, admin).
|-
| <code>/qs price</code> || Changes the selling or buying price.
|-
| <code>/qs remove</code> || Deletes the shop.
|-
| <code>/qs sell</code> || Converts the shop into a selling shop.
|-
| <code>/qs sign</code> || Changes the shop sign.
|-
| <code>/qs size</code> || Changes item quantity sold in one transaction.
|-
| <code>/qs staff</code> || Adds a staff member to the shop.
|-
| <code>/qs staffall</code> || Applies staff permissions to all shops.
|-
| <code>/qs suggestprice</code> || Suggests a price based on other shops.
|-
| <code>/qs toggledisplay</code> || Enables/disables item display above the shop.
|-
| <code>/qs transferall</code> || Transfers all your shops to another player.
|-
| <code>/qs transferownership</code> || Transfers one shop to another player.
|}
 
== Tips ==
* Use <code>/qs suggestprice</code> to stay competitive.
* Discounts are useful for promotions.
* Player staff can help keep shops restocked.
* Recheck stock often to avoid missed sales.
* Need more help? Use <code>/qs help</code> in-game for the latest available commands and guidance.
 
{{Guides navigation}}
[[Category:Guides]]

Latest revision as of 23:09, 11 July 2025

Alathra allows players to create custom shops to buy and sell items with others. This is a great way to generate income, as long as your shop is stocked and priced competitively.

How to Create a Shop

To set up your shop:

  1. Hold the item you want to sell.
  2. Right-click on a chest or barrel.
  3. Type the price per item in chat.
  4. (Optional) Set a bulk quantity, which defines the minimum amount buyers must purchase.

If your shop runs out of items and you're online, you'll get a notification.

Finding Shops

Use this command to search for a shop selling a specific item:/qs finditem TO_BUY [item name] or /qs finditem TO_BUY [item name].

Changing Shop Prices

  • It costs 5 coins to change the price of a shop.
  • You can set prices per item or in bulk.

Sharing Shop Profits

You can split the income from your shop with other players:

Example: /quickshop benefit add Player1 50% /quickshop benefit add Player2 30%

This splits profits as:

  • 50% to Player1
  • 30% to Player2
  • 20% to Shop Owner

Related Commands:

  • View beneficiaries: /quickshop benefit query
  • Remove a beneficiary: /quickshop benefit remove [player]

Managing Staff

You can assign players as staff to restock and help manage your shop:

  • Add staff: /qs staff <player>
  • Apply staff to all shops: /qs staffall

Shop Commands Reference

Command Description
/qs about Shows information about the plugin.
/qs amount Sets the price per item or bulk.
/qs benefit add [player] [percentage] Splits shop income with other players.
/qs benefit query Shows current beneficiaries.
/qs benefit remove <player> Removes a player from shop benefits.
/qs browse Opens a GUI to browse existing shops.
/qs buy Converts the shop into a buying shop.
/qs create [price] Creates a new shop with the specified price.
/qs currency Sets shop to use default currency.
/qs discount create [code] PLAYER_ALL_SHOPS [amount] Creates a discount code.
/qs fetchmessage Displays unread shop messages.
/qs finditem [TO_BUY or TO_SELL] [item] Finds a shop that buys or sells a specific item.
/qs help Lists plugin help information.
/qs history Shows the shop transaction history.
/qs item Changes the shop's item.
/qs limit Limits how many times the shop can be purchased from.
/qs name Sets a custom name for the shop.
/qs permission Sets shop permissions (e.g. staff, admin).
/qs price Changes the selling or buying price.
/qs remove Deletes the shop.
/qs sell Converts the shop into a selling shop.
/qs sign Changes the shop sign.
/qs size Changes item quantity sold in one transaction.
/qs staff Adds a staff member to the shop.
/qs staffall Applies staff permissions to all shops.
/qs suggestprice Suggests a price based on other shops.
/qs toggledisplay Enables/disables item display above the shop.
/qs transferall Transfers all your shops to another player.
/qs transferownership Transfers one shop to another player.

Tips

  • Use /qs suggestprice to stay competitive.
  • Discounts are useful for promotions.
  • Player staff can help keep shops restocked.
  • Recheck stock often to avoid missed sales.
  • Need more help? Use /qs help in-game for the latest available commands and guidance.