![\"OnePlayerBarPreview\"](\"https:\/\/github.com\/Jorget01\/HeadPets\/blob\/main\/media\/0215.gif?raw=true\")
<\/p>\n# HeadPets<\/p>\n
This plugin adds pets as floating player heads (invisible `ArmorStand` + `Player Head`), with a GUI menu, tabs, pagination, particles and passive effects.<\/p>\n
<\/p>\n
## Features<\/p>\n
– `\/pets` opens the menu.
\n– Tabs:
\n – **All pets** \u2014 shows every pet, including locked ones (if enabled in config).
\n – **My pets** \u2014 shows only pets the player has permission for.
\n– Pages:
\n – Navigation arrows at the bottom switch pages.
\n– Pet activation:
\n – **Left click** a pet \u2014 activate\/deactivate (pet floats near the player and follows them).
\n – Multiple pets can be active at once (limit is `pets-settings.max-active-per-player`).
\n– Particles:
\n – **Particles** button \u2014 selects the player\u2019s global particle type (**LMB** next, **RMB** previous).
\n – **Shift+LMB** on **Particles** \u2014 enable\/disable particles (if `particles.allow-player-disable` is enabled).
\n – If `particles.per-pet-selection` is enabled, you can select particles **per pet**:
\n – **RMB** on a pet \u2014 next particle
\n – **Shift+RMB** on a pet \u2014 previous particle
\n – Particles can be visible for everyone or only for the owner (config).
\n– Passive effects:
\n – Each pet can apply potion effects while it is active (config).
\n– Languages:
\n – Russian and English (`lang\/ru.yml`, `lang\/en.yml`)
\n – `settings.language.mode: auto` selects language by player locale (ru => Russian, otherwise English).<\/p>\n
## Commands & permissions<\/p>\n
– `\/pets` \u2014 open menu Access to a specific pet is controlled via the pet\u2019s `permission` in `config.yml` (for example: `pats.pets.head.118`).<\/p>\n ### Command examples<\/p>\n Add a pet (one name will be used for both RU\/EN):<\/p>\n “`text Add a pet (different names for RU\/EN):<\/p>\n “`text Remove a pet:<\/p>\n “`text ## Config<\/p>\n Main `config.yml` sections:<\/p>\n – `settings.language` \u2014 language settings (`auto` \/ `fixed`). ### Colors (HEX)<\/p>\n You can use color codes in many strings (pet names, messages, lore):<\/p>\n – Legacy: `&a`, `&c`, `&7`, etc. ### Pet example<\/p>\n “`yml ## Notes<\/p>\n – Player particle choice and language override are stored in `plugins\/PatsPets\/data.yml`. The plugin adds pets in the form of flying heads that follow the player.<\/p>\n","protected":false},"featured_media":79948,"template":"","meta":{"_minecraft_slug":"headpets","_minecraft_project_id":"oA5HFojN","_minecraft_author":"Jorget","_minecraft_license":"MIT","_minecraft_downloads":104,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"headpets.zip","_minecraft_size_bytes":155032,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:36:57.032084Z","_minecraft_date_created":"2026-02-14T23:59:45.662736Z","_minecraft_date_modified":"2026-02-20T02:13:16.120696Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/headpets","_minecraft_icon_attachment_id":79948,"_minecraft_imported_at":"2026-06-04T14:34:23+00:00","_minecraft_import_hash":"ad4d2d571b94019fccb47920383fa132","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,89,122,137,127,128,867,129],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-79947","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-game-mechanics","mod_category-magic","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","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 – permission: `pats.pets.open` (default: true)
\n– `\/pets reload` or `\/petsreload` \u2014 reload config\/lang\/pets (no server restart)
\n – permission: `pats.pets.reload` (default: op)
\n– `\/pets add …` or `\/petadd …` \u2014 add a pet to `config.yml`
\n – permission: `pats.pets.admin` (default: op)
\n– `\/pets remove
\n – permission: `pats.pets.admin` (default: op)<\/p>\n
\n\/petadd head_test eyJ0ZXh0dXJlcyI6… Donkey_Kong
\n“`<\/p>\n
\n\/petadd head_test eyJ0ZXh0dXJlcyI6… \u0414\u043e\u043d\u043a\u0438_\u041a\u043e\u043d\u0433 Donkey_Kong
\n“`<\/p>\n
\n\/petremove head_test
\n“`<\/p>\n
\n– `menu.show-locked-in-all` \u2014 show locked pets in \u201cAll pets\u201d tab.
\n– `menu.gui.*` \u2014 GUI settings (size, button slots, materials, pets grid area).
\n– `follow.*` \u2014 follow distances\/speeds.
\n– `particles.*` \u2014 particles settings (visibility, frequency, `y-offset`, options list).
\n– `effects.*` \u2014 passive effects timing settings.
\n– `pets:` \u2014 pets list (add your own pets here).<\/p>\n
\n– HEX: `&#ff00ff` (example: `&#ff00ffDonkey Kong`)<\/p>\n
\npets:
\n – id: head_118
\n # permission is optional (default: pats.pets.
\n permission: pats.pets.head.118
\n display:
\n ru: “\u0414\u043e\u043d\u043a\u0438 \u041a\u043e\u043d\u0433”
\n en: “Donkey Kong”
\n head:
\n # profile-id is optional
\n profile-name: “mcheads-118”
\n textures: “BASE64_TEXTURES_HERE”
\n effects:
\n – type: SPEED
\n amplifier: 0
\n # shorthand:
\n – “JUMP_BOOST:0”
\n“`<\/p>\n
\n– Active pets are stored in `plugins\/PatsPets\/data.yml` and restored when the player rejoins.
\n– 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`.<\/p>\n","protected":false},"excerpt":{"rendered":"