Knowledge Base (Posts about mod)

Script to stay synced to upstreams for Luanti mods

bgstack15 — Tue, 03 Mar 2026 14:27:00 GMT

I added a script to my repo for initializing a Mineclonia installation that uses a separate location to synchronize my local repositories to the upstream paths, if they still exist.

files/2026/listings/mod-upstreams.sh (Source)

	`#!/bin/sh`
	`# Startdate: 2026-01-30-6 13:35`
	`# Purpose: List and track git remotes for Luanti mods I care about`

	`# Config`
	`host="http://server3/git/luanti"`
	`WORKDIR="${WORKDIR:-${HOME}/mod-upstreams}"`

	`# Functions`

	`ginit() {`
	`err() {`
	`printf '%s\n' "${@}" 1>&2`
	`}`
	`err "# ginit ${*}"`
	`if test "${#}" -lt 1 ;`
	`then`
	`err "Usage: ginit <repository_url> [branch_name] [dirname]"`
	`return 1`
	`fi`
	`REPO_URL="${1}"`
	`REPO_DIR="$( basename "${REPO_URL}" .git )"`
	`BRANCH_NAME="${2}"`
	`DIRNAME="${3}"`
	`if test -n "${DIRNAME}" ; then REPO_DIR="${DIRNAME}" ; fi`
	`if test -d "${REPO_DIR}" ;`
	`then`
	`err "Directory ${REPO_DIR} already exists. Changing directory to it."`
	`cd "${REPO_DIR}" \|\| return`
	`if test -n "${BRANCH_NAME}" ;`
	`then`
	`err "Switching to branch ${BRANCH_NAME}"`
	`git fetch --all`
	`# my old redirect trick to filter stderr`
	`{`
	`{`
	`# Use 'git switch' (modern) or 'git checkout' (older versions)`
	`# 'git switch -c' creates and switches to a new branch if it doesn't exist locally`
	`git switch -c "${BRANCH_NAME}" "origin/${BRANCH_NAME}" \|\| \`
	`git checkout -b "${BRANCH_NAME}" "origin/${BRANCH_NAME}" \|\| \`
	`git checkout "${BRANCH_NAME}"`
	`} 2>&1 1>&3 \| sed -r -e '/fatal: a branch named.*already exists/d' 1>&2`
	`} 3>&1`
	`fi`
	`else`
	`if test -n "${BRANCH_NAME}" ;`
	`then`
	`err "Cloning branch ${BRANCH_NAME} into ${REPO_DIR}"`
	`git clone -b "${BRANCH_NAME}" "${REPO_URL}" "${REPO_DIR}"`
	`else`
	`err "Cloning default branch into ${REPO_DIR}"`
	`git clone "${REPO_URL}" "${REPO_DIR}"`
	`fi`
	`if test -d "${REPO_DIR}" ;`
	`then`
	`cd "${REPO_DIR}" \|\| return`
	`git pull`
	`err "Changed directory to ${REPO_DIR}"`
	`else`
	`err "Failed to clone repository"`
	`return 1`
	`fi`
	`fi`
	`}`

	`sync_repos() {`
	`_origin="${1}"`
	`_dest="${2}"`
	`_branches="${3}"`
	`cd "${WORKDIR}"`
	`if ginit "${_origin}" ;`
	`then`
	`{ {`
	`git remote add dest "${_dest}"`
	`} 2>&1 1>&3 \| sed -r -e '/error: remote.*already exists/d' 1>&2 ; } 3>&1`
	`git pull --all`
	`echo "${_branches},main,master" \| tr ',' '\n' \| awk '!x[$0]++' \| while read branch ;`
	`do`
	`{ {`
	`git switch -c "${branch}" "origin/${branch}" \|\| \`
	`git checkout -b "${branch}" "origin/${branch}" \|\| \`
	`git checkout "${branch}"`
	`git push dest "${branch}"`
	`} 2>&1 1>&3 \| sed -r -e '/fatal: a branch named.*already exists/d' 1>&2 ; } 3>&1`
	`done`
	`fi`
	`}`

	`# sync_repos origin dest "branches,comma-separated"`
	`sync_repos https://github.com/JamesClarke7283/enchantments_extractor "${host}/enchantments_extractor" "main"`
	`# enchantments_workbench is mine`
	`sync_repos https://codeberg.org/camelia/farmtools "${host}/farmtools" "main"`
	`sync_repos https://codeberg.org/Wuzzy/minetest_inventory_icon "${host}/minetest_inventory_icon"`
	`sync_repos https://github.com/JamesClarke7283/inventory_pouches "${host}/inventory_pouches"`
	`sync_repos https://github.com/ketwaroo/minetest-k-ambient-light "${host}-readonly/minetest-k-ambient-light" "main"`
	`sync_repos https://github.com/ketwaroo/minetest-k-recycler "${host}-readonly/minetest-k-recycler" "main"`
	`# lava_furnace is mine`
	`sync_repos https://codeberg.org/SilverSandstone/leads "${host}-readonly/leads" "main"`
	`# list_to_file is mine`
	`sync_repos https://github.com/minetest-mapserver/mapserver_mod "${host}-readonly/mapserver_mod" "master"`
	`# mcl_chiseled_bookshelf is mine`
	`# mcl_colored_chests is mine`
	`sync_repos https://codeberg.org/TomCon/mcl_copper_stuff "${host}-readonly/mcl_copper_stuff" "master"`
	`sync_repos https://codeberg.org/rudzik8/mcl_cozy "${host}/mcl_cozy" "master"`
	`sync_repos https://codeberg.org/rudzik8/mcl_decor "${host}-readonly/mcl_decor" "master"`
	`sync_repos https://codeberg.org/rudzik8/mcl_emerald_stuff "${host}/mcl_emerald_stuff" "main"`
	`# mcl_lapis_stuff is mine`
	`sync_repos https://github.com/ketwaroo/minetest-mcl-misk-recipes "${host}/mcl_misk_recipes" "main"`
	`sync_repos https://codeberg.org/rudzik8/mcl_morefood "${host}/mcl_morefood" "main"`
	`# milk_potion is mine`
	`# molten_sailor_mcl is mine`
	`sync_repos https://git.0x7be.net/dirk/mtimer "${host}/mtimer" "main"`
	`sync_repos https://github.com/minetest-go/mtui_mod "${host}-readonly/mtui_mod" "master"`
	`# obsidian_extra is mine`
	`sync_repos https://github.com/LizzyFleckenstein03/playerlist "${host}/playerlist" "main"`
	`sync_repos https://github.com/acmgit/minetest_poi "${host}/minetest_poi"`
	`# privs_per_world is mine`
	`sync_repos https://gitlab.com/cronvel/mt-respawn "${host}/mt-respawn"`
	`# safe_chest upstream is gone, so I guess I am upstream now.`
	`# sync_repos https://github.com/smnoe01/safe_chest "${host}/safe_chest"`
	`sync_repos https://github.com/mt-historical/snippets "${host}-readonly/snippets"`
	`sync_repos https://github.com/DonBatman/myairwand "${host}-readonly/myairwand"`
	`sync_repos https://github.com/Twinsonian/magicsquare "${host}/magicsquare" "main"`

The purpose of this script is to make synchronizing to upstream easy. I tend to have very small changes to upstream. On occasion my changes get merged into upstream, and I don't need any feature branches! For some of these, I have private patches that have been declined by upstream or never sent to them in the first place.

This script also documents the mods I care about. Any of the "readonly" ones are ones for which I have no changes at all. I have changed my mind and have had to move some around, when I realized I wanted to patch them after all.

New Luanti csm: node_inv_read

bgstack15 — Mon, 23 Feb 2026 14:13:00 GMT

I wrote a new client side mod for Luanti that is an inventory cheat. Technically it doesn't work in Minetest Game, so it only works in Mineclonia. I couldn't figure that out.

This mod lets you punch any node, and if it has inventory, it will show all the inventories to you. I have tested it with up to 6 inventories. And if a node does not use the allow_metadata_inventory_put functions, you can even move items around!

Get the code.

My necessary Luanti mods for Minetest Game

bgstack15 — Tue, 09 Dec 2025 14:15:00 GMT

Overview

I recently published my list of mods for Mineclonia, and here is my list of mods I want for Minetest Game (ContentDB).

It's been said that most Minetest Game servers are just a mod soup that the admin wants. Well, it's true.

Mods I use for Minetest Game

Airutils

This is a dependency library and helper components for the specific airplanes added by other mods. I do not have any patches for this.

ContentDB scm

Automobiles Pack (automobiles_pck)

Written by the same prolific Luanti mod author Apercy as the previous mod, this one adds a bunch of cool ground vehicles. I never sent any patches, but I did submit a single bug report. I want automobiles, and this seemed to be the premiere way to get them!

ContentDB scm

My necessary Luanti mods for Mineclonia

bgstack15 — Mon, 01 Dec 2025 13:44:00 GMT

Overview

I like the Free Software game Luanti. You can play in a sandbox world, with a great base for mods in Minetest Game (ContentDB). You can even get a premium experience with Mineclonia (ContentDB).

While Mineclonia can be played without mods because it already bundles many mods in with it, mods improve it even more. And I would definitely want to add mods to MTG. Here is my official list of mods to use in Mineclonia, in alphabetical order. I have even written about some of these before, particuarly the ones I wrote. I will publish my list of MTG mods next time.

Mods I use for Mineclonia

Enchantments extractor (enchantments_extractor)

Enchantments extractor is a nifty object that lets you strip enchantments from objects into books, or splits an object with multiple enchantments into each individual enchanted book. This is very useful to remove the scavenged items with random enchantments, for further use.

ContentDB scm: upstream mine

Enchantments workbench (enchantments_workbench)

I wrote this one. This was directly inspired by the enchantments extractor, and it gives you an object that lets you upgrade enchanted books and duplicate them: These abilities are very useful in a survival world.

ContentDB scm

New Luanti mod: privs_per_world

bgstack15 — Fri, 10 Oct 2025 13:10:00 GMT

I wrote a novel mod for Luanti, specifically for Mineclonia. This mod is named privs_per_world (codeberg, ContentDB) and it is an engine for automatically granting and revoking privileges based on entering and leaving the various worlds (Overworld, Nether, End) of Mineclonia.

The default settings grant fast, fly, noclip to players entering the Nether, and revokes these privileges upon leaving.

The server admin can configure settings in minetest.conf. See settingtypes.txt, but it is easier to use settings.lua.

I know that the Mineclonia guys tend to adapt existing mods, so if there's some "worlds" mod that facilitates different "dimensions" and the transport to and from them, this might be useful elsewhere but I don't have any test environments for that.

Here is the default settings, which are useful for a Mineclonia survival server.

ppw.settings = {
    nether = {
        enter = { 
            give = core.settings:get("privs_per_world.nether_enter_give") or "fly,noclip,fast",
            take = core.settings:get("privs_per_world.nether_enter_take") or "",
        },
        leave = {
            give = core.settings:get("privs_per_world.nether_leave_give") or "",
            take = core.settings:get("privs_per_world.nether_leave_take") or "fly,noclip,fast",
        },
    },
    overworld = {
        enter = {
            give = core.settings:get("privs_per_world.overworld_enter_give") or "",
            take = core.settings:get("privs_per_world.overworld_enter_take") or "",
        },
        leave = {
            give = core.settings:get("privs_per_world.overworld_leave_give") or "",
            take = core.settings:get("privs_per_world.overworld_leave_take") or "",
        },
    }
}

Future improvements

I might need to use mod storage to store privileges of user before entering/leaving the world, so we can restore them. But this would lose any privileges that change while the user is in the world. So register_on_grant_priv might be useful, if this mod's own set_privileges does not trigger those.

New Luanti mod: mcl_chiseled_bookshelf

bgstack15 — Tue, 16 Sep 2025 13:24:00 GMT

I wrote a novel Luanti mod, specifically for Mineclonia, named mcl_chiseled_bookshelf.

I wrote this to be incorporated into Mineclonia but as of the time of this writing, Mineclonia is taking it in a different direction (it is not yet in a released version of the game), so I'm going to keep my work separate so I will use my implementation. It's not any harder than managing the other dozens of mods I use on every server.

Using

See Chiseled Bookshelf – Minecraft Wiki.

Screenshots

Crafting recipe for chiseled bookshelf

Screenshot of a chiseled bookshelf

Settings

None.

How I keep Luanti mods updated

bgstack15 — Fri, 12 Sep 2025 13:13:00 GMT

Some of my mods for my game server of Luanti come from various git scm sources, and some just from ContentDB. I don't update the ContentDB ones during regular maintenance. I might spot update them, but mostly I switch them to git when I want to make some changes.

cd ~/.minetest/mods
for word in $( find */.git -maxdepth 0 -printf '%h\n' ) ; do ( cd "${word}" ; git fetch ; git status | sed -r -e "s@^@${word}: @" ; ) ; done

For regular maintenance, I visit just pull down all the info for each git remote and then I visit any that report they are behind, and manually git pull.

Sure, it's manual, but updates to applications should be reviewed by a human and not just blindly applied.

New luanti mod: Enchantments Workbench

bgstack15 — Thu, 04 Sep 2025 13:21:00 GMT

I wrote a novel Luanti mod, specifically for Mineclonia, named enchantments_workbench. You can get it from ContentDB too, in-game.

I was inspired by mod enchantments_extractor (ContentDB), and some ideas I had had for a while about facilitating the enchantments on my tools.

Description

This mod is designed for Mineclonia and adds a node, enchantment workbench, that performs 2 different operations on enchanted books.

Using

Enhance: e.g., Efficiency I + Efficiency I = Efficiency II
Copy: e.g., Efficiency I + empty book = two Efficiency I books

Use lapis lazuli or emeralds to make the very slow process happen faster. While the slot is labeled catalyst, the item is consumed! But it is not strictly necessary if you can wait.

Screenshots

Crafting recipe for enchantment workbench

Screenshot of formspec (dialog) for enchantment workbench

Settings

# Workflow time for enchantment workbench, seconds
# default 1200 (2 in-game days)
enchantments_workbench.workflow_time (Workflow time) int 1200

# Catalyst values required to speed up the process to 100%
# Comma separate list of `<item> <count>`
# default `mcl_core:lapis 5,mcl_core:emerald 10`
enchantments_workbench.catalysts (Catalyst values for 100%) string mcl_core:lapis 5,mcl_core:emerald 10

Mod for Luanti: lava furnace

bgstack15 — Tue, 27 May 2025 12:43:00 GMT

I wrote a novel mod for Luanti, specifically for Mineclonia: Lava Furnace.

Go get the code for yourself!

Snippets of the readme

Furnaces powered by being adjacent to lava for Mineclonia. Yes, this breaks balance because it does not need fuel. This is for fun, for large-scale operations in the lategame. Do not install this mod if the imbalance bothers you.

Heavily based on Minetest Game (default/furnace.lua).

Using

Build a lava-powered furnace with a gold block surrounded by 8 cobblestone, or a gold block and a furnace. Lava source or flowing lava must be adjacent (NESWUD) touching this lava furnace.

Configuring

# Speed factor for cooking with lava furnace.
# 1 is a regular furnace, 2 is a blast furnace.
# Requires a restart to take effect.
lava_furnace.factor (Cooking speed factor for lava) float 4.0 0.0 16.0

# Comma-separated list of '<node>,<node>'
# Nodes that can power lava furnace when immediately adjacent
lava_furnace.fuel_nodes (Nodes that power lava furnace) string mcl_core:lava_source,mcl_core:lava_flowing

By default these settings make a lava furnace 4x faster than a regular furnace, and the lava furnace must touch a lava source or flowing lava.

It's a little overpowered for early gameplay, but it makes lategame play easier because you don't have to keep every single furnace stocked with fuel.

Screenshot of lava furnace cooking while in front of flowing lava

Additional credits

Additional notes

Thankfully, I was able to just adapt the existing furnace code. I just disabled consuming the fuel, and made it "fueled" if any of the 6 surface-adjacent nodes is lava source or flowing lava. I also disabled putting fuel in the fuel slot, which is still there in case you want to put a bucket for drying out a wet sponge.

It took me less than a day to build and test this, which means, of course, that it has not been battle-tested beyond my small server. Contributions welcome!

Icons and inventory pouches now load at player login

bgstack15 — Tue, 01 Apr 2025 13:25:00 GMT

I really like these 2 mods for Luanti.

I added the original functionality for inventory_icon to show the player's pouches in the HUD. But inventory_pouches only loads the inventory for a pouch when the player first opens the pouch to use it, so the HUD doesn't display it until then.

So I have written my latest commit to inventory_pouches which loads the player's pouch inventories at login time!

Happy mining!

Corner of Luanti HUD showing some inventory pouch icons