HeadPets

HeadPets

This plugin adds pets as floating player heads (invisible `ArmorStand` + `Player Head`), with a GUI menu, tabs, pagination, particles and passive effects.

<img src="https://github.com/Jorget01/HeadPets/blob/main/media/0215.gif?raw=true" alt="OnePlayerBarPreview" width="100%"/>

Features

- `/pets` opens the menu. - Tabs: - Shift+RMB — shows every pet, including locked ones (if enabled in config). - Shift+RMB — shows only pets the player has permission for. - Pages: - Navigation arrows at the bottom switch pages. - Pet activation: - Shift+RMB a pet — activate/deactivate (pet floats near the player and follows them). - Multiple pets can be active at once (limit is `pets-settings.max-active-per-player`). - Particles: - Shift+RMB button — selects the player’s global particle type (Shift+RMB next, Shift+RMB previous). - Shift+RMB on Shift+RMB — enable/disable particles (if `particles.allow-player-disable` is enabled). - If `particles.per-pet-selection` is enabled, you can select particles Shift+RMB: - Shift+RMB on a pet — next particle - Shift+RMB on a pet — previous particle - Particles can be visible for everyone or only for the owner (config). - Passive effects: - Each pet can apply potion effects while it is active (config). - Languages: - Russian and English (`lang/ru.yml`, `lang/en.yml`) - `settings.language.mode: auto` selects language by player locale (ru => Russian, otherwise English).

Commands & permissions

- `/pets` — open menu - permission: `pats.pets.open` (default: true) - `/pets reload` or `/petsreload` — reload config/lang/pets (no server restart) - permission: `pats.pets.reload` (default: op) - `/pets add ...` or `/petadd ...` — add a pet to `config.yml` - permission: `pats.pets.admin` (default: op) - `/pets remove <id>` or `/petremove <id>` — remove a pet from `config.yml` - permission: `pats.pets.admin` (default: op)

Access to a specific pet is controlled via the pet’s `permission` in `config.yml` (for example: `pats.pets.head.118`).

Command examples

Add a pet (one name will be used for both RU/EN):

```text /petadd head_test eyJ0ZXh0dXJlcyI6... Donkey_Kong ```

Add a pet (different names for RU/EN):

```text /petadd head_test eyJ0ZXh0dXJlcyI6... Донки_Конг Donkey_Kong ```

Remove a pet:

```text /petremove head_test ```

Config

Main `config.yml` sections:

- `settings.language` — language settings (`auto` / `fixed`). - `menu.show-locked-in-all` — show locked pets in “All pets” tab. - `menu.gui.*` — GUI settings (size, button slots, materials, pets grid area). - `follow.*` — follow distances/speeds. - `particles.*` — particles settings (visibility, frequency, `y-offset`, options list). - `effects.*` — passive effects timing settings. - `pets:` — pets list (add your own pets here).

Colors (HEX)

You can use color codes in many strings (pet names, messages, lore):

- Legacy: `&a`, `&c`, `&7`, etc. - HEX: `&#ff00ff` (example: `&#ff00ffDonkey Kong`)

Pet example

```yml pets: - id: head_118

permission is optional (default: pats.pets.<id>)

permission: pats.pets.head.118 display: ru: "Донки Конг" en: "Donkey Kong" head:

profile-id is optional

profile-name: "mcheads-118" textures: "BASE64_TEXTURES_HERE" effects: - type: SPEED amplifier: 0

shorthand:

- "JUMP_BOOST:0" ```

Notes

- Player particle choice and language override are stored in `plugins/PatsPets/data.yml`. - Active pets are stored in `plugins/PatsPets/data.yml` and restored when the player rejoins. - By default, effects are removed when a pet is deactivated (`effects.remove-on-deactivate: true`). If disabled, effects will simply expire based on `effects.duration-ticks`.