AusWeis is a lightweight Bukkit\/Paper plugin that integrates **Cloudflare Turnstile** to provide frictionless human verification before players enter your server. It effectively stops bot attacks while offering a smooth experience for real players.<\/p>\n
*I am not a native English speaker, so corrections are welcome if there are any mistakes.*<\/u><\/p>\n
## Features<\/p>\n
– **Simple workflow** \u2013 Players are kicked once with a verification URL; after completing the Turnstile challenge on your website, they can rejoin normally.
\n– **Real\u2011time API check** \u2013 Every login queries your backend API for the player’s verification status (no local cache, always up\u2011to\u2011date).
\n– **Bypass permission** \u2013 Grant `ausweis.bypass` to trusted players (or yourself) to skip verification entirely.
\n– **Highly customisable** \u2013 Kick message, API URL, timeout and more can be changed in `config.yml`. Supports Minecraft colour codes and multi\u2011line messages.
\n– **Multi\u2011language ready** \u2013 Choose the language in config (`en`, `zh`, or add your own .yml files in the `lang` folder). Built\u2011in English and Chinese translations.
\n– **Command reload** \u2013 Use `\/ausweis reload` to apply configuration changes without restarting the server.
\n– **Wide compatibility** \u2013 Works on Spigot\/Paper from **1.8 to latest** (tested on 1.12.2, 1.16.5, 1.21+).<\/p>\n
## Installation<\/p>\n
1. Download the latest **AusWeis-*.jar** from the Releases page.
\n2. Place the JAR file into your server’s `plugins\/` folder.
\n3. **Restart** your server (or use `\/reload` \u2013 restart is recommended).
\n4. The plugin will generate a default `config.yml` and a `lang\/` folder with language files.
\n5. Edit `plugins\/AusWeis\/config.yml` to set your own backend API URL and verification page URL.
\n6. Run `\/ausweis reload` to apply the changes.<\/p>\n
## Config<\/p>\n
“`yaml ## Commands<\/p>\n | Command | Description | Permission | Default | | Permission | Description | Default | ## API Specification<\/p>\n Your website must provide two endpoints:<\/p>\n ### 1. Verification Status Query ### 2. Verification Page > Reference implementation: The companion web backend is open\u2011sourced by @ChineseLiyao \u2013 ChineseLiyao\/AusWeis. You can deploy it directly or use it as an example.<\/p>\n ## Languages<\/p>\n 1. Create a new file `messages_ ## Building<\/p>\n If you prefer to compile the plugin yourself:<\/p>\n ```bash The compiled JAR will be in the `target\/` directory.<\/p>\n ## License<\/p>\n This project is licensed under the MIT License \u2013 see the LICENSE file for details.<\/p>\n ## Support<\/p>\n - **GitHub Issues:** Report bugs \/ suggest features Happy Gaming! Cloudflare Turnstile Human Verification Plugin<\/p>\n","protected":false},"featured_media":22869,"template":"","meta":{"_minecraft_slug":"ausweis","_minecraft_project_id":"ZFMYv957","_minecraft_author":"Nsk_awa","_minecraft_license":"MIT","_minecraft_downloads":7,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ausweis.zip","_minecraft_size_bytes":18887,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:31:56.975422Z","_minecraft_date_created":"2026-03-19T20:41:47.359101Z","_minecraft_date_modified":"2026-03-14T09:33:16.524908Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ausweis","_minecraft_icon_attachment_id":22869,"_minecraft_imported_at":"2026-05-31T22:09:20+00:00","_minecraft_import_hash":"b39214f0769e32aab51025594ca44a5f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-22868","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n# Language file to use (e.g., en, zh). Must correspond to a messages_
\nlanguage: “en”
\n# API URL to check player verification status
\napi-url: “https:\/\/your-server.com\/api\/check?user={player}”
\n# Verification page URL to show in kick message
\nverify-url: “https:\/\/your-server.com\/verify?user={player}”
\n# HTTP request timeout in milliseconds
\ntimeout: 5000
\n# Debug mode, enables more detailed logs
\ndebug: false
\n“`<\/p>\n
\n|———|————-|————|———|
\n| `\/ausweis reload` | Reload the plugin configuration | `ausweis.reload` | op |
\n| `\/ausw reload` | Alias for the above | same | op |<\/p>\n
\n|————|————-|———|
\n| `ausweis.reload` | Allows reloading config | op |
\n| `ausweis.bypass` | Bypass verification and always join | false |<\/p>\n
\n– **URL:** `GET {api-url}?user={player}`
\n– **Response format:** JSON
\n “`json
\n {
\n “verified”: true,
\n “user”: “Steve”,
\n “timestamp”: 1709123456.789
\n }
\n “`
\n– **Description:** Return `”verified”: true` if the player has already passed the Turnstile challenge, otherwise `false`.<\/p>\n
\n– **URL:** `{verify-url}?user={player}`
\n– **Function:** Display the Cloudflare Turnstile widget. After successful verification, your backend should mark the player as verified (e.g., update a database) so that subsequent API calls return `true`.<\/p>\n.yml` in the `plugins\/AusWeis\/lang\/` folder (e.g., `messages_fr.yml` for French).
\n2. Use the same keys as in the built\u2011in language files (`kick-title`, `kick-message`).
\n3. Set `language: \"\"` in `config.yml` and reload.<\/p>\n
\ngit clone https:\/\/github.com\/Nskawa\/AusWeisPlugin.git
\ncd AusWeis
\nmvn clean package
\n```<\/p>\n
\n- **Discussion:** Feel free to open a discussion on GitHub or leave a comment below.<\/p>\n
\n```<\/p>\n","protected":false},"excerpt":{"rendered":"