docs: Update documentation tooling/templates and re-generate

Author: Xephi

authme-core/src/test/java/tools/docs/commands/commands.tpl.md

@@ -1,10 +1,12 @@
 <!-- {gen_warning} -->
-<!-- File auto-generated on {gen_date}. See docs/commands/commands.tpl.md -->
+<!-- File auto-generated on {gen_date}. See authme-core/src/test/java/tools/docs/commands/commands.tpl.md -->
 
 ## AuthMe Commands
 You can use the following commands to use the features of AuthMe. Mandatory arguments are marked with `< >`
 brackets; optional arguments are enclosed in square brackets (`[ ]`).
 
+The command tree is shared across the current Spigot Legacy, Spigot 1.21, and Paper 1.21 builds.
+
 [#commands]
   - **{command}**{arguments}: {description}[permissions]
   <br />Requires `{permissions}`[/permissions]

authme-core/src/test/java/tools/docs/config/config.tpl.md

@@ -1,11 +1,14 @@
 <!-- {gen_warning} -->
-<!-- File auto-generated on {gen_date}. See docs/config/config.tpl.md -->
+<!-- File auto-generated on {gen_date}. See authme-core/src/test/java/tools/docs/config/config.tpl.md -->
 
 ## AuthMe Configuration
 The first time you run AuthMe it will create a config.yml file in the plugins/AuthMe folder,
 with which you can configure various settings. The following is the initial contents of
 the generated config.yml file.
 
+This configuration is generated from the shared `authme-core` module. It applies to the
+current Spigot Legacy, Spigot 1.21, and Paper 1.21 builds unless a setting comment says otherwise.
+
 ```yml
 {config}
 ```

authme-core/src/test/java/tools/docs/hashmethods/hash_algorithms.tpl.md

@@ -1,5 +1,5 @@
 <!-- {gen_warning} -->
-<!-- File auto-generated on {gen_date}. See docs/hashmethods/hash_algorithms.tpl.md -->
+<!-- File auto-generated on {gen_date}. See authme-core/src/test/java/tools/docs/hashmethods/hash_algorithms.tpl.md -->
 
 ## Hash Algorithms
 AuthMe supports the following hash algorithms for storing your passwords safely.

authme-core/src/test/java/tools/docs/permissions/permission_nodes.tpl.md

@@ -1,9 +1,12 @@
 <!-- {gen_warning} -->
-<!-- File auto-generated on {gen_date}. See docs/permissions/permission_nodes.tpl.md -->
+<!-- File auto-generated on {gen_date}. See authme-core/src/test/java/tools/docs/permissions/permission_nodes.tpl.md -->
 
 ## AuthMe Permission Nodes
 The following are the permission nodes that are currently supported by the latest dev builds.
 
+Unless noted otherwise, these nodes are available across the current Spigot Legacy, Spigot 1.21,
+and Paper 1.21 builds.
+
 [#nodes]
   - **{node}** – {description}
 [/#nodes]

authme-core/src/test/java/tools/docs/translations/translations.tpl.md

@@ -1,5 +1,5 @@
 <!-- {gen_warning} -->
-<!-- File auto-generated on {gen_date}. See docs/translations/translations.tpl.md -->
+<!-- File auto-generated on {gen_date}. See authme-core/src/test/java/tools/docs/translations/translations.tpl.md -->
 
 # AuthMe Translations
 The following translations are available in AuthMe. Set `messagesLanguage` to the language code
@@ -8,7 +8,7 @@ in your config.yml to use the language, or use another language code to start a
 Code | Language | Translated | &nbsp;
 ---- | -------- | ---------: | ------
 [#languages]
-[{code}](https://github.com/AuthMe/AuthMeReloaded/blob/master/src/main/resources/messages/messages_{code}.yml) | {name} | {percentage}% | <img src="https://via.placeholder.com/{percentage}x7/{color}?text=%20" alt="{percentage}" />
+[{code}](https://github.com/AuthMe/AuthMeReloaded/blob/master/authme-core/src/main/resources/messages/messages_{code}.yml) | {name} | {percentage}% | <img src="https://via.placeholder.com/{percentage}x7/{color}?text=%20" alt="{percentage}" />
 [/#languages]
 
 {gen_footer}

authme-core/src/test/java/tools/utils/ToolsConstants.java

@@ -11,7 +11,8 @@ public final class ToolsConstants {
 
     public static final String TOOLS_SOURCE_ROOT = "src/test/java/tools/";
 
-    public static final String DOCS_FOLDER = "docs/";
+    // Docs are published at the repository root, while the tools run from the authme-core module.
+    public static final String DOCS_FOLDER = "../docs/";
 
     public static final String DOCS_FOLDER_URL = "https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/";
 

docs/commands.md

@@ -1,10 +1,12 @@
 <!-- AUTO-GENERATED FILE! Do not edit this directly -->
-<!-- File auto-generated on Sun Apr 04 21:31:42 CEST 2021. See docs/commands/commands.tpl.md -->
+<!-- File auto-generated on Mon Apr 20 11:07:34 CEST 2026. See authme-core/src/test/java/tools/docs/commands/commands.tpl.md -->
 
 ## AuthMe Commands
 You can use the following commands to use the features of AuthMe. Mandatory arguments are marked with `< >`
 brackets; optional arguments are enclosed in square brackets (`[ ]`).
 
+The command tree is shared across the current Spigot Legacy, Spigot 1.21, and Paper 1.21 builds.
+
 - **/authme**: The main AuthMeReloaded command. The root for all admin commands.
 - **/authme register** &lt;player> &lt;password>: Register the specified player with the specified password.
   <br />Requires `authme.admin.register`
@@ -108,4 +110,4 @@ brackets; optional arguments are enclosed in square brackets (`[ ]`).
 
 ---
 
-This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Sun Apr 04 21:31:42 CEST 2021
+This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Mon Apr 20 11:07:34 CEST 2026

docs/config.md

@@ -1,11 +1,14 @@
 <!-- AUTO-GENERATED FILE! Do not edit this directly -->
-<!-- File auto-generated on Thu Jul 28 18:11:22 CEST 2022. See docs/config/config.tpl.md -->
+<!-- File auto-generated on Mon Apr 20 11:07:35 CEST 2026. See authme-core/src/test/java/tools/docs/config/config.tpl.md -->
 
 ## AuthMe Configuration
 The first time you run AuthMe it will create a config.yml file in the plugins/AuthMe folder,
 with which you can configure various settings. The following is the initial contents of
 the generated config.yml file.
 
+This configuration is generated from the shared `authme-core` module. It applies to the
+current Spigot Legacy, Spigot 1.21, and Paper 1.21 builds unless a setting comment says otherwise.
+
 ```yml
 DataSource:
     # What type of database do you want to use?
@@ -251,7 +254,7 @@ settings:
         # Maximum length of password
         passwordMaxLength: 30
         # Possible values: SHA256, BCRYPT, BCRYPT2Y, PBKDF2, SALTEDSHA512,
-        # MYBB, IPB3, PHPBB, PHPFUSION, SMF, XENFORO, XAUTH, JOOMLA, WBB3, WBB4, MD5VB,
+        # MYBB, IPB3, PHPBB, PHPFUSION, SMF, XENFORO, JOOMLA, WBB3, WBB4, MD5VB,
         # PBKDF2DJANGO, WORDPRESS, ROYALAUTH, ARGON2, CUSTOM (for developers only). See full list at
         # https://github.com/AuthMe/AuthMeReloaded/blob/master/docs/hash_algorithms.md
         # If you use ARGON2, check that you have the argon2 c library on your system
@@ -304,6 +307,10 @@ settings:
         forceKickAfterRegister: false
         # Does AuthMe need to enforce a /login after a successful registration?
         forceLoginAfterRegister: false
+        # Show a graphical dialog UI for login/register instead of chat messages.
+        # Requires Minecraft 1.21.6+ on Spigot, or 1.21.11+ on Paper.
+        # On older server versions, this option is automatically ignored.
+        useDialogUi: true
     # Enable to display the welcome message (welcome.txt) after a login
     # You can use colors in this welcome.txt + some replaced strings:
     # {PLAYER}: player name, {ONLINE}: display number of online players,
@@ -355,9 +362,15 @@ GroupOptions:
 Email:
     # Email SMTP server host
     mailSMTP: smtp.gmail.com
-    # Email SMTP server port
+    # Email SMTP server port. The port determines the encryption mode:
+    #   25  -> plain SMTP; optional STARTTLS via 'useTls' (see below)
+    #   465 -> implicit SSL/TLS (SMTPS); 'useTls' is ignored
+    #   587 -> STARTTLS required (submission); 'useTls' is ignored
+    #   other -> STARTTLS required; 'useTls' is ignored
     mailPort: 465
-    # Only affects port 25: enable TLS/STARTTLS?
+    # Only applies to port 25: enable STARTTLS on the plain SMTP connection?
+    # Has no effect when using port 465 (SSL) or 587 (STARTTLS), which enforce
+    # their own encryption and cannot be overridden by this setting.
     useTls: true
     # Email account which sends the mails
     mailAccount: ''
@@ -386,6 +399,13 @@ Email:
     generateImage: false
     # The OAuth2 token
     emailOauth2Token: ''
+    # Verify the SSL/TLS server certificate hostname?
+    # Only applies when an SSL/TLS connection is active (port 465, port 587,
+    # port 25 with useTls=true, or any other port).
+    # Set to false only if your SMTP server uses a self-signed certificate.
+    # Note: if you previously used port 465, this check was not enforced;
+    # set to false to restore the old behavior with a self-signed certificate.
+    sslCheckServerIdentity: true
 Hooks:
     # Do we need to hook with multiverse for spawn checking?
     multiverse: true
@@ -590,4 +610,4 @@ To change settings on a running server, save your changes to config.yml and use
 
 ---
 
-This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Thu Jul 28 18:11:22 CEST 2022
+This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Mon Apr 20 11:07:35 CEST 2026

docs/hash_algorithms.md

@@ -1,5 +1,5 @@
 <!-- AUTO-GENERATED FILE! Do not edit this directly -->
-<!-- File auto-generated on Sun Apr 04 21:31:44 CEST 2021. See docs/hashmethods/hash_algorithms.tpl.md -->
+<!-- File auto-generated on Mon Apr 20 11:07:36 CEST 2026. See authme-core/src/test/java/tools/docs/hashmethods/hash_algorithms.tpl.md -->
 
 ## Hash Algorithms
 AuthMe supports the following hash algorithms for storing your passwords safely.
@@ -79,4 +79,4 @@ or bad.
 
 ---
 
-This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Sun Apr 04 21:31:44 CEST 2021
+This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Mon Apr 20 11:07:36 CEST 2026

docs/permission_nodes.md

@@ -1,9 +1,12 @@
 <!-- AUTO-GENERATED FILE! Do not edit this directly -->
-<!-- File auto-generated on Sun Apr 04 21:31:44 CEST 2021. See docs/permissions/permission_nodes.tpl.md -->
+<!-- File auto-generated on Mon Apr 20 11:07:36 CEST 2026. See authme-core/src/test/java/tools/docs/permissions/permission_nodes.tpl.md -->
 
 ## AuthMe Permission Nodes
 The following are the permission nodes that are currently supported by the latest dev builds.
 
+Unless noted otherwise, these nodes are available across the current Spigot Legacy, Spigot 1.21,
+and Paper 1.21 builds.
+
 - **authme.admin.*** – Give access to all admin commands.
 - **authme.admin.accounts** – Administrator command to see all accounts associated with a user.
 - **authme.admin.antibotmessages** – Permission to see Antibot messages.
@@ -73,4 +76,4 @@ The following are the permission nodes that are currently supported by the lates
 
 ---
 
-This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Sun Apr 04 21:31:44 CEST 2021
+This page was automatically generated on the [AuthMe/AuthMeReloaded repository](https://github.com/AuthMe/AuthMeReloaded/tree/master/docs/) on Mon Apr 20 11:07:36 CEST 2026