
Citizens2 插件下载教程CI 持续集成版本教程面向完全没接触过 Jenkins/CI 的新手手把手教你从 Citizens 官方构建站下载对应你 Minecraft 服务器版本的插件。一、先了解几个概念很重要别跳过概念通俗解释CitizensMinecraft 服务器上最老牌的 NPC假人/非玩家角色插件能创建各种拟真 NPCCI / Jenkins一种自动编译服务器。开发者每次提交代码它就自动把代码编译成可用的.jar插件文件。你可以理解为官方最新版自动发布站构建BuildJenkins 每次编译叫做一次构建每次都有一个编号比如 #4211。编号越大越新模块ModuleCitizens 插件内部按 Minecraft 版本拆分了很多子模块比如citizens-v1_21_R1专门适配 MC 1.21。每个模块只对应一个或几个 MC 版本didn’t run某次构建中这个模块没有重新编译因为代码没改动沿用上次编译的结果。不代表不支持该版本只是这次没重新编译而已二、Citizens 支持的 Minecraft 版本对照表Citizens 的每个版本模块名形如citizens-v1_21_R1其中1_21_R1就是你要填入 URL 的版本号。Minecraft 版本URL 中填写的版本号完整模块名1.8.81_8_R3citizens-v1_8_R31.10 1.10.21_10_R1citizens-v1_10_R11.11 1.11.21_11_R1citizens-v1_11_R11.12 1.12.21_12_R1citizens-v1_12_R11.13.1 1.13.21_13_R2citizens-v1_13_R21.14 1.14.41_14_R1citizens-v1_14_R11.15 1.15.21_15_R1citizens-v1_15_R11.16.11_16_R1citizens-v1_16_R11.16.2 1.16.31_16_R2citizens-v1_16_R21.16.4 1.16.51_16_R3citizens-v1_16_R31.17 1.17.11_17_R1citizens-v1_17_R11.18 1.18.11_18_R1citizens-v1_18_R11.18.21_18_R2citizens-v1_18_R21.19 1.19.21_19_R1citizens-v1_19_R11.19.31_19_R2citizens-v1_19_R21.19.41_19_R3citizens-v1_19_R31.20 1.20.11_20_R1citizens-v1_20_R11.20.21_20_R2citizens-v1_20_R21.20.3 1.20.41_20_R3citizens-v1_20_R31.20.5 1.20.61_20_R4citizens-v1_20_R41.21 1.21.11_21_R1citizens-v1_21_R11.21.21_21_R2citizens-v1_21_R21.21.31_21_R3citizens-v1_21_R31.21.41_21_R4citizens-v1_21_R41.21.51_21_R5citizens-v1_21_R51.21.61_21_R6citizens-v1_21_R61.21.71_21_R7citizens-v1_21_R726.1 26.1.226_1_R1citizens-v26_1_R126.226_2_R1citizens-v26_2_R1提示Minecraft 从 1.21.x 之后启用了新的版本编号体系26.x格式所以你会看到v26_1_R1、v26_2_R1这样的新模块名。如果不确定你的服务器版本在服务器控制台输入/version即可查看。三、详细下载步骤跟着做就行第一步确认你的 Minecraft 服务器版本在服务器控制台或游戏内 OP 输入执行/version屏幕会显示类似This server is running version 1.21.4的信息记下版本号1.21.4。然后对照上面的表格找到对应的版本号1_21_R4。第二步拼接模块页面 URLURL 的固定格式是https://ci.citizensnpcs.co/job/Citizens2/net.citizensnpcs$citizens-v版本号把版本号替换为上一步查到的值。例如你的服务器是 1.21.4https://ci.citizensnpcs.co/job/Citizens2/net.citizensnpcs$citizens-v1_21_R4注意URL 中的$符号是网址的一部分不是占位符不要删掉。第三步打开模块页面找到最新编译号在浏览器中打开上面拼接好的 URL。你会看到一个 Jenkins 页面页面内容大致如下citizens-v1_21_R4 Last Successful Artifacts: citizens-v1_21_R4-2.0.xx-SNAPSHOT.jar ← 这里会显示文件名和大小 Permalinks: Last build (#XXXX), xx days ago ← ★ 这个编号就是你要的构建号 Last stable build (#XXXX), xx days ago Last successful build (#XXXX), xx days ago ...你要找的关键信息页面上方的“Last Successful Artifacts”区域 —— 这里会显示最后一次成功编译产生的文件以及对应的构建编号页面下方的“Permalinks”区域 —— 这里列出了各种最后一次的构建链接两种方式都能拿到构建号。推荐看 “Last successful build” 那一行它后面的#XXXX就是你要的编号。关于左侧边栏Jenkins 页面左侧有一个导航栏其中有“Build History”构建历史链接。点击它可以查看该模块所有历史构建的列表你可以在列表里挑选最新的、状态为成功蓝色球的那一条。如果你不想翻列表直接看 Permalinks 里的 “Last successful build” 编号即可效果一样。第四步进入主构建页面拿到构建号后假设是4211拼接以下 URLhttps://ci.citizensnpcs.co/job/Citizens2/构建号/替换后https://ci.citizensnpcs.co/job/Citizens2/4211/在浏览器中打开这个地址。你会看到Citizens2 #4211 Success ← 绿色成功标记 Build Artifacts: Citizens-2.0.43-b4211.jar ← ★ 这就是最终要下载的插件文件 4.16 MiB ← 文件大小约 4.16 MB Revision: a5c3de1a... Repository: https://github.com/CitizensDev/Citizens2.git Module Builds: ← 这里列出本次构建编译了哪些模块 citizens 3.1 sec citizens-main 1 min 35 sec citizens-v1_21_R7 23 sec ← 这些是有编译的 citizens-v26_1_R1 14 sec citizens-v26_2_R1 13 sec citizens-v1_19_R3 (didnt run) ← 没重新编译但仍然包含在主 jar 中 ...第五步下载插件文件在第四步的页面中找到“Build Artifacts”区域Citizens-2.0.43-b4211.jar 4.16 MiB直接点击文件名即可开始下载。重要你只需要下载这个Citizens-2.0.xx-bXXXX.jar文件。这是完整的主插件包内部已经包含了所有支持的 Minecraft 版本的适配代码。不要去下载单独的模块 jar如citizens-v1_21_R4-xxx.jar那些只是内部组件单独无法使用。第六步安装到服务器将下载的.jar文件放入服务器的plugins文件夹中重启服务器不是/reload要完整重启启动后plugins文件夹下会自动生成Citizens文件夹说明安装成功在游戏内输入/citizens确认插件正常运行四、关于 “didn’t run” 的详细说明你在构建页面会看到很多模块标注(didnt run)比如citizens-v1_19_R3 (didnt run) citizens-v1_20_R4 (didnt run) citizens-v1_21_R1 (didnt run)这是什么意思Jenkins 使用增量编译机制。每次构建时它只重新编译代码有改动的模块没改动的模块直接沿用上次编译的结果。所以 “didn’t run”不是不支持或编译失败而是这次没必要重新编译直接用上次的成品。对你下载的影响下载的主 jar 文件Citizens-2.0.xx-bXXXX.jar包含了所有已支持版本的适配代码无论该模块在这次构建中是否 “ran”也就是说即使你的版本模块标注了 “didn’t run”主 jar 仍然支持你的版本为什么要走模块页面找构建号如果你想确保下载的构建确实重新编译过你的版本而不是沿用旧缓存可以走模块页面确认该模块最后一次编译是在哪个构建号不过对于绝大多数用户来说直接下载最新成功构建的主 jar 就够了不需要那么纠结五、快速下载懒人版如果你不想一步步来只需要最新版本打开https://ci.citizensnpcs.co/job/Citizens2/lastSuccessfulBuild/找到“Build Artifacts”下的Citizens-2.0.xx-bXXXX.jar点击下载最新构建的主 jar 有100%概率识别不了一些MC版本六、注意事项始终使用最新版本Citizens 官方强烈建议始终使用最新的 Minecraft 版本和最新的 Citizens 版本。旧版本不提供技术支持Java 版本要求MC 1.17 1.20.4 → Java 17MC 1.20.5 1.21.7 → Java 21MC 26.1 → 请使用 Spigot/Paper 推荐的 Java 版本只下载主 jar永远只下载Citizens-2.0.xx-bXXXX.jar约 4 MB 的那个不要下载模块单独的 jar 文件Sentinel 和 Denizen这两个 Citizens 的附属插件只支持最近 3-4 个大版本不支持 1.8.8 等老版本MC 1.8.8 特殊说明1.8.8 的支持方式比较特殊详细参考 Citizens Wiki - Minecraft 1.8七、完整流程速查表步骤操作示例1服务器内输入/version确认版本1.21.42查对照表得到版本号1_21_R43拼接模块页面 URL 并打开https://ci.citizensnpcs.co/job/Citizens2/net.citizensnpcs$citizens-v1_21_R44在页面找到最新成功构建号#42115拼接主构建页面 URL 并打开https://ci.citizensnpcs.co/job/Citizens2/4211/6点击Citizens-2.0.xx-bXXXX.jar下载下载完成7放入plugins文件夹重启服务器安装完成参考链接Citizens CI 构建站https://ci.citizensnpcs.co/job/Citizens2/Citizens GitHub 仓库https://github.com/CitizensDev/Citizens2Citizens Wiki版本兼容性https://wiki.citizensnpcs.co/VersionsSpigotMC 官方页面https://www.spigotmc.org/resources/citizens.13811/