177 lines
9.0 KiB
Plaintext
177 lines
9.0 KiB
Plaintext
# textdomain: commoditymarket
|
|
|
|
|
|
### doc.lua ###
|
|
|
|
#long-form description of how markets work, for documentation
|
|
At the core of how a market operates are "buy" and "sell" orders. A buy order is an announcement to the world that you are interested in purchasing a certain quantity of item and are willing to pay a certain amount of currency in exchange for each unit of that item. Conversely, a sell order is an announcement to the world that you are interested in selling a certain quantity of item and will accept a certain amount of currency in exchange for each unit of that item.@n@nThe market price of an item is determined by where the existing buy and sell orders for that item intersect. When you offer to buy an item for a price that someone is offering to sell it at, the item is transferred to you and currency is transferred from your account to theirs to cover the cost. The market will keep track of the most recent price that an item was successfully sold for, but note that this information is for historical interest only - there's no guarantee that anyone is currently willing to match the historical price.@n@nWhen an item is selected in the upper list, the currently existing buy and sell orders for that item will be displayed in the lower list. Sell orders are listed first in descending price, followed by buy orders in ascending price. The current market price will be somewhere in between the lowest sell order and the highest buy order. If you wish to cancel a buy or sell order that you've placed for an item, double-click on the order and the item or currency that you put into that order will be returned to your inventory.@n@nIf you place a buy order and there are already sell orders for the item that meet or are below your price, some or all of your buy order might be immediately fulfilled. Your purchases will be made at the price that the sell orders have been set to - if you were willing to pay 15 units of currency per item but someone was already offering to sell for 2 units of currency per item, you only pay 2 units for each of that offer's items. If there aren't enough compatible sell orders to fulfill your buy order, the remainder will be placed into the market and made available for future sellers to see and fulfill if they agree to your price. Your buy order will immediately deduct the currency required for it from your account's balance, but if you cancel your order you will get that currency back - it's not gone until the order is actually fulfilled.@n@nIf you place a sell order and there are already buy orders that meet or exceed your price, some or all of your sell order may be immediately fulfilled. You'll be paid the price that the buyers are offering rather than the amount you're demanding. If any of your sell offer is left unfulfilled, the sell order will be added to the market for future buyers to see. The items for this offer will be immediately taken from your market inventory but if you cancel your order you will get those items back.=
|
|
|
|
#documentation tab text
|
|
Commodity Markets=
|
|
|
|
#long-form description of how markets work, for documentation
|
|
Each player's account has an inventory that serves as a holding area for items that are destined to be sold or that have been bought by the player but not yet retrieved. This inventory is a bit different from the standard Minetest inventory in that it doesn't hold item "stacks", it just tracks the total number of that item present. Some markets allow for extremely large quantities of an item to be stored here for sale.@n@nTo add an item to your market inventory for eventual sale either shift-click on the item in your player inventory or drag the item stack to the inventory slot below the main market inventory list. Some markets may have restrictions on what items can be bought and sold, if an item is not valid for that market it won't go into the market's inventory. Some items are considered "currency" and will add to your account's currency balance instead of being listed in your market inventory.@n@nTools cannot be added to the market inventory if they have any wear on them. The market also can't handle items with attached metadata such as books that have had text added to them.@n@nTo remove an item from your market inventory, double-click in it in the market inventory list. As much of the item as can fit into your player inventory will be transferred to you, with any remainder staying behind in the market inventory. To withdraw currency from your market balance type the amount you'd like to withdraw in the field next to the "Withdraw" button. The currency will be converted into items and added to your player inventory, with whatever cannot be converted remaining behind in your market balance.=
|
|
|
|
#documentation category description
|
|
Game-wide marketplaces where goods can be bought and sold at prices of your choice.=
|
|
|
|
#title of documentation page
|
|
User Interface: Inventory=
|
|
#title of documentation page
|
|
User Interface: Orders=
|
|
|
|
### formspecs.lua ###
|
|
|
|
#tooltip
|
|
All the items you've transfered to the market to sell and the items you've@npurchased with buy orders. Double-click on an item to bring it back into your@npersonal inventory.=
|
|
|
|
#tooltip
|
|
Apply search to outputs.=
|
|
Balance:=
|
|
#label
|
|
#button label
|
|
Buy=
|
|
#table column header
|
|
Buy Max=
|
|
#table column header
|
|
Buy Vol=
|
|
#tooltip
|
|
Clear search.=
|
|
Days Old=
|
|
#table column header
|
|
Description=
|
|
Description:=
|
|
#label for inventory drop target. The hard return is needed to fit it into the UI
|
|
Drop items here to@nadd to your account=
|
|
#tooltip
|
|
Enter substring to search item identifiers for.=
|
|
|
|
#tooltip
|
|
Enter the amount of currency you'd like to withdraw then click the 'Withdraw'@nbutton to convert it into items and transfer it to your personal inventory.=
|
|
|
|
How many days ago this order was placed.=
|
|
#label
|
|
In inventory:=
|
|
#table column header
|
|
Inventory=
|
|
#label
|
|
Inventory limit:=
|
|
#table column header
|
|
Item=
|
|
#table column header
|
|
Last Price=
|
|
|
|
#tooltip
|
|
Log entries in yellow are new since last time you marked your log as read.=
|
|
|
|
Mark logs as read=
|
|
#tab label
|
|
Market Orders=
|
|
#tooltip
|
|
Maximum price being offered to buy one of these.=
|
|
#tooltip
|
|
Minimum price being demanded to sell one of these.=
|
|
#checkbox label
|
|
My orders=
|
|
#shown if there are no transactions the player has participated in to list in the log
|
|
No logged activities in this market yet.=
|
|
#tooltip
|
|
Number of items available for sale in the market.=
|
|
#tooltip
|
|
Number of items there's demand for in the market.=
|
|
|
|
#transaction log entry. @1 is a day number, @2 is a player name, @3 is a quantity of items, @4 is the item name, @5 is a player name, @6 is a currency symbol, @7 is a number (price), @8 is the currency symbol again and @9 is a number (price)
|
|
On day @1 @2 sold @3 @4 to @5 at @6@7 each for a total of @8@9.=
|
|
|
|
Order=
|
|
Player=
|
|
Price=
|
|
#tooltip
|
|
Price paid for one of these the last time one was sold.=
|
|
Price per=
|
|
#table column header, field label
|
|
Quantity=
|
|
|
|
#tooltip
|
|
Quantity of this item that you have in your inventory ready to sell.=
|
|
|
|
Select an item to view or place orders.=
|
|
|
|
#tooltip
|
|
Select this to show only the markets where you have either a buy or a sell order pending.=
|
|
|
|
Sell=
|
|
#table column header
|
|
Sell Min=
|
|
#table column header
|
|
Sell Vol=
|
|
Sell limit:=
|
|
#checkbox label
|
|
Show Icons=
|
|
#checkbox label
|
|
Show Itemnames=
|
|
|
|
The name of the player who placed this order.@nDouble-click your own orders to cancel them.=
|
|
|
|
The price per item in this order.=
|
|
|
|
The total amount of items available at this price accounting for the other orders also currently being offered.=
|
|
|
|
The total amount of items in this particular order.=
|
|
|
|
#tooltip
|
|
This market limits the total number of items a given seller can have for sale at a time.@nYou have @1 items remaining. Cancel old sell orders to free up space.=
|
|
|
|
Total Volume=
|
|
#undefined item
|
|
Unknown Item=
|
|
|
|
#tooltip
|
|
Use these fields to enter buy and sell orders for the selected item.=
|
|
|
|
#button label
|
|
Withdraw=
|
|
|
|
#tooltip
|
|
You can still receive purchased items if you've exceeded your inventory limit,@nbut you won't be able to transfer items from your personal inventory into@nthe market until you've emptied it back down below the limit again.=
|
|
|
|
#tab label
|
|
Your Inventory=
|
|
Your Recent Purchases and Sales:=
|
|
someone=
|
|
you=
|
|
yourself=
|
|
|
|
### market.lua ###
|
|
|
|
1 @1 @= @2@3=
|
|
|
|
A market where orders to buy or sell items can be placed and fulfilled.=
|
|
|
|
Add all registered items to the provided market=
|
|
Currency item values:=
|
|
Market=
|
|
Market has unlimited inventory space.=
|
|
Market inventory is limited to @1 items.=
|
|
Market supports unlimited pending sell orders.=
|
|
Purging item: @1 from market: @2=
|
|
Total pending sell orders are limited to @1 items.=
|
|
You can't afford that many of this item.=
|
|
You can't pay less than nothing for an item.=
|
|
You can't sell fewer than one item.=
|
|
You can't sell items for a negative price.=
|
|
|
|
You don't have enough of that item in your inventory to post this sell order.=
|
|
|
|
You have to buy at least one item.=
|
|
|
|
You have too many items listed for sale in this market, please cancel some sell orders to make room for new ones.=
|
|
|
|
list all registered markets=
|
|
|
|
remove item from market. All existing buys and sells will be canceled.=
|
|
|
|
removes all unknown items from all markets. All existing buys and sells for those items will be canceled.=
|
|
|
|
show market interface=
|