SecPlayer

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 工具备份或检查它。

安装

  1. 为 Minecraft 1.18.2 安装 Forge。
  2. 将模组 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。保留所有权利。