Repository navigation
AltHalt 1.0.0 is a client-side Fabric mod that helps prevent accidental server joins with the wrong account or a previously shared public IP.
Requirements
- Minecraft Java 26.2
- Fabric Loader 0.19.5 or newer
- Java 25
- Fabric API is not required
Included
- Per-server UUID locks and persistent Same-IP history shared across launcher profiles on the same OS account.
- Account-verified server-list pings and Refresh support.
- A Multiplayer management menu for recent blocks, known alts, server locks, and active exemptions.
- One-hour and permanent exemptions, scoped to the account, server, and failed rule. Same-IP exemptions cover only the recorded conflicting addresses.
- Alt-label and server-lock editing, confirmed removal, exemption revocation, and migration of existing history.
Install
Download althalt-1.0.0.jar and place it in your Fabric instance's mods directory. Remove any older AltHalt JAR. Open Multiplayer > AltHalt to configure your accounts and server locks. The -sources.jar is for developers and should not be installed as a mod.
Protection limits
History starts with attempts observed by AltHalt. Background pings verify the account UUID; login checks also verify public IPs unless explicitly exempted. IP lookups use ipify. Split routing, VPN changes, and other network differences can affect the IP a server sees. Realms and mods that replace vanilla connection paths are outside this release's protection. AltHalt does not guarantee anonymity.
Validation
35 automated tests and isolated in-game smoke checks passed, including connection gates, status pings and refreshes, cancellation, management controls, scoped exemptions, and removal confirmations. The in-game checks use simulated IP lookups and a local server fixture; they do not establish live-server VPN behavior.
See the README for configuration and storage details, and the changelog for the full release summary.