Paladins & PriestsMods · 1.19 – 26.x✨ Protect and heal your friends as a Paladin or a Priest

TokenProtector prevents malicious mods from stealing your Minecraft session token. It sits between the game's authentication system and every mod in your…
Direct download from Modrinth · 22 downloads
Token Protector is a mod made by cev-api. TokenProtector prevents malicious mods from stealing your Minecraft session token. It sits between the game's authentication system and every mod in your…
It supports Minecraft 1.21 – 26.x. It has been downloaded 22 times on Modrinth. The last update came out on Sep 9, 2026.
Token Protector has had 5 releases on Modrinth since Jun 4, 2026. 5 of them came out in the past year. The newest is 1.0.4, released on Sep 9, 2026. It is made for Minecraft 26.1 – 26.2. It runs on Fabric. The download is 134 KB.
| Version | Released | Minecraft | Type |
|---|---|---|---|
1.0.4 | Sep 9, 2026 | 26.1 – 26.2 | Release |
1.0.2 | Jun 21, 2026 | 1.21.1 – 1.21.11 | Release |
1.0.2 | Jun 21, 2026 | 26.1 – 26.2 | Release |
1.0.0 | Jun 4, 2026 | 26.1, 26.1.1, 26.1.2 | Release |
1.0.0 | Jun 4, 2026 | 1.21.1 – 1.21.11 | Release |
Token Protector is open source. Its newest release on GitHub is Token Protector 1.0.5, published on Oct 10, 2026.
Before that: Token Protector 1.0.4 (Sep 9, 2026), Token Protector v1.0.3 (Jul 14, 2026).
TokenProtector is a client-side security mod for Minecraft 1.21.x and 26.x.
It reduces Minecraft access-token exposure to other Fabric mods. It replaces exposed token values with replacement data and reports blocked access when it can identify the caller.
Normal multiplayer, skins, and Realms continue to work because TokenProtector keeps the real access token only for the Minecraft authentication path that needs it.
TokenProtector protects these tested in-JVM paths:
Path · Tested result
User.getAccessToken() and User.getSessionId() · Replacement value
Direct User.accessToken field reads · Replacement value
Protected User and authlib fields read with reflection, Unsafe, VarHandle, or MethodHandle · Replacement value or access denied
User constructor HEAD capture · Replacement value
Maximum-priority User constructor Mixin · Replacement value
MinecraftClient.accessToken · Replacement value at rest
FabricLoader.getLaunchArguments(false) · Replacement accessToken
FabricLoader.getLaunchArguments(true) · Access token omitted
Tested authlib request hooks · Replacement value
High-speed token-field polling · Replacement value for the full test
Java-agent advice at raw Main.main bytecode entry · Replacement value
Tested HttpURLConnection auth-header probes · No Authorization value observed
Reflective read of the internal vault field (getDeclaredField("accessToken")) · No such field exists (credential is masked at rest)
Blind scan of static String fields for a JWT · No real token found
Retransformation targeting a single shared gate helper (authorized()) · No such helper exists (read gate is inline and duplicated)
TokenProtector sanitizes Fabric's retained launch arguments during Fabric preLaunch. Fabric builds the later Main.main(String[]) array from this retained data. As a result, the game receives the replacement token before normal Minecraft startup code runs.
TokenProtector also defends the internal state that holds the real token for authentication. The credential is never kept as a plaintext String: it is masked against a per-capture random pad and the plaintext is materialised only inside the gated read path at the moment it is handed to an authentication call. The read gate is performed inline in the accessor rather than delegated to a single helper method, so there is no authorized()-style choke point that a hostile retransformation could force to always allow.
TokenProtector is tested against TokenReader, a separate adversarial Fabric test mod (100+ probes across 13 categories). Every probe receives replacement data or nothing, and Minecraft authentication still completes:
Full details and technical limits are in WRITEUP.md.
TokenProtector is a hardening mod, not a sandbox. Its limitations:
While these are the limitations, most are still detected by the mod, just not blocked. This is because blocking them is outside what a same-JVM Fabric mod can enforce. Competing high-priority Mixins, preLaunch entrypoints, agent tooling, dynamic-attach artifacts, stripped protected classes, spin-races, and unexpected credential copies in environment variables, system properties, or process arguments all raise alerts. Only events that give no in-JVM signal at all, such as a launcher agent that runs before Fabric, native code, file copies, and network interception cannot be surfaced, and those are the true silent limits.
Full technical detail is in WRITEUP.md.
TokenProtector reports blocked caller-aware access (mod, class, method, line, field) and alerts on what it cannot block:
A warning means a possible credential is present in an inspected source; it does not prove another mod reads it. A single normal --accessToken launch argument is treated as expected exposure; warnings are for unexpected copies (duplicate tokens, --msaToken/--refreshToken, unknown JWT-shaped or wrapper-embedded values, long credential-like values, env/system-property leaks).
TokenProtector cannot rewrite the native OS command line, launcher files, launcher logs, or another process, and reports scans as incomplete when Java hides process data.
Every TokenProtector console line (INFO, WARN, ERROR, and ALERT) is recorded twice so it is never lost when the launcher console scrolls or closes:
Only ALERT lines increase the unread count shown on the top-right banner; INFO and WARN lines still appear in the in-game history and in the file.
Users who want to block the dynamic self-attach route used by tools such as Byte Buddy can add this JVM argument in the launcher:
-XX:+DisableAttachMechanism
This option must be present when Java starts. TokenProtector cannot enable it after the JVM starts.
It disables the JVM Attach mechanism used by dynamic self-attach. It does not stop a launcher-supplied -javaagent, native instrumentation, or a modified JVM or loader.
Use Mod Menu or edit config/tokenprotector.json.
Setting · Function
blockAccessToken · Replace the access token
blockSessionId · Replace the session ID
blockProfileId · Replace the player UUID
blockXuid · Replace the Xbox user ID
blockClientId · Replace the client ID
*Mode · Use FAKE, CUSTOM, or NONE
custom* · Set a custom replacement value
allowedMods · Allow selected caller-aware getter access
showToasts · Show protection alerts
showChatMessages · Show protection messages in chat
Only allow a mod when you trust it. An allowed caller-aware path can return real data to that mod.
Tested build targets:
For the technical design, adversarial test methods, and security limits, see WRITEUP.md.
Written by cev-api. Read it with pictures on Modrinth.
This mod runs only on your own game. Servers do not need it, so you can use it on any server.
Install Fabric for Minecraft 1.21 – 26.x.
Download the .jar file from Modrinth and put it in the mods folder of your .minecraft directory.
Start Minecraft with the Fabric profile.
Easier: in Prism Launcher or the Modrinth App, search for Token Protector in your instance's mods and click Install. It adds the loader and the mods it needs for you.
Full guide: How to install Minecraft mods
| Resource | Downloads | Versions | Last update | Price |
|---|---|---|---|---|
| 22 | 1.21 – 26.x | Sep 9, 2026 | Free | |
| 3.6M | 1.19 – 26.x | Oct 9, 2026 | Free | |
| 6 | 1.21 – 26.x | Oct 16, 2026 | Free | |
| 41 | 1.21 | 10 days ago | Free |
Yes. Token Protector supports Minecraft 26.x. All supported versions: 26.x, 1.21.
Yes. Token Protector is free to download from Modrinth.
Client-side. Token Protector goes in your own mods folder and works on any server, including servers without mods.
Yes. The last update came out in the past day.
The closest ones are Paladins & Priests, Offhand Guard and DonutSMP Session Profit. Compare all alternatives
Paladins & PriestsMods · 1.19 – 26.x✨ Protect and heal your friends as a Paladin or a Priest
Offhand GuardMods · 1.21 – 26.xProtect your offhand from accidental item swaps. Configurable allowed items, inventory protection, optional sound and a hold-to-bypass key.
DonutSMP Session ProfitMods · 1.21A draggable DonutSMP profit HUD with an animated aurora design, tracking your session from exact in game balance checks.
Zhuravel ReminderMods · 1.21A lightweight Fabric mod that adds a pinnable reminder note on your HUD, saved between sessions.
StealthcraftMods · 26.xTurn Minecraft into a stealth game, with entity vision cones, customizable interactions upon being seen and more.
Simple Crash MenuMods · 1.16 – 1.21Simply added a crash menu to prevent exiting game during crash.
Log in to leave a review.