- Документация
- https://modrinth.com/plugin/citizens-scale
Citizens Scale — небольшой серверный плагин, добавляющий к NPC из Citizens признак ScaleTrait. Через него выбранному персонажу назначается числовой масштаб: NPC можно уменьшить, увеличить или вернуть к обычному размеру. Изменение отображается сразу и сохраняется после перезапуска сервера.
Его задача ограничена размером уже существующих NPC. Он не создаёт персонажей самостоятельно и не заявляет изменения их диалогов, маршрутов, экипировки, поведения или искусственного интеллекта.
Плагин можно использовать для визуального различения персонажей: выделения важного NPC или уменьшения декоративной фигуры.
Подтверждены следующие возможности:
• добавление ScaleTrait к NPC Citizens;
• точная установка коэффициента размера;
• увеличение и уменьшение персонажа;
• мгновенное визуальное обновление;
• сохранение значения между перезапусками;
• совместная работа с другими traits;
• использование стандартного права Citizens на изменение атрибутов.
Исходная основа не подтверждает пакетное масштабирование, автоматическое применение к новым NPC или изменение масштаба по расписанию.
Trait в Citizens представляет характеристику, связанную с конкретным NPC. Citizens Scale добавляет характеристику размера, а её значение, согласно официальному описанию, автоматически сохраняется в базе Citizens.
Масштаб задаётся как свойство выбранного персонажа, поэтому после обычного перезапуска повторно вводить значение не требуется. При этом источник не описывает формат записи, перенос базы, удаление trait или поведение данных после удаления дополнения.
Последовательность использования опирается на Citizens:
• выбрать существующего NPC командой /npc select либо предусмотренным Citizens щелчком правой кнопкой;
• выполнить /npc attribute scale <значение>;
• проверить визуальный результат;
• при необходимости указать другой коэффициент.
Команда применяется к выбранному NPC. В основе нет отдельного синтаксиса для обработки нескольких персонажей, выбора по имени внутри команды масштаба или копирования значения между NPC.
Отдельная команда отмены не указана; возврат к обычному виду выполняется назначением стандартного коэффициента.
Подтверждённый диапазон масштаба — от 0.01 до 15.0. Официальный текст приводит четыре примера:
• /npc attribute scale 2 — двойной размер;
• /npc attribute scale 0.5 — половина обычного размера;
• /npc attribute scale 1.5 — увеличение на 50%;
• /npc attribute scale 0.25 — четверть обычного размера.
Значение 1 соответствует обычному масштабу. Допустимый диапазон не означает, что каждое крайнее значение одинаково удобно для любой модели. В официальных примечаниях отдельно сказано, что очень малый размер способен вызвать проблемы клиентского отображения. Точный порог, кроме нижней границы 0.01, не приведён.
Проект заявлен как совместимый со всеми типами NPC Citizens и другими traits. Однако источник не раскрывает результаты для каждой комбинации. Нет подтверждённых сведений о влиянии размера на:
• хитбокс и коллизию;
• дистанцию взаимодействия;
• анимации и посадку;
• броню и предметы в руках;
• навигацию NPC;
• поведение сторонних traits.
Поэтому визуальное изменение нельзя автоматически считать пропорциональным изменением всех игровых механик. Проверять следует именно те типы NPC и сочетания traits, которые используются на сервере.
Подтверждены Paper, Purpur и Spigot, а также Minecraft 1.21–1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Клиентская сторона — unsupported, серверная — required.
В выбранных метаданных обязательные project dependencies не указаны. Одновременно официальное название, назначение, команда и раздел требований прямо связывают дополнение с Citizens и предписывают сначала установить Citizens. Поэтому Citizens следует считать функциональной основой, даже если отдельное поле зависимостей в карточке пусто.
Точная версия Citizens не приведена. Иные обязательные компоненты не подтверждены.
Подтверждённый способ установки — поместить CitizensScale-1.0.0.jar в папку plugins совместимого сервера, на котором уже работает Citizens.
Для изменения атрибутов используется стандартное право:
• citizens.npc.attribute — разрешение на изменение атрибутов NPC.
Отдельное право только для масштаба не указано. Права выбора NPC относятся к Citizens и здесь не раскрыты.
Практическая первичная проверка:
• убедиться, что Citizens загружен;
• сверить JAR по имени, размеру и хешам;
• поместить файл в plugins;
• выбрать тестового NPC;
• назначить умеренное значение;
• проверить мгновенное отображение;
• выполнить обычный перезапуск;
• убедиться, что масштаб сохранился.
Динамический запуск в рамках исходной проверки не выполнялся.
Для внедрения лучше начинать с коэффициентов, близких к 1, и менять по одному персонажу.
Рабочий список проверки:
• записать исходное и новое значение;
• осмотреть NPC с разных расстояний;
• проверить его в реальном месте размещения;
• проверить взаимодействие, используемое на сервере;
• проверить уже назначенные traits;
• избегать крайних малых значений без теста;
• повторно осмотреть NPC после перезапуска;
• сохранить перечень изменённых персонажей.
Предоставлен один файл: CitizensScale-1.0.0.jar, версия 1.0.0, размер 4 406 байт. SHA-512: 55902ffb886416f5fcc0b20bcc6fd55cdf03d599e7745c6de6d95258365e364be8367651b1a79bc3ac23e9267735c8e5fd860b8e23ccbbf084cc0b47811c5596. SHA-1: 358008c41651664da4566796051db50a3683d849.
Лицензия проекта — MIT. Файл получен по официальному HTTPS, локально сверён по опубликованным хешам и прошёл статическую проверку структуры и путей. Малый размер JAR сам по себе не доказывает безопасность или минимальную нагрузку. Динамический запуск, измерение производительности и полный аудит кода не выполнялись.
В основе нет сведений о резервном копировании, миграции между серверами, удалении сохранённого масштаба, обработке неверных чисел, локализации, пакетных операциях и поведении без Citizens. Также не описано, как размер влияет на хитбокс, физику, взаимодействие и сторонние traits.
Citizens Scale добавляет сохраняемый числовой масштаб выбранным NPC Citizens и использует стандартное право изменения атрибутов. Остальные аспекты требуют проверки на конкретной сборке.
Самостоятельная работа не подтверждена. Официальное описание прямо называет Citizens основой, несмотря на отсутствие обязательной зависимости в выбранном поле метаданных.
Следует назначить коэффициент 1. Отдельная команда сброса в источнике не указана.
Да. Это прямо заявлено, а данные описаны как автоматически сохраняемые в базе Citizens. Перенос между серверами и версиями отдельно не подтверждён.
Официальные примечания предупреждают о возможных проблемах клиентского рендеринга при очень малом масштабе. Более точный безопасный порог не установлен.
Его задача ограничена размером уже существующих NPC. Он не создаёт персонажей самостоятельно и не заявляет изменения их диалогов, маршрутов, экипировки, поведения или искусственного интеллекта.
Назначение и подтверждённые функции
Плагин можно использовать для визуального различения персонажей: выделения важного NPC или уменьшения декоративной фигуры.
Подтверждены следующие возможности:
• добавление ScaleTrait к NPC Citizens;
• точная установка коэффициента размера;
• увеличение и уменьшение персонажа;
• мгновенное визуальное обновление;
• сохранение значения между перезапусками;
• совместная работа с другими traits;
• использование стандартного права Citizens на изменение атрибутов.
Исходная основа не подтверждает пакетное масштабирование, автоматическое применение к новым NPC или изменение масштаба по расписанию.
Скриншоты и внешний вид
Как работает ScaleTrait
Trait в Citizens представляет характеристику, связанную с конкретным NPC. Citizens Scale добавляет характеристику размера, а её значение, согласно официальному описанию, автоматически сохраняется в базе Citizens.
Масштаб задаётся как свойство выбранного персонажа, поэтому после обычного перезапуска повторно вводить значение не требуется. При этом источник не описывает формат записи, перенос базы, удаление trait или поведение данных после удаления дополнения.
Выбор NPC и основная команда
Последовательность использования опирается на Citizens:
• выбрать существующего NPC командой /npc select либо предусмотренным Citizens щелчком правой кнопкой;
• выполнить /npc attribute scale <значение>;
• проверить визуальный результат;
• при необходимости указать другой коэффициент.
Команда применяется к выбранному NPC. В основе нет отдельного синтаксиса для обработки нескольких персонажей, выбора по имени внутри команды масштаба или копирования значения между NPC.
Отдельная команда отмены не указана; возврат к обычному виду выполняется назначением стандартного коэффициента.
Диапазон и примеры значений
Подтверждённый диапазон масштаба — от 0.01 до 15.0. Официальный текст приводит четыре примера:
• /npc attribute scale 2 — двойной размер;
• /npc attribute scale 0.5 — половина обычного размера;
• /npc attribute scale 1.5 — увеличение на 50%;
• /npc attribute scale 0.25 — четверть обычного размера.
Значение 1 соответствует обычному масштабу. Допустимый диапазон не означает, что каждое крайнее значение одинаково удобно для любой модели. В официальных примечаниях отдельно сказано, что очень малый размер способен вызвать проблемы клиентского отображения. Точный порог, кроме нижней границы 0.01, не приведён.
Совместимость с NPC и другими traits
Проект заявлен как совместимый со всеми типами NPC Citizens и другими traits. Однако источник не раскрывает результаты для каждой комбинации. Нет подтверждённых сведений о влиянии размера на:
• хитбокс и коллизию;
• дистанцию взаимодействия;
• анимации и посадку;
• броню и предметы в руках;
• навигацию NPC;
• поведение сторонних traits.
Поэтому визуальное изменение нельзя автоматически считать пропорциональным изменением всех игровых механик. Проверять следует именно те типы NPC и сочетания traits, которые используются на сервере.
Citizens, версии и платформы
Подтверждены Paper, Purpur и Spigot, а также Minecraft 1.21–1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Клиентская сторона — unsupported, серверная — required.
В выбранных метаданных обязательные project dependencies не указаны. Одновременно официальное название, назначение, команда и раздел требований прямо связывают дополнение с Citizens и предписывают сначала установить Citizens. Поэтому Citizens следует считать функциональной основой, даже если отдельное поле зависимостей в карточке пусто.
Точная версия Citizens не приведена. Иные обязательные компоненты не подтверждены.
Установка и права доступа
Подтверждённый способ установки — поместить CitizensScale-1.0.0.jar в папку plugins совместимого сервера, на котором уже работает Citizens.
Для изменения атрибутов используется стандартное право:
• citizens.npc.attribute — разрешение на изменение атрибутов NPC.
Отдельное право только для масштаба не указано. Права выбора NPC относятся к Citizens и здесь не раскрыты.
Практическая первичная проверка:
• убедиться, что Citizens загружен;
• сверить JAR по имени, размеру и хешам;
• поместить файл в plugins;
• выбрать тестового NPC;
• назначить умеренное значение;
• проверить мгновенное отображение;
• выполнить обычный перезапуск;
• убедиться, что масштаб сохранился.
Динамический запуск в рамках исходной проверки не выполнялся.
Практическое применение
Для внедрения лучше начинать с коэффициентов, близких к 1, и менять по одному персонажу.
Рабочий список проверки:
• записать исходное и новое значение;
• осмотреть NPC с разных расстояний;
• проверить его в реальном месте размещения;
• проверить взаимодействие, используемое на сервере;
• проверить уже назначенные traits;
• избегать крайних малых значений без теста;
• повторно осмотреть NPC после перезапуска;
• сохранить перечень изменённых персонажей.
Файл, лицензия и проверка
Предоставлен один файл: CitizensScale-1.0.0.jar, версия 1.0.0, размер 4 406 байт. SHA-512: 55902ffb886416f5fcc0b20bcc6fd55cdf03d599e7745c6de6d95258365e364be8367651b1a79bc3ac23e9267735c8e5fd860b8e23ccbbf084cc0b47811c5596. SHA-1: 358008c41651664da4566796051db50a3683d849.
Лицензия проекта — MIT. Файл получен по официальному HTTPS, локально сверён по опубликованным хешам и прошёл статическую проверку структуры и путей. Малый размер JAR сам по себе не доказывает безопасность или минимальную нагрузку. Динамический запуск, измерение производительности и полный аудит кода не выполнялись.
Что не подтверждено источником
В основе нет сведений о резервном копировании, миграции между серверами, удалении сохранённого масштаба, обработке неверных чисел, локализации, пакетных операциях и поведении без Citizens. Также не описано, как размер влияет на хитбокс, физику, взаимодействие и сторонние traits.
Citizens Scale добавляет сохраняемый числовой масштаб выбранным NPC Citizens и использует стандартное право изменения атрибутов. Остальные аспекты требуют проверки на конкретной сборке.
FAQ
Можно ли использовать Citizens Scale без Citizens?
Самостоятельная работа не подтверждена. Официальное описание прямо называет Citizens основой, несмотря на отсутствие обязательной зависимости в выбранном поле метаданных.
Как вернуть обычный размер?
Следует назначить коэффициент 1. Отдельная команда сброса в источнике не указана.
Сохраняется ли значение после перезапуска?
Да. Это прямо заявлено, а данные описаны как автоматически сохраняемые в базе Citizens. Перенос между серверами и версиями отдельно не подтверждён.
Почему очень маленький NPC может отображаться неправильно?
Официальные примечания предупреждают о возможных проблемах клиентского рендеринга при очень малом масштабе. Более точный безопасный порог не установлен.
