# NekoX – Cute Neko Plugin<\/p>\n
## What is this?<\/p>\n
NekoX is a fun Minecraft plugin that makes Minecraft more interesting! It allows players to become cute neko girls with special abilities and interactive features.<\/p>\n
**Simply put:** This plugin adds cute neko characters to your server!<\/p>\n
## Quick Start (3 Easy Steps)<\/p>\n
### Step 1: Download the Plugin<\/p>\n
1. Download the `NekoX-5.2-ProMax+++.jar` file
\n2. Place this file in your server’s `plugins` folder<\/p>\n
### Step 2: Start the Server<\/p>\n
1. Start your Minecraft server normally
\n2. The plugin will automatically create configuration files<\/p>\n
### Step 3: Start Playing<\/p>\n
1. In-game, type `\/nekoset playername true` to turn a player into a neko
\n2. Neko players can now use all the fun features!<\/p>\n
## What Can Nekos Do? (Awesome Features)<\/p>\n
### \ud83d\udc31 Basic Abilities<\/p>\n
– **Night Vision**: Nekos can see clearly in the dark
\n– **Jump Boost**: Can jump higher
\n– **Sneak Speed**: Move faster and quieter while sneaking<\/p>\n
### \ud83d\udcac Cute Chat<\/p>\n
– Neko chat has special prefixes and suffixes
\n– Automatically converts normal words into cute neko language
\n– For example, “hello” might become “meow~ hello”<\/p>\n
### \ud83c\udf56 Special Diet<\/p>\n
– Nekos can only eat meat! No vegetables or fruits
\n– Supports various meat-based foods<\/p>\n
### \ud83d\udc3e Claw Attacks<\/p>\n
– Nekos have special claw attacks
\n– Extra damage to mobs
\n– Has cooldown time, cannot be used continuously<\/p>\n
### \ud83d\udee1\ufe0f Leather Armor Bonus<\/p>\n
– Wearing leather armor provides speed bonuses
\n– Each piece of leather armor increases speed
\n– Multiple armor pieces stack effects
\n– Maximum bonus level is configurable<\/p>\n
**Simply put:** Leather armor makes nekos run faster!<\/p>\n
### \ud83d\udc51 Owner System<\/p>\n
– Nekos can have owners
\n– Special interactions between owners and nekos
\n– Can heal and help each other
\n– **Owner Death Effect**: When an owner dies, their nekos also die (configurable)
\n – Option to keep neko inventory and experience level<\/p>\n
### \ud83c\udf19 Night Abilities<\/p>\n
– Neko abilities become stronger at night
\n– Peak power at midnight
\n– Automatically activates, no manual control needed<\/p>\n
### \ud83d\udcaa Stress Response<\/p>\n
– When neko health is very low
\n– Automatically gains super strength
\n– Lasts 1 minute, helps escape danger<\/p>\n
### \u2694\ufe0f Passive Attack Boost<\/p>\n
– Nekos deal slightly higher damage when attacking
\n– Stronger knockback effect against enemies
\n– Applies to all weapon types
\n– Damage and knockback multiplier configurable<\/p>\n
**Simply put:** Neko attacks are more powerful and can knock enemies further!<\/p>\n
### \ud83c\udf3f Catnip Effects<\/p>\n
– Nekos use catnip items (default uses wheat seeds)
\n– Gain temporary speed and jump boost
\n– Effects last for a period of time
\n– Can modify the items used in configuration file<\/p>\n
### \ud83d\udee1\ufe0f Damage Adjustment<\/p>\n
– **Fall Damage Immunity**: Nekos don’t take damage from falling from heights
\n– **Other Damage Boost**: Nekos take 0.8x more damage from other sources
\n– Can adjust damage multiplier in configuration file<\/p>\n
**Simply put:** Nekos are immune to falling but more vulnerable to attacks!<\/p>\n
### \ud83d\udc3e Mob Repulsion<\/p>\n
– **Creeper Repulsion**: Creepers won’t explode when encountering nekos, but are repelled
\n– **Phantom Repulsion**: Phantoms won’t attack nekos, but are repelled
\n– Automatically activates, no manual operation needed<\/p>\n
**Simply put:** Creepers and phantoms are afraid of nekos and will automatically avoid them!<\/p>\n
### \ud83d\udc41\ufe0f Mob Targeting Behavior<\/p>\n
– Hostile mobs have increased detection distance for nekos
\n– Friendly mobs are more attracted to nekos
\n– Different effects on different types of mobs
\n– Detection parameters configurable<\/p>\n
### \ud83d\udd14 Player Proximity Notification<\/p>\n
– When other players enter a 25-block radius around a neko, the neko receives a title notification
\n– Shows the names and distances of nearby players
\n– Can enable\/disable the feature with the `\/playernotice` command
\n– Configuration information stored in SQLite database
\n– Helps nekos be aware of their surroundings<\/p>\n
**Simply put:** Nekos receive notifications about nearby players!<\/p>\n
### \ud83e\uddd7\u200d\u2640\ufe0f Climbing Feature<\/p>\n
– **Wall Climbing**: Nekos can climb up walls and vertical surfaces
\n– **Usage**: Use `\/climb` command to toggle climbing feature
\n– **Limitations**: Can only climb near walls, has a limited range of use
\n– **Auto-disable**: Stops climbing automatically when leaving the wall<\/p>\n
**Simply put:** Nekos can climb walls like spiders!<\/p>\n
### \ud83d\udc3e Tail Pull Feature<\/p>\n
– **Tail Interaction**: Players can pull nekos’ tails
\n– **Usage**: Use `\/pullthetail` command to toggle tail pull feature
\n– **Interactive Effects**: Pulling tails creates fun interaction effects (damage and heal with cat sounds)
\n– **Control**: Nekos can choose whether to allow their tails to be pulled<\/p>\n
**Simply put:** Players can interact with nekos by pulling their tails!<\/p>\n
### \ud83d\udc96 Health Restore Skill<\/p>\n
– **Active Skill**: Nekos can use `\/health` command to restore health for themselves and their owners
\n– **Cost**: Consumes hunger points to use
\n– **Cooldown**: Has a cooldown period between uses
\n– **Scaling Effect**: The lower the health, the stronger the restoration effect<\/p>\n
**Simply put:** Nekos can heal themselves and their owners with this skill!<\/p>\n
### \ud83d\udccb Skills List<\/p>\n
– **Command**: `\/myskills` – Shows all available skills for nekos
\n– **Active Skills**: Displays cooldown status and usage information
\n– **Passive Skills**: Shows status and description
\n– **Clear Format**: Easy to understand skill information<\/p>\n
**Simply put:** Nekos can view all their skills and cooldowns with this command!<\/p>\n
### \ud83d\udccb Placeholder System<\/p>\n
– **New Command**: `\/nekox placeholders` – Lists all available NekoX placeholders
\n– **Enhanced Compatibility**: Works correctly even without PlaceholderAPI installed
\n– **Better Error Handling**: Clear error messages when PlaceholderAPI is unavailable
\n– **Status Display**: Shows registration status for each placeholder<\/p>\n
**Simply put:** More reliable placeholder system with improved user experience!<\/p>\n
### \ud83d\udd27 Command System Enhancements<\/p>\n
– **Message Localization**: Ensures proper message display in Chinese
\n– **Improved Stability**: Optimized command execution flow for better code reliability
\n– **Crash Prevention**: Enhanced error handling mechanisms
\n– **Language Support**: Better default message fallback system<\/p>\n
**Simply put:** More stable commands with correct message display!<\/p>\n
### \ud83c\udf10 Language System Improvements<\/p>\n
– **Safe Message Access**: Using SafeMessageUtils for secure message retrieval
\n– **Fallback System**: Better default messages when translations are missing
\n– **Consistent Display**: Ensured all command messages show correctly in different language environments<\/p>\n
**Simply put:** Enhanced language support with more reliable message handling!<\/p>\n
## \ud83c\udf3f Catnip Detailed Usage Guide<\/p>\n
### What is Catnip?<\/p>\n
Catnip is a special feature in the NekoX plugin that allows neko players to use specific items to gain temporary buff effects.<\/p>\n
### \ud83c\udfaf Usage Method<\/p>\n
**Basic Operation:**
\n1. **Must be a Neko Player** – Only players set as nekos can use catnip
\n2. **Hold Catnip Item** – Default uses wheat seeds (WHEAT_SEEDS)
\n3. **Right-Click to Use** – Hold the catnip item and right-click to activate the effect<\/p>\n
**Specific Steps:**
\n1. Ensure you are a neko (admin uses `\/nekoset yourname true` to set)
\n2. Obtain wheat seeds (or other configured catnip items)
\n3. Hold wheat seeds and right-click
\n4. Immediately gain speed and jump boost effects<\/p>\n
### \u26a1 Effect Details<\/p>\n
**Catnip provides the following buff effects:**
\n– **Speed Boost** (Speed II) – Significantly increased movement speed
\n– **Jump Boost** (Jump Boost II) – Greatly enhanced jump height
\n– **Duration** – Default 60 seconds (can be modified in configuration)<\/p>\n
**Effect Characteristics:**
\n– Effects activate immediately
\n– Consumes one catnip item
\n– Has cooldown time, cannot be used continuously
\n– Only effective for neko players<\/p>\n
### \u2699\ufe0f Configuration Options<\/p>\n
Customize catnip settings in `config.yml`:<\/p>\n
“`yaml
\ncat-nip:
\n enabled: true # Enable\/disable catnip feature
\n item: “WHEAT_SEEDS” # Catnip item ID (can be changed to other items)
\n duration: 60 # Effect duration (seconds)
\n“`<\/p>\n
**Modifiable Item Options:**
\n– Default: `WHEAT_SEEDS` (wheat seeds)
\n– Can be changed to: `GRASS` (grass), `FERN` (fern), `VINE` (vine), etc.
\n– Supports any Minecraft item ID<\/p>\n
### \ud83d\udca1 Usage Tips<\/p>\n
1. **Combat Assistance** – Use during PVP or mob fighting to gain speed and jump advantage
\n2. **Escape Tool** – Use catnip to quickly escape danger when being chased
\n3. **Exploration Boost** – Use during long-distance travel to improve movement efficiency
\n4. **Building Aid** – Jump boost helps with building at heights
\n5. **Armor Selection** – Wear leather armor to get maximum speed bonus<\/p>\n
### \ud83d\udeab Limitations<\/p>\n
– Only neko players can use
\n– Requires consumption of catnip items
\n– Has usage cooldown
\n– Cannot be used with off-hand items (must be held in main hand)<\/p>\n
### \ud83d\udd04 Synergy with Other Features<\/p>\n
– **Night Effects** – Catnip effects work better at night
\n– **Stress Response** – Better effect when combining with catnip when health is low
\n– **Armor Bonus** – Speed bonus stacks with leather armor effects<\/p>\n
**Important Note:** Right-clicking with catnip in main hand consumes 1 catnip item, off-hand items won’t trigger the effect.<\/p>\n
## Common Commands (In-Game Usage)<\/p>\n
### Interaction Commands (Everyone can use)<\/p>\n
– `\/pat player` – Gently pat someone
\n– `\/lovebite player` – Give a cute love bite
\n– `\/earscratch player` – Scratch someone’s ears
\n– `\/purr` – Make purring sounds
\n– `\/hiss player` – Hiss at someone
\n– `\/scratch player` – Scratch someone with claws
\n– `\/attention player` – Attract other players’ attention
\n– `\/pullthetail` – Toggle tail pull feature<\/p>\n
### Ability Commands (Nekos only)<\/p>\n
– `\/nightvision` – Enable night vision
\n– `\/jumpboost` – Jump boost
\n– `\/swiftsneak` – Sneak speed
\n– `\/health` – Heal yourself and owner
\n– `\/myskills` – View all skills and cooldowns
\n– `\/playernotice [on|off]` – Enable\/disable player proximity notification
\n– `\/climb` – Toggle climbing feature<\/p>\n
### Owner System Commands<\/p>\n
– `\/owner add player` – Request to become someone’s owner
\n– `\/owner accept player` – Accept owner request
\n– `\/owner deny player` – Deny owner request
\n– `\/owner remove player` – Remove owner relationship
\n– `\/owner list` – View your owners
\n– `\/owner mylist` – View your nekos<\/p>\n
### Admin Commands<\/p>\n
– `\/nekox reload` – Reload plugin settings
\n– `\/nekoset player true\/false` – Set player as neko
\n– `\/nekox language language` – Switch plugin language
\n– `\/nekox placeholders` – Display all available NekoX placeholders<\/p>\n
## New Features in Emergency-fix Version<\/p>\n
### \ud83d\udccb Placeholder System Improvements<\/p>\n
– **New Command**: `\/nekox placeholders` – Lists all available NekoX placeholders
\n– **Enhanced Compatibility**: Works correctly even when PlaceholderAPI is not installed
\n– **Better Error Handling**: Clear error messages when PlaceholderAPI is unavailable
\n– **Status Display**: Shows registration status for each placeholder<\/p>\n
**Simple Description**: More reliable placeholder system with improved user experience!<\/p>\n
### \ud83d\udd27 Command System Enhancements<\/p>\n
– **Message Localization**: Fixed issues to ensure proper message display in Chinese
\n– **Improved Stability**: Optimized command execution flow for better code reliability
\n– **Crash Prevention**: Enhanced error handling mechanisms
\n– **Language Support**: Better default message fallback system<\/p>\n
**Simple Description**: More stable commands with correct message display!<\/p>\n
### \ud83c\udf10 Language System Improvements<\/p>\n
– **Safe Message Access**: Using SafeMessageUtils for secure message retrieval
\n– **Fallback System**: Better default messages when translations are missing
\n– **Consistent Display**: Ensured all command messages show correctly in different language environments<\/p>\n
**Simple Description**: Enhanced language support with more reliable message handling!<\/p>\n
## Configuration (Optional Settings)<\/p>\n
The plugin creates a `config.yml` file on first run, which you can open and modify with a text editor:<\/p>\n
### Basic Settings<\/p>\n
– `neko-chat`: Enable\/disable neko chat effects
\n– `meat-only`: Whether nekos can only eat meat
\n– `owner-system`: Enable\/disable owner system<\/p>\n
### Ability Adjustments<\/p>\n
– `claws`: Claw attack damage and cooldown time
\n– `armor-bonus`: Speed bonus from leather armor
\n– `night-effects`: Night ability start and end times
\n– `health-skill`: Healing skill cooldown and cost<\/p>\n
### Special Effects<\/p>\n
– `cat-nip`: Catnip effects and duration
\n– `stress-effect`: Stress response trigger conditions
\n– `passive-attack-boost`: Attack damage bonus
\n– `armor-bonus`: Leather armor bonus settings
\n – `enabled`: Enable\/disable armor bonus
\n – `leather-bonus`: Leather armor type list
\n – `speed-bonus-per-piece`: Speed bonus per armor piece
\n– `neko-damage-modification`: Neko damage adjustment settings
\n – `enabled`: Enable\/disable damage adjustment feature
\n – `fall-damage-immunity`: Fall damage immunity
\n – `other-damage-multiplier`: Other damage increase multiplier
\n – `debug`: Debug mode
\n– `neko-mob-behavior`: Neko mob behavior settings
\n – `enabled`: Enable\/disable mob behavior feature
\n – `creeper-repulsion`: Creeper repulsion feature
\n – `phantom-repulsion`: Phantom repulsion feature
\n – `debug`: Debug mode
\n– `mob-targeting`: Mob targeting behavior settings
\n – `enabled`: Enable\/disable targeting behavior adjustment
\n – `distance-increase`: Detection distance increase multiplier
\n – `friendly-attraction`: Enable\/disable friendly mob attraction
\n– `owner-death`: Owner death effect settings
\n – `feature.enabled`: Enable\/disable owner death effect
\n – `keep-inventory`: Keep neko inventory
\n – `keep-level`: Keep neko experience level<\/p>\n
## Developer API<\/p>\n
NekoX provides a comprehensive API for other plugins to integrate neko functionality.<\/p>\n
### API Access<\/p>\n
Using NekoX API in your plugin:<\/p>\n
1. Add dependency in `plugin.yml`:
\n“`yaml
\ndepend: [NekoX]
\n“`<\/p>\n
2. Get API instance in your plugin:
\n“`java
\nimport org.cneko.nekox.api.NekoXAPI;<\/p>\n
public class YourPlugin extends JavaPlugin {
\n private NekoXAPI nekoXAPI;<\/p>\n
@Override
\n public void onEnable() {
\n nekoXAPI = NekoXAPI.getInstance(this);
\n if (nekoXAPI == null) {
\n getLogger().warning(“NekoX plugin not found!”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }
\n }
\n}
\n“`<\/p>\n
### Development Environment Setup<\/p>\n
Since NekoX is not published to JitPack or other public repositories, you need to manually add it to your project:<\/p>\n
1. **Maven Project Setup:**
\n – Create a `libs` folder in your project directory
\n – Copy the `NekoX-5.2-ProMax+++.jar` file from this plugin’s target folder to your `libs` folder
\n – Add the following dependency to your `pom.xml`:<\/p>\n
“`xml 2. **Gradle Project Setup:** “`gradle 3. **Manual Setup (IDE):** ### API Methods<\/p>\n #### Neko Status Check<\/p>\n – `boolean isNeko(Player player)` – Check if player is a neko #### Player Retrieval<\/p>\n – `Set #### Owner Relationship Management<\/p>\n – `Set ### Events<\/p>\n NekoX provides custom events for other plugins to listen to:<\/p>\n #### NekoStatusChangeEvent<\/p>\n Triggered when a player’s neko status changes: #### OwnerRelationshipEvent<\/p>\n Triggered when owner relationships are added, removed, or requested: switch (action) { ## \ud83d\udd27 Developer Documentation<\/p>\n **\ud83d\udca1 Friendly Reminder: If you’re just a regular user without programming knowledge, you can skip this section!**<\/p>\n ### Maven Configuration<\/p>\n If you want to develop plugins that integrate with NekoX, here’s the Maven configuration you need:<\/p>\n “`xml\n ### How to Compile the Plugin (For Developers Who Want to Build the Plugin)<\/p>\n If you want to compile the plugin file yourself, you can follow these steps:<\/p>\n #### For Minecraft 1.20.4 (Default Version)<\/p>\n Open command line and enter: #### For Minecraft 1.21.4<\/p>\n **Important Note: You need to install Java 21 on your computer first** #### Current Limitations<\/p>\n – If your computer uses Java 17, you can only compile the 1.20.4 version ### PlaceholderAPI Support<\/p>\n NekoX integrates with PlaceholderAPI and provides the following placeholders (requires PlaceholderAPI plugin to be installed):<\/p>\n | Placeholder | Description | Use the `\/nekox placeholders` command to view all available placeholders and their status.<\/p>\n ### Technical Implementation of Damage Adjustment Feature<\/p>\n #### Core Classes<\/p>\n – #### Implementation Logic<\/p>\n 1. Listen for `EntityDamageEvent` events #### Testing Methods<\/p>\n – **Fall Test**: Nekos don’t take damage when falling from heights, regular players take normal damage ### Technical Implementation of Mob Repulsion Feature<\/p>\n #### Core Classes<\/p>\n – #### Implementation Logic<\/p>\n – **Creeper Repulsion**: Listen for `ExplosionPrimeEvent`, cancel explosion and apply reverse thrust #### Testing Methods<\/p>\n – **Creeper Test**: Creepers won’t explode near nekos, regular players experience normal explosions ## Frequently Asked Questions<\/p>\n ### Q: Which Minecraft versions are supported? ### Q: How to turn a player into a neko? ### Q: What can nekos do that regular players can’t? ### Q: What’s the purpose of the owner system? ### Q: How to modify plugin settings? ### Q: Is Chinese supported? ## Technical Support<\/p>\n If you encounter problems: ## Tips<\/p>\n – Nekos are stronger at night, try to be active during nighttime —<\/p>\n # NekoX Developer Wiki<\/p>\n ## Table of Contents<\/p>\n 1. [Introduction](#introduction) ## Introduction<\/p>\n NekoX is a feature-rich Minecraft neko plugin that adds neko characters and related functionality to servers. This developer Wiki aims to help other plugin developers understand how to integrate with the NekoX plugin.<\/p>\n ## Build Configuration<\/p>\n ### Maven Configuration<\/p>\n If you use Maven to build your plugin, add the following configuration to your pom.xml file:<\/p>\n “`xml\n ### Gradle Configuration<\/p>\n If you use Gradle to build your plugin, add the following configuration to your build.gradle file:<\/p>\n “`gradle group = ‘your.group.id’ repositories { mavenCentral() dependencies { \/\/ NekoX API java { tasks.withType(JavaCompile) { ### Manual Configuration<\/p>\n If you don’t use build tools, you can directly add the NekoX plugin jar file to your project dependencies:<\/p>\n 1. Copy the NekoX-5.2-ProMax+++.jar file from the NekoX project’s target folder ### Build and Deployment<\/p>\n After building your plugin, ensure: ### Multi-Version Support<\/p>\n NekoX supports multiple Minecraft versions: If you need to build a specific version, you can use Maven profiles: # Build 1.21.4 version ## API Access<\/p>\n ### 1. Adding Dependencies<\/p>\n To use the NekoX API in your plugin, first you need to get the API instance:<\/p>\n “`java \/\/ In your plugin main class @Override getLogger().info(“Successfully connected to NekoX API!”); ### 2. plugin.yml Configuration<\/p>\n Add NekoX as a dependency in your plugin.yml file:<\/p>\n “`yaml ## API Methods<\/p>\n ### Neko Check Methods<\/p>\n #### `boolean isNeko(Player player)`<\/p>\n Check if specified player is a neko<\/p>\n **Parameters**: **Return Value**: #### `boolean isNeko(String playerName)`<\/p>\n Check if specified player name is a neko (supports offline players)<\/p>\n **Parameters**: **Return Value**: ### Player Retrieval Methods<\/p>\n #### `Set Get all neko player names (including offline)<\/p>\n **Return Value**: ### Relationship Query Methods<\/p>\n #### `Set Get all owner names of specified neko<\/p>\n **Parameters**: **Return Value**: #### `boolean isOwnerOf(String ownerName, String nekoName)`<\/p>\n Check if specified player is owner of a neko<\/p>\n **Parameters**: **Return Value**: #### `boolean hasOwner(String playerName)`<\/p>\n Check if specified player has an owner<\/p>\n **Parameters**: **Return Value**: ## Usage Examples<\/p>\n ### Example 1: Check if Player is Neko<\/p>\n “`java ### Example 2: Get All Neko Player Names<\/p>\n “`java ### Example 3: Check Owner Relationship<\/p>\n “`java if (nekoXAPI.isOwnerOf(ownerName, nekoName)) { ### Example 4: Get All Owners of a Neko<\/p>\n “`java if (owners.isEmpty()) { ## Event System<\/p>\n NekoX provides some custom events that other plugins can listen to in order to respond to neko-related behaviors.<\/p>\n ### Available Events<\/p>\n #### NekoStatusChangeEvent<\/p>\n Triggered when a player’s neko status changes<\/p>\n **Event Class**: `org.cneko.nekox.api.events.NekoStatusChangeEvent` **Usage Example**: if (isNeko) { #### OwnerRelationshipEvent<\/p>\n Triggered when owner relationship changes<\/p>\n **Event Class**: `org.cneko.nekox.api.events.OwnerRelationshipEvent` **Usage Example**: switch (action) { ## Data Storage<\/p>\n NekoX uses SQLite database to store player data, including: ### Database Structure<\/p>\n #### player_configs Table<\/p>\n Store player basic configuration #### neko_owners Table<\/p>\n Store neko-owner relationships #### owner_requests Table<\/p>\n Store owner request relationships ### Notes<\/p>\n 1. All database operations are executed asynchronously and won’t block the main thread ## Best Practices<\/p>\n ### Performance Optimization<\/p>\n 1. Cache API instances to avoid repeated retrieval ### Error Handling<\/p>\n 1. Always check if API instance is null ### Compatibility<\/p>\n 1. Check if NekoX plugin exists and is enabled ## Support and Feedback<\/p>\n If you encounter problems or have improvement suggestions while using the NekoX API, please contact us through the following methods: Thank you for using NekoX!<\/p>\n —<\/p>\n # NekoX – \u53ef\u7231\u7684\u732b\u5a18\u63d2\u4ef6<\/p>\n ## \u8fd9\u662f\u4ec0\u4e48\uff1f<\/p>\n NekoX\u662f\u4e00\u4e2a\u8ba9Minecraft\u53d8\u5f97\u66f4\u6709\u8da3\u7684\u63d2\u4ef6\uff01\u5b83\u53ef\u4ee5\u8ba9\u73a9\u5bb6\u53d8\u6210\u53ef\u7231\u7684\u732b\u5a18\uff0c\u62e5\u6709\u7279\u6b8a\u80fd\u529b\u548c\u4e92\u52a8\u65b9\u5f0f\u3002<\/p>\n **\u7b80\u5355\u6765\u8bf4\uff1a** \u8fd9\u4e2a\u63d2\u4ef6\u8ba9\u4f60\u7684\u670d\u52a1\u5668\u91cc\u51fa\u73b0\u53ef\u7231\u7684\u732b\u5a18\u89d2\u8272\uff01<\/p>\n ## \u5feb\u901f\u5f00\u59cb\uff083\u6b65\u641e\u5b9a\uff09<\/p>\n ### \u7b2c1\u6b65\uff1a\u4e0b\u8f7d\u63d2\u4ef6<\/p>\n 1. \u4e0b\u8f7d `NekoX-5.2-ProMax+++.jar` \u6587\u4ef6 ### \u7b2c2\u6b65\uff1a\u542f\u52a8\u670d\u52a1\u5668<\/p>\n 1. \u6b63\u5e38\u542f\u52a8\u4f60\u7684Minecraft\u670d\u52a1\u5668 ### \u7b2c3\u6b65\uff1a\u5f00\u59cb\u4f7f\u7528<\/p>\n 1. \u5728\u6e38\u620f\u91cc\u8f93\u5165 `\/nekoset \u73a9\u5bb6\u540d\u5b57 true` \u628a\u73a9\u5bb6\u53d8\u6210\u732b\u5a18 ## \u732b\u5a18\u80fd\u505a\u4ec0\u4e48\uff1f\uff08\u8d85\u6709\u8da3\u7684\u529f\u80fd\uff09<\/p>\n ### \ud83d\udc31 \u57fa\u7840\u80fd\u529b<\/p>\n – **\u591c\u89c6\u80fd\u529b**\uff1a\u732b\u5a18\u5728\u9ed1\u6697\u4e2d\u4e5f\u80fd\u770b\u6e05\u695a ### \ud83d\udcac \u53ef\u7231\u804a\u5929<\/p>\n – \u732b\u5a18\u804a\u5929\u4f1a\u6709\u7279\u6b8a\u7684\u524d\u7f00\u548c\u540e\u7f00 ### \ud83c\udf56 \u7279\u6b8a\u996e\u98df<\/p>\n – \u732b\u5a18\u53ea\u80fd\u5403\u8089\uff01\u4e0d\u80fd\u5403\u852c\u83dc\u6c34\u679c ### \ud83d\udc3e \u722a\u5b50\u653b\u51fb<\/p>\n – \u732b\u5a18\u6709\u7279\u6b8a\u7684\u722a\u5b50\u653b\u51fb ### \ud83d\udee1\ufe0f \u76ae\u9769\u62a4\u7532\u52a0\u6210<\/p>\n – \u7a7f\u7740\u76ae\u9769\u62a4\u7532\u53ef\u4ee5\u83b7\u5f97\u901f\u5ea6\u52a0\u6210 **\u7b80\u5355\u6765\u8bf4\uff1a** \u76ae\u9769\u62a4\u7532\u8ba9\u732b\u5a18\u8dd1\u5f97\u66f4\u5feb\uff01<\/p>\n ### \ud83d\udc51 \u4e3b\u4eba\u7cfb\u7edf<\/p>\n – \u732b\u5a18\u53ef\u4ee5\u8ba4\u4e3b\u4eba ### \ud83c\udf19 \u591c\u95f4\u80fd\u529b<\/p>\n – \u665a\u4e0a\u732b\u5a18\u80fd\u529b\u4f1a\u53d8\u5f3a ### \ud83d\udcaa \u5e94\u6fc0\u53cd\u5e94<\/p>\n – \u5f53\u732b\u5a18\u751f\u547d\u503c\u5f88\u4f4e\u65f6 ### \u2694\ufe0f \u88ab\u52a8\u653b\u51fb\u589e\u5f3a<\/p>\n – \u732b\u5a18\u653b\u51fb\u65f6\u9020\u6210\u7565\u5fae\u66f4\u9ad8\u7684\u4f24\u5bb3 **\u7b80\u5355\u6765\u8bf4\uff1a** \u732b\u5a18\u7684\u653b\u51fb\u66f4\u6709\u529b\uff0c\u80fd\u628a\u654c\u4eba\u6253\u5f97\u66f4\u8fdc\uff01<\/p>\n ### \ud83c\udf3f \u732b\u8584\u8377\u6548\u679c<\/p>\n – \u732b\u5a18\u4f7f\u7528\u732b\u8584\u8377\u7269\u54c1\uff08\u9ed8\u8ba4\u4f7f\u7528\u5c0f\u9ea6\u79cd\u5b50\uff09 ### \ud83d\udee1\ufe0f \u4f24\u5bb3\u8c03\u6574<\/p>\n – **\u514d\u75ab\u8dcc\u843d\u4f24\u5bb3**\uff1a\u732b\u5a18\u4ece\u9ad8\u5904\u8dcc\u843d\u4e0d\u4f1a\u53d7\u5230\u4f24\u5bb3 **\u7b80\u5355\u6765\u8bf4\uff1a** \u732b\u5a18\u4e0d\u6015\u6454\uff0c\u4f46\u66f4\u5bb9\u6613\u53d7\u4f24\uff01<\/p>\n ### \ud83d\udc3e \u751f\u7269\u9a71\u8d76<\/p>\n – **\u82e6\u529b\u6015\u9a71\u8d76**\uff1a\u82e6\u529b\u6015\u9047\u5230\u732b\u5a18\u4e0d\u4f1a\u7206\u70b8\uff0c\u800c\u662f\u88ab\u9a71\u8d76 **\u7b80\u5355\u6765\u8bf4\uff1a** \u82e6\u529b\u6015\u548c\u5e7b\u7ffc\u90fd\u6015\u732b\u5a18\uff0c\u4f1a\u81ea\u52a8\u8eb2\u5f00\uff01<\/p>\n ### \ud83d\udc41\ufe0f \u751f\u7269\u76ee\u6807\u884c\u4e3a<\/p>\n – \u654c\u5bf9\u751f\u7269\u5bf9\u732b\u5a18\u7684\u68c0\u6d4b\u8ddd\u79bb\u589e\u52a0 ### \ud83d\udd14 \u73a9\u5bb6\u63a5\u8fd1\u63d0\u9192<\/p>\n – \u5f53\u5176\u4ed6\u73a9\u5bb6\u8fdb\u5165\u732b\u5a1825\u683c\u8303\u56f4\u5185\u65f6\uff0c\u732b\u5a18\u4f1a\u6536\u5230\u52a8\u4f5c\u680f\u901a\u77e5 **\u7b80\u5355\u6765\u8bf4\uff1a** \u732b\u5a18\u4f1a\u5728\u52a8\u4f5c\u680f\u4e2d\u5b9e\u65f6\u6536\u5230\u9644\u8fd1\u73a9\u5bb6\u7684\u901a\u77e5\uff01<\/p>\n ### \ud83e\uddd7\u200d\u2640\ufe0f \u722c\u5899\u529f\u80fd<\/p>\n – **\u722c\u5899\u80fd\u529b**\uff1a\u732b\u5a18\u53ef\u4ee5\u722c\u4e0a\u5899\u58c1\u548c\u5782\u76f4\u8868\u9762 **\u7b80\u5355\u6765\u8bf4\uff1a** \u732b\u5a18\u53ef\u4ee5\u50cf\u8718\u86db\u4e00\u6837\u5728\u5899\u58c1\u4e0a\u722c\u884c\uff01<\/p>\n ### \ud83d\udc3e \u5c3e\u5df4\u62c9\u626f\u529f\u80fd<\/p>\n – **\u5c3e\u5df4\u62c9\u626f**\uff1a\u73a9\u5bb6\u53ef\u4ee5\u62c9\u626f\u732b\u5a18\u7684\u5c3e\u5df4 **\u7b80\u5355\u6765\u8bf4\uff1a** \u73a9\u5bb6\u53ef\u4ee5\u548c\u732b\u5a18\u8fdb\u884c\u5c3e\u5df4\u62c9\u626f\u7684\u4e92\u52a8\uff01<\/p>\n ### \ud83d\udc96 \u5065\u5eb7\u6062\u590d\u6280\u80fd<\/p>\n – **\u4e3b\u52a8\u6280\u80fd**\uff1a\u732b\u5a18\u53ef\u4ee5\u4f7f\u7528`\/health`\u547d\u4ee4\u6062\u590d\u81ea\u5df1\u548c\u4e3b\u4eba\u7684\u751f\u547d\u503c **\u7b80\u5355\u6765\u8bf4\uff1a** \u732b\u5a18\u53ef\u4ee5\u7528\u8fd9\u4e2a\u6280\u80fd\u6cbb\u7597\u81ea\u5df1\u548c\u4e3b\u4eba\uff01<\/p>\n ### \ud83d\udccb \u6280\u80fd\u5217\u8868<\/p>\n – **\u547d\u4ee4**\uff1a`\/myskills` – \u663e\u793a\u732b\u5a18\u53ef\u7528\u7684\u6240\u6709\u6280\u80fd **\u7b80\u5355\u6765\u8bf4\uff1a** \u732b\u5a18\u53ef\u4ee5\u901a\u8fc7\u8fd9\u4e2a\u547d\u4ee4\u67e5\u770b\u6240\u6709\u6280\u80fd\u548c\u51b7\u5374\u65f6\u95f4\uff01<\/p>\n ### \ud83d\udccb \u5360\u4f4d\u7b26\u7cfb\u7edf<\/p>\n – **\u65b0\u547d\u4ee4**\uff1a`\/nekox placeholders` – \u5217\u51fa\u6240\u6709\u53ef\u7528\u7684NekoX\u5360\u4f4d\u7b26 **\u7b80\u5355\u6765\u8bf4\uff1a** \u66f4\u53ef\u9760\u7684\u5360\u4f4d\u7b26\u7cfb\u7edf\uff0c\u63d0\u5347\u7528\u6237\u4f53\u9a8c\uff01<\/p>\n ### \ud83d\udd27 \u547d\u4ee4\u7cfb\u7edf\u589e\u5f3a<\/p>\n – **\u6d88\u606f\u672c\u5730\u5316**\uff1a\u786e\u4fdd\u4e2d\u6587\u6d88\u606f\u6b63\u786e\u663e\u793a **\u7b80\u5355\u6765\u8bf4\uff1a** \u66f4\u7a33\u5b9a\u7684\u547d\u4ee4\uff0c\u6d88\u606f\u663e\u793a\u6b63\u786e\uff01<\/p>\n ### \ud83c\udf10 \u8bed\u8a00\u7cfb\u7edf\u6539\u8fdb<\/p>\n – **\u5b89\u5168\u6d88\u606f\u8bbf\u95ee**\uff1a\u4f7f\u7528SafeMessageUtils\u5b89\u5168\u83b7\u53d6\u6d88\u606f **\u7b80\u5355\u6765\u8bf4\uff1a** \u589e\u5f3a\u7684\u8bed\u8a00\u652f\u6301\uff0c\u6d88\u606f\u5904\u7406\u66f4\u53ef\u9760\uff01<\/p>\n ## \ud83c\udf3f \u732b\u8584\u8377\u8be6\u7ec6\u4f7f\u7528\u6307\u5357<\/p>\n ### \u4ec0\u4e48\u662f\u732b\u8584\u8377\uff1f<\/p>\n \u732b\u8584\u8377\u662fNekoX\u63d2\u4ef6\u4e2d\u7684\u4e00\u4e2a\u7279\u6b8a\u529f\u80fd\uff0c\u8ba9\u732b\u5a18\u73a9\u5bb6\u4f7f\u7528\u7279\u5b9a\u7269\u54c1\u83b7\u5f97\u4e34\u65f6\u589e\u76ca\u6548\u679c\u3002<\/p>\n ### \ud83c\udfaf \u4f7f\u7528\u65b9\u6cd5<\/p>\n **\u57fa\u672c\u64cd\u4f5c\uff1a**<\/p>\n 1. **\u5fc5\u987b\u662f\u732b\u5a18\u73a9\u5bb6** – \u53ea\u6709\u88ab\u8bbe\u7f6e\u4e3a\u732b\u5a18\u7684\u73a9\u5bb6\u624d\u80fd\u4f7f\u7528\u732b\u8584\u8377 **\u5177\u4f53\u6b65\u9aa4\uff1a**<\/p>\n 1. \u786e\u4fdd\u4f60\u662f\u732b\u5a18\uff08\u7ba1\u7406\u5458\u4f7f\u7528 `\/nekoset \u4f60\u7684\u540d\u5b57 true` \u8bbe\u7f6e\uff09 ### \u26a1 \u6548\u679c\u8be6\u60c5<\/p>\n **\u732b\u8584\u8377\u63d0\u4f9b\u4ee5\u4e0b\u589e\u76ca\u6548\u679c\uff1a**<\/p>\n – **\u901f\u5ea6\u63d0\u5347** (Speed II) – \u79fb\u52a8\u901f\u5ea6\u5927\u5e45\u589e\u52a0 **\u6548\u679c\u7279\u70b9\uff1a**<\/p>\n – \u6548\u679c\u7acb\u5373\u751f\u6548 ### \u2699\ufe0f \u914d\u7f6e\u9009\u9879<\/p>\n \u5728 `config.yml` \u4e2d\u53ef\u4ee5\u81ea\u5b9a\u4e49\u732b\u8584\u8377\u8bbe\u7f6e\uff1a<\/p>\n “`yaml **\u53ef\u4fee\u6539\u7684\u7269\u54c1\u9009\u9879\uff1a**<\/p>\n – \u9ed8\u8ba4\uff1a`WHEAT_SEEDS`\uff08\u5c0f\u9ea6\u79cd\u5b50\uff09 ### \ud83d\udca1 \u4f7f\u7528\u6280\u5de7<\/p>\n 1. **\u6218\u6597\u8f85\u52a9** – \u5728PVP\u6216\u6253\u602a\u65f6\u4f7f\u7528\uff0c\u83b7\u5f97\u901f\u5ea6\u548c\u8df3\u8dc3\u4f18\u52bf ### \ud83d\udeab \u9650\u5236\u6761\u4ef6<\/p>\n – \u53ea\u6709\u732b\u5a18\u73a9\u5bb6\u53ef\u4ee5\u4f7f\u7528 ### \ud83d\udd04 \u4e0e\u5176\u4ed6\u529f\u80fd\u7684\u914d\u5408<\/p>\n – **\u591c\u95f4\u6548\u679c** – \u665a\u4e0a\u4f7f\u7528\u732b\u8584\u8377\u6548\u679c\u66f4\u4f73 **\u91cd\u8981\u63d0\u793a\uff1a** \u4e3b\u624b\u6301\u7269\u53f3\u952e\u4f1a\u6d88\u80171\u4e2a\u732b\u8584\u8377\u7269\u54c1\uff0c\u526f\u624b\u6301\u7269\u4e0d\u4f1a\u89e6\u53d1\u6548\u679c\u3002<\/p>\n ## \u5e38\u7528\u547d\u4ee4\uff08\u6e38\u620f\u5185\u4f7f\u7528\uff09<\/p>\n ### \u4e92\u52a8\u547d\u4ee4\uff08\u6240\u6709\u4eba\u90fd\u80fd\u7528\uff09<\/p>\n – `\/pat \u73a9\u5bb6` – \u8f7b\u8f7b\u62cd\u62cd\u522b\u4eba ### \u80fd\u529b\u547d\u4ee4\uff08\u53ea\u6709\u732b\u5a18\u80fd\u7528\uff09<\/p>\n – `\/nightvision` – \u5f00\u542f\u591c\u89c6 ### \u4e3b\u4eba\u7cfb\u7edf\u547d\u4ee4<\/p>\n – `\/owner add \u73a9\u5bb6` – \u8bf7\u6c42\u6210\u4e3a\u67d0\u4eba\u7684\u4e3b\u4eba ### \u7ba1\u7406\u5458\u547d\u4ee4<\/p>\n – `\/nekox reload` – \u91cd\u65b0\u52a0\u8f7d\u63d2\u4ef6\u8bbe\u7f6e ## \u914d\u7f6e\u8bf4\u660e\uff08\u53ef\u9009\u8bbe\u7f6e\uff09<\/p>\n \u63d2\u4ef6\u7b2c\u4e00\u6b21\u8fd0\u884c\u65f6\u4f1a\u521b\u5efa `config.yml` \u6587\u4ef6\uff0c\u4f60\u53ef\u4ee5\u7528\u8bb0\u4e8b\u672c\u6253\u5f00\u4fee\u6539\uff1a<\/p>\n ### \u57fa\u672c\u8bbe\u7f6e<\/p>\n – `neko-chat`: \u5f00\u542f\/\u5173\u95ed\u732b\u5a18\u804a\u5929\u7279\u6548 ### \u80fd\u529b\u8c03\u6574<\/p>\n – `claws`: \u722a\u5b50\u653b\u51fb\u7684\u4f24\u5bb3\u548c\u51b7\u5374\u65f6\u95f4 ### \u7279\u6b8a\u6548\u679c<\/p>\n – `cat-nip`: \u732b\u8584\u8377\u7684\u6548\u679c\u548c\u6301\u7eed\u65f6\u95f4 ## \u5f00\u53d1\u8005API<\/p>\n NekoX\u4e3a\u5176\u4ed6\u63d2\u4ef6\u63d0\u4f9b\u4e86\u5168\u9762\u7684API\uff0c\u4ee5\u4fbf\u96c6\u6210\u732b\u5a18\u529f\u80fd\u3002<\/p>\n ### API\u63a5\u5165<\/p>\n \u5728\u60a8\u7684\u63d2\u4ef6\u4e2d\u4f7f\u7528NekoX API\uff1a<\/p>\n 1. \u5728 `plugin.yml` \u4e2d\u6dfb\u52a0\u4f9d\u8d56\uff1a 2. \u5728\u63d2\u4ef6\u4e2d\u83b7\u53d6API\u5b9e\u4f8b\uff1a public class YourPlugin extends JavaPlugin { @Override ### \u5f00\u53d1\u73af\u5883\u8bbe\u7f6e\u65b9\u6cd5<\/p>\n \u7531\u4e8eNekoX\u6ca1\u6709\u53d1\u5e03\u5230JitPack\u6216\u5176\u4ed6\u516c\u5171\u4ed3\u5e93\uff0c\u60a8\u9700\u8981\u624b\u52a8\u5c06\u5176\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\u4e2d\uff1a<\/p>\n 1. **Maven\u9879\u76ee\u8bbe\u7f6e\uff1a** “`xml 2. **Gradle\u9879\u76ee\u8bbe\u7f6e\uff1a** “`gradle 3. **\u624b\u52a8\u8bbe\u7f6e\uff08IDE\uff09\uff1a** ### API\u65b9\u6cd5<\/p>\n #### \u732b\u5a18\u72b6\u6001\u68c0\u67e5<\/p>\n – `boolean isNeko(Player player)` – \u68c0\u67e5\u73a9\u5bb6\u662f\u5426\u4e3a\u732b\u5a18 #### \u73a9\u5bb6\u83b7\u53d6<\/p>\n – `Set #### \u4e3b\u4eba\u5173\u7cfb\u7ba1\u7406<\/p>\n – `Set ### \u4e8b\u4ef6<\/p>\n NekoX\u63d0\u4f9b\u4e86\u81ea\u5b9a\u4e49\u4e8b\u4ef6\u4f9b\u5176\u4ed6\u63d2\u4ef6\u76d1\u542c\uff1a<\/p>\n #### NekoStatusChangeEvent<\/p>\n \u5f53\u73a9\u5bb6\u7684\u732b\u5a18\u72b6\u6001\u6539\u53d8\u65f6\u89e6\u53d1\uff1a #### OwnerRelationshipEvent<\/p>\n \u5f53\u4e3b\u4eba\u5173\u7cfb\u6dfb\u52a0\u3001\u79fb\u9664\u6216\u7533\u8bf7\u65f6\u89e6\u53d1\uff1a switch (action) { ## \ud83d\udd27 \u5f00\u53d1\u8005\u76f8\u5173\u6587\u6863<\/p>\n **\ud83d\udca1 \u6e29\u99a8\u63d0\u793a\uff1a\u5982\u679c\u60a8\u53ea\u662f\u666e\u901a\u7528\u6237\uff0c\u6ca1\u6709\u7f16\u7a0b\u57fa\u7840\uff0c\u53ef\u4ee5\u8df3\u8fc7\u8fd9\u90e8\u5206\u5185\u5bb9\uff01**<\/p>\n ### Maven\u914d\u7f6e<\/p>\n \u5982\u679c\u60a8\u60f3\u5f00\u53d1\u4e0eNekoX\u96c6\u6210\u7684\u63d2\u4ef6\uff0c\u4ee5\u4e0b\u662f\u60a8\u9700\u8981\u7684Maven\u914d\u7f6e\uff1a<\/p>\n “`xml\n ### \u5982\u4f55\u7f16\u8bd1\u63d2\u4ef6\uff08\u9002\u5408\u60f3\u81ea\u5df1\u6784\u5efa\u63d2\u4ef6\u7684\u5f00\u53d1\u8005\uff09<\/p>\n \u5982\u679c\u60a8\u60f3\u8981\u81ea\u5df1\u7f16\u8bd1\u63d2\u4ef6\u6587\u4ef6\uff0c\u53ef\u4ee5\u6309\u7167\u4ee5\u4e0b\u6b65\u9aa4\u64cd\u4f5c\uff1a<\/p>\n #### \u5bf9\u4e8e Minecraft 1.20.4\uff08\u9ed8\u8ba4\u7248\u672c\uff09<\/p>\n \u6253\u5f00\u547d\u4ee4\u884c\uff0c\u8f93\u5165\uff1a #### \u5bf9\u4e8e Minecraft 1.21.4<\/p>\n **\u91cd\u8981\u63d0\u793a\uff1a\u60a8\u9700\u8981\u5148\u5728\u7535\u8111\u4e0a\u5b89\u88c5 Java 21** #### \u5f53\u524d\u9650\u5236<\/p>\n – \u5982\u679c\u60a8\u7684\u7535\u8111\u4f7f\u7528\u7684\u662f Java 17\uff0c\u60a8\u53ea\u80fd\u7f16\u8bd1 1.20.4 \u7248\u672c A Minecraft Paper plugin that transforms players into cute neko girls with special abilities, combining features from NekoC and toNeko plugins to create a comprehensive feline experience on your server.<\/p>\n","protected":false},"featured_media":109385,"template":"","meta":{"_minecraft_slug":"nekox","_minecraft_project_id":"2PzGp3rm","_minecraft_author":"_Chinese_Player_","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":131,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"nekox.zip","_minecraft_size_bytes":14943586,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T18:58:48.347125Z","_minecraft_date_created":"2025-09-03T23:03:06.319489Z","_minecraft_date_modified":"2025-12-07T04:55:46.276221Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/nekox","_minecraft_icon_attachment_id":109385,"_minecraft_imported_at":"2026-06-06T10:21:44+00:00","_minecraft_import_hash":"b60faa14aed0d0fb3204b283953aac9f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,122,127],"mod_loader":[132],"minecraft_version":[40,38,78,79,80,81,82],"class_list":["post-109384","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-magic","mod_category-paper","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n “`<\/p>\n
\n – Create a `libs` folder in your project directory
\n – Copy the `NekoX-5.2-ProMax+++.jar` file to your `libs` folder
\n – Add the following dependency to your `build.gradle`:<\/p>\n
\n implementation files(‘libs\/NekoX-5.2-ProMax+++.jar’)
\n “`<\/p>\n
\n – Create a `libs` folder in your project directory
\n – Copy the `NekoX-5.2-ProMax+++.jar` file to your `libs` folder
\n – Add the jar file to your project’s build path in your IDE<\/p>\n
\n– `boolean isNeko(String playerName)` – Check if player (by name) is a neko<\/p>\n
\n– `boolean isOwnerOf(String ownerName, String nekoName)` – Check if player is owner of a neko
\n– `boolean hasOwner(String playerName)` – Check if player has an owner<\/p>\n
\n“`java
\n@EventHandler
\npublic void onNekoStatusChange(NekoStatusChangeEvent event) {
\n Player player = event.getPlayer();
\n boolean isNeko = event.isNeko();
\n boolean isOnline = event.isOnline();
\n \/\/ Handle status change
\n}
\n“`<\/p>\n
\n“`java
\n@EventHandler
\npublic void onOwnerRelationshipChange(OwnerRelationshipEvent event) {
\n String nekoName = event.getNekoName();
\n String ownerName = event.getOwnerName();
\n OwnerRelationshipEvent.RelationshipAction action = event.getAction();<\/p>\n
\n case ADD:
\n \/\/ Handle relationship addition
\n break;
\n case REMOVE:
\n \/\/ Handle relationship removal
\n break;
\n case REQUEST:
\n \/\/ Handle relationship request
\n break;
\n }
\n}
\n“`<\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n <\/repository>
\n <\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n
\n <\/dependency><\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n <\/dependencies><\/p>\n
\n
\n
\n
\n
\n <\/configuration>\n <\/plugin>\n <\/plugins>\n <\/build>\n<\/project>\n“`<\/p>\n
\n“`bash
\nmvn clean install
\n“`<\/p>\n
\nOpen command line and enter:
\n“`bash
\nmvn clean install -Ppaper-1.21.4
\n“`<\/p>\n
\n– To compile the 1.21.4 version, you need to install Java 21 first<\/p>\n
\n|————-|————-|
\n| `%nekox_is_neko%` | Check if player is a neko |
\n| `%nekox_humans%` | Get list of non-neko players |
\n| `%nekox_nekos%` | Get list of neko players |<\/p>\n
\n2. Check if the damaged entity is a neko
\n3. If it’s fall damage (`FALL` enum), cancel the damage event
\n4. If it’s other damage, increase the damage by the configured multiplier<\/p>\n
\n– **Damage Test**: Nekos take 0.8x more damage when attacked
\n– **Configuration Test**: Modify configuration file to verify effects<\/p>\n
\n– **Phantom Repulsion**: Listen for `EntityTargetLivingEntityEvent`, cancel attack and apply reverse thrust
\n– Distance judgment: Effective within 4 blocks
\n– Configuration-driven, features can be toggled on\/off individually<\/p>\n
\n– **Phantom Test**: Nekos aren’t attacked by phantoms at night, regular players are attacked normally
\n– **Configuration Test**: Modify configuration file to verify repulsion effects<\/p>\n
\nA: Supports 1.20.4 and 1.21.4 versions<\/p>\n
\nA: Admin types `\/nekoset playername true`<\/p>\n
\nA: Night vision, jump boost, sneak speed, special chat, claw attacks, etc.<\/p>\n
\nA: Nekos can have owners, owners and nekos can heal each other and have special interactions<\/p>\n
\nA: Edit the `plugins\/NekoX\/config.yml` file<\/p>\n
\nA: Yes! Type `\/nekox language chinese` to switch to Chinese<\/p>\n
\n1. Check if Minecraft version matches
\n2. Confirm plugin file is in correct location
\n3. Check error messages in server logs
\n4. Contact plugin developer for help<\/p>\n
\n– Leather armor provides speed bonus to nekos
\n– Catnip gives temporary speed and jump boost to nekos
\n– Low health automatically triggers stress response for extra power<\/p>\n
\n2. [Build Configuration](#build-configuration)
\n3. [API Access](#api-access)
\n4. [API Methods](#api-methods)
\n5. [Usage Examples](#usage-examples)
\n6. [Event System](#event-system)
\n7. [Data Storage](#data-storage)<\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n <\/repository>
\n <\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n
\n <\/dependency><\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n <\/dependencies><\/p>\n
\n
\n
\n
\n
\n <\/configuration>\n <\/plugin>\n <\/plugins>\n <\/build>\n<\/project>\n“`<\/p>\n
\nplugins {
\n id ‘java’
\n}<\/p>\n
\nversion = ‘1.0-SNAPSHOT’<\/p>\n
\n \/\/ PaperMC Repository
\n maven {
\n name = ‘papermc’
\n url = ‘https:\/\/repo.papermc.io\/repository\/maven-public\/’
\n }<\/p>\n
\n}<\/p>\n
\n \/\/ Paper API
\n compileOnly ‘io.papermc.paper:paper-api:1.20.4-R0.1-SNAPSHOT’<\/p>\n
\n \/\/ Place the NekoX plugin jar file in your project’s libs folder
\n implementation files(‘libs\/NekoX-5.2-ProMax+++.jar’)
\n}<\/p>\n
\n toolchain {
\n languageVersion = JavaLanguageVersion.of(17)
\n }
\n}<\/p>\n
\n options.encoding = ‘UTF-8’
\n}
\n“`<\/p>\n
\n2. Create a libs folder in your project
\n3. Put the NekoX-5.2-ProMax+++.jar file in the libs folder
\n4. Add the jar file to your project’s build path in your IDE
\n5. Make sure to add NekoX as a dependency in plugin.yml<\/p>\n
\n1. Place the generated jar file in the server’s plugins folder
\n2. Ensure the NekoX plugin is also installed
\n3. Restart the server to load all plugins<\/p>\n
\n– For Minecraft 1.20.4, use Java 17
\n– For Minecraft 1.21.4, use Java 21<\/p>\n
\n“`bash
\n# Build 1.20.4 version (default)
\nmvn clean install<\/p>\n
\nmvn clean install -Ppaper-1.21.4
\n“`<\/p>\n
\nimport org.cneko.nekox.api.NekoXAPI;<\/p>\n
\npublic class YourPlugin extends JavaPlugin {
\n private NekoXAPI nekoXAPI;<\/p>\n
\n public void onEnable() {
\n \/\/ Get NekoX API instance
\n nekoXAPI = NekoXAPI.getInstance(this);
\n if (nekoXAPI == null) {
\n getLogger().warning(“NekoX plugin not found, please ensure NekoX is installed and enabled!”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }<\/p>\n
\n }
\n}
\n“`<\/p>\n
\nname: YourPlugin
\nversion: 1.0
\nmain: your.package.YourPlugin
\napi-version: 1.13
\ndepend: [NekoX]
\n“`<\/p>\n
\n– `player`: Player to check<\/p>\n
\n– `true`: Player is a neko
\n– `false`: Player is not a neko<\/p>\n
\n– `playerName`: Player name<\/p>\n
\n– `true`: Player is a neko
\n– `false`: Player is not a neko<\/p>\n
\n– Set containing all neko player names<\/p>\n
\n– `nekoName`: Neko player name<\/p>\n
\n– Set containing all owner player names<\/p>\n
\n– `ownerName`: Owner player name
\n– `nekoName`: Neko player name<\/p>\n
\n– `true`: Is owner
\n– `false`: Is not owner<\/p>\n
\n– `playerName`: Player name<\/p>\n
\n– `true`: Has owner
\n– `false`: Has no owner<\/p>\n
\nPlayer player = …; \/\/ Get player instance
\nif (nekoXAPI.isNeko(player)) {
\n player.sendMessage(“You are a cute neko!”);
\n} else {
\n player.sendMessage(“You are not a neko~”);
\n}
\n“`<\/p>\n
\nSet
\nfor (String nekoName : nekoNames) {
\n \/\/ Process each neko player name
\n getLogger().info(“Neko: ” + nekoName);
\n}
\n“`<\/p>\n
\nString ownerName = …; \/\/ Owner player name
\nString nekoName = …; \/\/ Neko player name<\/p>\n
\n getLogger().info(ownerName + ” is the owner of ” + nekoName + “!”);
\n}
\n“`<\/p>\n
\nString nekoName = …; \/\/ Neko player name
\nSet
\n getLogger().info(nekoName + ” doesn’t have an owner yet~”);
\n} else {
\n StringBuilder message = new StringBuilder(nekoName + “‘s owners: “);
\n for (String owner : owners) {
\n message.append(owner).append(“, “);
\n }
\n getLogger().info(message.toString());
\n}
\n“`<\/p>\n
\n**Trigger Timing**: When a player is set as neko or neko status is cancelled<\/p>\n
\n“`java
\n@EventHandler
\npublic void onNekoStatusChange(NekoStatusChangeEvent event) {
\n Player player = event.getPlayer();
\n boolean isNeko = event.isNeko();
\n boolean isOnline = event.isOnline();<\/p>\n
\n getLogger().info(player.getName() + ” became a neko!”);
\n } else {
\n getLogger().info(player.getName() + ” is no longer a neko!”);
\n }
\n}
\n“`<\/p>\n
\n**Trigger Timing**: When adding, removing, or requesting owner relationship<\/p>\n
\n“`java
\n@EventHandler
\npublic void onOwnerRelationshipChange(OwnerRelationshipEvent event) {
\n String nekoName = event.getNekoName();
\n String ownerName = event.getOwnerName();
\n OwnerRelationshipEvent.RelationshipAction action = event.getAction();<\/p>\n
\n case ADD:
\n getLogger().info(ownerName + ” became the owner of ” + nekoName + “!”);
\n break;
\n case REMOVE:
\n getLogger().info(ownerName + ” is no longer the owner of ” + nekoName + “!”);
\n break;
\n case REQUEST:
\n getLogger().info(ownerName + ” requested to become the owner of ” + nekoName + “!”);
\n break;
\n }
\n}
\n“`<\/p>\n
\n– Whether player is a neko
\n– Neko-owner relationships
\n– Player personalization settings<\/p>\n
\n– `player_name`: Player name (primary key)
\n– `notice_enabled`: Whether player proximity notification is enabled
\n– `is_neko`: Whether is a neko
\n– `tail_pull_enabled`: Whether tail pull feature is enabled<\/p>\n
\n– `neko_name`: Neko name
\n– `owner_name`: Owner name<\/p>\n
\n– `requester_name`: Requester name
\n– `neko_name`: Requested neko name<\/p>\n
\n2. It’s recommended to access data through API methods rather than directly operating the database
\n3. Player data uses player name as identifier and supports offline player queries<\/p>\n
\n2. Use asynchronous operations appropriately to avoid executing time-consuming tasks on the main thread
\n3. Release resources in a timely manner, especially when the plugin is disabled<\/p>\n
\n2. Handle possible exception cases, such as player not being online
\n3. Provide friendly error messages<\/p>\n
\n2. Adapt to different versions of NekoX API
\n3. Provide fallback solutions and alternative logic when NekoX is unavailable<\/p>\n
\n– GitHub Issues: https:\/\/github.com\/Shabby-666\/NekoX\/issues
\n– QQ: 959612591<\/p>\n
\n2. \u628a\u8fd9\u4e2a\u6587\u4ef6\u653e\u5230\u4f60\u670d\u52a1\u5668\u7684 `plugins` \u6587\u4ef6\u5939\u91cc<\/p>\n
\n2. \u63d2\u4ef6\u4f1a\u81ea\u52a8\u521b\u5efa\u914d\u7f6e\u6587\u4ef6<\/p>\n
\n2. \u732b\u5a18\u73a9\u5bb6\u5c31\u53ef\u4ee5\u4f7f\u7528\u5404\u79cd\u6709\u8da3\u7684\u529f\u80fd\u5566\uff01<\/p>\n
\n– **\u8df3\u8dc3\u589e\u5f3a**\uff1a\u53ef\u4ee5\u8df3\u5f97\u66f4\u9ad8
\n– **\u6f5c\u884c\u52a0\u901f**\uff1a\u6f5c\u884c\u65f6\u79fb\u52a8\u66f4\u5feb\u66f4\u5b89\u9759<\/p>\n
\n– \u81ea\u52a8\u628a\u666e\u901a\u8bcd\u8bed\u53d8\u6210\u53ef\u7231\u7684\u732b\u5a18\u7528\u8bed
\n– \u6bd4\u5982”\u4f60\u597d”\u53ef\u80fd\u53d8\u6210”\u55b5~\u4f60\u597d”<\/p>\n
\n– \u652f\u6301\u5404\u79cd\u8089\u7c7b\u98df\u7269<\/p>\n
\n– \u5bf9\u751f\u7269\u9020\u6210\u989d\u5916\u4f24\u5bb3
\n– \u6709\u51b7\u5374\u65f6\u95f4\uff0c\u4e0d\u80fd\u8fde\u7eed\u4f7f\u7528<\/p>\n
\n– \u6bcf\u4ef6\u76ae\u9769\u62a4\u7532\u90fd\u80fd\u589e\u52a0\u901f\u5ea6
\n– \u591a\u4ef6\u62a4\u7532\u6548\u679c\u53e0\u52a0
\n– \u6700\u5927\u52a0\u6210\u7b49\u7ea7\u53ef\u914d\u7f6e<\/p>\n
\n– \u4e3b\u4eba\u548c\u732b\u5a18\u6709\u7279\u6b8a\u4e92\u52a8
\n– \u53ef\u4ee5\u4e92\u76f8\u6cbb\u7597\u548c\u5e2e\u52a9
\n– **\u4e3b\u4eba\u6b7b\u4ea1\u6548\u5e94**\uff1a\u5f53\u4e3b\u4eba\u6b7b\u4ea1\u65f6\uff0c\u5176\u732b\u5a18\u4e5f\u4f1a\u6b7b\u4ea1\uff08\u53ef\u914d\u7f6e\uff09
\n – \u53ef\u9009\u62e9\u662f\u5426\u4fdd\u7559\u732b\u5a18\u7684\u7269\u54c1\u680f\u548c\u7ecf\u9a8c\u7b49\u7ea7<\/p>\n
\n– \u5348\u591c\u65f6\u80fd\u529b\u8fbe\u5230\u6700\u5f3a
\n– \u81ea\u52a8\u751f\u6548\uff0c\u4e0d\u7528\u624b\u52a8\u5f00\u542f<\/p>\n
\n– \u4f1a\u81ea\u52a8\u83b7\u5f97\u8d85\u5f3a\u529b\u91cf
\n– \u6301\u7eed1\u5206\u949f\uff0c\u5e2e\u52a9\u8131\u79bb\u5371\u9669<\/p>\n
\n– \u5bf9\u654c\u4eba\u6709\u66f4\u5f3a\u7684\u51fb\u9000\u6548\u679c
\n– \u9002\u7528\u4e8e\u6240\u6709\u6b66\u5668\u7c7b\u578b
\n– \u4f24\u5bb3\u548c\u51fb\u9000\u500d\u6570\u53ef\u914d\u7f6e<\/p>\n
\n– \u83b7\u5f97\u4e34\u65f6\u901f\u5ea6\u548c\u8df3\u8dc3\u63d0\u5347
\n– \u6548\u679c\u6301\u7eed\u4e00\u6bb5\u65f6\u95f4
\n– \u53ef\u4ee5\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u4fee\u6539\u4f7f\u7528\u7684\u7269\u54c1<\/p>\n
\n– **\u5176\u4ed6\u4f24\u5bb3\u589e\u5f3a**\uff1a\u732b\u5a18\u53d7\u5230\u7684\u5176\u4ed6\u4f24\u5bb3\u589e\u52a00.8\u500d
\n– \u53ef\u4ee5\u5728\u914d\u7f6e\u6587\u4ef6\u4e2d\u8c03\u6574\u4f24\u5bb3\u500d\u6570<\/p>\n
\n– **\u5e7b\u7ffc\u9a71\u8d76**\uff1a\u5e7b\u7ffc\u4e0d\u4f1a\u653b\u51fb\u732b\u5a18\uff0c\u800c\u662f\u88ab\u9a71\u8d76
\n– \u81ea\u52a8\u751f\u6548\uff0c\u65e0\u9700\u624b\u52a8\u64cd\u4f5c<\/p>\n
\n– \u53cb\u597d\u751f\u7269\u66f4\u5bb9\u6613\u88ab\u732b\u5a18\u5438\u5f15
\n– \u5bf9\u4e0d\u540c\u7c7b\u578b\u7684\u751f\u7269\u6709\u4e0d\u540c\u5f71\u54cd
\n– \u68c0\u6d4b\u53c2\u6570\u53ef\u914d\u7f6e<\/p>\n
\n– \u5b9e\u65f6\u663e\u793a\u9644\u8fd1\u73a9\u5bb6\u7684\u540d\u79f0\u548c\u8ddd\u79bb
\n– \u66f4\u65b0\u9891\u7387\u63d0\u9ad8\u52300.5\u79d2\u4e00\u6b21\uff0c\u53cd\u5e94\u66f4\u7075\u654f
\n– \u53ef\u901a\u8fc7`\/playernotice`\u547d\u4ee4\u5f00\u542f\/\u5173\u95ed\u529f\u80fd
\n– \u914d\u7f6e\u4fe1\u606f\u5b58\u50a8\u5728SQLite\u6570\u636e\u5e93\u4e2d
\n– \u5e2e\u52a9\u732b\u5a18\u4e86\u89e3\u5468\u56f4\u73af\u5883<\/p>\n
\n– **\u4f7f\u7528\u65b9\u6cd5**\uff1a\u4f7f\u7528`\/climb`\u547d\u4ee4\u5f00\u542f\/\u5173\u95ed\u722c\u5899\u529f\u80fd
\n– **\u9650\u5236\u6761\u4ef6**\uff1a\u53ea\u80fd\u5728\u5899\u58c1\u9644\u8fd1\u6500\u722c\uff0c\u6709\u4e00\u5b9a\u7684\u4f7f\u7528\u8303\u56f4
\n– **\u81ea\u52a8\u5173\u95ed**\uff1a\u79bb\u5f00\u5899\u58c1\u540e\u81ea\u52a8\u505c\u6b62\u6500\u722c<\/p>\n
\n– **\u4f7f\u7528\u65b9\u6cd5**\uff1a\u4f7f\u7528`\/pullthetail`\u547d\u4ee4\u5f00\u542f\/\u5173\u95ed\u5c3e\u5df4\u62c9\u626f\u529f\u80fd
\n– **\u4e92\u52a8\u6548\u679c**\uff1a\u62c9\u626f\u5c3e\u5df4\u4f1a\u4ea7\u751f\u6709\u8da3\u7684\u4e92\u52a8\u6548\u679c\uff08\u9020\u6210\u4f24\u5bb3\u5e76\u7acb\u5373\u6062\u590d\uff0c\u64ad\u653e\u732b\u53eb\u58f0\uff09
\n– **\u5f00\u5173\u63a7\u5236**\uff1a\u732b\u5a18\u53ef\u4ee5\u81ea\u4e3b\u9009\u62e9\u662f\u5426\u5141\u8bb8\u88ab\u62c9\u626f\u5c3e\u5df4<\/p>\n
\n– **\u6d88\u8017**\uff1a\u4f7f\u7528\u6280\u80fd\u4f1a\u6d88\u8017\u9971\u98df\u5ea6
\n– **\u51b7\u5374**\uff1a\u6280\u80fd\u6709\u4f7f\u7528\u51b7\u5374\u65f6\u95f4
\n– **\u6548\u679c\u7f29\u653e**\uff1a\u751f\u547d\u503c\u8d8a\u4f4e\uff0c\u6062\u590d\u6548\u679c\u8d8a\u5f3a<\/p>\n
\n– **\u4e3b\u52a8\u6280\u80fd**\uff1a\u663e\u793a\u51b7\u5374\u72b6\u6001\u548c\u4f7f\u7528\u4fe1\u606f
\n– **\u88ab\u52a8\u6280\u80fd**\uff1a\u663e\u793a\u72b6\u6001\u548c\u63cf\u8ff0
\n– **\u6e05\u6670\u683c\u5f0f**\uff1a\u6613\u4e8e\u7406\u89e3\u7684\u6280\u80fd\u4fe1\u606f<\/p>\n
\n– **\u589e\u5f3a\u517c\u5bb9\u6027**\uff1a\u5373\u4f7f\u672a\u5b89\u88c5PlaceholderAPI\u4e5f\u80fd\u6b63\u5e38\u5de5\u4f5c
\n– **\u66f4\u597d\u7684\u9519\u8bef\u5904\u7406**\uff1aPlaceholderAPI\u4e0d\u53ef\u7528\u65f6\u663e\u793a\u6e05\u6670\u7684\u9519\u8bef\u4fe1\u606f
\n– **\u72b6\u6001\u663e\u793a**\uff1a\u663e\u793a\u6bcf\u4e2a\u5360\u4f4d\u7b26\u7684\u6ce8\u518c\u72b6\u6001<\/p>\n
\n– **\u63d0\u9ad8\u7a33\u5b9a\u6027**\uff1a\u4f18\u5316\u547d\u4ee4\u6267\u884c\u6d41\u7a0b\uff0c\u63d0\u9ad8\u4ee3\u7801\u53ef\u9760\u6027
\n– **\u9632\u6b62\u5d29\u6e83**\uff1a\u589e\u5f3a\u9519\u8bef\u5904\u7406\u673a\u5236
\n– **\u8bed\u8a00\u652f\u6301**\uff1a\u66f4\u597d\u7684\u9ed8\u8ba4\u6d88\u606f\u56de\u9000\u7cfb\u7edf<\/p>\n
\n– **\u56de\u9000\u7cfb\u7edf**\uff1a\u7ffb\u8bd1\u7f3a\u5931\u65f6\u63d0\u4f9b\u66f4\u597d\u7684\u9ed8\u8ba4\u6d88\u606f
\n– **\u4e00\u81f4\u663e\u793a**\uff1a\u786e\u4fdd\u6240\u6709\u547d\u4ee4\u6d88\u606f\u5728\u4e0d\u540c\u8bed\u8a00\u73af\u5883\u4e0b\u6b63\u786e\u663e\u793a<\/p>\n
\n2. **\u624b\u6301\u732b\u8584\u8377\u7269\u54c1** – \u9ed8\u8ba4\u4f7f\u7528\u5c0f\u9ea6\u79cd\u5b50\uff08WHEAT_SEEDS\uff09
\n3. **\u53f3\u952e\u4f7f\u7528** – \u624b\u6301\u732b\u8584\u8377\u7269\u54c1\u53f3\u952e\u70b9\u51fb\u5373\u53ef\u6fc0\u6d3b\u6548\u679c<\/p>\n
\n2. \u83b7\u53d6\u5c0f\u9ea6\u79cd\u5b50\uff08\u6216\u5176\u4ed6\u914d\u7f6e\u7684\u732b\u8584\u8377\u7269\u54c1\uff09
\n3. \u624b\u6301\u5c0f\u9ea6\u79cd\u5b50\u53f3\u952e\u70b9\u51fb
\n4. \u7acb\u5373\u83b7\u5f97\u901f\u5ea6\u548c\u8df3\u8dc3\u63d0\u5347\u6548\u679c<\/p>\n
\n– **\u8df3\u8dc3\u63d0\u5347** (Jump Boost II) – \u8df3\u8dc3\u9ad8\u5ea6\u663e\u8457\u63d0\u5347
\n– **\u6301\u7eed\u65f6\u95f4** – \u9ed8\u8ba460\u79d2\uff08\u53ef\u5728\u914d\u7f6e\u4e2d\u4fee\u6539\uff09<\/p>\n
\n– \u6d88\u8017\u4e00\u4e2a\u732b\u8584\u8377\u7269\u54c1
\n– \u6709\u51b7\u5374\u65f6\u95f4\uff0c\u4e0d\u80fd\u8fde\u7eed\u4f7f\u7528
\n– \u53ea\u5bf9\u732b\u5a18\u73a9\u5bb6\u6709\u6548<\/p>\n
\ncat-nip:
\n enabled: true # \u662f\u5426\u542f\u7528\u732b\u8584\u8377\u529f\u80fd
\n item: “WHEAT_SEEDS” # \u732b\u8584\u8377\u7269\u54c1ID\uff08\u53ef\u4fee\u6539\u4e3a\u5176\u4ed6\u7269\u54c1\uff09
\n duration: 60 # \u6548\u679c\u6301\u7eed\u65f6\u95f4\uff08\u79d2\uff09
\n“`<\/p>\n
\n– \u53ef\u6539\u4e3a\uff1a`GRASS`\uff08\u8349\uff09\u3001`FERN`\uff08\u8568\u7c7b\uff09\u3001`VINE`\uff08\u85e4\u8513\uff09\u7b49
\n– \u652f\u6301\u4efb\u4f55Minecraft\u7269\u54c1ID<\/p>\n
\n2. **\u9003\u8dd1\u5229\u5668** – \u88ab\u8ffd\u51fb\u65f6\u4f7f\u7528\u732b\u8584\u8377\u5feb\u901f\u8131\u79bb\u5371\u9669
\n3. **\u63a2\u7d22\u52a0\u901f** – \u957f\u9014\u65c5\u884c\u65f6\u4f7f\u7528\uff0c\u63d0\u9ad8\u79fb\u52a8\u6548\u7387
\n4. **\u5efa\u7b51\u8f85\u52a9** – \u8df3\u8dc3\u63d0\u5347\u6709\u52a9\u4e8e\u642d\u5efa\u9ad8\u5904\u5efa\u7b51
\n5. **\u62a4\u7532\u9009\u62e9** – \u7a7f\u76ae\u9769\u62a4\u7532\u53ef\u83b7\u5f97\u6700\u5927\u901f\u5ea6\u52a0\u6210<\/p>\n
\n– \u9700\u8981\u6d88\u8017\u732b\u8584\u8377\u7269\u54c1
\n– \u6709\u4f7f\u7528\u51b7\u5374\u65f6\u95f4
\n– \u526f\u624b\u6301\u7269\u65f6\u65e0\u6cd5\u4f7f\u7528\uff08\u5fc5\u987b\u4e3b\u624b\u6301\u7269\uff09<\/p>\n
\n– **\u5e94\u6fc0\u53cd\u5e94** – \u751f\u547d\u503c\u4f4e\u65f6\u914d\u5408\u732b\u8584\u8377\u6548\u679c\u66f4\u597d
\n– **\u62a4\u7532\u52a0\u6210** – \u901f\u5ea6\u52a0\u6210\u4e0e\u76ae\u9769\u62a4\u7532\u6548\u679c\u53e0\u52a0<\/p>\n
\n– `\/lovebite \u73a9\u5bb6` – \u7ed9\u4e2a\u53ef\u7231\u7684\u54ac\u54ac
\n– `\/earscratch \u73a9\u5bb6` – \u6320\u6320\u8033\u6735
\n– `\/purr` – \u53d1\u51fa\u547c\u565c\u58f0
\n– `\/hiss \u73a9\u5bb6` – \u5bf9\u522b\u4eba\u53d1\u51fa\u5636\u5636\u58f0
\n– `\/scratch \u73a9\u5bb6` – \u7528\u722a\u5b50\u6293\u4e00\u4e0b
\n– `\/attention \u73a9\u5bb6` – \u5438\u5f15\u5176\u4ed6\u73a9\u5bb6\u7684\u6ce8\u610f
\n– `\/pullthetail` – \u5f00\u5173\u5c3e\u5df4\u62c9\u626f\u529f\u80fd<\/p>\n
\n– `\/jumpboost` – \u8df3\u8dc3\u589e\u5f3a
\n– `\/swiftsneak` – \u6f5c\u884c\u52a0\u901f
\n– `\/health` – \u6cbb\u7597\u81ea\u5df1\u548c\u4e3b\u4eba
\n– `\/myskills` – \u67e5\u770b\u6240\u6709\u6280\u80fd\u548c\u51b7\u5374\u65f6\u95f4
\n– `\/playernotice [on|off]` – \u5f00\u542f\/\u5173\u95ed\u73a9\u5bb6\u63a5\u8fd1\u63d0\u9192
\n– `\/climb` – \u5f00\u5173\u722c\u5899\u529f\u80fd<\/p>\n
\n– `\/owner accept \u73a9\u5bb6` – \u63a5\u53d7\u4e3b\u4eba\u7684\u8bf7\u6c42
\n– `\/owner deny \u73a9\u5bb6` – \u62d2\u7edd\u4e3b\u4eba\u7684\u8bf7\u6c42
\n– `\/owner remove \u73a9\u5bb6` – \u89e3\u9664\u4e3b\u4eba\u5173\u7cfb
\n– `\/owner list` – \u67e5\u770b\u81ea\u5df1\u7684\u4e3b\u4eba
\n– `\/owner mylist` – \u67e5\u770b\u81ea\u5df1\u7684\u732b\u5a18<\/p>\n
\n– `\/nekoset \u73a9\u5bb6 true\/false` – \u8bbe\u7f6e\u73a9\u5bb6\u4e3a\u732b\u5a18
\n– `\/nekox language \u8bed\u8a00` – \u5207\u6362\u63d2\u4ef6\u8bed\u8a00
\n– `\/nekox placeholders` – \u663e\u793a\u6240\u6709\u53ef\u7528\u7684NekoX\u5360\u4f4d\u7b26<\/p>\n
\n– `meat-only`: \u732b\u5a18\u662f\u5426\u53ea\u80fd\u5403\u8089
\n– `owner-system`: \u662f\u5426\u5f00\u542f\u4e3b\u4eba\u7cfb\u7edf<\/p>\n
\n– `armor-bonus`: \u76ae\u9769\u62a4\u7532\u63d0\u4f9b\u7684\u901f\u5ea6\u52a0\u6210
\n– `night-effects`: \u591c\u95f4\u80fd\u529b\u7684\u5f00\u59cb\u548c\u7ed3\u675f\u65f6\u95f4
\n– `health-skill`: \u6cbb\u7597\u6280\u80fd\u7684\u51b7\u5374\u548c\u6d88\u8017<\/p>\n
\n– `stress-effect`: \u5e94\u6fc0\u53cd\u5e94\u7684\u89e6\u53d1\u6761\u4ef6
\n– `passive-attack-boost`: \u653b\u51fb\u4f24\u5bb3\u52a0\u6210
\n– `armor-bonus`: \u76ae\u9769\u62a4\u7532\u52a0\u6210\u8bbe\u7f6e
\n – `enabled`: \u662f\u5426\u542f\u7528\u62a4\u7532\u52a0\u6210
\n – `leather-bonus`: \u76ae\u9769\u62a4\u7532\u7c7b\u578b\u5217\u8868
\n – `speed-bonus-per-piece`: \u6bcf\u4ef6\u62a4\u7532\u7684\u901f\u5ea6\u52a0\u6210
\n– `neko-damage-modification`: \u732b\u5a18\u4f24\u5bb3\u8c03\u6574\u8bbe\u7f6e
\n – `enabled`: \u662f\u5426\u542f\u7528\u4f24\u5bb3\u8c03\u6574\u529f\u80fd
\n – `fall-damage-immunity`: \u514d\u75ab\u8dcc\u843d\u4f24\u5bb3
\n – `other-damage-multiplier`: \u5176\u4ed6\u4f24\u5bb3\u589e\u52a0\u500d\u6570
\n – `debug`: \u8c03\u8bd5\u6a21\u5f0f
\n– `neko-mob-behavior`: \u732b\u5a18\u751f\u7269\u884c\u4e3a\u8bbe\u7f6e
\n – `enabled`: \u662f\u5426\u542f\u7528\u751f\u7269\u884c\u4e3a\u529f\u80fd
\n – `creeper-repulsion`: \u82e6\u529b\u6015\u9a71\u8d76\u529f\u80fd
\n – `phantom-repulsion`: \u5e7b\u7ffc\u9a71\u8d76\u529f\u80fd
\n – `debug`: \u8c03\u8bd5\u6a21\u5f0f
\n– `mob-targeting`: \u751f\u7269\u76ee\u6807\u884c\u4e3a\u8bbe\u7f6e
\n – `enabled`: \u662f\u5426\u542f\u7528\u76ee\u6807\u884c\u4e3a\u8c03\u6574
\n – `distance-increase`: \u68c0\u6d4b\u8ddd\u79bb\u589e\u52a0\u500d\u6570
\n – `friendly-attraction`: \u662f\u5426\u542f\u7528\u53cb\u597d\u751f\u7269\u5438\u5f15
\n– `owner-death`: \u4e3b\u4eba\u6b7b\u4ea1\u6548\u5e94\u8bbe\u7f6e
\n – `feature.enabled`: \u662f\u5426\u542f\u7528\u4e3b\u4eba\u6b7b\u4ea1\u6548\u5e94
\n – `keep-inventory`: \u662f\u5426\u4fdd\u7559\u732b\u5a18\u7269\u54c1\u680f
\n – `keep-level`: \u662f\u5426\u4fdd\u7559\u732b\u5a18\u7ecf\u9a8c\u7b49\u7ea7<\/p>\n
\n“`yaml
\ndepend: [NekoX]
\n“`<\/p>\n
\n“`java
\nimport org.cneko.nekox.api.NekoXAPI;<\/p>\n
\n private NekoXAPI nekoXAPI;<\/p>\n
\n public void onEnable() {
\n nekoXAPI = NekoXAPI.getInstance(this);
\n if (nekoXAPI == null) {
\n getLogger().warning(“\u672a\u627e\u5230NekoX\u63d2\u4ef6\uff01”);
\n getServer().getPluginManager().disablePlugin(this);
\n return;
\n }
\n }
\n}
\n“`<\/p>\n
\n – \u5728\u60a8\u7684\u9879\u76ee\u76ee\u5f55\u4e2d\u521b\u5efa\u4e00\u4e2a `libs` \u6587\u4ef6\u5939
\n – \u5c06\u672c\u63d2\u4ef6target\u6587\u4ef6\u5939\u4e2d\u7684 `NekoX-5.2-ProMax+++.jar` \u6587\u4ef6\u590d\u5236\u5230\u60a8\u7684 `libs` \u6587\u4ef6\u5939
\n – \u5728\u60a8\u7684 `pom.xml` \u4e2d\u6dfb\u52a0\u4ee5\u4e0b\u4f9d\u8d56\uff1a<\/p>\n
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n “`<\/p>\n
\n – \u5728\u60a8\u7684\u9879\u76ee\u76ee\u5f55\u4e2d\u521b\u5efa\u4e00\u4e2a `libs` \u6587\u4ef6\u5939
\n – \u5c06 `NekoX-5.2-ProMax+++.jar` \u6587\u4ef6\u590d\u5236\u5230\u60a8\u7684 `libs` \u6587\u4ef6\u5939
\n – \u5728\u60a8\u7684 `build.gradle` \u4e2d\u6dfb\u52a0\u4ee5\u4e0b\u4f9d\u8d56\uff1a<\/p>\n
\n implementation files(‘libs\/NekoX-5.2-ProMax+++.jar’)
\n “`<\/p>\n
\n – \u5728\u60a8\u7684\u9879\u76ee\u76ee\u5f55\u4e2d\u521b\u5efa\u4e00\u4e2a `libs` \u6587\u4ef6\u5939
\n – \u5c06 `NekoX-5.2-ProMax+++.jar` \u6587\u4ef6\u590d\u5236\u5230\u60a8\u7684 `libs` \u6587\u4ef6\u5939
\n – \u5728\u60a8\u7684IDE\u4e2d\u5c06jar\u6587\u4ef6\u6dfb\u52a0\u5230\u9879\u76ee\u7684\u6784\u5efa\u8def\u5f84<\/p>\n
\n– `boolean isNeko(String playerName)` – \u68c0\u67e5\u73a9\u5bb6\uff08\u6309\u540d\u79f0\uff09\u662f\u5426\u4e3a\u732b\u5a18<\/p>\n
\n– `boolean isOwnerOf(String ownerName, String nekoName)` – \u68c0\u67e5\u73a9\u5bb6\u662f\u5426\u4e3a\u732b\u5a18\u7684\u4e3b\u4eba
\n– `boolean hasOwner(String playerName)` – \u68c0\u67e5\u73a9\u5bb6\u662f\u5426\u6709\u4e3b\u4eba<\/p>\n
\n“`java
\n@EventHandler
\npublic void onNekoStatusChange(NekoStatusChangeEvent event) {
\n Player player = event.getPlayer();
\n boolean isNeko = event.isNeko();
\n boolean isOnline = event.isOnline();
\n \/\/ \u5904\u7406\u72b6\u6001\u53d8\u66f4
\n}
\n“`<\/p>\n
\n“`java
\n@EventHandler
\npublic void onOwnerRelationshipChange(OwnerRelationshipEvent event) {
\n String nekoName = event.getNekoName();
\n String ownerName = event.getOwnerName();
\n OwnerRelationshipEvent.RelationshipAction action = event.getAction();<\/p>\n
\n case ADD:
\n \/\/ \u5904\u7406\u5173\u7cfb\u6dfb\u52a0
\n break;
\n case REMOVE:
\n \/\/ \u5904\u7406\u5173\u7cfb\u79fb\u9664
\n break;
\n case REQUEST:
\n \/\/ \u5904\u7406\u5173\u7cfb\u7533\u8bf7
\n break;
\n }
\n}
\n“`<\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n <\/repository>
\n <\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n
\n <\/dependency><\/p>\n
\n
\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n <\/dependencies><\/p>\n
\n
\n
\n
\n
\n <\/configuration>\n <\/plugin>\n <\/plugins>\n <\/build>\n<\/project>\n“`<\/p>\n
\n“`bash
\nmvn clean install
\n“`<\/p>\n
\n\u6253\u5f00\u547d\u4ee4\u884c\uff0c\u8f93\u5165\uff1a
\n“`bash
\nmvn clean install -Ppaper-1.21.4
\n“`<\/p>\n
\n– \u8981\u7f16\u8bd1 1.21.4 \u7248\u672c\uff0c\u60a8\u9700\u8981\u5148\u5b89\u88c5 Java 21<\/p>\n","protected":false},"excerpt":{"rendered":"