
SecPlayer
Forge 注册与登录模组:玩家必须先注册或登录才能游玩。包含服务条款/年龄验证、忘记密码邮件、IP 地理位置定位、自定义登录标志及 OP 管理员面板。
查看大图SecPlayer 为你的 Minecraft 服务器添加了注册与登录功能。玩家必须先注册一次(或在之后加入时登录),然后才能移动或游玩。该模组提供服务条款与年龄确认界面、可选的忘记密码邮件、IP 与地理位置记录、自定义登录界面 Logo、仅限 OP 的管理面板(带有可选的审批模式用于新注册、时区分组以及批准/拒绝),以及一个玩家个人资料,用户可以在其中更改密码、更新邮箱或删除账户(会发送邮件通知并断开连接)。
此模组的功能
- 注册: 新玩家会看到 TOS(服务条款)界面,然后是注册表单。全名字段已预填为你的 Minecraft 用户名且不可编辑。你还需要输入邮箱、可选的显示名称和密码。一个 “服务条款与隐私” 按钮会打开可滚动的数据/隐私政策(来自客户端的
config/secplayer_privacy.txt)。密码会被遮蔽。一个“我同意服务条款”复选框用于确认年龄(最小年龄可配置)。 - 登录: 回归玩家在加入时输入密码。可选的“记住我”会按服务器安全地存储密码,以便下次自动登录。“忘记密码?”会通过邮件发送重置码(当配置了 SMTP 时)。一个 “输入重置码” 按钮让你无需再次请求邮件即可打开重置码 + 新密码界面(例如你关闭了菜单或重新打开了游戏)。
- 玩家个人资料: 运行
/secplayer info打开个人资料界面。你可以查看自己的信息(用户名、遮蔽后的邮箱、备用名称)、更改密码、更新邮箱或删除账户。删除账户会移除所有数据,向你发送一封确认邮件(包含服务器名称),并断开你的连接;重新加入需要再次注册。 - TOS 文本: 服务器管理员可以在
config/secplayer_tos.txt中编辑确切的服务条款(文件在服务器启动时若缺失会被创建)。 - IP 与地理位置: 该模组在注册和登录时记录 IP、国家、地区、城市,以及可选的 ISP(ASN)。使用
config/中的 GeoLite2 数据库文件(你需手动放置这些文件;可从免费的 MaxMind 账户获取)。在管理员玩家详情中,只显示国家和最后登录(按时间格式化);完整地理数据仍会存储在数据库中,直到账户被删除。 - 管理面板: OP 运行
/secplayer admin打开已注册玩家列表,按时区分组(可按玩家或时区搜索;没有时区的玩家显示在“本地”下)。打开一个玩家可查看详情(用户名、UUID、遮蔽后的邮箱、备用名称、出生年份、状态、国家、最后登录)、封禁/解封(Minecraft 的封禁列表)、重置密码、设置备用用户名、批准/拒绝(当审批模式开启时),或删除该玩家(向其发送邮件并移除账户)。所有滚动条均支持点击并拖动。 - 审批模式: 在配置中设置
requireApproval=true,使新注册处于“待审批”状态,直到管理员批准。使用管理列表中的 Pending 过滤器,或玩家详情中的 Approve / Deny,或/secplayer approve <player>//secplayer deny <player>。拒绝会将玩家加入封禁列表;批准时可发送可选邮件(若配置了 SMTP)。 - 显示名称: 玩家可以选择一个可选的“备用用户名”并将其用作游戏内名称(聊天、Tab 列表)。使用
/secplayer setAlt <name>设置或清除它;设置非空名称会自动启用“用作游戏内名称”,因此你无需在注册时勾选该复选框。 - 登录 Logo: 你可以在登录界面显示自定义 Logo。服务器可以向所有客户端发送一张图片(无需逐客户端配置),或者客户端可以使用本地图片。Logo 会缩放以适应面板。
- 数据存储: 所有账户数据存储在服务器上的 SQLite 数据库中。无需单独的数据库服务器。文件
config/secplayer.db在首次运行时创建,保存账户、登录历史(IP、地理位置、时间戳)和密码重置令牌。你可以使用任何 SQLite 工具备份或检查它。
安装
- 为 Minecraft 1.18.2 安装 Forge。
- 将模组 JAR 放入服务器和每个客户端的
mods/文件夹中。
注册与登录仅在专用服务器上运行。单人游戏 / 集成服务器不使用注册流程。
使用方法(玩家)
- 首次: 加入时你会看到 TOS 界面。勾选同意复选框并点击 Continue to Registration。你的名称已预填为你的 Minecraft 用户名。填写邮箱、可选的显示名称和密码,然后提交。使用 Disconnect 可在未注册的情况下离开。
- 之后加入: 在登录界面输入密码。可选择勾选 Remember me 以便下次自动登录。使用 Forgot password? 通过邮件接收重置码(如果服务器配置了 SMTP)。你也可以点击 Enter reset code 输入已有的重置码和新密码,而无需再次请求邮件。
- 个人资料: 运行
/secplayer info打开你的个人资料。在那里你可以更改密码、更新邮箱或删除账户(你会收到邮件并被断开连接)。 - 显示名称: 使用
/secplayer setAlt <name>设置或清除你的游戏内显示名称(不含空格)。设置名称会自动开启“用作游戏内名称”,即使你在注册时未启用。
使用方法(服务器管理员)
- 管理列表: 运行
/secplayer admin(需要 OP)。你会看到按时间区组分的已注册玩家(搜索框可按玩家或时区过滤)。当审批模式开启时使用 Pending 过滤器。打开一个玩家可查看详情(显示国家和最后登录;完整地理数据已存储但不在 UI 中显示)、封禁/解封、重置密码、设置备用用户名、批准/拒绝(对待审批玩家),或删除该玩家(向其发送邮件并移除账户)。你也可以从聊天或控制台使用/secplayer approve <player>和/secplayer deny <player>。 - TOS: 在服务器上编辑
config/secplayer_tos.txt。在文本中使用%d表示最小年龄数字。文件在首次服务器启动时若缺失会以默认文本创建。
配置
主配置:config/secplayer.properties(首次运行时创建)。
| 选项 | 作用 | 默认值 |
|---|---|---|
| minAge | TOS 文本中的最小年龄(例如 13) | 13 |
| requireApproval | 为 true 时,新注册需要管理员批准后才能登录 | false |
| smtpHost、smtpPort、smtpUseTls | 用于“忘记密码?”和账户删除邮件的 SMTP 服务器 | (空)、587、true |
| smtpUsername、smtpPassword | SMTP 登录 | (空) |
| smtpFromAddress、smtpFromName | 邮件的发件人地址和名称 | (空)、SecPlayer |
| smtpPasswordFile | 可选:包含 SMTP 密码的文件的路径(相对于 config/);避免 .properties 中的特殊字符问题 | (空) |
| smtpDebug | 设为 true 将 SMTP 对话记录到服务器日志(用于排查问题) | false |
| loginLogoPath | 服务器 config/ 文件夹中的 Logo 文件名(例如 mylogo.png)。服务器会将其发送给客户端,使所有人看到相同的 Logo。 |
(空) |
| bannedAltNames | 玩家不能使用的显示名称,逗号分隔(例如 herobrine) |
herobrine |
| displayTimezone | 管理列表中“最后登录”的时区(例如 America/New_York、UTC) |
UTC |
登录 Logo(仅客户端覆盖): 创建 config/secplayer_client.properties 并设置 loginLogoPath=filename.png,然后将 PNG 放入 config/。当服务器未发送 Logo 时使用。
地理位置(可选): 对于国家/地区/城市,将 GeoLite2-City.mmdb 放入服务器 config/ 文件夹。对于 ISP(ASN),添加 GeoLite2-ASN.mmdb。从 MaxMind(免费账户)获取这些文件并放入你的服务器 config/ 文件夹。
故障排除
/secplayer admin无反应: 你必须是 OP(例如在服务器控制台执行/op YourName)。没有游戏内菜单按钮;该命令会打开管理列表。- 注册/登录从不出现: 该模组仅在专用服务器上运行该流程。使用专用服务器或局域网主机进行测试。
- 崩溃或退出代码 1: 检查
crash-reports/中的最新文件(客户端或服务器)。确保模组和 Forge 版本匹配(例如 1.18.2 使用 Forge 40.x)。
需要 Minecraft 1.18.2 和 Forge 40.x。保留所有权利。
正在加载版本记录…


正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。