Basics:
Vending machines (red) give items to their users and take their money in return.
Depositing machines (yellow) take items from their users and give them money in return.
Both vending and depositing machines use locked chests as storage for both items and money. Locked chests are essential for operation.
The machines use gold ingots as currency. The currency can be changed with a setting game-wide.
A status LED shows the machine status:
The green LED means the machine is operational and ready to trade.
The red LED means the machine is currently out of order and can't trade right now. Reasons: Out of stock, misconfiguration, no storage chest, etc.
Quick Start:
(Note: Help entries for doc_items are provided.)
Spoiler
Point the machine to see what is is buying or selling and who owns it. Rightclick the machine to see details and click on “Buy” or “Sell” to do a single exchange.
Provided that both you and the machine have enough money, items and inventory space for the exchange, the exchange is done.
The “message” field shows the previous user message to notify the user about something. It contains useful information when something didn't work.
Spoiler
- Place a locked chest
- Put the item you want to sell into the locked chest
- Put a vending machine above or below it
- Rightclick the vending machine
- Put the item you want to sell into the “Offered item” slot
- Enter the number of items and a selling price
- Hit confirm. If the LED goes green, then you're all set, otherwise, check the message
- Wait for customers to come and retrieve gained money from locked chest
Hint: Any locked chest connected in an unbroken vertical stack of locked chests, vending machines and depositing machines can be accessed as storage by the vending machine.
This is the same as for buyers, but you use deposit machines, you have to put money into the chest, and you have to pick a “Required item”.
Special case: Tools. You can decide whether you want to sell/buy worn tools or if you only accept tools in perfect condition
Spoiler
Code: Select all
WWW
WSW
WWW
Code: Select all
WSW
WSW
WWW
S = Steel Ingot[/code]
Spoiler
I did not really like version 1.02 of the original mod because I found the new bank account concept too confusing and it didn't even work for me. I liked the trading with items as currency much more and it was more straightforward to use. I have put a lot of work to make using this mod as easy as possible. Usability is important to me, if you have problems with this mod or find it unwieldy to use, please report it here.
- Unique textures for active and inactive machines
- Point a machine to see what is sells or buys
- Machines support buying and selling of up to 31 times the maximum stack size per item (example: a vending machine can theoretically sell up to 3069 apples at once)
- Choose whether the machines accept to buy/sell worn tools
- Change the currency item used by machines with a setting (server-wide)
- You can buy or sell from your own vending machines
- Status LEDs: Green means it is active, red means it is inactive
- Status and user messages in the form tell you about possible errors in the machine setup. The chat is kept clean
- Help entries for Item Documentation [doc_items]
Git repository / project page (for developers): https://codeberg.org/Wuzzy/minetest_easyvend
Dependency: default (from Minetest Game) (Sorry for this, but I try to get rid of this dependency in later versions)
Optional dependencies: awards, doc, doc_items, screwdriver
Spoiler
- Code: LGPL 2.1. Forked from vendor by Bad_Command_.
- Sounds: CC-BY 3.0/CC-BY-SA 3.0/GPL 3.0/GPL 2.0
- Textures: MIT License