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 NanoLimbo

---

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 - 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 configuration

After setting servers.use-virtual-server to true and restarting the server,
you need to configure NanoLimbo — its configuration is located in:

/plugins/tiAuth/limbo

Configure infoForwarding

• Set type to MODERN if you are using VELOCITY_MODERN,
  then specify your key under secret.
• If you are using BungeeGuard, set type to BUNGEE_GUARD,
  then specify your tokens under tokens.
• LEGACY mode is not recommended as it is insecure.

Optional Settings

You may optionally:

• Change the port
• Disable BossBar, Join Message, etc.

After editing /plugins/tiAuth/limbo/settings.yml,
restart your proxy to apply the changes.

---

Support

Discord Server
Telegram