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: 6.4.0 - "Eh! Voleeevi!"
  • Add minigame recipe disabled_huds to choose which HUDs will be disabled during the minigame
  • Let entities damage people in minigames
  • Add on_prejoin callback
  • Players kicked through /arenas kick must wait 2 minutes before re-entering a match
  • Prevent players from being eliminated during the celebration phase
  • Improve HUD position (title and broadcast)
  • Arena signs HUD: fix size of some text fields
  • Editor: also show count of 1 in players section
  • Remove disabled damage types from debug (as it's not a per arena property)
  • Improve translation system (@Wuzzy)
  • Change license GPL -> AGPL

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) First time? Check out the wiki to create your first minigame. Otherwise, dive into the full documentation

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.

  • Quite powerful

    I haven't worked w/ arena_lib a lot so far but from what I've learned by going through the documentation and fixing some bugs of existing minigames, I think it seems quite powerful. What is especially interesting is the editor mode where you can edit arenas with special "items" in your hotbar which act like some kind of "mini menu". It is unusual but I understood it somehow.

    Nothing of the mod's design seems to disturb me so far, coding with it is fairly reasonable with no weird surprises.

    A minor downside are the signs because they introduce non-translatable text. Signs are hardcoded in arena_lib and can't be removed but I've read it is possible to add alternative entry methods (not tested so far).

    The only major criticism I currently have is that there is no player or admin manual, only a programmer's manual because not everything is obvious from the player/admin perspective (although it is mostly intuitive already). For example, I don't know how many players are aware that you can rightclick the signs to enter spectator mode. And it also took me quite some time to figure out how to set up my own test world with arena minigames because the documentation doesn't say.

    Arena_lib has been successfully supporting the A.E.S. minigame server which is I guess evidence enough for it's power. Overall, I can give it a clear recommend.

  • If you need to make a minigame this is the library for you

    I' ve used this library since the earliest versions and it has only improved since then. To date it is in my opinion the best way to create minigames on minetests, fast, easy to use, well documented, and constantly evolving.

  • 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