NekoX - 可爱猫娘插件
这是什么?
NekoX 是一款有趣的 Minecraft 插件,让游戏变得更加精彩!它允许玩家变成拥有特殊能力和互动功能的可爱猫娘。
简单来说: 这个插件为你的服务器增添了可爱的猫娘角色!
快速开始(3个简单步骤)
第 1 步:下载插件
- 下载
NekoX-5.2-ProMax+++.jar文件 - 将该文件放入服务器的
plugins文件夹中
第 2 步:启动服务器
- 正常启动你的 Minecraft 服务器
- 插件将自动创建配置文件
第 3 步:开始游玩
- 在游戏中,输入
/nekoset playername true将一名玩家变成猫娘 - 猫娘玩家现在可以使用所有有趣的功能了!
猫娘能做什么?(酷炫功能)
? 基础能力
- 夜视:猫娘在黑暗中也能看清一切
- 跳跃提升:可以跳得更高
- 潜行加速:潜行时移动更快且更安静
? 可爱聊天
- 猫娘聊天有特殊的词缀前缀和后缀
- 自动将普通词汇转换为可爱的猫娘语言
- 例如,“hello”可能会变成“meow~ hello”
? 特殊饮食
- 猫娘只能吃肉!不能吃蔬菜或水果
- 支持各种肉类食物
? 爪击攻击
- 猫娘拥有特殊的爪击攻击
- 对生物造成额外伤害
- 具有冷却时间,无法连续使用
?️ 皮革护甲加成
- 穿着皮革护甲可提供速度加成
- 每件皮革护甲都会增加速度
- 多件护甲效果叠加
- 最大加成等级可配置
简单来说: 皮革护甲让猫娘跑得更快!
? 主人系统
- 猫娘可以有主人
- 主人与猫娘之间有特殊的互动
- 可以互相治疗和帮助
- 主人死亡效果:当主人死亡时,他们的猫娘也会死亡(可配置)
- 可选择保留猫娘的背包和经验等级
? 夜间能力
- 猫娘的能力在夜间变得更强
- 午夜时分达到最强状态
- 自动激活,无需手动控制
? 应激反应
- 当猫娘生命值极低时
- 自动获得超级力量
- 持续 1 分钟,帮助逃离危险
⚔️ 被动攻击增强
- 猫娘攻击时造成略高的伤害
- 对敌人产生更强的击退效果
- 适用于所有武器类型
- 伤害和击退倍数可配置
简单来说: 猫娘的攻击更强力,能将敌人击退得更远!
? 猫薄荷效果
- 猫娘使用猫薄荷物品(默认使用小麦种子)
- 获得临时的速度和跳跃提升
- 效果持续一段时间
- 可在配置文件中修改使用的物品
?️ 伤害调整
- 坠落伤害免疫:猫娘不会从高处坠落受伤
- 其他伤害增强:猫娘受到其他来源的伤害增加 0.8 倍
- 可在配置文件中调整伤害倍数
简单来说: 猫娘免疫坠落伤害,但更容易受到攻击!
? 生物排斥
- 苦力怕排斥:苦力怕遇到猫娘时不会爆炸,而是被排斥
- 幻翼排斥:幻翼不会攻击猫娘,而是被排斥
- 自动激活,无需手动操作
简单来说: 苦力怕和幻翼害怕猫娘,会自动避开它们!
?️ 生物锁定行为
- 敌对生物对猫娘的检测距离增加
- 友好生物对猫娘更有吸引力
- 对不同种类的生物有不同的效果
- 检测参数可配置
? 玩家 proximity 通知
- 当其他玩家进入猫娘周围 25 格半径范围时,猫娘会收到标题通知
- 显示附近玩家的名称和距离
- 可以通过
/playernotice命令启用/禁用该功能 - 配置信息存储在 SQLite 数据库中
- 帮助猫娘感知周围环境
简单来说: 猫娘会收到关于附近玩家的通知!
?♀️ 攀爬功能
- 墙壁攀爬:猫娘可以攀爬墙壁和垂直表面
- 用法:使用
/climb命令切换攀爬功能 - 限制:只能在靠近墙壁处攀爬,使用范围有限
- 自动禁用:离开墙壁后自动停止攀爬
简单来说: 猫娘像蜘蛛一样可以爬墙!
? 拽尾巴功能
- 尾巴互动:玩家可以拽猫娘的尾巴
- 用法:使用
/pullthetail命令切换拽尾巴功能 - 互动效果:拽尾巴会产生有趣的互动效果(带有猫叫声的伤害和治疗)
- 控制:猫娘可以选择是否允许别人拽自己的尾巴
简单来说: 玩家可以通过拽尾巴与猫娘互动!
? 恢复生命技能
- 主动技能:猫娘可以使用
/health命令为自己和主人恢复生命值 - 消耗:使用时消耗饥饿值
- 冷却:使用之间有时间冷却
- 缩放效果:生命值越低,恢复效果越强
简单来说: 猫娘可以用这个技能治愈自己和主人!
? 技能列表
- 命令:
/myskills- 显示猫娘所有可用的技能 - 主动技能:显示冷却状态和使用信息
- 被动技能:显示状态和描述
- 清晰格式:易于理解的技能信息
简单来说: 猫娘可以使用此命令查看所有技能及其冷却时间!
? 占位符系统
- 新命令:
/nekox placeholders- 列出所有可用的 NekoX 占位符 - 增强兼容性:即使未安装 PlaceholderAPI 也能正常工作
- 更好的错误处理:当 PlaceholderAPI 不可用时显示清晰的错误消息
- 状态显示:显示每个占位符的注册状态
简单来说: 更可靠的占位符系统,用户体验得到改善!
? 命令系统增强
- 消息本地化:确保中文环境下消息正确显示
- 稳定性提升:优化命令执行流程,提高代码可靠性
- 防崩溃机制:增强错误处理机制
- 语言支持:改进默认消息回退系统
简单来说: 更稳定的命令与正确的消息显示!
? 语言系统改进
- 安全消息访问:使用
SafeMessageUtils进行安全消息获取 - 回退系统:在缺少翻译时提供更好的默认消息
- 显示一致性:确保所有命令消息在不同语言环境中均能正确显示
简单来说: 增强的语言支持与更可靠的消息处理!
? Catnip(猫薄荷)详细使用指南
什么是 Catnip?
Catnip 是 NekoX 插件的一项特殊功能,允许 neko 玩家使用特定物品获得临时增益效果。
? 使用方法
基本操作:
- 必须是 Neko 玩家 - 只有被设置为 neko 的玩家才能使用猫薄荷
- 手持猫薄荷物品 - 默认使用小麦种子(
WHEAT_SEEDS) - 右键使用 - 手持猫薄荷物品并右键点击以激活效果
具体步骤:
- 确认你是 neko(管理员使用
/nekoset yourname true进行设置) - 获取小麦种子(或其他配置的猫薄荷物品)
- 手持小麦种子并右键点击
- 立即获得加速和跳跃提升效果
⚡ 效果详情
Catnip 提供以下增益效果:
- 速度提升(速度 II) - 显著增加移动速度
- 跳跃提升(跳跃提升 II) - 大幅提升跳跃高度
- 持续时间 - 默认 60 秒(可在配置中修改)
效果特性:
- 效果即时激活
- 消耗一个猫薄荷物品
- 存在冷却时间,无法连续使用
- 仅对 neko 玩家有效
⚙️ 配置选项
在 config.yml 中自定义 catnip 设置:
cat-nip:
enabled: true # 启用/禁用猫薄荷功能
item: "WHEAT_SEEDS" # 猫薄荷物品 ID(可更改为其他物品)
duration: 60 # 效果持续时间(秒)
可修改的物品选项:
- 默认:
WHEAT_SEEDS(小麦种子) - 可更改为:
GRASS(草)、FERN(蕨类植物)、VINE(藤蔓)等 - 支持任何 Minecraft 物品 ID
? 使用技巧
- 战斗辅助 - 在 PVP 或对抗怪物时使用,获得速度与跳跃优势
- 逃生工具 - 在被追逐时使用猫薄荷快速逃离危险
- 探索加速 - 长途旅行时使用以提高移动效率
- 建筑辅助 - 跳跃提升有助于高空建筑
- 装备选择 - 穿戴皮革盔甲以获得最大速度加成
? 限制条件
- 仅限 neko 玩家使用
- 需要消耗猫薄荷物品
- 存在使用冷却时间
- 无法通过副手物品触发(必须手持于主手)
? 与其他功能的协同效应
- 夜间效果 - 猫薄荷效果在夜间表现更佳
- 压力响应 - 生命值较低时结合猫薄荷效果更佳
- 盔甲加成 - 速度加成可与皮革盔甲效果叠加
重要提示: 在主手持猫薄荷右键点击会消耗 1 个猫薄荷物品,副手物品不会触发该效果。
常用命令(游戏内使用)
交互命令(所有人可用)
/pat player- 轻拍某人/lovebite player- 给予可爱的爱心咬痕/earscratch player- 挠某人的耳朵/purr- 发出呼噜声/hiss player- 向某人哈气/scratch player- 用爪子抓某人/attention player- 吸引其他玩家的注意/pullthetail- 切换尾巴拉扯功能
能力命令(仅限 Neko 玩家)
/nightvision- 开启夜视/jumpboost- 跳跃提升/swiftsneak- 潜行加速/health- 治疗自己及主人/myskills- 查看所有技能及冷却时间/playernotice [on|off]- 启用/禁用玩家 proximity 通知/climb- 切换攀爬功能
主人系统命令
/owner add player- 申请成为某人的主人/owner accept player- 接受主人申请/owner deny player- 拒绝主人申请/owner remove player- 移除主人关系/owner list- 查看你的主人列表/owner mylist- 查看你的 neko 列表
管理员命令
/nekox reload- 重载插件设置/nekoset player true/false- 将玩家设置为 neko/nekox language language- 切换插件语言/nekox placeholders- 显示所有可用的 NekoX 占位符
紧急修复版新增功能
? 占位符系统改进
- 新命令:
/nekox placeholders- 列出所有可用的 NekoX 占位符 - 增强兼容性:即使未安装 PlaceholderAPI 也能正常工作
- 更好的错误处理:当 PlaceholderAPI 不可用时显示清晰的错误消息
- 状态显示:显示每个占位符的注册状态
简单说明: 更可靠的占位符系统与改善的用户体验!
? 命令系统增强
- 消息本地化:修复问题以确保中文环境下消息正确显示
- 稳定性提升:优化命令执行流程,提高代码可靠性
- 防崩溃机制:增强错误处理机制
- 语言支持:改进默认消息回退系统
简单说明: 更稳定的命令与正确的消息显示!
? 语言系统改进
- 安全消息访问:使用
SafeMessageUtils进行安全消息获取 - 回退系统:在缺少翻译时提供更好的默认消息
- 显示一致性:确保所有命令消息在不同语言环境中均能正确显示
简单说明: 增强的语言支持与更可靠的消息处理!
配置(可选设置)
插件首次运行时会在目录下生成一个 config.yml 文件,你可以使用文本编辑器打开并进行修改:
基本设置
neko-chat: 启用/禁用猫娘聊天特效meat-only: 猫娘是否只能吃肉owner-system: 启用/禁用主人系统
能力调整
claws: 爪击伤害与冷却时间armor-bonus: 皮革盔甲提供的速度加成night-effects: 夜间能力开始与结束时间health-skill: 治疗技能冷却时间与消耗
特殊效果
cat-nip: 猫薄荷效果与持续时间stress-effect: 压力反应触发条件passive-attack-boost: 攻击伤害加成armor-bonus: 皮革盔甲加成设置enabled: 启用/禁用盔甲加成leather-bonus: 皮革盔甲类型列表speed-bonus-per-piece: 每件盔甲提供的速度加成
neko-damage-modification: 猫娘伤害调整设置enabled: 启用/禁用伤害调整功能fall-damage-immunity: 坠落伤害免疫other-damage-multiplier: 其他伤害增加倍率debug: 调试模式
neko-mob-behavior: 猫娘实体行为设置enabled: 启用/禁用实体行为功能creeper-repulsion: 苦力怕排斥功能phantom-repulsion: 幻翼排斥功能debug: 调试模式
mob-targeting: 实体锁定行为设置enabled: 启用/禁用锁定行为调整distance-increase: 检测距离增加倍率friendly-attraction: 启用/禁用友好实体吸引
owner-death: 主人死亡效果设置feature.enabled: 启用/禁用主人死亡效果keep-inventory: 保留猫娘物品栏keep-level: 保留猫娘经验等级
开发者 API
NekoX 提供了全面的 API,供其他插件集成猫娘功能。
API 访问
在你的插件中使用 NekoX API:
- 在
plugin.yml中添加依赖:
depend: [NekoX]
- 在你的插件中获取 API 实例:
import org.cneko.nekox.api.NekoXAPI;
public class YourPlugin extends JavaPlugin {
private NekoXAPI nekoXAPI;
@Override
public void onEnable() {
nekoXAPI = NekoXAPI.getInstance(this);
if (nekoXAPI == null) {
getLogger().warning("未找到 NekoX 插件!");
getServer().getPluginManager().disablePlugin(this);
return;
}
}
}
开发环境设置
由于 NekoX 未发布到 JitPack 或其他公共仓库,你需要手动将其添加到项目中:
-
Maven 项目设置:
- 在项目目录中创建一个
libs文件夹 - 将插件目标文件夹中的
NekoX-5.2-ProMax+++.jar文件复制到你的libs文件夹中 - 在
pom.xml中添加以下依赖:
<dependency> <groupId>org.cneko</groupId> <artifactId>NekoX</artifactId> <version>5.2-ProMax+++</version> <scope>system</scope> <systemPath>${project.basedir}/libs/NekoX-5.2-ProMax+++.jar</systemPath> </dependency> - 在项目目录中创建一个
-
Gradle 项目设置:
- 在项目目录中创建一个
libs文件夹 - 将
NekoX-5.2-ProMax+++.jar文件复制到你的libs文件夹中 - 在
build.gradle中添加以下依赖:
implementation files('libs/NekoX-5.2-ProMax+++.jar') - 在项目目录中创建一个
-
手动设置(IDE):
- 在项目目录中创建一个
libs文件夹 - 将
NekoX-5.2-ProMax+++.jar文件复制到你的libs文件夹中 - 在 IDE 中将 jar 文件添加到项目的构建路径中
- 在项目目录中创建一个
API 方法
猫娘状态检查
boolean isNeko(Player player)- 检查玩家是否为猫娘boolean isNeko(String playerName)- 检查玩家(按名称)是否为猫娘
玩家获取
Set<String> getAllNekoNames()- 获取所有猫娘玩家名称(包括离线状态)
主人关系管理
Set<String> getOwnerNames(String nekoName)- 获取某只猫娘的所有主人boolean isOwnerOf(String ownerName, String nekoName)- 检查玩家是否是某只猫娘的主人boolean hasOwner(String playerName)- 检查玩家是否有主人
事件
NekoX 提供了自定义事件,供其他插件监听:
NekoStatusChangeEvent
当玩家的猫娘状态发生变化时触发:
@EventHandler
public void onNekoStatusChange(NekoStatusChangeEvent event) {
Player player = event.getPlayer();
boolean isNeko = event.isNeko();
boolean isOnline = event.isOnline();
// 处理状态变更
}
OwnerRelationshipEvent
当主人关系被添加、移除或请求时触发:
@EventHandler
public void onOwnerRelationshipChange(OwnerRelationshipEvent event) {
String nekoName = event.getNekoName();
String ownerName = event.getOwnerName();
OwnerRelationshipEvent.RelationshipAction action = event.getAction();
switch (action) {
case ADD:
// 处理关系添加
break;
case REMOVE:
// 处理关系移除
break;
case REQUEST:
// 处理关系请求
break;
}
}
? 开发者文档
? 温馨提示:如果你只是普通用户且没有编程知识,可以跳过本节!
Maven 配置
如果你想开发与 NekoX 集成的插件,以下是所需的 Maven 配置:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>your.group.id</groupId>
<artifactId>YourPlugin</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>YourPlugin</name>
<properties>
<java.version>17</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<repositories>
<!-- PaperMC Repository -->
<repository>
<id>papermc-repo</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<!-- Paper API -->
<dependency>
<groupId>io.papermc.paper</groupId>
<artifactId>paper-api</artifactId>
<version>1.20.4-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
<!-- NekoX API -->
<!-- Place the NekoX plugin jar file in your project's libs folder -->
<dependency>
<groupId>org.cneko</groupId>
<artifactId>NekoX</artifactId>
<version>5.2-ProMax+++</version>
<scope>system</scope>
<systemPath>${project.basedir}/libs/NekoX-5.2-ProMax+++.jar</systemPath>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
如何编译插件(适用于希望自行构建插件的开发者)
如果您想自行编译插件文件,请按照以下步骤操作:
Minecraft 1.20.4(默认版本)
打开命令行并输入:
mvn clean install
Minecraft 1.21.4
重要提示:您需要先在计算机上安装 Java 21 打开命令行并输入:
mvn clean install -Ppaper-1.21.4
当前限制
- 如果您的计算机使用 Java 17,则只能编译 1.20.4 版本
- 要编译 1.21.4 版本,需要先安装 Java 21
PlaceholderAPI 支持
NekoX 集成了 PlaceholderAPI 并提供以下占位符(需安装 PlaceholderAPI 插件):
| 占位符 | 描述 |
|---|---|
%nekox_is_neko% |
检查玩家是否为猫娘 |
%nekox_humans% |
获取非猫娘玩家列表 |
%nekox_nekos% |
获取猫娘玩家列表 |
使用 /nekox placeholders 命令查看所有可用的占位符及其状态。
伤害调整功能的技术实现
核心类
- <mcfile name="NekoDamageListener.java" path="src\main\java\org\cneko\nekox\events\NekoDamageListener.java"></mcfile>: 伤害处理监听器
实现逻辑
- 监听
EntityDamageEvent事件 - 检查受损实体是否为猫娘
- 如果是坠落伤害(
FALL枚举),取消该伤害事件 - 如果是其他伤害,按配置倍数增加伤害量
测试方法
- 坠落测试:猫娘从高处坠落不会受到伤害,普通玩家承受正常伤害
- 伤害测试:猫娘受到攻击时承受 0.8 倍额外伤害
- 配置测试:修改配置文件以验证效果
生物驱赶功能的技术实现
核心类
- <mcfile name="NekoMobBehaviorListener.java" path="src\main\java\org\cneko\nekox\events\NekoMobBehaviorListener.java"></mcfile>: 生物行为监听器
实现逻辑
- 苦力怕驱赶:监听
ExplosionPrimeEvent,取消爆炸并施加反向推力 - 幻翼驱赶:监听
EntityTargetLivingEntityEvent,取消攻击意图并施加反向推力 - 距离判定:有效范围为 4 格内
- 配置驱动,功能可单独开关
测试方法
- 苦力怕测试:苦力怕在猫娘附近不会爆炸,普通玩家会正常遭遇爆炸
- 幻翼测试:夜间幻翼不会攻击猫娘,普通玩家会正常被攻击
- 配置测试:修改配置文件以验证驱赶效果
常见问题
Q: 支持哪些 Minecraft 版本?
A: 支持 1.20.4 和 1.21.4 版本
Q: 如何将玩家变成猫娘?
A: 管理员输入 /nekoset playername true
Q: 猫娘比普通玩家多哪些能力?
A: 夜视、跳跃提升、潜行加速、特殊聊天、爪击等
Q: 主人系统的作用是什么?
A: 猫娘可以有主人,主人与猫娘可以互相治疗并具有特殊互动
Q: 如何修改插件设置?
A: 编辑 plugins/NekoX/config.yml 文件
Q: 是否支持中文?
A: 是的!输入 /nekox language chinese 切换为中文
技术支持
如果您遇到问题:
- 检查 Minecraft 版本是否匹配
- 确认插件文件位于正确位置
- 检查服务器日志中的错误信息
- 联系插件开发者寻求帮助
小贴士
- 猫娘在夜间更强,建议夜间多活动
- 皮革盔甲为猫娘提供速度加成
- 猫薄荷给予临时速度和跳跃提升
- 低血量会自动触发应激反应以获得额外力量
NekoX 开发者维基
目录
简介
NekoX 是一款功能丰富的 Minecraft 猫娘插件,为服务器添加了猫娘角色及相关功能。本开发者 Wiki 旨在帮助其他插件开发者了解如何与 NekoX 插件进行集成。
构建配置
Maven 配置
如果您使用 Maven 构建插件,请将以下配置添加到您的 pom.xml 文件中:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>your.group.id</groupId>
<artifactId>YourPlugin</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>YourPlugin</name>
<properties>
<java.version>17</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<repositories>
<!-- PaperMC Repository -->
<repository>
<id>papermc-repo</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<!-- Paper API -->
<dependency>
<groupId>io.papermc.paper</groupId>
<artifactId>paper-api</artifactId>
<version>1.20.4-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
<!-- NekoX API -->
<!-- Place the NekoX plugin jar file in your project's libs folder -->
<dependency>
<groupId>org.cneko</groupId>
<artifactId>NekoX</artifactId>
<version>5.2-ProMax+++</version>
<scope>system</scope>
<systemPath>${project.basedir}/libs/NekoX-5.2-ProMax+++.jar</systemPath>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
Gradle 配置
如果您使用 Gradle 构建插件,请将以下配置添加到您的 build.gradle 文件中:
plugins {
id 'java'
}
group = 'your.group.id'
version = '1.0-SNAPSHOT'
repositories {
// PaperMC Repository
maven {
name = 'papermc'
url = 'https://repo.papermc.io/repository/maven-public/'
}
mavenCentral()
}
dependencies {
// Paper API
compileOnly 'io.papermc.paper:paper-api:1.20.4-R0.1-SNAPSHOT'
// NekoX API
// Place the NekoX plugin jar file in your project's libs folder
implementation files('libs/NekoX-5.2-ProMax+++.jar')
}
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
tasks.withType(JavaCompile) {
options.encoding = 'UTF-8'
}
手动配置
如果您不使用构建工具,您可以直接将 NekoX 插件的 jar 文件添加到项目依赖项中:
- 从 NekoX 项目的 target 文件夹复制
NekoX-5.2-ProMax+++.jar文件 - 在项目中创建一个
libs文件夹 - 将
NekoX-5.2-ProMax+++.jar文件放入libs文件夹中 - 在 IDE 中将 jar 文件添加到项目的构建路径中
- 确保在
plugin.yml中添加 NekoX 作为依赖项
构建与部署
构建插件后,请确保:
- 将生成的 jar 文件放置在服务器的
plugins文件夹中 - 确保已安装 NekoX 插件
- 重启服务器以加载所有插件
多版本支持
NekoX 支持多个 Minecraft 版本:
- 对于 Minecraft 1.20.4,请使用 Java 17
- 对于 Minecraft 1.21.4,请使用 Java 21
如果需要构建特定版本,可以使用 Maven profiles:
# Build 1.20.4 version (default)
mvn clean install
# Build 1.21.4 version
mvn clean install -Ppaper-1.21.4
API 访问
1. 添加依赖项
要在插件中使用 NekoX API,首先需要获取 API 实例:
import org.cneko.nekox.api.NekoXAPI;
// In your plugin main class
public class YourPlugin extends JavaPlugin {
private NekoXAPI nekoXAPI;
@Override
public void onEnable() {
// Get NekoX API instance
nekoXAPI = NekoXAPI.getInstance(this);
if (nekoXAPI == null) {
getLogger().warning("NekoX plugin not found, please ensure NekoX is installed and enabled!");
getServer().getPluginManager().disablePlugin(this);
return;
}
getLogger().info("Successfully connected to NekoX API!");
}
}
2. plugin.yml 配置
在 plugin.yml 文件中将 NekoX 添加为依赖项:
name: YourPlugin
version: 1.0
main: your.package.YourPlugin
api-version: 1.13
depend: [NekoX]
API 方法
猫娘检查方法
boolean isNeko(Player player)
检查指定玩家是否为猫娘
参数:
player: 要检查的玩家
返回值:
true: 玩家是猫娘false: 玩家不是猫娘
boolean isNeko(String playerName)
检查指定玩家名称是否为猫娘(支持离线玩家)
参数:
playerName: 玩家名称
返回值:
true: 玩家是猫娘false: 玩家不是猫娘
玩家检索方法
Set<String> getAllNekoNames()
获取所有猫娘玩家的名称(包括离线玩家)
返回值:
- 包含所有猫娘玩家名称的 Set
关系查询方法
Set<String> getOwnerNames(String nekoName)
获取指定猫娘的所有主人名称。
参数:
nekoName: 猫娘玩家名称
返回值:
- 包含所有主人玩家名称的 Set
boolean isOwnerOf(String ownerName, String nekoName)
检查指定玩家是否是某只猫娘的主人。
参数:
ownerName: 主人玩家名称nekoName: 猫娘玩家名称
返回值:
true: 是主人false: 不是主人
boolean hasOwner(String playerName)
检查指定玩家是否有主人。
参数:
playerName: 玩家名称
返回值:
true: 有主人false: 没有主人
使用示例
示例 1:检查玩家是否为猫娘
Player player = ...; // 获取玩家实例
if (nekoXAPI.isNeko(player)) {
player.sendMessage("你是一只可爱的猫娘!");
} else {
player.sendMessage("你不是猫娘哦~");
}
示例 2:获取所有猫娘玩家名称
Set<String> nekoNames = nekoXAPI.getAllNekoNames();
for (String nekoName : nekoNames) {
// 处理每个猫娘玩家名称
getLogger().info("猫娘: " + nekoName);
}
示例 3:检查主从关系
String ownerName = ...; // 主人玩家名称
String nekoName = ...; // 猫娘玩家名称
if (nekoXAPI.isOwnerOf(ownerName, nekoName)) {
getLogger().info(ownerName + " 是 " + nekoName + " 的主人!");
}
示例 4:获取猫娘的所有主人
String nekoName = ...; // 猫娘玩家名称
Set<String> owners = nekoXAPI.getOwnerNames(nekoName);
if (owners.isEmpty()) {
getLogger().info(nekoName + " 还没有主人呢~");
} else {
StringBuilder message = new StringBuilder(nekoName + " 的主人: ");
for (String owner : owners) {
message.append(owner).append(", ");
}
getLogger().info(message.toString());
}
事件系统
NekoX 提供了一些自定义事件,其他插件可以监听这些事件以响应与猫娘相关的行为。
可用事件
NekoStatusChangeEvent
当玩家的猫娘状态发生变化时触发。
事件类: org.cneko.nekox.api.events.NekoStatusChangeEvent
触发时机: 当玩家被设为猫娘或取消猫娘状态时
使用示例:
@EventHandler
public void onNekoStatusChange(NekoStatusChangeEvent event) {
Player player = event.getPlayer();
boolean isNeko = event.isNeko();
boolean isOnline = event.isOnline();
if (isNeko) {
getLogger().info(player.getName() + " 变成了猫娘!");
} else {
getLogger().info(player.getName() + " 不再是猫娘了!");
}
}
OwnerRelationshipEvent
当主从关系发生变化时触发。
事件类: org.cneko.nekox.api.events.OwnerRelationshipEvent
触发时机: 添加、移除或请求主从关系时
使用示例:
@EventHandler
public void onOwnerRelationshipChange(OwnerRelationshipEvent event) {
String nekoName = event.getNekoName();
String ownerName = event.getOwnerName();
OwnerRelationshipEvent.RelationshipAction action = event.getAction();
switch (action) {
case ADD:
getLogger().info(ownerName + " 成为了 " + nekoName + " 的主人!");
break;
case REMOVE:
getLogger().info(ownerName + " 不再是 " + nekoName + " 的主人了!");
break;
case REQUEST:
getLogger().info(ownerName + " 请求成为 " + nekoName + " 的主人!");
break;
}
}
数据存储
NekoX 使用 SQLite 数据库存储玩家数据,包括:
- 玩家是否为猫娘
- 猫娘与主人的关系
- 玩家个性化设置
数据库结构
player_configs 表
存储玩家基本配置
player_name: 玩家名称(主键)notice_enabled: 是否启用玩家 proximity 通知is_neko: 是否为猫娘tail_pull_enabled: 是否启用尾巴拉扯功能
neko_owners 表
存储猫娘与主人的关系
neko_name: 猫娘名称owner_name: 主人名称
owner_requests 表
存储主人请求关系
requester_name: 请求者名称neko_name: 被请求的猫娘名称
注意事项
- 所有数据库操作均在异步执行,不会阻塞主线程
- 建议通过 API 方法访问数据,而不是直接操作数据库
- 玩家数据使用玩家名称作为标识符,并支持离线玩家查询
最佳实践
性能优化
- 缓存 API 实例,避免重复获取
- 适当使用异步操作,避免在主线程上执行耗时任务
- 及时释放资源,特别是在插件禁用时
错误处理
- 始终检查 API 实例是否为 null
- 处理可能的异常情况,例如玩家不在线
- 提供友好的错误提示
兼容性
- 检查 NekoX 插件是否存在且已启用
- 适配不同版本的 NekoX API
- 在 NekoX 不可用时提供回退方案和替代逻辑
支持与反馈
如果您在使用 NekoX API 过程中遇到问题或有改进建议,请通过以下方式联系我们:
- GitHub Issues:
- QQ: 959612591
感谢您使用 NekoX!
NekoX - 可爱的猫娘插件
这是什么?
NekoX 是一款让 Minecraft 变得更有趣的插件!它可以让玩家变成可爱的猫娘,拥有特殊能力和互动方式。
简单来说: 这个插件让你的服务器里出现可爱的猫娘角色!
快速开始(3步搞定)
第1步:下载插件
- 下载
NekoX-5.2-ProMax+++.jar文件 - 把这个文件放到你服务器的
plugins文件夹里
第2步:启动服务器
- 正常启动你的 Minecraft 服务器
- 插件会自动创建配置文件
第3步:开始使用
- 在游戏里输入
/nekoset 玩家名字 true把玩家变成猫娘 - 猫娘玩家就可以使用各种有趣的功能啦!
猫娘能做什么?(超有趣的功能)
? 基础能力
- 夜视能力:猫娘在黑暗中也能看清楚
- 跳跃增强:可以跳得更高
- 潜行加速:潜行时移动更快更安静
? 可爱聊天
- 猫娘聊天会有特殊的前缀和后缀
- 自动把普通词语变成可爱的猫娘用语
- 比如"你好"可能变成"喵~你好"
? 特殊饮食
- 猫娘只能吃肉!不能吃蔬菜水果
- 支持各种肉类食物
? 爪子攻击
- 猫娘有特殊的爪子攻击
- 对生物造成额外伤害
- 有冷却时间,不能连续使用
?️ 皮革护甲加成
- 穿着皮革护甲可以获得速度加成
- 每件皮革护甲都能增加速度
- 多件护甲效果叠加
- 最大加成等级可配置
简单来说: 皮革护甲让猫娘跑得更快!
? 主人系统
- 猫娘可以认主人
- 主人和猫娘有特殊互动
- 可以互相治疗和帮助
- 主人死亡效应:当主人死亡时,其猫娘也会死亡(可配置)
- 可选择是否保留猫娘的物品栏和经验等级
? 夜间能力
- 晚上猫娘能力会变强
- 午夜时能力达到最强
- 自动生效,不用手动开启
? 应激反应
- 当猫娘生命值很低时
- 会自动获得超强力量
- 持续1分钟,帮助脱离危险
⚔️ 被动攻击增强
- 猫娘攻击时造成略微更高的伤害
- 对敌人有更强的击退效果
- 适用于所有武器类型
- 伤害和击退倍数可配置
简单来说: 猫娘的攻击更有力,能把敌人打得更远!
? 猫薄荷效果
- 猫娘使用猫薄荷物品(默认使用小麦种子)
- 获得临时速度和跳跃提升
- 效果持续一段时间
- 可以在配置文件中修改使用的物品
?️ 伤害调整
- 免疫跌落伤害:猫娘从高处跌落不会受到伤害
- 其他伤害增强:猫娘受到的其他伤害增加0.8倍
- 可以在配置文件中调整伤害倍数
简单来说: 猫娘不怕摔,但更容易受伤!
? 生物驱赶
- 苦力怕驱赶:苦力怕遇到猫娘不会爆炸,而是被驱赶
- 幻翼驱赶:幻翼不会攻击猫娘,而是被驱赶
- 自动生效,无需手动操作
简单来说: 苦力怕和幻翼都怕猫娘,会自动躲开!
?️ 生物目标行为
- 敌对生物对猫娘的检测距离增加
- 友好生物更容易被猫娘吸引
- 对不同类型的生物有不同影响
- 检测参数可配置
? 玩家接近提醒
- 当其他玩家进入猫娘25格范围内时,猫娘会收到动作栏通知
- 实时显示附近玩家的名称和距离
- 更新频率提高到0.5秒一次,反应更灵敏
- 可通过
/playernotice命令开启/关闭功能 - 配置信息存储在SQLite数据库中
- 帮助猫娘了解周围环境
简单来说: 猫娘会在动作栏中实时收到附近玩家的通知!
?♀️ 爬墙功能
- 爬墙能力:猫娘可以爬上墙壁和垂直表面
- 使用方法:使用
/climb命令开启/关闭爬墙功能 - 限制条件:只能在墙壁附近攀爬,有一定的使用范围
- 自动关闭:离开墙壁后自动停止攀爬
简单来说: 猫娘可以像蜘蛛一样在墙壁上爬行!
? 尾巴拉扯功能
- 尾巴拉扯:玩家可以拉扯猫娘的尾巴
- 使用方法:使用
/pullthetail命令开启/关闭尾巴拉扯功能 - 互动效果:拉扯尾巴会产生有趣的互动效果(造成伤害并立即恢复,播放猫叫声)
- 开关控制:猫娘可以自主选择是否允许被拉扯尾巴
简单来说: 玩家可以和猫娘进行尾巴拉扯的互动!
? 健康恢复技能
- 主动技能:猫娘可以使用
/health命令恢复自己和主人的生命值 - 消耗:使用技能会消耗饱食度
- 冷却:技能有使用冷却时间
- 效果缩放:生命值越低,恢复效果越强
简单来说: 猫娘可以用这个技能治疗自己和主人!
? 技能列表
- 命令:
/myskills- 显示猫娘可用的所有技能 - 主动技能:显示冷却状态和使用信息
- 被动技能:显示状态和描述
- 清晰格式:易于理解的技能信息
简单来说: 猫娘可以通过这个命令查看所有技能和冷却时间!
? 占位符系统
- 新命令:
/nekox placeholders- 列出所有可用的NekoX占位符 - 增强兼容性:即使未安装PlaceholderAPI也能正常工作
- 更好的错误处理:PlaceholderAPI不可用时显示清晰的错误信息
- 状态显示:显示每个占位符的注册状态
简单来说: 更可靠的占位符系统,提升用户体验!
? 命令系统增强
- 消息本地化:确保中文消息正确显示
- 提高稳定性:优化命令执行流程,提高代码可靠性
- 防止崩溃:增强错误处理机制
- 语言支持:更好的默认消息回退系统
简单来说: 更稳定的命令,消息显示正确!
? 语言系统改进
- 安全消息访问:使用SafeMessageUtils安全获取消息
- 回退系统:翻译缺失时提供更好的默认消息
- 一致显示:确保所有命令消息在不同语言环境下正确显示
简单来说: 增强的语言支持,消息处理更可靠!
? 猫薄荷详细使用指南
什么是猫薄荷?
猫薄荷是NekoX插件中的一个特殊功能,让猫娘玩家使用特定物品获得临时增益效果。
? 使用方法
基本操作:
- 必须是猫娘玩家 - 只有被设置为猫娘的玩家才能使用猫薄荷
- 手持猫薄荷物品 - 默认使用小麦种子(WHEAT_SEEDS)
- 右键使用 - 手持猫薄荷物品右键点击即可激活效果
具体步骤:
- 确保你是猫娘(管理员使用
/nekoset 你的名字 true设置) - 获取小麦种子(或其他配置的猫薄荷物品)
- 手持小麦种子右键点击
- 立即获得速度和跳跃提升效果
⚡ 效果详情
猫薄荷提供以下增益效果:
- 速度提升 (Speed II) - 移动速度大幅增加
- 跳跃提升 (Jump Boost II) - 跳跃高度显著提升
- 持续时间 - 默认60秒(可在配置中修改)
效果特点:
- 效果立即生效
- 消耗一个猫薄荷物品
- 有冷却时间,不能连续使用
- 只对猫娘玩家有效
⚙️ 配置选项
在 config.yml 中可以自定义猫薄荷设置:
cat-nip:
enabled: true # 是否启用猫薄荷功能
item: "WHEAT_SEEDS" # 猫薄荷物品ID(可修改为其他物品)
duration: 60 # 效果持续时间(秒)
可修改的物品选项:
- 默认:
WHEAT_SEEDS(小麦种子) - 可改为:
GRASS(草)、FERN(蕨类)、VINE(藤蔓)等 - 支持任何Minecraft物品ID
? 使用技巧
- 战斗辅助 - 在PVP或打怪时使用,获得速度和跳跃优势
- 逃跑利器 - 被追击时使用猫薄荷快速脱离危险
- 探索加速 - 长途旅行时使用,提高移动效率
- 建筑辅助 - 跳跃提升有助于搭建高处建筑
- 护甲选择 - 穿皮革护甲可获得最大速度加成
? 限制条件
- 只有猫娘玩家可以使用
- 需要消耗猫薄荷物品
- 有使用冷却时间
- 副手持物时无法使用(必须主手持物)
? 与其他功能的配合
- 夜间效果 - 晚上使用猫薄荷效果更佳
- 应激反应 - 生命值低时配合猫薄荷效果更好
- 护甲加成 - 速度加成与皮革护甲效果叠加
重要提示: 主手持物右键会消耗1个猫薄荷物品,副手持物不会触发效果。
常用命令(游戏内使用)
互动命令(所有人都能用)
/pat 玩家- 轻轻拍拍别人/lovebite 玩家- 给个可爱的咬咬/earscratch 玩家- 挠挠耳朵/purr- 发出呼噜声/hiss 玩家- 对别人发出嘶嘶声/scratch 玩家- 用爪子抓一下/attention 玩家- 吸引其他玩家的注意/pullthetail- 开关尾巴拉扯功能
能力命令(只有猫娘能用)
/nightvision- 开启夜视/jumpboost- 跳跃增强/swiftsneak- 潜行加速/health- 治疗自己和主人/myskills- 查看所有技能和冷却时间/playernotice [on|off]- 开启/关闭玩家接近提醒/climb- 开关爬墙功能
主人系统命令
/owner add 玩家- 请求成为某人的主人/owner accept 玩家- 接受主人的请求/owner deny 玩家- 拒绝主人的请求/owner remove 玩家- 解除主人关系/owner list- 查看自己的主人/owner mylist- 查看自己的猫娘
管理员命令
/nekox reload- 重新加载插件设置/nekoset 玩家 true/false- 设置玩家为猫娘/nekox language 语言- 切换插件语言/nekox placeholders- 显示所有可用的NekoX占位符
配置说明(可选设置)
插件第一次运行时会创建 config.yml 文件,你可以用记事本打开修改:
基本设置
neko-chat: 开启/关闭猫娘聊天特效meat-only: 猫娘是否只能吃肉owner-system: 是否开启主人系统
能力调整
claws: 爪子攻击的伤害和冷却时间armor-bonus: 皮革护甲提供的速度加成night-effects: 夜间能力的开始和结束时间health-skill: 治疗技能的冷却和消耗
特殊效果
cat-nip: 猫薄荷的效果和持续时间stress-effect: 应激反应的触发条件passive-attack-boost: 攻击伤害加成armor-bonus: 皮革护甲加成设置enabled: 是否启用护甲加成leather-bonus: 皮革护甲类型列表speed-bonus-per-piece: 每件护甲的速度加成
neko-damage-modification: 猫娘伤害调整设置enabled: 是否启用伤害调整功能fall-damage-immunity: 免疫跌落伤害other-damage-multiplier: 其他伤害增加倍数debug: 调试模式
neko-mob-behavior: 猫娘生物行为设置enabled: 是否启用生物行为功能creeper-repulsion: 苦力怕驱赶功能phantom-repulsion: 幻翼驱赶功能debug: 调试模式
mob-targeting: 生物目标行为设置enabled: 是否启用目标行为调整distance-increase: 检测距离增加倍数friendly-attraction: 是否启用友好生物吸引
owner-death: 主人死亡效应设置feature.enabled: 是否启用主人死亡效应keep-inventory: 是否保留猫娘物品栏keep-level: 是否保留猫娘经验等级
开发者API
NekoX为其他插件提供了全面的API,以便集成猫娘功能。
API接入
在您的插件中使用NekoX API:
- 在
plugin.yml中添加依赖:
depend: [NekoX]
- 在插件中获取API实例:
import org.cneko.nekox.api.NekoXAPI;
public class YourPlugin extends JavaPlugin {
private NekoXAPI nekoXAPI;
@Override
public void onEnable() {
nekoXAPI = NekoXAPI.getInstance(this);
if (nekoXAPI == null) {
getLogger().warning("未找到NekoX插件!");
getServer().getPluginManager().disablePlugin(this);
return;
}
}
}
开发环境设置方法
由于NekoX没有发布到JitPack或其他公共仓库,您需要手动将其添加到您的项目中:
-
Maven 项目设置:
- 在您的项目目录中创建一个
libs文件夹 - 将本插件 target 文件夹中的
NekoX-5.2-ProMax+++.jar文件复制到您的libs文件夹 - 在您的
pom.xml中添加以下依赖:
<dependency> <groupId>org.cneko</groupId> <artifactId>NekoX</artifactId> <version>5.2-ProMax+++</version> <scope>system</scope> <systemPath>${project.basedir}/libs/NekoX-5.2-ProMax+++.jar</systemPath> </dependency> - 在您的项目目录中创建一个
-
Gradle 项目设置:
- 在您的项目目录中创建一个
libs文件夹 - 将
NekoX-5.2-ProMax+++.jar文件复制到您的libs文件夹 - 在您的
build.gradle中添加以下依赖:
implementation files('libs/NekoX-5.2-ProMax+++.jar') - 在您的项目目录中创建一个
-
手动设置(IDE):
- 在您的项目目录中创建一个
libs文件夹 - 将
NekoX-5.2-ProMax+++.jar文件复制到您的libs文件夹 - 在您的 IDE 中将 jar 文件添加到项目的构建路径
- 在您的项目目录中创建一个
API 方法
猫娘状态检查
boolean isNeko(Player player)- 检查玩家是否为猫娘boolean isNeko(String playerName)- 检查玩家(按名称)是否为猫娘
玩家获取
Set<String> getAllNekoNames()- 获取所有猫娘玩家名称(包括离线)
主人关系管理
Set<String> getOwnerNames(String nekoName)- 获取猫娘的所有主人名称boolean isOwnerOf(String ownerName, String nekoName)- 检查玩家是否为猫娘的主人boolean hasOwner(String playerName)- 检查玩家是否有主人
事件
NekoX 提供了自定义事件供其他插件监听:
NekoStatusChangeEvent
当玩家的猫娘状态改变时触发:
@EventHandler
public void onNekoStatusChange(NekoStatusChangeEvent event) {
Player player = event.getPlayer();
boolean isNeko = event.isNeko();
boolean isOnline = event.isOnline();
// 处理状态变更
}
OwnerRelationshipEvent
当主人关系添加、移除或申请时触发:
@EventHandler
public void onOwnerRelationshipChange(OwnerRelationshipEvent event) {
String nekoName = event.getNekoName();
String ownerName = event.getOwnerName();
OwnerRelationshipEvent.RelationshipAction action = event.getAction();
switch (action) {
case ADD:
// 处理关系添加
break;
case REMOVE:
// 处理关系移除
break;
case REQUEST:
// 处理关系申请
break;
}
}
? 开发者相关文档
? 温馨提示:如果您只是普通用户,没有编程基础,可以跳过这部分内容!
Maven 配置
如果您想开发与 NekoX 集成的插件,以下是您需要的 Maven 配置:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>your.group.id</groupId>
<artifactId>YourPlugin</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>YourPlugin</name>
<properties>
<java.version>17</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<repositories>
<!-- PaperMC 仓库 -->
<repository>
<id>papermc-repo</id>
<url>https://repo.papermc.io/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<!-- Paper API -->
<dependency>
<groupId>io.papermc.paper</groupId>
<artifactId>paper-api</artifactId>
<version>1.20.4-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
<!-- NekoX API -->
<!-- 将 NekoX 插件 jar 文件放在项目的 libs 文件夹中 -->
<dependency>
<groupId>org.cneko</groupId>
<artifactId>NekoX</artifactId>
<version>5.2-ProMax+++</version>
<scope>system</scope>
<systemPath>${project.basedir}/libs/NekoX-5.2-ProMax+++.jar</systemPath>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>${java.version}</source>
<target>${java.version}</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
如何编译插件(适合想自己构建插件的开发者)
如果您想要自己编译插件文件,可以按照以下步骤操作:
对于 Minecraft 1.20.4(默认版本)
打开命令行,输入:
mvn clean install
对于 Minecraft 1.21.4
重要提示:您需要先在电脑上安装 Java 21 打开命令行,输入:
mvn clean install -Ppaper-1.21.4
当前限制
- 如果您的电脑使用的是 Java 17,您只能编译 1.20.4 版本
- 要编译 1.21.4 版本,您需要先安装 Java 21
你是这个资源的作者?登录后可认领此资源。
相似资源
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
使床在所有维度中爆炸的模组
为 Armor Poser 模组添加兼容性
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
一个高度兼容、功能完善且稳定的 TPA 模组
AbAcc AbAcc 是一款适用于 Minecraft 服务器的管理插件,可简化玩家作弊检测与举报管理工作。工作人员可以发起并管理对可疑玩家的检查流程,并在检查完成后将其释放。
评论 0
登录后参与评分
还没有评论,来抢沙发吧