For Minetest 5.5 and above

How do I install this?

Arena_lib is a library for Minetest working as a core for any arena mini-game you have in mind. It comes with an arena manager and a signs system. The latter creates a bridge inside your own server between the hub and your actual mod (deathmatch, capture the flag, assault, you name it). In other words, you don't have to do the boring job and you can focus exclusively on your minigame(s) :*

What's new: 5.4.0 - "Better Signs"
  • Redo signs infobox
  • customise arena_lib and minigames through the arena_lib world folder
  • Allow most arena operations (creation, editing, removal etc) to be run through built-in commands
  • Join a game from spectate mode
  • Let spectators and players interact with each other in the celebration phase
  • Go through the celebration phase even when there are no players left inside the arena
  • Force minigames to have a celebration phase
  • Possibility to run /quit even when there is only one player left, but can't quit anymore during the celebration phase
  • Add /arenas gamelist (and its alias /arenas glist) to list all the installed minigames
  • Add arena parameter thumbnail
  • Prevent people from entering and leaving queues repeatedly in a short amount of time
  • Editor: option to change stars visiblity at daytime
  • Use offset instead of position for HUD elements
  • Add description to mod.conf

Older and dev changelogs


  1. Install it as any other mod
  2. Launch the world at least once with arena_lib enabled and then check worlds/nameofyourworld/arena_lib to customise it
  3. (modders only) Dive into the full documentation to understand how to create minigames

Known conflicts

Beds or any other mod overriding the default respawn system
SkinsDB or any other mod applying a 3D model onto the player, if teams_color_overlay is used
Weather or any other mod changing players skybox at runtime (custom celestial vaults will be overridden)

Coming next

Have a look at the project milestones



Do you recommend this mod?

  • Helps make a diverse array of minigames... almost any minigame you want.

    Arena_lib is very useful for making minigames (I have made/helped make 5 minigames so far) It provides well-documented callbacks to run and handle your minigame, as well as nice extras such as spectate mode, an arena editor GUI, background music handler, and more.

    It is based on the idea of punching a sign to enter a queue for the minigame. The sign displays information about the arena (number of players, arena status, etc) and rightclicking it gives more into and a menu to enter spectate.

    Arenas are physically just a collection of positions that the players will be teleported to when the game starts. its up to the arena maker to make an inescapable arena, and make the arena have the features that it should for the minigame.

    There are per-arena variables (properties) that can be set in the arena editor. That can let you do things like clear the board, or reset it, (by storing positions) or set arena specific variables to initialize that arena.

    the arena editor is also expandable per minigame mod.

    Did I mention, the documentation is great?

  • Great lib!

    It saved me the immense effort of having to create an arena management system from scratch :D

  • Great Mod!

    I like this mod. Now everybody can make a minigame. At my old server(which i never published) i wanted make a mesewars minigame, but without this libary that would be maybe impossile. Thankyou Zughy! Edit: Maybe you could add minigames type: tempoary: minigames which use round system like block league alwaysrunning: minigames which you can join every time you like and quit like skyblock.

    Oh and please add that you can quit arenas which are singleplayer, thankyou.

  • Great lib! Very helpful

    I REALLY recommend this lib because it helps and give a boost about the creation of a minigame in Minetest. There is also a "sampleminigame" Mod that you can use to try the lib and it could be a usefull template to start to create your first minigame!

    I also would like to tell that there is a huge and detailed documentation that helps and guide you while coding the mod (in my case, all my questions found the solutions inside there)

    I really appreciated it 👍!


Used By