跳转至

Installation & Configuration

📥 Installation

  1. Download MyPets-1.0.0.jar
  2. Place the jar file into your server's plugins/ folder
  3. Restart the server

On first startup, the plugin will automatically generate the following files:

plugins/MyPets/
├── config.yml          # Main configuration file
├── data/               # Player data
│   ├── pets/           # Pet data (JSON)
│   └── farms/          # Farm data (JSON)
└── lang/               # Language files
    ├── zh_CN.json
    ├── zh_TW.json
    ├── en_US.json
    ├── ja_JP.json
    └── ko_KR.json

⚙️ Configuration (config.yml)

language: "zh_CN"                  # Default language
max_farms: 1                       # Free version farm limit
selection_tool: "WOODEN_SHOVEL"    # Tool for selecting farm area
price_per_block: 0.2              # Premium price per block

max_farm_size_x: 20                # Free version max X size
max_farm_size_y: 20                # Free version max height
max_farm_size_z: 20                # Free version max Z size

premium:
  enable_capture: false            # Pet sealing feature
  gui_chest: false                 # Premium chest GUI
  farm_pricing: false              # Volume-based pricing
  farm_heal: false                 # Farm pet healing
  gui_menu: false                  # Clickable chat menu
  flags: false                     # Farm permission flags
  leash_teleport: false            # Leash teleport (premium)
  ride_teleport: false             # Ride teleport
  max_pets_per_farm: 10            # Max pets per farm
  max_farms: 3                     # Premium farm limit
  max_farm_size_x: 100             # Premium X size
  max_farm_size_y: 50              # Premium height
  max_farm_size_z: 100             # Premium Z size
  world_whitelist: []              # Allowed worlds
  world_whitelist_enabled: false

Configuration Options Explained

Option Description
language Server language. Available: zh_CN, zh_TW, en_US, ja_JP, ko_KR
max_farms Maximum number of farms a player can create (free version)
selection_tool The item used to select farm area corners. Default: wooden shovel
price_per_block Cost per block when premium volume-pricing is enabled
max_farm_size_* Maximum farm dimensions in blocks

Premium Features Configuration

Set any premium.* option to true to enable that feature. The plugin auto-detects premium mode when any premium option is enabled.

🔄 Reload Configuration

After modifying config.yml, use /mp reload to hot-reload without restarting the server.

🌐 World Whitelist

Restrict the plugin to specific worlds only:

/mp world add <world>      # Add world to whitelist
/mp world remove <world>   # Remove world from whitelist
/mp world list             # View whitelist
/mp world enable           # Enable whitelist
/mp world disable          # Disable whitelist

When whitelist is empty and enabled, the plugin works in all worlds.