AltDetector - 小号检测

💡AltDetector - 玩家小号检测插件

AltDetector 是一款用于检测和报告玩家潜在小号账户的插件。它会追踪每位玩家的 IP 地址，并在同一 IP 被多个账户使用时发出通知。插件无需配置，放入插件文件夹并重启服务器即可使用。默认情况下，玩家的 IP 历史记录会保留 60 天。

请注意，插件本身不会惩罚使用小号的玩家。来自同一 IP 的合法玩家（例如住在同一屋檐下的兄弟姐妹）也会被识别为潜在小号。部分 ISP（如 Starlink）使用 CGNAT 技术，会将同一 IP 分配给区域内数百名用户。本插件的目的是帮助管理员了解玩家情况，而非进行惩罚。

兼容性与扩展

• 如果同时使用 SuperVanish 或 PremiumVanish 插件，AltDetector 将遵循其“分层可见与使用权限”系统，只向消息接收者显示其可见玩家的相关信息。
• 支持 PlaceholderAPI 扩展。若已安装 PlaceholderAPI，此功能默认启用。占位符格式为：%altdetector_alts_<玩家名>%，其中 <玩家名> 区分大小写。你可以在配置文件中设置小号名称之间的分隔符。
• 支持在检测到小号时向 Discord 服务器发送消息。此功能需在配置文件中进行设置。

🎮命令

• /alt [玩家名] - 列出指定玩家的潜在小号。若未指定玩家名，则列出所有在线玩家的潜在小号。
• /alt delete <玩家名> - 从 AltDetector 数据中删除指定玩家的所有记录。

关于离线玩家查询

当你对不在线的玩家使用 /alt <玩家名> 命令时，插件会查找该玩家最近使用的所有 IP 地址并基于此进行查询。如果该玩家近期使用了多个 IP 地址，或者某个 IP 被多个用户共享，查询结果可能不一致。例如，A 可能显示为 B 的小号，但 B 却不显示为 A 的小号。这不是程序错误，而是由于单个玩家使用了多个 IP 地址所致。

🎮权限

• altdetector.alt - 允许使用 /alt 命令。默认 OP 拥有。
• altdetector.alt.seevanished - 允许命令使用者查看关于隐身玩家的消息。默认 OP 拥有。
• altdetector.alt.delete - 允许使用 /alt delete 命令。默认 OP 拥有。
• altdetector.exempt - 使玩家免于被插件检测。默认为 false。
• altdetector.notify - 当检测到小号时通知此玩家。默认 OP 拥有。
• altdetector.notify.seevanished - 允许此玩家在检测到隐身玩家的小号时收到通知。默认 OP 拥有。

🔧配置（可选）

配置文件为 config.yml。以下为部分关键配置项：

数据与存储

• expiration-time - 数据过期时间（单位：天，默认 60 天）。早于此时间的 IP 数据将在插件启动时从数据文件中清除。如果你觉得玩家的 IP 地址变更频繁，可以调低此值。
• database-type, mysql, convert-from, sql-debug - 默认插件使用 SQLite 存储数据，无需更改。如需使用 MySQL，请参阅下文。注意：Spigot 1.8.8 自带的 SQLite 版本过旧，无法与此插件兼容。

消息内容

以下条目用于更改消息内容。所有字符串应使用双引号 ("...") 包裹。

• join-player-prefix, join-player, join-player-list, join-player-separator - 这些字符串用于构建玩家加入服务器时的输出消息。
• altcmd-player, altcmd-player-list, altcmd-player-separator - 这些字符串用于构建 /alt 命令的输出消息。
• altcmd-playernoalts, altcmd-noalts, altcmd-playernotfound, altcmd-paramerror, altcmd-noperm - 这些字符串用于 /alt 命令的各种其他响应。
• delcmd-removedsingular, delcmd-removedplural - 这些字符串用于 /alt delete 命令的响应。
• placeholder-enabled, placeholder-separator - 这些用于 PlaceholderAPI 扩展。
• discord - 配置 Discord 网络钩子设置。mc-server-name 可以是任何你想在 Discord 消息中显示的字符串，用于设置 Discord 消息的作者名。

🔧MySQL 配置

默认使用 SQLite。如需使用 MySQL，请先运行一次插件以生成 config.yml 文件，然后进行编辑：

• 将 database-type 改为 mysql。
• 填写 mysql 部分下的数据库凭据。
• jdbcurl-properties 的内容将被追加到连接 URL 后，你可以根据需要添加任何 MySQL 服务器要求的参数。
• 重启服务器。

🔧切换数据库

你可以在不丢失数据的情况下在 SQLite 和 MySQL 数据库之间切换。

• 在 config.yml 中，将 database-type 改为你想要转换到的数据库类型。
• 将 convert-from 改为你正在从哪种数据库转换。
• 同时，你也需要填写 MySQL 数据库的凭据。
• 重启服务器，你的数据将自动转换。此过程可能耗时，尤其是转换到 MySQL 时。

重要提示：你必须手动删除目标数据库中的任何旧数据。

• 转换到 SQLite：删除 altdetector.db 文件。
• 转换到 MySQL：使用 phpMyAdmin 等工具删除 altdetector_iptable 和 altdetector_playertable 表。

✨其他事项

• 如果你使用 Geyser 插件（允许基岩版客户端加入你的 Spigot 服务器），为了正确识别基岩版玩家的小号，你还需要安装 Floodgate 插件。
• 本插件使用 bStats 统计系统收集匿名使用数据。你可以通过修改 plugins/bStats/config.yml 全局选择退出。统计数据可在 https://bstats.org/plugin/bukkit/AltDetector 查看。