安装指南

本节将提供 CDKer 插件在 Minecraft 服务器上的详细部署流程。请严格遵循以下步骤以确保插件的正确安装与功能实现。

1. 获取插件文件:

   • 请访问 CDKer 插件的官方发布页面（例如，GitHub Releases 或 SpigotMC 资源页面），下载最新稳定版本的 CDKer.jar 文件。
   • 重要提示: 务必下载与您的 Minecraft 服务器版本 (api-version 在 plugin.yml 中指定为 1.18 及以上) 兼容的插件版本。不兼容的版本可能导致插件无法加载或引发服务器错误。

2. 部署插件至服务器目录:

   • 定位您的 Minecraft 服务器根目录。此目录通常包含 server.jar（或 spigot.jar, paper.jar 等）文件以及 world、logs 等文件夹。
   • 在该根目录下，您会找到一个名为 plugins/ 的文件夹。这是所有 Bukkit/Spigot 兼容插件的存放位置。
   • 将您下载的 CDKer.jar 文件上传或移动至此 plugins/ 文件夹中。
   • 对于远程服务器: 如果您的 Minecraft 服务器托管在远程主机上，您可能需要使用 FTP (File Transfer Protocol) 或 SFTP (SSH File Transfer Protocol) 客户端工具（如 FileZilla, WinSCP）连接到服务器，并将 CDKer.jar 文件上传至相应的 plugins/ 目录。

3. 启动或重新启动服务器:

   • 插件的加载过程在服务器启动时完成。因此，在将 CDKer.jar 文件放入 plugins/ 文件夹后，您需要执行以下操作之一：
     • 如果服务器正在运行: 在服务器控制台输入 stop 命令安全关闭服务器，然后重新启动服务器。
     • 如果服务器已关闭: 直接启动您的 Minecraft 服务器。
   • 在服务器启动过程中，您应在控制台输出中观察到类似 [CDKer] CDKer 插件已启用！ 的消息，这表明插件已成功加载。
   • 验证加载: 服务器完全启动后，您可以在游戏内输入 /plugins 命令（或在控制台输入 plugins）。在显示的插件列表中，您应该能够看到 CDKer 插件以绿色字体显示，这进一步确认了插件的正常运行。
   • 初步故障排除:
     • 如果 CDKer 未在 /plugins 列表中显示，或显示为红色，请检查服务器控制台日志。常见的错误包括 Java 版本不匹配、插件文件损坏或服务器版本不兼容。
     • 确保 CDKer.jar 文件直接位于 plugins/ 目录下，而不是嵌套在子文件夹中。

成功安装并加载插件后，CDKer 将自动在 plugins/CDKer/ 目录下生成所有必要的配置文件（config.yml, cdk.yml, used_codes.yml 以及 lang/ 文件夹及其内部的语言文件），供您进一步配置。