Your first mod

This guide walks you through creating and uploading a minimal working mod.

1. Create the files

A mod needs at minimum two files: mod.conf and init.lua.

Create a folder on your computer called my_mod. Inside it, create the following files.

mod.conf

name = my_mod
description = My first Plextoria mod

init.lua

minetest.register_on_joinplayer(function(player)
    local name = player:get_player_name()
    minetest.chat_send_player(name, "Welcome to my world!")
end)

This mod sends a welcome message to every player who joins.

2. Zip the files

Select both mod.conf and init.lua and compress them into a .zip file. The zip must contain the files at its root, not inside a subfolder.

If you zip the folder itself rather than the files inside it, Plextoria will handle the extra directory level automatically.

3. Upload via Creator Dashboard

1. Go to your Creator Dashboard
2. Find your world and click Manage mods
3. Enter a display name for your mod
4. Select your .zip file and click Upload

4. Test it

Once uploaded, restart your world by clicking Play. Join the world and you should see your welcome message in chat.

If the mod does not load, check that your mod.conf contains a valid name field and that your init.lua has no syntax errors.