? 最具风格的 Minecraft 身份验证插件。
一套包含完全交互式 GUI 数字键盘、自定义数字头像头颅、IP 追踪、BungeeCord 支持以及全方位账户安全的 6 位 PIN 码系统——一切尽在掌握。
?️ 预览
| ? 登录界面 |
? 注册界面 |
⚙️ 修改 PIN |
| 带有实时 PIN 显示的数字头像数字键盘 |
简洁的 6 格注册流程 |
两步旧 → 新 PIN 码修改 |
✨ 功能
? 基于 GUI 的 PIN 码系统
- 完全交互式的 54 槽箱子 GUI — 无需使用聊天命令
- 自定义玩家头颅作为每个数字
0–9 的按钮,每个数字都有独特的数字皮肤
- 实时 PIN 指示器 — 顶部的 6 个槽位在点击数字时逐渐填满(显示为
● 圆点)
- 自动确认 — 输入完所有 6 位数字后自动提交
- 退格和确认头颅按钮
- 如果在身份验证前关闭 GUI,它将自动重新打开 — 无法绕过
?️ 坚如磐石的安全性
- PIN 码经过 SHA-256 + UUID 盐值哈希处理 — 绝不以明文存储
- 未通过身份验证时冻结移动
- 加入服务器时施加失明效果,直到完成身份验证
- 阻止聊天和命令,直到登录完成
- 最大尝试次数限制 — 错误 PIN 码输入过多将被踢出
? IP 追踪与控制
- ? 完整的 IP 历史记录 — 按玩家记录并附带时间戳
- ? IP 账户限制 — 可配置每个 IP 地址的最大账户数
- ? 管理员警报 — 当玩家从新 IP 登录时通知管理员
- ?
/maskauth ipinfo <player> 查看玩家的完整 IP 历史
?️ 旧版客户端支持
- 使用较旧客户端或偏好使用命令的玩家可以使用:
/register <pin> — 通过聊天注册 6 位 PIN 码
/login <pin> — 通过聊天命令进行身份验证
- 可在
config.yml 中完全切换启用/禁用
? 认证世界
- 未通过身份验证的玩家将被传送至指定的认证世界/出生点
- 可配置世界名称、XYZ 坐标、偏航角和俯仰角
? BungeeCord 集成
- 将此服务器指定为认证服务器
- 自动将已通过身份验证的玩家转发到您的大厅/主服务器
- 兼容 BungeeCord 的 IP 转发功能
? 完全自定义消息
- 每条消息均可在
config.yml 中配置
- 支持完整的
& 颜色代码
- 支持带颜色格式化的自定义前缀
? 安装
1. 下载 MaskAuth-1.0.0.jar
2. 将其放入 /plugins/ 文件夹
3. 重启服务器
4. 配置 plugins/MaskAuth/config.yml
5. ✅ 完成!
要求: Spigot 或 Paper 1.20.x · Java 11+
? 命令
| 命令 |
描述 |
权限 |
/register |
打开注册 GUI(或 /register <pin> 旧版模式) |
— |
/login |
打开登录 GUI(或 /login <pin> 旧版模式) |
— |
/changepin |
通过 GUI 修改您的 PIN 码 |
— |
/unregister <player> |
删除玩家的认证数据 |
maskauth.admin |
/maskauth reload |
重载配置文件 |
maskauth.admin |
/maskauth status |
查看实时认证状态 |
maskauth.admin |
/maskauth ipinfo <player> |
查看玩家 IP 历史 |
maskauth.admin |
/maskauth info |
插件版本信息 |
maskauth.admin |
? 权限
| 权限 |
描述 |
默认值 |
maskauth.admin |
完全管理访问权限 |
OP |
maskauth.bypass |
完全跳过身份验证 |
false |
maskauth.ipbypass |
绕过 IP 账户限制 |
false |
⚙️ 配置
? 点击展开 config.yml
settings:
session-timeout: 0 # 记住登录状态的秒数 (0 = 关闭)
max-attempts: 5 # 踢出前的错误 PIN 尝试次数
login-timeout: 60 # 踢出前进行身份验证的秒数
blind-on-join: true # 在未通过身份验证前应用失明效果
freeze-movement: true # 在未通过身份验证前冻结玩家移动
hide-until-auth: true # 在未通过身份验证前隐藏玩家
auth-world:
enabled: true
world: "world"
spawn: { x: 0.5, y: 64.0, z: 0.5 }
legacy-support:
enabled: true # 允许使用 /login <pin> 和 /register <pin>
ip-settings:
max-accounts-per-ip: 3
track-ip-history: true
alert-admins-on-new-ip: true
bungeecord:
enabled: false
is-auth-server: false
forward-server: "lobby"
gui:
register-title: "&8? &bMask&3Auth &8» &7Register"
login-title: "&8? &bMask&3Auth &8» &7Login"
mask-display: true # 显示 ● 而不是实际数字
? GUI 布局
┌─────────────────────────────────────────────────────┐
│ [●] [●] [●] [○] [○] [○] ← PIN 显示 (6 个槽位) │
│─────────────────────────────────────────────────────│
│ [ 7 ] [ 8 ] [ 9 ] [ ⌫ ] ← 数字头颅 │
│ [ 4 ] [ 5 ] [ 6 ] [ ] │
│ [ 1 ] [ 2 ] [ 3 ] [ ✔ ] ← 确认 │
│ [ 0 ] [ ] │
└─────────────────────────────────────────────────────┘
每个数字都是带有数字皮肤的自定义玩家头颅
? 安全机制工作原理
玩家通过图形界面输入 PIN 码
↓
SHA-256( UUID + "::maskauth::" + PIN )
↓
对比存储的哈希值 — 原始 PIN 码永不保存
↓
✅ 匹配 → 已认证 ❌ 不匹配 → 记录尝试次数
使用玩家的 UUID 进行加盐,意味着拥有相同 PIN 码的两个玩家会生成完全不同的存储哈希值。
?️ 数据存储
玩家数据存储在 plugins/MaskAuth/data/players.yml 中:
players:
<uuid>:
name: "Steve"
hashed-pin: "a3f5c8..." # SHA-256 哈希值 — 绝不明文存储
registered-ip: "192.168.1.1"
registered-at: 1700000000000
ip-history:
192_168_1_1: 1700000000000
10_0_0_5: 1700005000000
? BungeeCord 设置
- 在
config.yml 中启用 bungeecord.enabled: true
- 在你的认证服务器上设置
is-auth-server: true
- 将
forward-server 设置为主服务器名称 "lobby"
- 玩家完成认证后 → 自动转发至大厅服
? 兼容性
| 平台 |
状态 |
| Spigot 1.20.x |
✅ 支持 |
| Paper 1.20.x |
✅ 支持 |
| BungeeCord |
✅ 支持 |
| Velocity |
⚠️ 未测试 |
| Spigot 1.18–1.19 |
⚠️ 可能可用 |
? 问题与支持
发现漏洞或有功能建议?
? Discord: allay_gaming_x
? GitHub: @ALLAY-XD-20
? 许可证
Copyright © 2024 Pawan (ALLAY-XD-20)
All Rights Reserved.
This software and its source code are the exclusive property of Pawan.
Unauthorized copying, modification, distribution, sublicensing, or
commercial use of this software, in whole or in part, is strictly
prohibited without express written permission from the author.
You may NOT:
• Redistribute this plugin or its source code
• Modify and re-upload as your own
• Use in commercial products without permission
• Claim authorship or ownership
You MAY:
• Use this plugin on your personal or public Minecraft server
• Report issues and suggest features via GitHub
For licensing inquiries, contact via Discord: allay_gaming_x
⚠️ ALL RIGHTS RESERVED (ARR) — Pawan © 2024
由 Pawan 用 ❤️ 制作
? 守护 Minecraft 服务器的安全,从每一个 PIN 码开始。
? The most stylish authentication plugin for Minecraft.
A 6-digit PIN system with a fully interactive GUI numpad, custom number-head skulls, IP tracking, BungeeCord support, and total account security — all in one.
?️ Preview
| ? Login GUI |
? Register GUI |
⚙️ Change PIN |
| Number-head numpad with live PIN display |
Clean 6-slot register flow |
Two-step old → new PIN change |
✨ Features
? GUI-Based PIN System
- Fully interactive 54-slot chest GUI — no chat commands needed
- Custom player-head skulls for every digit
0–9, each with a unique number skin
- Live PIN indicator — 6 slot display at the top fills in as you click digits (shown as
● dots)
- Auto-confirm when all 6 digits are entered
- Backspace and Confirm skull buttons
- GUI re-opens automatically if closed before authentication — no bypass possible
?️ Rock-Solid Security
- PINs hashed with SHA-256 + UUID salt — never stored in plaintext
- Movement freeze while unauthenticated
- Blindness effect on join until authenticated
- Chat and command blocking until login completes
- Max attempt limit — too many wrong PINs = kick
? IP Tracking & Control
- ? Full IP history logged per player with timestamps
- ? IP account limit — configurable max accounts per IP address
- ? Admin alerts when a player logs in from a new IP
- ?
/maskauth ipinfo <player> to view a player's complete IP history
?️ Legacy Player Support
- Players on older clients or who prefer commands can use:
/register <pin> — register with a 6-digit PIN via chat
/login <pin> — authenticate via chat command
- Fully toggleable in
config.yml
? Auth World
- Unauthenticated players are teleported to a designated auth world/spawn
- Configurable world name, XYZ coordinates, yaw & pitch
? BungeeCord Integration
- Designate this server as an auth server
- Automatically forward authenticated players to your lobby/main server
- Compatible with BungeeCord's IP forwarding
? Fully Custom Messages
- Every single message is configurable in
config.yml
- Full
& color code support
- Custom prefix with color formatting
? Installation
1. Download MaskAuth-1.0.0.jar
2. Drop it into your /plugins/ folder
3. Restart your server
4. Configure plugins/MaskAuth/config.yml
5. ✅ Done!
Requirements: Spigot or Paper 1.20.x · Java 11+
? Commands
| Command |
Description |
Permission |
/register |
Open register GUI (or /register <pin> legacy) |
— |
/login |
Open login GUI (or /login <pin> legacy) |
— |
/changepin |
Change your PIN via GUI |
— |
/unregister <player> |
Delete a player's auth data |
maskauth.admin |
/maskauth reload |
Reload the config |
maskauth.admin |
/maskauth status |
View live auth status |
maskauth.admin |
/maskauth ipinfo <player> |
View player IP history |
maskauth.admin |
/maskauth info |
Plugin version info |
maskauth.admin |
? Permissions
| Permission |
Description |
Default |
maskauth.admin |
Full admin access |
OP |
maskauth.bypass |
Skip authentication entirely |
false |
maskauth.ipbypass |
Bypass IP account limit |
false |
⚙️ Configuration
? Click to expand config.yml
settings:
session-timeout: 0 # Seconds to remember login (0 = off)
max-attempts: 5 # Wrong PIN attempts before kick
login-timeout: 60 # Seconds to authenticate before kick
blind-on-join: true # Apply blindness until authenticated
freeze-movement: true # Freeze player until authenticated
hide-until-auth: true # Hide player from others until auth
auth-world:
enabled: true
world: "world"
spawn: { x: 0.5, y: 64.0, z: 0.5 }
legacy-support:
enabled: true # Allow /login <pin> and /register <pin>
ip-settings:
max-accounts-per-ip: 3
track-ip-history: true
alert-admins-on-new-ip: true
bungeecord:
enabled: false
is-auth-server: false
forward-server: "lobby"
gui:
register-title: "&8? &bMask&3Auth &8» &7Register"
login-title: "&8? &bMask&3Auth &8» &7Login"
mask-display: true # Show ● instead of actual digits
? GUI Layout
┌─────────────────────────────────────────────────────┐
│ [●] [●] [●] [○] [○] [○] ← PIN display (6 slots) │
│─────────────────────────────────────────────────────│
│ [ 7 ] [ 8 ] [ 9 ] [ ⌫ ] ← Number skulls │
│ [ 4 ] [ 5 ] [ 6 ] [ ] │
│ [ 1 ] [ 2 ] [ 3 ] [ ✔ ] ← Confirm │
│ [ 0 ] [ ] │
└─────────────────────────────────────────────────────┘
Each number is a custom player head with digit skin
? How Security Works
Player enters PIN via GUI
↓
SHA-256( UUID + "::maskauth::" + PIN )
↓
Stored hash compared — raw PIN never saved
↓
✅ Match → Authenticated ❌ No match → Attempt recorded
Salting with the player's UUID means two players with the same PIN have completely different stored hashes.
?️ Data Storage
Player data is stored in plugins/MaskAuth/data/players.yml:
players:
<uuid>:
name: "Steve"
hashed-pin: "a3f5c8..." # SHA-256 hash — never plaintext
registered-ip: "192.168.1.1"
registered-at: 1700000000000
ip-history:
192_168_1_1: 1700000000000
10_0_0_5: 1700005000000
? BungeeCord Setup
- Enable
bungeecord.enabled: true in config.yml
- Set
is-auth-server: true on your auth server
- Set
forward-server: "lobby" to your main server name
- Players authenticate → automatically forwarded to lobby
? Compatibility
| Platform |
Status |
| Spigot 1.20.x |
✅ Supported |
| Paper 1.20.x |
✅ Supported |
| BungeeCord |
✅ Supported |
| Velocity |
⚠️ Untested |
| Spigot 1.18–1.19 |
⚠️ May work |
? Issues & Support
Found a bug or have a feature request?
? Discord: allay_gaming_x
? GitHub: @ALLAY-XD-20
? License
Copyright © 2024 Pawan (ALLAY-XD-20)
All Rights Reserved.
This software and its source code are the exclusive property of Pawan.
Unauthorized copying, modification, distribution, sublicensing, or
commercial use of this software, in whole or in part, is strictly
prohibited without express written permission from the author.
You may NOT:
• Redistribute this plugin or its source code
• Modify and re-upload as your own
• Use in commercial products without permission
• Claim authorship or ownership
You MAY:
• Use this plugin on your personal or public Minecraft server
• Report issues and suggest features via GitHub
For licensing inquiries, contact via Discord: allay_gaming_x
⚠️ ALL RIGHTS RESERVED (ARR) — Pawan © 2024
Made with ❤️ by Pawan
? Keeping Minecraft servers secure, one PIN at a time.
评论 0
登录后参与评分
还没有评论,来抢沙发吧