README.md

   1 # Easy Vending Machines [`easyvend`]
   2 Version: 0.4.3
   3
   4 Adds vending and depositing machines which allow to buy and sell items from other players.
   5
   6 Help is included as help entry for Item Documentation [`doc_items`].
   7
   8 ## Converting machines from `vendor` mod (experimental)
   9 This mod is able to automatically transform the vending and depositing
  10 machines from Bad\_Command\_'s Vending machines [`vendor`] mod on loading
  11 and turn them into the new machines from `easyvend`. This is useful if
  12 you want to switch a world from `vendor` to `easyvend`.
  13
  14 **WARNING**: This feature is experimental! It is advised to backup your world
  15 before doing this. This feature is also incomplete; items are currently
  16 **not** transformed in the process.
  17
  18 ### Conversion process
  19 To transform all nodes from the `vendor` mod, disable the `vendor` mod (if
  20 it is not already disabled), enable the setting `easyvend_convert_vendor`
  21 and start or restart the game.
  22
  23 Now all nodes from the `vendor` mod will be replaced  with `easyvend` ones.
  24
  25 If you run a server, you should inform players of this change because a few
  26 machines might need a reconfiguration.
  27
  28 ### Details
  29 The machine configuration will be kept in the process and the machines will
  30 stay in operation provided their configuration is valid. The mod tries to
  31 keep as many machines in operation as possible. Machines with very high values
  32 (item count or price) might be disabled because they exceed limits and must
  33 be reconfigured by their owners. Most machines which worked before will likely
  34 stay in operation afterwards.
  35
  36 ## Credits and licenses
  37 - Code
  38     - License: [LGPL 2.1](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)
  39     - Source: Forked from mod “Vending Machines” [vendor] by Bad\_Command\_.
  40     - Authors: Bad\_Command\_ and Wuzzy
  41 - Textures
  42     - License: MIT License
  43     - Author: Wuzzy
  44 - Sounds
  45     - Any of the following licenses apply:
  46         - [CC-BY 3.0](https://creativecommons.org/licenses/by/3.0/)
  47         - [CC-BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0/)
  48         - [GPL 3.0](https://www.gnu.org/licenses/gpl-3.0.html)
  49         - [GPL 2.0](https://www.gnu.org/licenses/old-licenses/gpl-2.0)
  50     - Original title of the work: “Inventory Sound Effects”
  51     - Source: [OpenGameArt](http://opengameart.org/content/inventory-sound-effects)
  52     - Authors: [OpenGameArt](http://opengameart.org/) user artisticdude, edited by Bad\_Command\_