🔒 KCaptcha 是一款验证码插件，用于验证玩家是否为真人，防止机器人和垃圾信息。它具有高度的可配置性，并且与其它插件兼容。验证码可以通过聊天框、BossBar 或标题栏显示。

🔑 KCaptcha

✨ 特性

• 兼容性强：不与其他插件冲突。
• 可配置性高：几乎所有内容都可以自定义。
• 多种显示方式：支持在聊天框、BossBar 或标题栏显示验证码。
• 玩家记录：记录玩家验证信息，如验证时间、IP 地址等。
• 忽略登录指令：允许玩家在输入验证码前登录。
• 强制验证：可设置每隔一段时间或强制玩家进行验证。

🛠️ 安装

适用于原版 Minecraft

1. 下载最新版本的插件。
2. 将下载的 .jar 文件放入服务器的 plugins 文件夹中。
3. 重启或重载服务器。
4. 通过 KCaptcha 文件夹中的配置文件进行配置。
5. 使用 /kcaptcha reload 命令加载新的配置。

适用于 Modded Minecraft

1. 按照上述步骤 1-2 操作。
2. 下载 ProtocolLib 并将 .jar 文件放入 plugins 文件夹。
3. 按照上述步骤 3-5 操作。

🔄 向后兼容性

本节内容适用于更新插件并需要重新配置的用户。

从 v1.4.1 或更早版本更新的用户：

1. 运行 /kcaptcha convert pre15 命令（只能通过控制台运行）。
2. 插件将重命名 config.yml 和 messages.yml 文件中的一些部分。
3. 现在必须将重命名的部分复制到插件使用的正确的配置文件中（例如 mainConfig.yml）。
4. 此命令所做的只是重命名部分和删除旧的、不再使用的部分。
5. 它不会自行在文件之间传输数据，您必须手动操作！

⚙️ 配置文件

配置分为四个文件，每个文件都有详细的说明：

• barConfig.yml
• chatConfig.yml
• mainConfig.yml
• titleConfig.yml

⌨️ 命令

• /kcaptcha - 主命令，别名：captcha, kcode, code
• /kcaptcha help - 显示帮助信息
• /kcaptcha reload - 重新加载插件配置
• /kcaptcha force <nick> - 强制玩家再次验证
• /kcaptcha info <nick> - 显示玩家验证信息
• /kcaptcha version - 显示插件信息和版本
• /kcaptcha convert <mode> - 转换旧的配置文件

🛡️ 权限

• kcaptcha.* - 授予所有权限（OP 默认拥有）
• kcaptcha.bypass - 允许玩家跳过验证
• kcaptcha.info - 允许使用 /kcaptcha info 命令
• kcaptcha.force - 允许使用 /kcaptcha force 命令
• kcaptcha.reload - 允许使用 /kcaptcha reload 命令

🐛 问题和错误

如果您在使用插件时遇到任何问题，请先执行以下操作：

• 如果您运行的是 Modded 服务器，请检查您的 ProtocolLib 版本是否正确。
• 再次阅读您的配置，看看是否犯了错误。
• 查看服务器日志或控制台中是否有来自 KCaptcha 的任何消息。
• 查看插件页面，看看您的问题是否已经被发现并且正在解决。

如果您仍然有问题：

不要将问题写成评论 - 我会忽略这些。

如果你的问题例如是一个 Bug：

• 在 GitHub 上创建一个新的 Issue
• 在插件讨论中写下你的问题

如果您的问题需要直接与我联系：

• 通过 Skype 联系我 - 我的用户名是 kamilkime
• 通过 Steam 联系我
• 通过 Facebook 联系我
• 通过 Youtube 联系我
• 通过 PM 联系我

🔮 计划

• 添加 MySQL 数据库支持
• 添加更多验证方法
• 提高用户数据操作效率
• 添加更多配置选项

💻 服务器列表

如果您在服务器上使用 KCaptcha，请联系我，我将在此处放置您的服务器 IP。

📝 配置示例 (mainConfig.yml)

# +--------------------------------------------------------------------------------------------------+ #
# |                       KCaptcha configuration file - mainConfig.yml                               | #
# +--------------------------------------------------------------------------------------------------+ #

# +--------------------------------------------------------------------------------------------------+ #
# |                                            GENERAL                                               | #
# +--------------------------------------------------------------------------------------------------+ #

# Method of displaying captcha code to player, avaliable methods: chat, title, bar
# It's not case sensitive
displayMethod: 'chat'

# Time in seconds after player will be forced to verify again
# Set to 0 to disable
verificationInterval: 0

# Should plugin check if player moved since join?
# If set to true - player will have to stand still to pass verification
checkPlayerMovement: false

# List of commands which won't be blocked before verification, every command on new line
# Remember that commands are case-sensitive
ignoredCommands:
  - '/login'
  - '/register'

# Should plugin ignore commands from console?
ignoreConsoleCommands: true

# Should plugin protect players with "kcaptcha.bypass" permission?
protectBypassed: false

# +--------------------------------------------------------------------------------------------------+ #
# |                                          CAPTCHA CODE                                            | #
# +--------------------------------------------------------------------------------------------------+ #

# Length of captcha code
codeLength: 6

# Avaliable characters in captcha code
# If you want to use only numbers - set to "1234567890"
# It's case sensitive
codeCharacters: 'QWERTYUIOPASDFGHJKLZXCVBNMqwertyuiopasdfghjklzxcvbnm1234567890'

# Is captcha code case sensitive?
caseSensitive: false

# Should plugin generate new code after player types wrong one?
regenerateCode: true

# +--------------------------------------------------------------------------------------------------+ #
# |                                            DATABASE                                              | #
# +--------------------------------------------------------------------------------------------------+ #

# Use MySQL database to store verification data?
useMysql: false

# MySQL database configuration
mysql:
  host: 'localhost'
  port: 3306
  database: 'minecraft'
  user: 'root'
  password: ''

# +--------------------------------------------------------------------------------------------------+ #
# |                                          ADVANCED                                                | #
# +--------------------------------------------------------------------------------------------------+ #

# Delay in miliseconds before sending first message to player
messageDelay: 0

# Should plugin block player actions before verification?
# Avaliable actions: chat, command, movement
blockedActions:
  chat: true
  command: true
  movement: true

# +--------------------------------------------------------------------------------------------------+ #
# |                                          PLACEHOLDERS                                             | #
# +--------------------------------------------------------------------------------------------------+ #

# Placeholders used in messages:
# %code% - captcha code
# %nick% - player's nickname

# +--------------------------------------------------------------------------------------------------+ #
# |                                              THE END                                              | #
# +--------------------------------------------------------------------------------------------------+ #