HyperzoneLogin

KO | EN

gitlite — search

#typescript #llm #android #linux #macos #nodejs #windows #awesome #cli #awesome-list #pytorch #security #openai #open-source

(★ 52)

超域登入

File Explorer

Download Latest Version (.zip)

- - bug_report.yml
  - config.yml
  - feature_request.yml
  - question.yml
- - weekly-release.yml
- pull_request_template.md
- build.gradle.kts
- build.gradle.kts
- README.md
- build.gradle.kts
- README.md
- build.gradle.kts
- README.md
- build.gradle.kts
- build.gradle.kts
- README.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- build.gradle.kts
- README.md
- build.gradle.kts
- README.md
- build.gradle.kts
- build.gradle.kts
- README.md
.gitignore
AGENT.MD
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
HEADER.txt
LICENSE
README.md
README.zh-CN.md
settings.gradle.kts
THIRD_PARTY_NOTICES.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HyperZoneLogin

**HyperZoneLogin** is a Velocity-based authentication framework for Minecraft proxy networks.
It is designed for servers that need to support multiple login flows under one unified profile system.

**Languages:** [English](README.md) | [简体中文](README.zh-CN.md)

[![GitHub Release](https://img.shields.io/github/v/release/HyperZoneLogin/HyperzoneLogin?label=Release)](https://github.com/HyperZoneLogin/HyperzoneLogin/releases)
[![License](https://img.shields.io/github/license/HyperZoneLogin/HyperzoneLogin?label=License)](https://raw.githubusercontent.com/HyperZoneLogin/HyperzoneLogin/master/LICENSE)
[![Discord](https://img.shields.io/discord/1492467475810484244.svg?logo=discord&label=Discord)](https://discord.gg/dCAeNyR9TA)
[![QQ Group](https://img.shields.io/badge/QQ%20Group-832210691-12B7F5?logo=tencentqq&logoColor=white)](https://qm.qq.com/q/GZWVfEyokS)
[![Proxy Stats](https://img.shields.io/bstats/servers/30691?logo=minecraft&label=Servers)](https://bstats.org/plugin/velocity/HyperZoneLogin/30691)
[![Proxy Stats](https://img.shields.io/bstats/players/30691?logo=minecraft&label=Players)](https://bstats.org/plugin/velocity/HyperZoneLogin/30691)

## What it does

HyperZoneLogin helps you build a consistent authentication layer for a Velocity network.

- Supports multiple authentication methods in one project
- Keeps players in a controlled auth / waiting flow until authentication is complete
- Unifies profile creation, profile binding, and post-auth routing
- Can be extended with optional modules for security, migration, and skin handling

## Supported authentication methods

HyperZoneLogin currently provides these authentication modules:

| Method | Module | Summary |
|---|---|---|
| Local / Offline accounts | `auth-offline` | Register, log in, change password, unregister, email recovery, optional short sessions, and optional TOTP 2FA |
| Yggdrasil authentication | `auth-yggd` | Authenticate with Mojang-style or compatible Yggdrasil services, including configurable multiple entries |
| Floodgate / Bedrock authentication | `auth-floodgate` | Recognize Floodgate players and treat Bedrock access as a trusted authentication channel |

In other words, the project is suitable for networks that need one or more of the following:

- classic offline/local account login
- Yggdrasil-based premium or custom online authentication
- Bedrock player access through Floodgate / Geyser setups

## Optional modules

Besides authentication, the repository also includes several supporting modules:

| Module | Purpose |
|---|---|
| `safe` | Entry-layer protection such as rate limiting, abnormal name checks, and temporary cooldowns |
| `data-merge` | Migration tools for importing data from older systems such as MinecraftLink / legacy ML and AuthMe |
| `profile-skin` | Skin extraction, repair, caching, and profile skin application for authenticated profiles |

## Documentation

If you are new to the project, start here:

- **User documentation:** <https://docs.h2l.icu>
- **Chinese README:** [`README.zh-CN.md`](README.zh-CN.md)

For module-specific details, see the READMEs inside:

- [`velocity`](./velocity/README.md)
- [`auth-offline`](./auth-offline/README.md)
- [`auth-yggd`](./auth-yggd/README.md)
- [`auth-floodgate`](./auth-floodgate/README.md)
- [`safe`](./safe/README.md)
- [`data-merge`](./data-merge/README.md)
- [`profile-skin`](./profile-skin/README.md)

## Community

- GitHub Issues: <https://github.com/HyperZoneLogin/HyperzoneLogin/issues>
- Discord: <https://discord.gg/dCAeNyR9TA>
- QQ Group: <https://qm.qq.com/q/GZWVfEyokS>

## Support the project

If HyperZoneLogin helps your network, you can support development and maintenance here:

[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Project-FF5E5B?logo=kofi&logoColor=white)](https://ko-fi.com/ksqeib)
[![爱发电](https://img.shields.io/badge/%E7%88%B1%E5%8F%91%E7%94%B5-%E6%94%AF%E6%8C%81%E9%A1%B9%E7%9B%AE-946CE6)](https://afdian.com/a/ksqeib445)

If you do not want to sponsor, you can still help by:

- reporting bugs and feedback through Issues
- improving documentation
- submitting high-quality pull requests
- recommending the project to other server owners

HyperzoneLogin

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

HyperzoneLogin

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README