item_drop/README.md

55 lines
2.5 KiB
Markdown
Raw Normal View History

2017-08-31 21:21:15 +02:00
# item_drop
2017-09-12 10:49:57 +02:00
By [PilzAdam](https://github.com/PilzAdam),
2018-06-17 07:35:06 +02:00
[texmex](https://github.com/tacotexmex/), [hybriddog](https://github.com/hybriddog/).
2017-08-31 21:21:15 +02:00
## Description
This mod adds Minecraft like drop/pick up of items to Minetest.
## Licensing
2018-06-23 10:15:40 +02:00
LGPLv2.1/CC BY-SA 3.0. Particle code from WCILA mod by Aurailus, originally licensed MIT.
2017-08-31 21:21:15 +02:00
## Notes
2017-09-12 10:49:57 +02:00
item_drop can be played with Minetest 0.4.16 or above. It was originally
developed by [PilzAdam](https://github.com/PilzAdam/item_drop).
2017-08-31 21:21:15 +02:00
## List of features
2017-09-12 10:49:57 +02:00
* All settings may be configured from within the game itself.
(Settings tab > Advanced settings > Mods > item_drop)
* Drops nodes as in-world items on dig if `item_drop.enable_item_drop` is
`true` (true by default) It does nothing in creative mode.
* Puts dropped items to the player's inventory if `item_drop.enable_item_pickup`
is `true` (true by default)
* It uses a node radius set in `item_drop.pickup_radius` (default 0.75),
if items are within this radius around the player's belt, they're picked.
* If `item_drop.pickup_age` is something positive, items dropped by players
are ignored for this time to avoid instantly picking up when dropping.
* If `item_drop.pickup_age` is `-1`, items are only picked when they don't
move, it's another fix for instant item picking.
* If `item_drop.magnet_radius` is bigger than `item_drop.pickup_radius`,
items between these radii are flying to the player for
`item_drop.magnet_time` seconds, after this time, they're picked or stop
flying.
* Plays a sound when the items are picked up with the gain level set to
`item_drop.pickup_sound_gain` (default 0.2)
* Requires a key to be pressed in order to pick items if
`item_drop.enable_pickup_key` is `true` (true by default)
* The keytypes to choose from by setting `item_pickup_keytype` are:
* Use key (`Use`)
* Sneak key (`Sneak`)
* Left and Right keys combined (`LeftAndRight`)
* Right mouse button (`RMB`)
* Sneak key and right mouse button combined (`SneakAndRMB`)
* If `item_drop.pickup_keyinvert` is `true` (false by default), items are
collected when the key is not pressed instead of when it's pressed.
2017-08-31 21:21:15 +02:00
## Known issues
## Bug reports and suggestions
2017-09-12 10:49:57 +02:00
You can report bugs or suggest ideas by
2018-06-17 07:35:06 +02:00
[filing an issue](http://github.com/minetest-mods/item_drop/issues/new).
2017-08-31 21:21:15 +02:00
## Links
2018-06-17 07:35:06 +02:00
* [Download ZIP](https://github.com/minetest-mods/item_drop/archive/master.zip)
* [Source](https://github.com/minetest-mods/item_drop/)
2017-08-31 21:21:15 +02:00
* [Forum thread](https://forum.minetest.net/viewtopic.php?t=16913)