KitsuScale - realistic height in the game.

---

🇺🇲 EN:

This is a simple and convenient plugin that allows players to change their character's height using commands or special items. All values are set in real centimeters and fully correspond to the player model's height in the game.

No arbitrary units, no abstract scale. Just honest centimeters, just like in real life.

---

🎮 Commands

| Command | Description | | --- | --- | | `/height` | Opens a beautiful interactive chat menu with `[✔ Enter]` and `[✖ Default]` buttons to easily manage your height. | | `/height [number]` | Sets your own height. Example: `/height 175` | | `/height set [player] [number]` | Sets another player's height (requires permissions). Example: `/height set Steve 190` | | `/height skip` | Resets your height to the default value set in the config. | | `/height give [player] [amount]` | Gives the player a specified amount of Magic Cookies (from 1 to 64). |

---

🍪 The Magic Cookie

In addition to commands, players can change their height using a custom item — the Magic Cookie. It features its own lore, a gradient name, and uses a hidden tag so the plugin doesn't confuse it with ordinary food.

* Crafting: Players consume the cookie with vanilla animations and crunch sounds. Thanks to new mechanics, it can be eaten even if the food bar is completely full. * Crafting: Eating the cookie randomly changes the player's height (e.g., between 60 and 350 cm) for a configured duration, after which their height returns to normal. * Crafting: You can set a dedicated cooldown to prevent spam, and apply `CustomModelData` to give it a unique texture via resource packs. * Crafting: Players can craft the cookie using a custom shaped recipe (1 Cookie in the center + 4 Suspicious Stews on the sides). The recipe can be toggled in the config.

---

🔧 How it works

* After entering a command or eating a cookie, the character model and camera height change instantly. * Visuals & Sounds: * All changes are saved and remain until the next height change. * The `/height skip` command resets to the default height, which can be configured in the configuration file. * Visuals & Sounds: Height changes are accompanied by a custom particle cloud (e.g., `happy_villager`) and a level-up sound. The sound plays smartly—only upon active changes, remaining silent during logins or respawns.

---

⚙️ Flexible config

The plugin comes with a convenient configuration file that you can edit to suit your needs:

* Smart Color Parser — the value given by the `/height skip` command and to new players by default. * Smart Color Parser — limits for commands. * Smart Color Parser — you can completely translate all plugin messages into your language (English, German, French, etc.). * Smart Color Parser — fully supports HEX colors and perfectly parses `<gradient>` tags without breaking them.

```yaml

======================================================== #

KitsuScale Settings #

======================================================== #

settings: min-height: 145 max-height: 210 default-height: 200

Height change cooldown (in minutes)

cooldown-minutes: 15

features:

Placeholder %kitsuscale_height% support

placeholder-api: true

Sound effect when height changes

play-sound: true sound-name: "entity.player.levelup"

Particle effects when height changes

play-particles: true particle-type: "happy_villager"

======================================================== #

Magic Item Settings #

======================================================== #

magic-item:

Random height range when used

min-height: 60 max-height: 350

Effect duration in seconds

duration-seconds: 60

Cooldown between eating cookies (in seconds)

cooldown-seconds: 120

Item type

material: "COOKIE"

Resource pack tag (CustomModelData). 0 = disabled

custom-model-data: 0 craft-enabled: true

name: "<gradient:#FFD1FF:#D65FBE>✨ Magic Cookie</gradient>" lore: - "" - "#FFE385Changes your height to a random value" - "#FFE385between #A8E6CF%min%-%max% cm#FFE385!" - "" - "#FFB3BA⚠ Lasts %time% sec."

======================================================== #

Messages Settings #

======================================================== #

messages:

Plugin messages prefix

prefix: "<gradient:#FFB5A7:#FFD1FF>✦ KitsuScale ✦</gradient> #FFE385» #FFFFFF"

==============================================

Interactive chat menu

==============================================

prompt-text: "#FFE385Please enter your height: " btn-input: "#A8E6CF[✔ Enter] #FFFFFF" btn-input-hover: "#FFFFFFClick to enter heightn#FFE385Allowed: #A8E6CF%min% #FFE385- #A8E6CF%max% #FFE385cm" btn-skip: "#FFB3BA[✖ Default]" btn-skip-hover: "#FFFFFFClick to skipn#FFE385Your height will be set to: #FFB3BA%default% #FFE385cm #D0D0D0(2 blocks)"

==============================================

System notifications and errors

==============================================

only-players: "#FFB3BA✖ #FFFFFFThis command is only available to players." no-permission: "#FFB3BA✖ #FFFFFFYou don't have permission to use this command." usage: "#FFE385⚠ #FFFFFFUsage: #A8E6CF/height <%min%-%max%> #FFFFFFor #A8E6CF/height skip" invalid-number: "#FFB3BA✖ #FFFFFFPlease enter a valid number!" out-of-bounds: "#FFB3BA✖ #FFFFFFYour height must be between #A8E6CF%min% #FFFFFFand #A8E6CF%max% #FFFFFFcm!" cooldown: "#FFE385⚠ #FFFFFFHeight change available in: #D65FBE%time%"

success: "#A8E6CF✔ #FFFFFFYour height has been successfully changed to #68ACEC%height% #FFFFFFcm." reload: "#A8E6CF✔ #FFFFFFPlugin configuration has been successfully reloaded!"

==============================================

Admin and item notifications

==============================================

admin-usage: "#FFE385⚠ #FFFFFFUsage: #A8E6CF/height set <player> <height>" player-not-found: "#FFB3BA✖ #FFFFFFPlayer not found or is currently offline." admin-success: "#A8E6CF✔ #FFFFFFYou set height to #68ACEC%height% #FFFFFFcm for player #D65FBE%player%#FFFFFF." target-success: "#A8E6CF✔ #FFFFFFAn administrator changed your height to #68ACEC%height% #FFFFFFcm."

item-give: "#A8E6CF✔ #FFFFFFYou gave #FFE385Magic Cookie #FFFFFFto player #D65FBE%player%#FFFFFF." item-use: "<gradient:#D65FBE:#FFD1FF>✨ Magic worked! Your temporary height: %height% cm.</gradient>" item-back: "#FFE385⚠ #FFFFFFThe magic has worn off, your height has returned to normal." cookie-cooldown: "#FFE385⚠ #FFFFFFMagic will be available in: #D65FBE%time% sec."

```

---

🛡 Permissions

| Permission | Description | | --- | --- | | `kitsuscale.reload` | Access to `/height reload` command to reload the config without restarting the server. | | `kitsuscale.admin` | Access to `/height set` and `/height give` commands. Allows changing other players' heights. | | `kitsuscale.bypass` | Allows ignoring the 15-minute cooldown when changing your own height. |

---

🎯 Perfect for

* Roleplay (RP) servers * Realistic gameplay setups * Friendly servers where players want to look like in real life * Any project where visual comfort and customization matter

---

The plugin is lightweight, doesn't burden the server, supports PlaceholderAPI (`%kitsuscale_height%`), and is easy to configure for any purpose.

---

🇷🇺 RU:

Это простой и удобный плагин, который позволяет игрокам менять рост своего персонажа с помощью команд или специальных предметов. Все значения задаются в реальных сантиметрах и полностью соответствуют высоте модели игрока в игре.

Никаких условных единиц, никакой абстрактной шкалы. Только честные сантиметры, как в реальной жизни.

---

🎮 Команды

| Команда | Описание | | --- | --- | | `/height` | Открывает красивое интерактивное меню в чате с кнопками `[✔ Ввести]` и `[✖ Стандарт]` для удобной настройки роста. | | `/height [число]` | Устанавливает ваш собственный рост. Пример: `/height 175` | | `/height set [ник] [число]` | Устанавливает рост другому игроку (требуются права). Пример: `/height set Steve 190` | | `/height skip` | Сбрасывает ваш рост до стандартного значения, заданного в конфиге. | | `/height give [ник] [кол-во]` | Выдает игроку указанное количество магического печенья (от 1 до 64 штук за раз). |

---

🍪 Магическое печенье

Помимо команд, игроки могут менять рост с помощью кастомного предмета — Магического печенья. Оно имеет собственный лор, название с градиентами и невидимый тег, благодаря которому плагин не путает его с обычной едой.

* Крафт: Игрок съедает печеньку с ванильной анимацией и звуком хруста. Благодаря новым механикам, съесть её можно даже с полностью заполненной полоской голода. * Крафт: При поедании рост меняется на случайный (в заданном диапазоне, например, от 60 до 350 см) на определенное время, после чего возвращается в норму. * Крафт: Можно настроить кулдаун на поедание, чтобы избежать спама, а также задать `CustomModelData` для установки уникальной текстуры через ресурспак. * Крафт: Печенье можно скрафтить (фигурный рецепт: печенье в центре + 4 загадочных рагу по бокам). Рецепт легко включается и выключается в конфиге.

---

🔧 Как это работает

* После ввода команды или поедания печенья модель персонажа и высота камеры мгновенно меняются. * Эффекты: * Все изменения сохраняются и действуют до следующей смены роста. * Команда `/height skip` возвращает стандартный рост, который можно настроить в конфигурационном файле. * Эффекты: Смена роста сопровождается красивым облаком частиц (по умолчанию `happy_villager`) и звуком. Звук воспроизводится «умно» — только при активной смене роста, оставаясь тихим при заходе на сервер или возрождении.

---

⚙️ Гибкий конфиг

Плагин поставляется с удобным конфигурационным файлом, который вы можете редактировать под свои нужды:

* Умный парсер цветов — значение, которое выдаётся по команде `/height skip` и новым игрокам по умолчанию. * Умный парсер цветов — ограничения для команд. * Умный парсер цветов — вы можете полностью перевести все сообщения плагина на свой язык (русский, английский, украинский и т.д.). * Умный парсер цветов — полностью поддерживает HEX-цвета и идеально отображает теги `<gradient>`, ничего не ломая.

```yaml

======================================================== #

Настройки KitsuScale #

======================================================== #

settings: min-height: 145 max-height: 210 default-height: 200

Задержка на смену роста (в минутах)

cooldown-minutes: 15

features:

Поддержка плейсхолдера %kitsuscale_height%

placeholder-api: true

Звуковой эффект при изменении роста

play-sound: true sound-name: "entity.player.levelup"

Эффекты частиц при смене роста

play-particles: true particle-type: "happy_villager"

======================================================== #

Настройки волшебного предмета #

======================================================== #

magic-item:

Диапазон случайного роста при использовании

min-height: 60 max-height: 350

Длительность эффекта в секундах

duration-seconds: 60

Перезарядка между поеданием печенек (в секундах)

cooldown-seconds: 120

Тип предмета

material: "COOKIE"

Тег для ресурспака (CustomModelData). 0 = выключено

custom-model-data: 0 craft-enabled: true

name: "<gradient:#FFD1FF:#D65FBE>✨ Волшебное печенье</gradient>" lore: - "" - "#FFE385Меняет ваш рост на случайный" - "#FFE385в пределах #A8E6CF%min%-%max% см#FFE385!" - "" - "#FFB3BA⚠ Действует ровно %time% сек."

======================================================== #

Настройка сообщений #

======================================================== #

messages:

Префикс сообщений плагина

prefix: "<gradient:#FFB5A7:#FFD1FF>✦ KitsuScale ✦</gradient> #FFE385» #FFFFFF"

==============================================

Интерактивное меню в чате

==============================================

prompt-text: "#FFE385Пожалуйста, укажите ваш рост: " btn-input: "#A8E6CF[✔ Ввести] #FFFFFF" btn-input-hover: "#FFFFFFНажмите, чтобы ввести ростn#FFE385Допустимо: #A8E6CF%min% #FFE385- #A8E6CF%max% #FFE385см" btn-skip: "#FFB3BA[✖ Стандарт]" btn-skip-hover: "#FFFFFFНажмите, чтобы пропуститьn#FFE385Будет установлен рост: #FFB3BA%default% #FFE385см #D0D0D0(2 блока)"

==============================================

Системные уведомления и ошибки

==============================================

only-players: "#FFB3BA✖ #FFFFFFЭта команда доступна только игрокам." no-permission: "#FFB3BA✖ #FFFFFFУ вас нет прав для использования этой команды." usage: "#FFE385⚠ #FFFFFFИспользование: #A8E6CF/height <%min%-%max%> #FFFFFFили #A8E6CF/height skip" invalid-number: "#FFB3BA✖ #FFFFFFПожалуйста, введите корректное число!" out-of-bounds: "#FFB3BA✖ #FFFFFFВаш рост должен быть от #A8E6CF%min% #FFFFFFдо #A8E6CF%max% #FFFFFFсм!" cooldown: "#FFE385⚠ #FFFFFFСмена роста будет доступна через: #D65FBE%time%"

success: "#A8E6CF✔ #FFFFFFВаш рост успешно изменен на #68ACEC%height% #FFFFFFсм." reload: "#A8E6CF✔ #FFFFFFКонфигурация плагина успешно обновлена!"

==============================================

Уведомления для администрации и предметов

==============================================

admin-usage: "#FFE385⚠ #FFFFFFИспользование: #A8E6CF/height set <игрок> <рост>" player-not-found: "#FFB3BA✖ #FFFFFFИгрок не найден или сейчас не в сети." admin-success: "#A8E6CF✔ #FFFFFFВы установили рост #68ACEC%height% #FFFFFFсм для игрока #D65FBE%player%#FFFFFF." target-success: "#A8E6CF✔ #FFFFFFАдминистратор изменил ваш рост на #68ACEC%height% #FFFFFFсм."

item-give: "#A8E6CF✔ #FFFFFFВы выдали #FFE385Волшебное печенье #FFFFFFигроку #D65FBE%player%#FFFFFF." item-use: "<gradient:#D65FBE:#FFD1FF>✨ Магия сработала! Ваш временный рост: %height% см.</gradient>" item-back: "#FFE385⚠ #FFFFFFДействие магии закончилось, ваш рост вернулся в норму." cookie-cooldown: "#FFE385⚠ #FFFFFFМагию можно будет использовать через: #D65FBE%time% сек."

```

---

🛡 Права доступа (Permissions)

| Право | Описание | | --- | --- | | `kitsuscale.reload` | Доступ к команде `/height reload` для обновления конфига без перезагрузки сервера. | | `kitsuscale.admin` | Доступ к командам `/height set` и `/height give`. Позволяет менять рост другим людям. | | `kitsuscale.bypass` | Позволяет игнорировать задержку (cooldown) при смене собственного роста. |

---

🎯 Идеально подходит для

* Ролевых серверов (RP) * Реалистичных сборок * Дружеских серверов, где игроки хотят выглядеть как в реальной жизни * Любых проектов, где важен визуальный комфорт и кастомизация

---

Плагин лёгкий, не нагружает сервер, полностью поддерживает PlaceholderAPI (`%kitsuscale_height%`) и легко настраивается под любые задачи.