---

🇺🇲 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.

• Immersive Eating: 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.
• Temporary Effect: 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.
• Customization: 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.
• If you set your height to 175 — your character will be exactly 175 cm in the game.
• 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:

• Default height — the value given by the /height skip command and to new players by default.
• Minimum and maximum height — limits for commands.
• Full message customization — 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.

# ======================================================== #
#                  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 height\n#FFE385Allowed: #A8E6CF%min% #FFE385- #A8E6CF%max% #FFE385cm"
  btn-skip: "#FFB3BA[✖ Default]"
  btn-skip-hover: "#FFFFFFClick to skip\n#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 загадочных рагу по бокам). Рецепт легко включается и выключается в конфиге.

---

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

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

---

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

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

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

# ======================================================== #
#                  Настройки 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%) и легко настраивается под любые задачи.