tiAuth

Authorization plugin for BungeeCord

---

Features:

• Dialog window support (1.21.6+)
  • Interactive window with a password input field
• Premium mode
  • Allows licensed players to skip password entry by activating local online-mode true
• Session support
  • Allows players to skip password entry for a certain period after successful authentication
• Multiple database types support
  • Supports SQLite, H2, MySQL, PostgreSQL
• Virtual server
  • Virtual server for auth server powered by PicoLimbo

---

Commands:

For players:

• /register <password> <password> - Register an account
• /login <password> - Log in
• /logout - Destory session
• /changepassword <old password> <new password> - Change password
• /premium - Enable premium mode
• /unregister <password> - Delete account

For administrators:

• /tiauth reload - Reload config
  • Permission: tiauth.admin.commands.reload
• /tiauth unregister <player> - Delete player account
  • Permission: tiauth.admin.commands.unregister
• /tiauth changepassword <player> <password> - Change player password
  • Permission: tiauth.admin.commands.changepassword
• /tiauth forcelogin <player> - Force login player
  • Permission: tiauth.admin.commands.forcelogin
• /tiauth migrate <sourceplugin> <sourcedatabase> [file] [user] [password] [host] [port] [name] - Migrate database from other plugins/database type
  • Permission: tiauth.admin.commands.migrate

---

Migration

Supported Plugins

• tiAuth (for changing the database type)
• MCAuth
• LimboAuth
• AuthMe

Migration Commands

Below are the commands for the default database types used by these plugins.

If you are using a file-based database (SQLite or H2):

• Place the database file into the plugin folder.
• For H2, do not include the .mv.db extension in the filename.
• If there is no username or password, set both user and password to empty.

MCAuth SQLite

/tiauth migrate mcauth sqlite auth.db

LimboAuth H2

/tiauth migrate limboauth h2 limboauth-v2 empty empty

AuthMe SQLite

/tiauth migrate authme sqlite authme.db

Important — LimboAuth H2 Migration

Before migrating from LimboAuth H2 (which uses H2 as its default database):

1. Open your config.yml.
2. Change the version value under libraries.h-2 to 2.1.214.
3. Delete the tiAuth database file (if you are using H2 — it’s the default).
4. Restart your server.

This is required because LimboAuth uses an outdated version of H2 that is incompatible with the newer version used by tiAuth by default.
If you skip these steps, the plugin will throw an error during migration.

---

Virtual server forwarding setup (required for proper player redirection):

1. In the plugin configuration, set servers.use-virtual-server: true and restart the server.
2. Navigate to the virtual server configuration file: /plugins/tiAuth/picolimbo/config.toml.
3. In the [forwarding] section, select your preferred method:
   • MODERN — for Velocity or any proxy supporting Modern forwarding. Enter your key in the secret field.
   • BUNGEE_GUARD — for BungeeGuard. Add a tokens field as an array, for example: tokens = ["123", "456", "789"].
   • LEGACY — for legacy forwarding.
4. Restart the server.

Additional configuration: To disable the use of schematics, set schematic_file = "" in the [world.experimental] section. If you wish to use your own schematic, provide the file path (note: the file may need to be converted; check the PicoLimbo documentation for more details).

Full documentation for PicoLimbo configuration

---

Support

Discord Server
Telegram