Auth Redux by sorcerykid

Auth Redux is a drop-in replacement for the builtin authentication handler of Minetest


Auth Redux is a drop-in replacement for the builtin authentication handler of Minetest. It is designed from the ground up to be robust and secure enough for use on high-traffic Minetest servers, while also addressing a number of outstanding engine bugs (including #5334 and #6783 and #4451) as described last year in the Critical bug in builtin authentication handler forum topic.

Auth Redux is completely Lua-driven, with no external dependencies. It interfaces seamlessly with Minetest's authentication handler API, therefore no complicated setup or configuration is required. It is intended to be compatible with all versions of Minetest 0.4.14+ and 5.x and has been successfully tested under CentOS7, Windows 10, and Windows XP.

For the latest release notes, as well as technical support requests, please visit the forum topic.


Auth Redux provides an efficient and scalable back-end solution for player authentication, making it suitable for even the most demanding server environments. It has been put to the test with a database of over 520,000 registered users -- with no in-game overhead!

The project is a WIP and will be undergoing continuous development based upon your suggestions and feedback. New features and bug-fixes will be announced here as they become available.


Only a few basic steps are required to begin using the Auth_Redux mod immediately with your server.

  1. Unzip the archive into the mods directory of your game
  2. Rename the auth_rx-master directory to "auth_rx"
  3. Execute the conversion scripts (see usage instructions below)

Linux distributions already include the awk command-line utility, so no additional setup is required. However Microsoft Windows users will need to install Gawk for Windows.

Basic Database Import:

If you intend to use Auth Redux with an existing world, then the default authentication database must be converted. A simple awk script is made available for this purpose. It is located within the 'tools' subdirectory.

The following commands will begin the conversion process. Depending on the size of your auth.txt file, it may take several seconds to complete:

> cd auth_rx/tools
> awk -f convert.awk -v mode=convert ~/.minetest/worlds/world/auth.txt

Since the original 'auth.txt' file is no longer needed, it should be renamed for safe-keeping and to prevent conflicts. If you perform daily backups of your world directory, then it is strongly recommend that you archive these three files:

Both files must have read and write permissions. The master database and transaction log should never be removed nor modified directly.

If you are creating a new world, then you can initialize the master database using the same command as above. Simply, create an empty 'auth.txt' file beforehand.