|raymoo 7db6fb3ca7||3 years ago|
|sounds||4 years ago|
|textures||4 years ago|
|COPYING||4 years ago|
|README.md||4 years ago|
|atm.lua||4 years ago|
|depends.txt||4 years ago|
|description.txt||4 years ago|
|digital_mailbox.lua||4 years ago|
|exchange.lua||3 years ago|
|exchange_machine.lua||4 years ago|
|init.lua||3 years ago|
|mod.conf||4 years ago|
|screenshot.png||4 years ago|
|test.db||4 years ago|
This mod provides a server-wide trading exchange for items. It is available under GNU GPL version 3 or any later version. lsqlite3 is required by this mod, and can be installed through luarocks. ($ sudo luarocks install lsqlite3)
The first screen you see is where you can search and post new buy/sell orders. Here is an overview of each element:
This summarizes the various items available on the exchange. From left to right, the columns display the item name, the description (what is shown in inventory), the amount requested by buyers, the maximum rate offered by buyers, the amount offered by sellers, and the minimum rate offered by sellers. It is updated periodically.
This screen lets you see and cancel your orders. To cancel an order, click the order and press the “Cancel” button.
This displays a creative-style inventory menu for selecting an item for searches or posting orders. To select an item, drag it from the inventory to the box near the bottom of the form
Once you have opened the exchange, you have a few options. If you don’t already know what you want to buy or sell, you can look at the Market Summary to get a glance at what people are offering. After you have decided on what you are going to do, return to the exchange page.
If you are selling an item, you should check the “Sell” checkbox. Otherwise, leave it unchecked. Next, you need to select the item you want to deal in. There are two ways: typing the item name (e.g. default:cobble) in manually to the item field, or using the “Select Item” menu. If you haven’t already decided on a price, or you want to make sure your order is filled quickly, you can conduct a search. To do this, click the “Search” button. This will give you a list of results. If you checked the “Sell” box, then these will be buy orders, and will show the maximum price per item each buyer is willing to accept. Otherwise, these will be sell orders, displaying the minimum price each seller will accept. If you click on a search result, it will automatically fill your Amount and Rate fields to match.
The Amount and Rate fields are used to decide how much and how expensively you want to make your order. When selling, the Rate field is the minimum price you will accept. When buying, it is the maximum. Once everything is filled out how you want it, press the “Post Order” button. If there are matching offers (when you post a buy/sell offer, there are one or more sell/buy offers with a price at least as good), then that part of your offer will immediately be filled. For example, if you post a buy order for 10 cobblestone at 5 credits each, and there is a sell offer for 5 cobblestone 3 credits each, it will give you 5 cobble immediately, and leave an order on the exchange for 5 more cobblestone.
Once your offer is on the exchange, you can view or cancel it from the “Your Orders” menu.