# authmebia A addon for AuthMe Reloaded that replaces chat-based login and register prompts with native Minecraft dialogs (1.21.6+). Players interact through proper GUI windows instead of typing commands in chat. [Source code](https://github.com/Mytai20100/authmebia)

---

Login

![Login dialog](https://cdn.modrinth.com/data/cached_images/cd5d9af9bda7ece8d1d356db202e4a25887c934c_0.webp)

Register

![Register dialog](https://cdn.modrinth.com/data/cached_images/dfe496ec27483904a149e74ee75017cf2c23fe9d_0.webp)

Rules

![Rules dialog](https://cdn.modrinth.com/data/cached_images/e230aa5498712bfe9a8ce5e4fdef85f125260620_0.webp)

Wait screen before join server

![wait](https://cdn.modrinth.com/data/cached_images/744b0c064cf88b80ad1d1b55eb3829c1212a208a_0.webp)

Custom buttons link

![custom link](https://cdn.modrinth.com/data/cached_images/6c9f73d2a0bcd5f67612e970e620766a1de23906_0.webp)

Captcha

![captcha](https://cdn.modrinth.com/data/cached_images/ffcb7bf5ebd6d214edfef4d3959e7f61b58de333_0.webp)

Email verify

![Email verify](https://cdn.modrinth.com/data/cached_images/e5b39e68c1cc8e3fd770c355e3422e600e95426d_0.webp)

Recovery password

![Recovery password](https://cdn.modrinth.com/data/cached_images/3c0b3d3c53b5feadf70431b4eeee284f67fae1de_0.webp)

--- | Requirement | Version | |-------------|---------| | Minecraft | 1.21.6+ | | Paper | ✔ | | Folia | ✔ | | Java | 21 | | AuthMe Reloaded | 6.0.0+ | | ViaVersion | Optional | --- ## Features **Dialog modes** - Pre-spawn dialog mode: the login or register window blocks the connection phase, so the player spawns already authenticated - Post-spawn dialog mode: the window appears after the player joins the world - Three auth input modes: password text field, numeric PIN grid, or per-digit slider **Authentication** - Premium bypass: players whose UUID matches a premium account stored in AuthMe are detected automatically and skip all dialogs entirely - TOTP / 2FA dialog for players who have an authenticator app set up in AuthMe - Captcha dialog synced with AuthMe's captcha setting - Email verification dialog on registration (reuses AuthMe's SMTP config) - Admin-forced password recovery: use `/bia recover ` to flag an account; the player is shown a reset dialog on their next login or immediately if they are already online - Server rules agreement checkbox shown to new players before their account is created - Login attempt limit with kick after too many wrong passwords - Login timeout with optional kick or re-show of the dialog - IP ban with escalating ban durations after repeated failed logins across sessions **Admin tools** - Bypass list: players added with `/bia add` skip all dialogs and fall back to AuthMe's own commands - Custom screens: define any number of dialog windows in config.yml and push them to any online player with `/bia screen [player]` - Debug commands: preview individual dialogs in-game without going through the full login flow **Extras** - Link buttons inside dialogs (open URL, copy to clipboard) - Discord webhook notification on player join or first registration - Welcome image sent to the player after first login - ViaVersion support: players on older protocol versions fall back to AuthMe's normal flow automatically --- ## Commands | Command | Permission | Description | |---|---|---| | `/bia reload` | OP | Reload config and lang | | `/bia info` | - | Show plugin version and status | | `/bia add ` | `authmebia.bypass` | Add player to bypass list | | `/bia rm ` | `authmebia.bypass` | Remove player from bypass list | | `/bia recover ` | `bia.admin.recover` | Force password reset on next login | | `/bia screen [player]` | OP | Show a custom screen to a player | | `/bia debug ` | OP | Test features in-game | Debug features: `captcha`, `email`, `register`, `login`, `wait`, `recover`, `rule`. Use `show` with `captcha` or `email` to preview those dialogs directly without going through the login flow. --- ## AuthMe API used AuthMeBia hooks into AuthMe Reloaded through reflection rather than a compile-time API dependency, so it stays compatible across minor AuthMe builds without recompiling. | Class | Usage | |---|---| | `fr.xephi.authme.api.v3.AuthMeApi` | Core operations: isRegistered, forceLogin, forceRegister, forceLogout, checkPassword, changePassword, isAuthenticated, registerPlayer | | `fr.xephi.authme.data.auth.PlayerAuth` | Read player data: isPremium, getPremiumUuid, getTotpKey, setEmail | | `fr.xephi.authme.datasource.DataSource` | Fetch PlayerAuth records, persist email changes | | `fr.xephi.authme.mail.EmailService` | Check SMTP availability, send verification codes | | `fr.xephi.authme.security.totp.TotpAuthenticator` | Verify TOTP codes for 2FA dialog (`checkCode(PlayerAuth, String)`) | | `fr.xephi.authme.events.LoginEvent` | Detect successful login to complete async futures | | `fr.xephi.authme.events.RegisterEvent` | Detect successful registration | | `fr.xephi.authme.events.FailedLoginEvent` | Detect failed login | --- ## Building from source ### Clone ```bash git clone https://github.com/Mytai20100/authmebia.git cd authmebia ``` ### IntelliJ IDEA (recommended) 1. Open IntelliJ IDEA and choose **Open**, then select the `authmebia` folder. 2. IntelliJ will detect the Gradle project automatically and import it. 3. Wait for the Gradle sync to finish and dependencies to download. 4. Open the **Gradle** panel (right side) and run `Tasks > shadow > shadowJar`. 5. The output jar is in `build/libs/`. ### Command line ```bash ./gradlew shadowJar ``` The built jar is placed in `build/libs/`. Copy it to your server's `plugins/` folder alongside AuthMe Reloaded. --- ## Configuration

config.yml

```yaml # AuthMeBia configuration. # Text fields support MiniMessage color/decoration tags, e.g. , <#ff0000>, . # Use {player} as a placeholder for the player's name where supported. # Use \n inside a string to insert a line break. # Language code for messages (disconnect/kick, errors, chat). # Built-in options: en (English), vi (Vietnamese). # To add your own, copy plugins/AuthMeBia/lang/en.yml to lang/

.yml and edit it.
# Reload with /bia reload.
lang: en

dialog:
  enabled: true
  menu: true
  min_protocol_version: 771
  button_width: 200
  input_width: 200

  register:
    title: "<#4287f5>Create Account"
    content: ""

  login:
    title: "Login"
    content: "Welcome back, {player}!"

  logout_button: "Logout"
  submit_register_button: "Register"
  submit_login_button: "Login"
  allow_close: true

auth_mode:
  # password | pin | slider
  mode: password

  pin:
    length: 4
    title: "Enter your PIN"
    confirm_button: "Confirm"
    delete_button: "Delete"
    button_width: 100

  slider:
    length: 4
    title: "Enter your code"
    confirm_button: "Confirm"
    button_width: 100

auth_wait:
  wait: true
  prejoin: true
  time: 3
  title: "Please wait"
  content: "Logging you in, please wait..."

rule:
  enabled: false
  title: "Server Rules"
  content: ""
  checkbox_label: "I have read and agree to the rules"
  agree_button: "Agree"

discord:
  enabled: false
  webhook_url: ""

welcome_image:
  enabled: false

links:
  enabled: false
  position: grouped
  button_width: 200
  buttons:
    - enabled: true
      label: "<#5865F2>Discord"
      action: open_url
      value: "https://discord.gg/abc"
      width: 200
    - enabled: true
      label: "{player}, copy IP"
      action: copy
      value: "play.example.com"
      width: 200

captcha:
  enabled: false
  length: 5
  title: "Verification"
  content: "Type the code below to continue:\n{code}"
  input_label: "Enter code"
  submit_button: "Verify"
  trust_duration_seconds: 18000

login_attempts:
  enabled: false
  max_tries: 5

login_timeout:
  enabled: false
  seconds: 60
  kick_message: "Authentication timed out. Please reconnect."

recover:
  title: "Reset Password"
  content: "An admin has requested you set a new password."
  new_password_label: "New password"
  confirm_password_label: "Confirm password"
  submit_button: "Set Password"
  success_message: "Password updated successfully."
  mismatch_message: "Passwords do not match. Try again."

email:
  enabled: false
  code_length: 6
  resend_cooldown: 60
  field_label: "Email"
  verify_title: "Verify your email"
  verify_content: "A code was sent to {email}.\nResend available in {cooldown}s."
  code_label: "Code"
  verify_button: "Verify"
  resend_button: "Resend code"
  invalid_email_message: "Please enter a valid email address."
  send_failed_message: "Could not send the email. Please contact an admin."
  wrong_code_error: "Incorrect code"

totp_2fa:
  # Shows a 2FA dialog after login if the player has TOTP enabled in AuthMe.
  # Requires AuthMe 5.6+.
  enabled: false
  title: "Two-Factor Authentication"
  content: "Enter your 6-digit authenticator app code:"
  input_label: "Authenticator code"
  submit_button: "Verify"
  wrong_code_error: "Invalid code"

# Custom dialog screens. Show with: /bia screen  [player]
# Button actions: close, open_url, copy
custom_screens:
  - id: example
    title: "Server Notice"
    content: "Welcome to the server, {player}!\nHave fun playing."
    allow_close: true
    button_width: 200
    buttons:
      - label: "OK"
        action: close
      - label: "<#5865F2>Discord"
        action: open_url
        value: "https://discord.gg/abc"
        width: 200

ip_ban:
  enabled: false
  threshold: 10
  ban_durations_seconds: [600, 1800, 3600, 86400]
```