mirror of
https://github.com/minetest/minetest_game.git
synced 2024-12-22 22:22:25 +01:00
Minetest Game - The default game for the Minetest engine [https://github.com/minetest/minetest/]
e4b1c93512
This code adds the key concept to minetest_game, and integrates it with lockable nodes. Currently supported lockable items are the Steel Door, the Steel Trapdoor, and the Locked Chest. The goal of this modification is to introduce a fine-grained multi- player permission system that is intuitive and usable without any console or chat commands, and doesn't require extra privileges to be granted or setup. Keys can also physically be conveyed to other players, adding to gameplay and adding some personality that is preferable to console commands or editing formspecs. A skeleton key can be crafted with 1 gold ingot. Skeleton keys can then be matched to a lockable node by right-clicking the skeleton key on a lockable node, which changes the skeleton key to a "key". Gold was chosen as it's currently a not-so very useful item, and therefore it's likely that players have some, but aren't really using it for any purpose. This key can subsequently used by any player to open or access that lockable node, including retrieving items from Locked Chests, or putting items in them. They key is programmed to fit only the particular locked node it is programmed to. This is achieved by storing a secret value in both key and locked node. If this secret value doesn't match, the key will not open the locked node. This allows many keys to be created for one chest or door, but a key will only fit one node ever. The secrets are stored in node, and item meta for the key. If a locked node is removed, all keys that opened it are no longer valid. Even if a new door/chest is placed in exactly the same spot, the old keys will no longer fit that node. Keys can be smelted back in gold ingots if they are no longer useful. The method of storing a secret in nodemeta and itemstackmeta is secure as there is no way for the client to create new items on the server with a particular secret metadata value. Even if you could possible create such an itemstack on the client, the server does not ever read itemstackmeta from a client package. The patch adds an API that allows other nodes and nodes added by mods to use the same keys as well. The method how to implement this is described in game_api.txt. The mod should add 2 callbacks to it's node definition. Example code is given. Textures are from PixelBOX, thanks to Gambit. |
||
|---|---|---|
| menu | ||
| mods | ||
| .gitignore | ||
| .luacheckrc | ||
| .travis.yml | ||
| game_api.txt | ||
| game.conf | ||
| minetest.conf | ||
| minetest.conf.example | ||
| README.txt | ||
| settingtypes.txt | ||
Minetest Game [minetest_game] ============================= The main subgame for the Minetest engine ======================================== To use this subgame with the Minetest engine, insert this repository as /games/minetest_game The Minetest engine can be found in: https://github.com/minetest/minetest/ Compatibility -------------- The Minetest Game github master HEAD is generally compatible with the github master HEAD of the Minetest engine. Additionally, when the Minetest engine is tagged to be a certain version (eg. 0.4.10), Minetest Game is tagged with the version too. When stable releases are made, Minetest Game is packaged and made available in http://minetest.net/download and in case the repository has grown too much, it may be reset. In that sense, this is not a "real" git repository. (Package maintainers please note!) License of source code ---------------------- Copyright (C) 2010-2012 celeron55, Perttu Ahola <celeron55@gmail.com> See README.txt in each mod directory for information about other authors. This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. License of media (textures and sounds) -------------------------------------- Copyright (C) 2010-2012 celeron55, Perttu Ahola <celeron55@gmail.com> See README.txt in each mod directory for information about other authors. Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) http://creativecommons.org/licenses/by-sa/3.0/ License of menu/header.png Copyright (C) 2015 paramat CC BY-SA 3.0