write something there

mods/minetest_game/binoculars/README.txt

@@ -0,0 +1,37 @@
+Minetest Game mod: binoculars
+=============================
+See license.txt for license information.
+
+Authors of source code
+----------------------
+paramat (MIT)
+
+Authors of media (textures)
+---------------------------
+paramat (CC BY-SA 3.0):
+  binoculars_binoculars.png
+
+Crafting
+--------
+binoculars:binoculars
+
+default:obsidian_glass O
+default:bronze_ingot B
+
+O_O
+BBB
+O_O
+
+Usage
+-----
+In survival mode, use of zoom requires the binoculars item in your inventory,
+they will allow a 10 degree field of view.
+It can take up to 5 seconds for adding to or removal from inventory to have an
+effect, however to instantly allow the use of this zoom 'use' (leftclick) the
+item.
+
+Zoom with a field of view of 15 degrees is automatically allowed in creative
+mode and for any player with the 'creative' privilege.
+
+The 'binoculars.update_player_property()' function is global so can be
+redefined by a mod for alternative behaviour.

mods/minetest_game/binoculars/init.lua

@@ -0,0 +1,73 @@
+-- binoculars/init.lua
+
+-- Mod global namespace
+
+binoculars = {}
+
+-- Load support for MT game translation.
+local S = minetest.get_translator("binoculars")
+
+
+-- Update player property
+-- Global to allow overriding
+
+function binoculars.update_player_property(player)
+	local new_zoom_fov = 0
+
+	if player:get_inventory():contains_item(
+			"main", "binoculars:binoculars") then
+		new_zoom_fov = 10
+	elseif minetest.is_creative_enabled(player:get_player_name()) then
+		new_zoom_fov = 15
+	end
+
+	-- Only set property if necessary to avoid player mesh reload
+	if player:get_properties().zoom_fov ~= new_zoom_fov then
+		player:set_properties({zoom_fov = new_zoom_fov})
+	end
+end
+
+
+-- Set player property 'on joinplayer'
+
+minetest.register_on_joinplayer(function(player)
+	binoculars.update_player_property(player)
+end)
+
+
+-- Cyclic update of player property
+
+local function cyclic_update()
+	for _, player in ipairs(minetest.get_connected_players()) do
+		binoculars.update_player_property(player)
+	end
+	minetest.after(4.7, cyclic_update)
+end
+
+minetest.after(4.7, cyclic_update)
+
+
+-- Binoculars item
+
+minetest.register_craftitem("binoculars:binoculars", {
+	description = S("Binoculars") .. "\n" .. S("Use with 'Zoom' key"),
+	inventory_image = "binoculars_binoculars.png",
+	stack_max = 1,
+	groups = {tool = 1},
+
+	on_use = function(itemstack, user, pointed_thing)
+		binoculars.update_player_property(user)
+	end,
+})
+
+
+-- Crafting
+
+minetest.register_craft({
+	output = "binoculars:binoculars",
+	recipe = {
+		{"default:obsidian_glass", "", "default:obsidian_glass"},
+		{"default:bronze_ingot", "default:bronze_ingot", "default:bronze_ingot"},
+		{"default:obsidian_glass", "", "default:obsidian_glass"},
+	}
+})

mods/minetest_game/binoculars/license.txt

@@ -0,0 +1,59 @@
+License of source code
+----------------------
+
+The MIT License (MIT)
+Copyright (C) 2017 paramat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this
+software and associated documentation files (the "Software"), to deal in the Software
+without restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+For more details:
+https://opensource.org/licenses/MIT
+
+
+Licenses of media (textures)
+----------------------------
+
+Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
+Copyright (C) 2017 paramat
+
+You are free to:
+Share — copy and redistribute the material in any medium or format.
+Adapt — remix, transform, and build upon the material for any purpose, even commercially.
+The licensor cannot revoke these freedoms as long as you follow the license terms.
+
+Under the following terms:
+
+Attribution — You must give appropriate credit, provide a link to the license, and
+indicate if changes were made. You may do so in any reasonable manner, but not in any way
+that suggests the licensor endorses you or your use.
+
+ShareAlike — If you remix, transform, or build upon the material, you must distribute
+your contributions under the same license as the original.
+
+No additional restrictions — You may not apply legal terms or technological measures that
+legally restrict others from doing anything the license permits.
+
+Notices:
+
+You do not have to comply with the license for elements of the material in the public
+domain or where your use is permitted by an applicable exception or limitation.
+No warranties are given. The license may not give you all of the permissions necessary
+for your intended use. For example, other rights such as publicity, privacy, or moral
+rights may limit how you use the material.
+
+For more details:
+http://creativecommons.org/licenses/by-sa/3.0/

mods/minetest_game/binoculars/locale/binoculars.de.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Fernglas
+Use with 'Zoom' key=Mit „Zoom“-Taste benutzen

mods/minetest_game/binoculars/locale/binoculars.eo.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Binoklo
+Use with 'Zoom' key=Uzi per 'Zomo' klavo

mods/minetest_game/binoculars/locale/binoculars.es.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Prismáticos
+Use with 'Zoom' key=Usar con la tecla 'Zoom'

mods/minetest_game/binoculars/locale/binoculars.fr.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Jumelles
+Use with 'Zoom' key=Utiliser avec le bouton « Zoom »

mods/minetest_game/binoculars/locale/binoculars.id.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Teropong
+Use with 'Zoom' key=Gunakan dengan tombol 'Zum'

mods/minetest_game/binoculars/locale/binoculars.it.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Binocolo
+Use with 'Zoom' key=Usalo col tasto 'Ingrandimento'

mods/minetest_game/binoculars/locale/binoculars.ja.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=双眼鏡
+Use with 'Zoom' key=ズームキーで使います

mods/minetest_game/binoculars/locale/binoculars.jbo.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=lo reldarvistci
+Use with 'Zoom' key=.i tu'a le jvinu banro batke cu tadji lo nu pilno

mods/minetest_game/binoculars/locale/binoculars.lv.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Binoklis
+Use with 'Zoom' key=Lietojiet ar 'Pietuvināt' pogu

mods/minetest_game/binoculars/locale/binoculars.ms.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Binokular
+Use with 'Zoom' key=Guna dengan kekunci 'Zum'

mods/minetest_game/binoculars/locale/binoculars.pl.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Lornetka
+Use with 'Zoom' key=Aby użyć naciśnij 'Zoom'

mods/minetest_game/binoculars/locale/binoculars.pt_BR.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Binóculos
+Use with 'Zoom' key=Use com a tecla de 'Zoom'

mods/minetest_game/binoculars/locale/binoculars.ru.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Бинокль
+Use with 'Zoom' key=Используется клавишей 'Приближение'

mods/minetest_game/binoculars/locale/binoculars.sk.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Ďalekohľad
+Use with 'Zoom' key=Použi s klávesou "Priblíž"

mods/minetest_game/binoculars/locale/binoculars.sv.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Kikare
+Use with 'Zoom' key=Använd med 'Zoom'-knappen

mods/minetest_game/binoculars/locale/binoculars.uk.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=Бінокль
+Use with 'Zoom' key=Використовується клавішею 'Наближення'

mods/minetest_game/binoculars/locale/binoculars.zh_CN.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=望远镜
+Use with 'Zoom' key=与“缩放”键一起使用

mods/minetest_game/binoculars/locale/binoculars.zh_TW.tr

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=望遠鏡
+Use with 'Zoom' key=與“縮放”鍵一起使用

mods/minetest_game/binoculars/locale/template.txt

@@ -0,0 +1,3 @@
+# textdomain: binoculars
+Binoculars=
+Use with 'Zoom' key=

mods/minetest_game/binoculars/mod.conf

@@ -0,0 +1,3 @@
+name = binoculars
+description = Minetest Game mod: binoculars
+depends = default