switch to client-side translation

Fixed deprecated call.

README.txt

@@ -11,6 +11,11 @@ see: LICENSE
 
 =-=-=-=-=-=-=-=-=-=
 
-A mod containing magical orbs a player can use a limited number of times to change the time of day
+A mod containing magical orbs a player can use a limited number of times to change the time of day.
 
-=-=-=-=-=-=-=-=-=-=
+Orbs present in this mod are:
+
+Orb of Midday
+Orb of Dusk
+Orb of Midnight
+Orb of Dawn

depends.txt

@@ -1,3 +1,4 @@
-default
-intllib?
+default?
+mcl_core?
 loot?
+doc?

i18n.py

@@ -0,0 +1,418 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+#
+# Script to generate the template file and update the translation files.
+# Copy the script into the mod or modpack root folder and run it there.
+#
+# Copyright (C) 2019 Joachim Stolberg, 2020 FaceDeer, 2020 Louis Royer
+# LGPLv2.1+
+
+from __future__ import print_function
+import os, fnmatch, re, shutil, errno
+from sys import argv as _argv
+
+# Running params
+params = {"recursive": False,
+    "help": False,
+    "mods": False,
+    "verbose": False,
+    "folders": []
+}
+# Available CLI options
+options = {"recursive": ['--recursive', '-r'],
+    "help": ['--help', '-h'],
+    "mods": ['--installed-mods'],
+    "verbose": ['--verbose', '-v']
+}
+
+# Strings longer than this will have extra space added between
+# them in the translation files to make it easier to distinguish their
+# beginnings and endings at a glance
+doublespace_threshold = 60
+
+def set_params_folders(tab: list):
+    '''Initialize params["folders"] from CLI arguments.'''
+    # Discarding argument 0 (tool name)
+    for param in tab[1:]:
+        stop_param = False
+        for option in options:
+            if param in options[option]:
+                stop_param = True
+                break
+        if not stop_param:
+            params["folders"].append(os.path.abspath(param))
+
+def set_params(tab: list):
+    '''Initialize params from CLI arguments.'''
+    for option in options:
+        for option_name in options[option]:
+            if option_name in tab:
+                params[option] = True
+                break
+
+def print_help(name):
+    '''Prints some help message.'''
+    print(f'''SYNOPSIS
+    {name} [OPTIONS] [PATHS...]
+DESCRIPTION
+    {', '.join(options["help"])}
+        prints this help message
+    {', '.join(options["recursive"])}
+        run on all subfolders of paths given
+    {', '.join(options["mods"])}
+        run on locally installed modules
+    {', '.join(options["verbose"])}
+        add output information
+''')
+
+
+def main():
+    '''Main function'''
+    set_params(_argv)
+    set_params_folders(_argv)
+    if params["help"]:
+        print_help(_argv[0])
+    elif params["recursive"] and params["mods"]:
+        print("Option --installed-mods is incompatible with --recursive")
+    else:
+        # Add recursivity message
+        print("Running ", end='')
+        if params["recursive"]:
+            print("recursively ", end='')
+        # Running
+        if params["mods"]:
+            print(f"on all locally installed modules in {os.path.abspath('~/.minetest/mods/')}")
+            run_all_subfolders("~/.minetest/mods")
+        elif len(params["folders"]) >= 2:
+            print("on folder list:", params["folders"])
+            for f in params["folders"]:
+                if params["recursive"]:
+                    run_all_subfolders(f)
+                else:
+                    update_folder(f)
+        elif len(params["folders"]) == 1:
+            print("on folder", params["folders"][0])
+            if params["recursive"]:
+                run_all_subfolders(params["folders"][0])
+            else:
+                update_folder(params["folders"][0])
+        else:
+            print("on folder", os.path.abspath("./"))
+            if params["recursive"]:
+                run_all_subfolders(os.path.abspath("./"))
+            else:
+                update_folder(os.path.abspath("./"))
+
+#group 2 will be the string, groups 1 and 3 will be the delimiters (" or ')
+#See https://stackoverflow.com/questions/46967465/regex-match-text-in-either-single-or-double-quote
+pattern_lua = re.compile(r'[\.=^\t,{\(\s]N?S\(\s*(["\'])((?:\\\1|(?:(?!\1)).)*)(\1)[\s,\)]', re.DOTALL)
+pattern_lua_bracketed = re.compile(r'[\.=^\t,{\(\s]N?S\(\s*\[\[(.*?)\]\][\s,\)]', re.DOTALL)
+
+# Handles "concatenation" .. " of strings"
+pattern_concat = re.compile(r'["\'][\s]*\.\.[\s]*["\']', re.DOTALL)
+
+pattern_tr = re.compile(r'(.+?[^@])=(.*)')
+pattern_name = re.compile(r'^name[ ]*=[ ]*([^ \n]*)')
+pattern_tr_filename = re.compile(r'\.tr$')
+pattern_po_language_code = re.compile(r'(.*)\.po$')
+
+#attempt to read the mod's name from the mod.conf file. Returns None on failure
+def get_modname(folder):
+    try:
+        with open(os.path.join(folder, "mod.conf"), "r", encoding='utf-8') as mod_conf:
+            for line in mod_conf:
+                match = pattern_name.match(line)
+                if match:
+                    return match.group(1)
+    except FileNotFoundError:
+        pass
+    return None
+
+#If there are already .tr files in /locale, returns a list of their names
+def get_existing_tr_files(folder):
+    out = []
+    for root, dirs, files in os.walk(os.path.join(folder, 'locale/')):
+        for name in files:
+            if pattern_tr_filename.search(name):
+                out.append(name)
+    return out
+
+# A series of search and replaces that massage a .po file's contents into
+# a .tr file's equivalent
+def process_po_file(text):
+    # The first three items are for unused matches
+    text = re.sub(r'#~ msgid "', "", text)
+    text = re.sub(r'"\n#~ msgstr ""\n"', "=", text)
+    text = re.sub(r'"\n#~ msgstr "', "=", text)
+    # comment lines
+    text = re.sub(r'#.*\n', "", text)
+    # converting msg pairs into "=" pairs
+    text = re.sub(r'msgid "', "", text)
+    text = re.sub(r'"\nmsgstr ""\n"', "=", text)
+    text = re.sub(r'"\nmsgstr "', "=", text)
+    # various line breaks and escape codes
+    text = re.sub(r'"\n"', "", text)
+    text = re.sub(r'"\n', "\n", text)
+    text = re.sub(r'\\"', '"', text)
+    text = re.sub(r'\\n', '@n', text)
+    # remove header text
+    text = re.sub(r'=Project-Id-Version:.*\n', "", text)
+    # remove double-spaced lines
+    text = re.sub(r'\n\n', '\n', text)
+    return text
+
+# Go through existing .po files and, if a .tr file for that language
+# *doesn't* exist, convert it and create it.
+# The .tr file that results will subsequently be reprocessed so
+# any "no longer used" strings will be preserved.
+# Note that "fuzzy" tags will be lost in this process.
+def process_po_files(folder, modname):
+    for root, dirs, files in os.walk(os.path.join(folder, 'locale/')):
+        for name in files:
+            code_match = pattern_po_language_code.match(name)
+            if code_match == None:
+                continue
+            language_code = code_match.group(1)
+            tr_name = modname + "." + language_code + ".tr"
+            tr_file = os.path.join(root, tr_name)
+            if os.path.exists(tr_file):
+                if params["verbose"]:
+                    print(f"{tr_name} already exists, ignoring {name}")
+                continue
+            fname = os.path.join(root, name)
+            with open(fname, "r", encoding='utf-8') as po_file:
+                if params["verbose"]:
+                    print(f"Importing translations from {name}")
+                text = process_po_file(po_file.read())
+                with open(tr_file, "wt", encoding='utf-8') as tr_out:
+                    tr_out.write(text)
+
+# from https://stackoverflow.com/questions/600268/mkdir-p-functionality-in-python/600612#600612
+# Creates a directory if it doesn't exist, silently does
+# nothing if it already exists
+def mkdir_p(path):
+    try:
+        os.makedirs(path)
+    except OSError as exc: # Python >2.5
+        if exc.errno == errno.EEXIST and os.path.isdir(path):
+            pass
+        else: raise
+
+# Converts the template dictionary to a text to be written as a file
+# dKeyStrings is a dictionary of localized string to source file sets
+# dOld is a dictionary of existing translations and comments from
+# the previous version of this text
+def strings_to_text(dkeyStrings, dOld, mod_name):
+    lOut = [f"# textdomain: {mod_name}\n"]
+    
+    dGroupedBySource = {}
+
+    for key in dkeyStrings:
+        sourceList = list(dkeyStrings[key])
+        sourceList.sort()
+        sourceString = "\n".join(sourceList)
+        listForSource = dGroupedBySource.get(sourceString, [])
+        listForSource.append(key)
+        dGroupedBySource[sourceString] = listForSource
+    
+    lSourceKeys = list(dGroupedBySource.keys())
+    lSourceKeys.sort()
+    for source in lSourceKeys:
+        localizedStrings = dGroupedBySource[source]
+        localizedStrings.sort()
+        lOut.append("")
+        lOut.append(source)
+        lOut.append("")
+        for localizedString in localizedStrings:
+            val = dOld.get(localizedString, {})
+            translation = val.get("translation", "")
+            comment = val.get("comment")
+            if len(localizedString) > doublespace_threshold and not lOut[-1] == "":
+                lOut.append("")
+            if comment != None:
+                lOut.append(comment)
+            lOut.append(f"{localizedString}={translation}")
+            if len(localizedString) > doublespace_threshold:
+                lOut.append("")
+
+
+    unusedExist = False
+    for key in dOld:
+        if key not in dkeyStrings:
+            val = dOld[key]
+            translation = val.get("translation")
+            comment = val.get("comment")
+            # only keep an unused translation if there was translated
+            # text or a comment associated with it
+            if translation != None and (translation != "" or comment):
+                if not unusedExist:
+                    unusedExist = True
+                    lOut.append("\n\n##### not used anymore #####\n")
+                if len(key) > doublespace_threshold and not lOut[-1] == "":
+                    lOut.append("")
+                if comment != None:
+                    lOut.append(comment)
+                lOut.append(f"{key}={translation}")
+                if len(key) > doublespace_threshold:
+                    lOut.append("")
+    return "\n".join(lOut) + '\n'
+
+# Writes a template.txt file
+# dkeyStrings is the dictionary returned by generate_template
+def write_template(templ_file, dkeyStrings, mod_name):
+    # read existing template file to preserve comments
+    existing_template = import_tr_file(templ_file)
+    
+    text = strings_to_text(dkeyStrings, existing_template[0], mod_name)
+    mkdir_p(os.path.dirname(templ_file))
+    with open(templ_file, "wt", encoding='utf-8') as template_file:
+        template_file.write(text)
+
+
+# Gets all translatable strings from a lua file
+def read_lua_file_strings(lua_file):
+    lOut = []
+    with open(lua_file, encoding='utf-8') as text_file:
+        text = text_file.read()
+        #TODO remove comments here
+
+        text = re.sub(pattern_concat, "", text)
+
+        strings = []
+        for s in pattern_lua.findall(text):
+            strings.append(s[1])
+        for s in pattern_lua_bracketed.findall(text):
+            strings.append(s)
+                
+        for s in strings:
+            s = re.sub(r'"\.\.\s+"', "", s)
+            s = re.sub("@[^@=0-9]", "@@", s)
+            s = s.replace('\\"', '"')
+            s = s.replace("\\'", "'")
+            s = s.replace("\n", "@n")
+            s = s.replace("\\n", "@n")
+            s = s.replace("=", "@=")
+            lOut.append(s)
+    return lOut
+
+# Gets strings from an existing translation file
+# returns both a dictionary of translations
+# and the full original source text so that the new text
+# can be compared to it for changes.
+def import_tr_file(tr_file):
+    dOut = {}
+    text = None
+    if os.path.exists(tr_file):
+        with open(tr_file, "r", encoding='utf-8') as existing_file :
+            # save the full text to allow for comparison
+            # of the old version with the new output
+            text = existing_file.read()
+            existing_file.seek(0)
+            # a running record of the current comment block
+            # we're inside, to allow preceeding multi-line comments
+            # to be retained for a translation line
+            latest_comment_block = None
+            for line in existing_file.readlines():
+                line = line.rstrip('\n')
+                if line[:3] == "###":
+                    # Reset comment block if we hit a header
+                    latest_comment_block = None
+                    continue
+                if line[:1] == "#":
+                    # Save the comment we're inside
+                    if not latest_comment_block:
+                        latest_comment_block = line
+                    else:
+                        latest_comment_block = latest_comment_block + "\n" + line
+                    continue
+                match = pattern_tr.match(line)
+                if match:
+                    # this line is a translated line
+                    outval = {}
+                    outval["translation"] = match.group(2)
+                    if latest_comment_block:
+                        # if there was a comment, record that.
+                        outval["comment"] = latest_comment_block
+                    latest_comment_block = None
+                    dOut[match.group(1)] = outval
+    return (dOut, text)
+
+# Walks all lua files in the mod folder, collects translatable strings,
+# and writes it to a template.txt file
+# Returns a dictionary of localized strings to source file sets
+# that can be used with the strings_to_text function.
+def generate_template(folder, mod_name):
+    dOut = {}
+    for root, dirs, files in os.walk(folder):
+        for name in files:
+            if fnmatch.fnmatch(name, "*.lua"):
+                fname = os.path.join(root, name)
+                found = read_lua_file_strings(fname)
+                if params["verbose"]:
+                    print(f"{fname}: {str(len(found))} translatable strings")
+
+                for s in found:
+                    sources = dOut.get(s, set())
+                    sources.add(f"### {os.path.basename(fname)} ###")
+                    dOut[s] = sources
+                    
+    if len(dOut) == 0:
+        return None
+    templ_file = os.path.join(folder, "locale/template.txt")
+    write_template(templ_file, dOut, mod_name)
+    return dOut
+
+# Updates an existing .tr file, copying the old one to a ".old" file
+# if any changes have happened
+# dNew is the data used to generate the template, it has all the
+# currently-existing localized strings
+def update_tr_file(dNew, mod_name, tr_file):
+    if params["verbose"]:
+        print(f"updating {tr_file}")
+
+    tr_import = import_tr_file(tr_file)
+    dOld = tr_import[0]
+    textOld = tr_import[1]
+
+    textNew = strings_to_text(dNew, dOld, mod_name)
+
+    if textOld and textOld != textNew:
+        print(f"{tr_file} has changed.")
+        shutil.copyfile(tr_file, f"{tr_file}.old")
+
+    with open(tr_file, "w", encoding='utf-8') as new_tr_file:
+        new_tr_file.write(textNew)
+
+# Updates translation files for the mod in the given folder
+def update_mod(folder):
+    modname = get_modname(folder)
+    if modname is not None:
+        process_po_files(folder, modname)
+        print(f"Updating translations for {modname}")
+        data = generate_template(folder, modname)
+        if data == None:
+            print(f"No translatable strings found in {modname}")
+        else:
+            for tr_file in get_existing_tr_files(folder):
+                update_tr_file(data, modname, os.path.join(folder, "locale/", tr_file))
+    else:
+        print("Unable to find modname in folder " + folder)
+
+# Determines if the folder being pointed to is a mod or a mod pack
+# and then runs update_mod accordingly
+def update_folder(folder):
+    is_modpack = os.path.exists(os.path.join(folder, "modpack.txt")) or os.path.exists(os.path.join(folder, "modpack.conf"))
+    if is_modpack:
+        subfolders = [f.path for f in os.scandir(folder) if f.is_dir()]
+        for subfolder in subfolders:
+            update_mod(subfolder + "/")
+    else:
+        update_mod(folder)
+    print("Done.")
+
+def run_all_subfolders(folder):
+    for modfolder in [f.path for f in os.scandir(folder) if f.is_dir()]:
+        update_folder(modfolder + "/")
+
+
+main()

init.lua

@@ -1,21 +1,22 @@
--- internationalization boilerplate
-local MP = minetest.get_modpath(minetest.get_current_modname())
-local S, NS = dofile(MP.."/intllib.lua")
+local S = minetest.get_translator(minetest.get_current_modname())
 
 minetest.register_alias("castle:orb_day", "orbs_of_time:orb_day")
 minetest.register_alias("castle:orb_night", "orbs_of_time:orb_night")
 
 minetest.register_tool("orbs_of_time:orb_day", {
 	description = S("Orb of Midday"),
+	_doc_items_longdesc = S("This magical orb grants you the power to bring the Sun to the zenith of the sky."),
+	_doc_items_usagehelp = S("When weilded, use this item and the Sun will jump to its highest point. The day will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it."),
 	tiles = {"orbs_orb_day.png"},
 	inventory_image = "orbs_orb_day.png",
 	wield_image = "orbs_orb_day_weild.png",
 	stack_max=1,
+	groups = { tool=1 },
 	on_use = function(itemstack, user)
-		minetest.sound_play("orbs_ding", {pos=pos, loop=false})
+		minetest.sound_play("orbs_ding", {pos=user:getpos(), loop=false})
 		minetest.set_timeofday(0.5)
-		minetest.sound_play("orbs_birds", {pos=pos, loop=false})
-		if not minetest.setting_getbool("creative_mode") then
+		minetest.sound_play("orbs_birds", {pos=user:getpos(), loop=false})
+		if not minetest.settings:get_bool("creative_mode") then
 			itemstack:add_wear(65535/8)
 		end
 		return itemstack
@@ -23,16 +24,19 @@ minetest.register_tool("orbs_of_time:orb_day", {
 })
 
 minetest.register_tool("orbs_of_time:orb_night",{
- description = S("Orb of Midnight"),
+	description = S("Orb of Midnight"),
+	_doc_items_longdesc = S("This magical orb grants you the power to banish the Sun to the bottom of the world."),
+	_doc_items_usagehelp = S("When weilded, use this item and the Moon will jump to its highest point. The night will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it."),
 	tiles = {"orbs_orb_night.png"},
 	inventory_image = "orbs_orb_night.png",
 	wield_image = "orbs_orb_night_weild.png",
 	stack_max=1,
+	groups = { tool=1 },
 	on_use = function(itemstack, user)
-		minetest.sound_play("orbs_ding", {pos=pos, loop=false})
+		minetest.sound_play("orbs_ding", {pos=user:getpos(), loop=false})
 		minetest.set_timeofday(0)
-		minetest.sound_play("orbs_owl", {pos=pos, loop=false})
-		if not minetest.setting_getbool("creative_mode") then
+		minetest.sound_play("orbs_owl", {pos=user:getpos(), loop=false})
+		if not minetest.settings:get_bool("creative_mode") then
 			itemstack:add_wear(65535/8)
 		end
 		return itemstack
@@ -42,15 +46,17 @@ minetest.register_tool("orbs_of_time:orb_night",{
 
 minetest.register_tool("orbs_of_time:orb_dawn", {
 	description = S("Orb of Dawn"),
+	_doc_items_longdesc = S("This magical orb grants you the power to bring the Sun to eastern horizon."),
+	_doc_items_usagehelp = S("When weilded, use this item and day will break. The day will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it."),
 	tiles = {"orbs_orb_day.png"},
 	inventory_image = "orbs_orb_day.png^[lowpart:50:orbs_orb_night.png",
 	wield_image = "orbs_orb_day_weild.png^[lowpart:75:orbs_orb_night_weild.png",
 	stack_max=1,
 	on_use = function(itemstack, user)
-		minetest.sound_play("orbs_ding", {pos=pos, loop=false})
+		minetest.sound_play("orbs_ding", {pos=user:getpos(), loop=false})
 		minetest.set_timeofday(0.2)
-		minetest.sound_play("orbs_birds", {pos=pos, loop=false})
-		if not minetest.setting_getbool("creative_mode") then
+		minetest.sound_play("orbs_birds", {pos=user:getpos(), loop=false})
+		if not minetest.settings:get_bool("creative_mode") then
 			itemstack:add_wear(65535/8)
 		end
 		return itemstack
@@ -59,15 +65,17 @@ minetest.register_tool("orbs_of_time:orb_dawn", {
 
 minetest.register_tool("orbs_of_time:orb_dusk",{
 	description = S("Orb of Dusk"),
+	_doc_items_longdesc = S("This magical orb grants you the power to send the Sun to western horizon."),
+	_doc_items_usagehelp = S("When weilded, use this item and night will fall. The night will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it."),
 	tiles = {"orbs_orb_night.png"},
 	inventory_image = "orbs_orb_night.png^[lowpart:50:orbs_orb_day.png",
 	wield_image = "orbs_orb_night_weild.png^[lowpart:75:orbs_orb_day_weild.png",
 	stack_max=1,
 	on_use = function(itemstack, user)
-		minetest.sound_play("orbs_ding", {pos=pos, loop=false})
+		minetest.sound_play("orbs_ding", {pos=user:getpos(), loop=false})
 		minetest.set_timeofday(0.8)
-		minetest.sound_play("orbs_owl", {pos=pos, loop=false})
-		if not minetest.setting_getbool("creative_mode") then
+		minetest.sound_play("orbs_owl", {pos=user:getpos(), loop=false})
+		if not minetest.settings:get_bool("creative_mode") then
 			itemstack:add_wear(65535/8)
 		end
 		return itemstack
@@ -78,38 +86,58 @@ minetest.register_tool("orbs_of_time:orb_dusk",{
 --Crafting
 -----------
 
-minetest.register_craft( {
-  output = "orbs_of_time:orb_day",
-  recipe = {
-    {"default:diamond", "default:diamond","default:diamond"},
-    {"default:diamond", "default:mese_crystal","default:diamond"},
-    {"default:diamond", "default:diamond","default:diamond"}
-   },
+if minetest.get_modpath("mcl_core") then
+	minetest.register_craft({
+		output = "orbs_of_time:orb_day",
+		recipe = {
+			{"mcl_core:diamond", "mcl_core:diamond","mcl_core:diamond"},
+			{"mcl_core:diamond", "mesecons:redstone","mcl_core:diamond"},
+			{"mcl_core:diamond", "mcl_core:diamond","mcl_core:diamond"}
+		 },
+	})
+
+	minetest.register_craft({
+		output = "orbs_of_time:orb_night",
+		recipe = {
+			{"mcl_core:diamond", "mcl_core:diamond","mcl_core:diamond"},
+			{"mcl_core:diamond", "mcl_dye:black","mcl_core:diamond"},
+			{"mcl_core:diamond", "mcl_core:diamond","mcl_core:diamond"}
+		},
+	})
+else
+	minetest.register_craft({
+		output = "orbs_of_time:orb_day",
+		recipe = {
+			{"default:diamond", "default:diamond","default:diamond"},
+			{"default:diamond", "default:mese_crystal_fragment","default:diamond"},
+			{"default:diamond", "default:diamond","default:diamond"}
+		},
+	})
+
+	minetest.register_craft({
+		output = "orbs_of_time:orb_night",
+		recipe = {
+			{"default:diamond", "default:diamond","default:diamond"},
+			{"default:diamond", "default:obsidian_shard","default:diamond"},
+			{"default:diamond", "default:diamond","default:diamond"}
+		},
+	})
+end
+
+minetest.register_craft({
+	output = "orbs_of_time:orb_dawn 2",
+	recipe = {
+		{"orbs_of_time:orb_day"},
+		{"orbs_of_time:orb_night"},
+	},
 })
 
 minetest.register_craft({
-  output = "orbs_of_time:orb_night",
-  recipe = {
-   {"default:diamond", "default:diamond","default:diamond"},
-   {"default:diamond", "default:obsidian_shard","default:diamond"},
-   {"default:diamond", "default:diamond","default:diamond"}
-  },
-})
-
-minetest.register_craft({
-  output = "orbs_of_time:orb_dawn 2",
-  recipe = {
-   {"orbs_of_time:orb_day"},
-   {"orbs_of_time:orb_night"},
-  },
-})
-
-minetest.register_craft({
-  output = "orbs_of_time:orb_dusk 2",
-  recipe = {
-   {"orbs_of_time:orb_night"},
-   {"orbs_of_time:orb_day"},
-  },
+	output = "orbs_of_time:orb_dusk 2",
+	recipe = {
+		{"orbs_of_time:orb_night"},
+		{"orbs_of_time:orb_day"},
+	},
 })
 
 -----------

intllib.lua

@@ -1,45 +0,0 @@
-
--- Fallback functions for when `intllib` is not installed.
--- Code released under Unlicense <http://unlicense.org>.
-
--- Get the latest version of this file at:
---   https://raw.githubusercontent.com/minetest-mods/intllib/master/lib/intllib.lua
-
-local function format(str, ...)
-	local args = { ... }
-	local function repl(escape, open, num, close)
-		if escape == "" then
-			local replacement = tostring(args[tonumber(num)])
-			if open == "" then
-				replacement = replacement..close
-			end
-			return replacement
-		else
-			return "@"..open..num..close
-		end
-	end
-	return (str:gsub("(@?)@(%(?)(%d+)(%)?)", repl))
-end
-
-local gettext, ngettext
-if minetest.get_modpath("intllib") then
-	if intllib.make_gettext_pair then
-		-- New method using gettext.
-		gettext, ngettext = intllib.make_gettext_pair()
-	else
-		-- Old method using text files.
-		gettext = intllib.Getter()
-	end
-end
-
--- Fill in missing functions.
-
-gettext = gettext or function(msgid, ...)
-	return format(msgid, ...)
-end
-
-ngettext = ngettext or function(msgid, msgid_plural, n, ...)
-	return format(n==1 and msgid or msgid_plural, ...)
-end
-
-return gettext, ngettext

locale/orbs_of_time.es.tr

@@ -0,0 +1,26 @@
+# textdomain: orbs_of_time
+
+
+### init.lua ###
+
+Orb of Dawn=Orbe del amanecer
+Orb of Dusk=Orbe del anochecer
+Orb of Midday=Orbe del mediodía
+Orb of Midnight=Orbe de medianoche
+
+This magical orb grants you the power to banish the Sun to the bottom of the world.=Este orbe mágico te da el poder de ocultar completamente el Sol.
+
+This magical orb grants you the power to bring the Sun to eastern horizon.=Este orbe mágico te da el poder de llevar el Sol al horizonte oriental.
+
+This magical orb grants you the power to bring the Sun to the zenith of the sky.=Este orbe mágico te da el poder de llevar el Sol a la cima del cielo.
+
+This magical orb grants you the power to send the Sun to western horizon.=Este orbe mágico te da el poder de enviar el Sol al horizonte occidental".
+
+When weilded, use this item and day will break. The day will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=Cuando lo lleves puesto, usa este objeto y lleva el sol al horizonte oriental.El día progresará normalmente desde este punto. Este orbe se puede utilizar hasta ocho veces.- Una vez por cada diamante que se utilizó para elaborarlo.
+
+When weilded, use this item and night will fall. The night will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=Cuando lo lleves puesto, usa este objeto y lleva el sol al horizonte occidental.La noche progresará normalmente desde este punto. Este orbe se puede utilizar hasta ocho veces.- Una vez por cada diamante que se utilizó para elaborarlo."
+
+When weilded, use this item and the Moon will jump to its highest point. The night will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=Cuando lo lleves puesto, usa este objeto y la luna aparecerá en su punto más altoLa noche progresará normalmente desde este punto. Este orbe se puede utilizar hasta ocho veces.- Una vez por cada diamante que se utilizó para elaborarlo.
+
+When weilded, use this item and the Sun will jump to its highest point. The day will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=Cuando lo lleves puesto, usa este objeto y el Sol saltará a su punto más alto.El día progresará normalmente desde este punto. Este orbe se puede utilizar hasta ocho veces.- Una vez por cada diamante que se utilizó para elaborarlo.
+

locale/template.pot

@@ -1,33 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
-# This file is distributed under the same license as the PACKAGE package.
-# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2017-02-25 20:04-0700\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: LANGUAGE <LL@li.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=CHARSET\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#: init.lua:9
-msgid "Orb of Midday"
-msgstr ""
-
-#: init.lua:24
-msgid "Orb of Midnight"
-msgstr ""
-
-#: init.lua:40
-msgid "Orb of Dawn"
-msgstr ""
-
-#: init.lua:55
-msgid "Orb of Dusk"
-msgstr ""

locale/template.txt

@@ -0,0 +1,26 @@
+# textdomain: orbs_of_time
+
+
+### init.lua ###
+
+Orb of Dawn=
+Orb of Dusk=
+Orb of Midday=
+Orb of Midnight=
+
+This magical orb grants you the power to banish the Sun to the bottom of the world.=
+
+This magical orb grants you the power to bring the Sun to eastern horizon.=
+
+This magical orb grants you the power to bring the Sun to the zenith of the sky.=
+
+This magical orb grants you the power to send the Sun to western horizon.=
+
+When weilded, use this item and day will break. The day will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=
+
+When weilded, use this item and night will fall. The night will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=
+
+When weilded, use this item and the Moon will jump to its highest point. The night will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=
+
+When weilded, use this item and the Sun will jump to its highest point. The day will then progress normally from there. This orb can be used eight times - once for each diamond that was used to craft it.=
+

mod.conf

@@ -1 +1,3 @@
 name = orbs_of_time
+optional_depends = default, mcl_core, loot, doc
+description = A mod containing magical orbs a player can use a limited number of times to change the time of day