CC: Sable

Мод CC: Sable для Minecraft 1.21.1

CC: Sable — это дополнение к экосистеме CC: Tweaked, предназначенное для работы с бэкендом Sable в модификации Create: Simulated!. Мод предоставляет расширенные API для взаимодействия с компьютерами игры, позволяя получать детальную информацию о физике объектов и аэродинамике. Также он включает утилиты для работы с математикой и добавляет новые параметры к данным блоков, которые могут использоваться черепашками (turtles) для более точного моделирования поведения материалов.

Основная функциональность и API

Главная цель мода — предоставить доступ к специфическим данным через Lua-скрипты. Мод добавляет два ключевых интерфейса для всех компьютеров в игре: API субуровней (sublevel) и API аэродинамики (aero, aerodynamics).

Методы API sublevel работают корректно только тогда, когда компьютер физически расположен на объекте субуровня (Sub-Level), который является частью физически моделируемого мира. Это позволяет скриптам получать точную информацию о текущем состоянии и параметрах этого физического уровня.

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

Математические утилиты

В комплект поставки включен датапак CC: Advanced Math, который расширяет возможности Lua-программирования. Особое внимание уделено модулю quaternion, предназначенному для работы с вращениями в трехмерном пространстве.

Этот инструмент критически важен для конвертации ориентации субуровней в формат, удобный для обработки в скриптах. Использование кватернионов позволяет избежать проблем, связанных с гирроскопическим эффектом (gimbal lock), при расчете сложных вращений физических объектов.

Детализация аэродинамических расчетов

Для работы с аэродинамикой в модуле используются кривые Безье. Объект LuaBezierResourceFunction доступен через методы aero.getRaw и aero.getDefault (в частности, через ключ pressureFunction).

Доступны два основных метода для работы с этими кривыми:

• getPoints(): возвращает таблицу точек, описывающих кривую. Каждая точка содержит поля altitude (высота), value (значение параметра) и slope (наклон).
• evaluateFunction(altitude: number): позволяет вычислить значение функции для заданной высоты вдоль кривой Безье.

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

Расширенные данные блоков для черепашек

Мод добавляет к стандартным данным блоков набор физических свойств, доступных через методы инспекции черепашек (например, turtle.inspect()). Новая информация доступна в объекте данных под ключом sable и включает параметры, необходимые для точного моделирования взаимодействия с материалами:

• Базовые свойства: mass (масса), friction (трение), restitution (упругость отскока), volume (объем).
• Параметры плавучести: floatingScale, floatingMaterial (включая коэффициенты трения для горизонтального и вертикального движения, скорость подъема, силу подъема и возможность предотвращения собственного подъема).
• Динамика: transitionSpeed, scaleWithGravity, scaleWithPressure.

Данные о трении разделяются на фактические (factHorizontalFriction, factVerticalFriction) и замедленные (slowHorizontalFriction, slowVerticalFriction), что позволяет создавать более реалистичные механики движения объектов по поверхностям.

Структура архива

Файл распространения — это стандартный .jar архив, содержащий 40 файлов. В сборку включены миксины для интеграции с основной платформой. Размер архива составляет около 43 КБ, а распакованный объем файлов превышает 133 КБ. Архив не содержит встроенных JAR-файлов.