NekoX

插件

· 作者 _Chinese_Player_

一个 Minecraft Paper 插件,可将玩家变成拥有特殊能力的可爱猫娘,结合了 NekoC 和 toNeko 插件的功能,为您的服务器带来全面的猫咪体验。

0 本站下载 0 关注 更新于 11 个月前

最新 5.2-ProMax+++ · 1.21.10 · Paper

一键开服(送7天)

NekoX - 可爱猫娘插件

这是什么?

NekoX 是一款有趣的 Minecraft 插件,让游戏变得更加精彩!它允许玩家变成拥有特殊能力和互动功能的可爱猫娘。

简单来说: 这个插件为你的服务器增添了可爱的猫娘角色!

快速开始(3个简单步骤)

第 1 步:下载插件

  1. 下载 NekoX-5.2-ProMax+++.jar 文件
  2. 将该文件放入服务器的 plugins 文件夹中

第 2 步:启动服务器

  1. 正常启动你的 Minecraft 服务器
  2. 插件将自动创建配置文件

第 3 步:开始游玩

  1. 在游戏中,输入 /nekoset playername true 将一名玩家变成猫娘
  2. 猫娘玩家现在可以使用所有有趣的功能了!

猫娘能做什么?(酷炫功能)

? 基础能力

  • 夜视:猫娘在黑暗中也能看清一切
  • 跳跃提升:可以跳得更高
  • 潜行加速:潜行时移动更快且更安静

? 可爱聊天

  • 猫娘聊天有特殊的词缀前缀和后缀
  • 自动将普通词汇转换为可爱的猫娘语言
  • 例如,“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 玩家使用特定物品获得临时增益效果。

? 使用方法

基本操作:

  1. 必须是 Neko 玩家 - 只有被设置为 neko 的玩家才能使用猫薄荷
  2. 手持猫薄荷物品 - 默认使用小麦种子(WHEAT_SEEDS)
  3. 右键使用 - 手持猫薄荷物品并右键点击以激活效果

具体步骤:

  1. 确认你是 neko(管理员使用 /nekoset yourname true 进行设置)
  2. 获取小麦种子(或其他配置的猫薄荷物品)
  3. 手持小麦种子并右键点击
  4. 立即获得加速和跳跃提升效果

⚡ 效果详情

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

? 使用技巧

  1. 战斗辅助 - 在 PVP 或对抗怪物时使用,获得速度与跳跃优势
  2. 逃生工具 - 在被追逐时使用猫薄荷快速逃离危险
  3. 探索加速 - 长途旅行时使用以提高移动效率
  4. 建筑辅助 - 跳跃提升有助于高空建筑
  5. 装备选择 - 穿戴皮革盔甲以获得最大速度加成

? 限制条件

  • 仅限 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:

  1. 在 plugin.yml 中添加依赖:
depend: [NekoX]
  1. 在你的插件中获取 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 或其他公共仓库,你需要手动将其添加到项目中:

  1. 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>
    
  2. Gradle 项目设置:

    • 在项目目录中创建一个 libs 文件夹
    • 将 NekoX-5.2-ProMax+++.jar 文件复制到你的 libs 文件夹中
    • 在 build.gradle 中添加以下依赖:
    implementation files('libs/NekoX-5.2-ProMax+++.jar')
    
  3. 手动设置(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>: 伤害处理监听器

实现逻辑

  1. 监听 EntityDamageEvent 事件
  2. 检查受损实体是否为猫娘
  3. 如果是坠落伤害(FALL 枚举),取消该伤害事件
  4. 如果是其他伤害,按配置倍数增加伤害量

测试方法

  • 坠落测试:猫娘从高处坠落不会受到伤害,普通玩家承受正常伤害
  • 伤害测试:猫娘受到攻击时承受 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 切换为中文

技术支持

如果您遇到问题:

  1. 检查 Minecraft 版本是否匹配
  2. 确认插件文件位于正确位置
  3. 检查服务器日志中的错误信息
  4. 联系插件开发者寻求帮助

小贴士

  • 猫娘在夜间更强,建议夜间多活动
  • 皮革盔甲为猫娘提供速度加成
  • 猫薄荷给予临时速度和跳跃提升
  • 低血量会自动触发应激反应以获得额外力量

NekoX 开发者维基

目录

  1. 简介
  2. 构建配置
  3. API 访问
  4. API 方法
  5. 使用示例
  6. 事件系统
  7. 数据存储

简介

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 文件添加到项目依赖项中:

  1. 从 NekoX 项目的 target 文件夹复制 NekoX-5.2-ProMax+++.jar 文件
  2. 在项目中创建一个 libs 文件夹
  3. 将 NekoX-5.2-ProMax+++.jar 文件放入 libs 文件夹中
  4. 在 IDE 中将 jar 文件添加到项目的构建路径中
  5. 确保在 plugin.yml 中添加 NekoX 作为依赖项

构建与部署

构建插件后,请确保:

  1. 将生成的 jar 文件放置在服务器的 plugins 文件夹中
  2. 确保已安装 NekoX 插件
  3. 重启服务器以加载所有插件

多版本支持

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: 被请求的猫娘名称

注意事项

  1. 所有数据库操作均在异步执行,不会阻塞主线程
  2. 建议通过 API 方法访问数据,而不是直接操作数据库
  3. 玩家数据使用玩家名称作为标识符,并支持离线玩家查询

最佳实践

性能优化

  1. 缓存 API 实例,避免重复获取
  2. 适当使用异步操作,避免在主线程上执行耗时任务
  3. 及时释放资源,特别是在插件禁用时

错误处理

  1. 始终检查 API 实例是否为 null
  2. 处理可能的异常情况,例如玩家不在线
  3. 提供友好的错误提示

兼容性

  1. 检查 NekoX 插件是否存在且已启用
  2. 适配不同版本的 NekoX API
  3. 在 NekoX 不可用时提供回退方案和替代逻辑

支持与反馈

如果您在使用 NekoX API 过程中遇到问题或有改进建议,请通过以下方式联系我们:

  • GitHub Issues:
  • QQ: 959612591

感谢您使用 NekoX!


NekoX - 可爱的猫娘插件

这是什么?

NekoX 是一款让 Minecraft 变得更有趣的插件!它可以让玩家变成可爱的猫娘,拥有特殊能力和互动方式。

简单来说: 这个插件让你的服务器里出现可爱的猫娘角色!

快速开始(3步搞定)

第1步:下载插件

  1. 下载 NekoX-5.2-ProMax+++.jar 文件
  2. 把这个文件放到你服务器的 plugins 文件夹里

第2步:启动服务器

  1. 正常启动你的 Minecraft 服务器
  2. 插件会自动创建配置文件

第3步:开始使用

  1. 在游戏里输入 /nekoset 玩家名字 true 把玩家变成猫娘
  2. 猫娘玩家就可以使用各种有趣的功能啦!

猫娘能做什么?(超有趣的功能)

? 基础能力

  • 夜视能力:猫娘在黑暗中也能看清楚
  • 跳跃增强:可以跳得更高
  • 潜行加速:潜行时移动更快更安静

? 可爱聊天

  • 猫娘聊天会有特殊的前缀和后缀
  • 自动把普通词语变成可爱的猫娘用语
  • 比如"你好"可能变成"喵~你好"

? 特殊饮食

  • 猫娘只能吃肉!不能吃蔬菜水果
  • 支持各种肉类食物

? 爪子攻击

  • 猫娘有特殊的爪子攻击
  • 对生物造成额外伤害
  • 有冷却时间,不能连续使用

?️ 皮革护甲加成

  • 穿着皮革护甲可以获得速度加成
  • 每件皮革护甲都能增加速度
  • 多件护甲效果叠加
  • 最大加成等级可配置

简单来说: 皮革护甲让猫娘跑得更快!

? 主人系统

  • 猫娘可以认主人
  • 主人和猫娘有特殊互动
  • 可以互相治疗和帮助
  • 主人死亡效应:当主人死亡时,其猫娘也会死亡(可配置)
    • 可选择是否保留猫娘的物品栏和经验等级

? 夜间能力

  • 晚上猫娘能力会变强
  • 午夜时能力达到最强
  • 自动生效,不用手动开启

? 应激反应

  • 当猫娘生命值很低时
  • 会自动获得超强力量
  • 持续1分钟,帮助脱离危险

⚔️ 被动攻击增强

  • 猫娘攻击时造成略微更高的伤害
  • 对敌人有更强的击退效果
  • 适用于所有武器类型
  • 伤害和击退倍数可配置

简单来说: 猫娘的攻击更有力,能把敌人打得更远!

? 猫薄荷效果

  • 猫娘使用猫薄荷物品(默认使用小麦种子)
  • 获得临时速度和跳跃提升
  • 效果持续一段时间
  • 可以在配置文件中修改使用的物品

?️ 伤害调整

  • 免疫跌落伤害:猫娘从高处跌落不会受到伤害
  • 其他伤害增强:猫娘受到的其他伤害增加0.8倍
  • 可以在配置文件中调整伤害倍数

简单来说: 猫娘不怕摔,但更容易受伤!

? 生物驱赶

  • 苦力怕驱赶:苦力怕遇到猫娘不会爆炸,而是被驱赶
  • 幻翼驱赶:幻翼不会攻击猫娘,而是被驱赶
  • 自动生效,无需手动操作

简单来说: 苦力怕和幻翼都怕猫娘,会自动躲开!

?️ 生物目标行为

  • 敌对生物对猫娘的检测距离增加
  • 友好生物更容易被猫娘吸引
  • 对不同类型的生物有不同影响
  • 检测参数可配置

? 玩家接近提醒

  • 当其他玩家进入猫娘25格范围内时,猫娘会收到动作栏通知
  • 实时显示附近玩家的名称和距离
  • 更新频率提高到0.5秒一次,反应更灵敏
  • 可通过/playernotice命令开启/关闭功能
  • 配置信息存储在SQLite数据库中
  • 帮助猫娘了解周围环境

简单来说: 猫娘会在动作栏中实时收到附近玩家的通知!

?‍♀️ 爬墙功能

  • 爬墙能力:猫娘可以爬上墙壁和垂直表面
  • 使用方法:使用/climb命令开启/关闭爬墙功能
  • 限制条件:只能在墙壁附近攀爬,有一定的使用范围
  • 自动关闭:离开墙壁后自动停止攀爬

简单来说: 猫娘可以像蜘蛛一样在墙壁上爬行!

? 尾巴拉扯功能

  • 尾巴拉扯:玩家可以拉扯猫娘的尾巴
  • 使用方法:使用/pullthetail命令开启/关闭尾巴拉扯功能
  • 互动效果:拉扯尾巴会产生有趣的互动效果(造成伤害并立即恢复,播放猫叫声)
  • 开关控制:猫娘可以自主选择是否允许被拉扯尾巴

简单来说: 玩家可以和猫娘进行尾巴拉扯的互动!

? 健康恢复技能

  • 主动技能:猫娘可以使用/health命令恢复自己和主人的生命值
  • 消耗:使用技能会消耗饱食度
  • 冷却:技能有使用冷却时间
  • 效果缩放:生命值越低,恢复效果越强

简单来说: 猫娘可以用这个技能治疗自己和主人!

? 技能列表

  • 命令:/myskills - 显示猫娘可用的所有技能
  • 主动技能:显示冷却状态和使用信息
  • 被动技能:显示状态和描述
  • 清晰格式:易于理解的技能信息

简单来说: 猫娘可以通过这个命令查看所有技能和冷却时间!

? 占位符系统

  • 新命令:/nekox placeholders - 列出所有可用的NekoX占位符
  • 增强兼容性:即使未安装PlaceholderAPI也能正常工作
  • 更好的错误处理:PlaceholderAPI不可用时显示清晰的错误信息
  • 状态显示:显示每个占位符的注册状态

简单来说: 更可靠的占位符系统,提升用户体验!

? 命令系统增强

  • 消息本地化:确保中文消息正确显示
  • 提高稳定性:优化命令执行流程,提高代码可靠性
  • 防止崩溃:增强错误处理机制
  • 语言支持:更好的默认消息回退系统

简单来说: 更稳定的命令,消息显示正确!

? 语言系统改进

  • 安全消息访问:使用SafeMessageUtils安全获取消息
  • 回退系统:翻译缺失时提供更好的默认消息
  • 一致显示:确保所有命令消息在不同语言环境下正确显示

简单来说: 增强的语言支持,消息处理更可靠!

? 猫薄荷详细使用指南

什么是猫薄荷?

猫薄荷是NekoX插件中的一个特殊功能,让猫娘玩家使用特定物品获得临时增益效果。

? 使用方法

基本操作:

  1. 必须是猫娘玩家 - 只有被设置为猫娘的玩家才能使用猫薄荷
  2. 手持猫薄荷物品 - 默认使用小麦种子(WHEAT_SEEDS)
  3. 右键使用 - 手持猫薄荷物品右键点击即可激活效果

具体步骤:

  1. 确保你是猫娘(管理员使用 /nekoset 你的名字 true 设置)
  2. 获取小麦种子(或其他配置的猫薄荷物品)
  3. 手持小麦种子右键点击
  4. 立即获得速度和跳跃提升效果

⚡ 效果详情

猫薄荷提供以下增益效果:

  • 速度提升 (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

? 使用技巧

  1. 战斗辅助 - 在PVP或打怪时使用,获得速度和跳跃优势
  2. 逃跑利器 - 被追击时使用猫薄荷快速脱离危险
  3. 探索加速 - 长途旅行时使用,提高移动效率
  4. 建筑辅助 - 跳跃提升有助于搭建高处建筑
  5. 护甲选择 - 穿皮革护甲可获得最大速度加成

? 限制条件

  • 只有猫娘玩家可以使用
  • 需要消耗猫薄荷物品
  • 有使用冷却时间
  • 副手持物时无法使用(必须主手持物)

? 与其他功能的配合

  • 夜间效果 - 晚上使用猫薄荷效果更佳
  • 应激反应 - 生命值低时配合猫薄荷效果更好
  • 护甲加成 - 速度加成与皮革护甲效果叠加

重要提示: 主手持物右键会消耗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:

  1. 在 plugin.yml 中添加依赖:
depend: [NekoX]
  1. 在插件中获取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或其他公共仓库,您需要手动将其添加到您的项目中:

  1. 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>
    
  2. Gradle 项目设置:

    • 在您的项目目录中创建一个 libs 文件夹
    • 将 NekoX-5.2-ProMax+++.jar 文件复制到您的 libs 文件夹
    • 在您的 build.gradle 中添加以下依赖:
    implementation files('libs/NekoX-5.2-ProMax+++.jar')
    
  3. 手动设置(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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源