Lib39

Lib39 — это свободный набор утилит, миксинов, событий и т.д., происходящий из нашего контентного мода Yttr — люди постоянно говорят о «краже» миксинов из Yttr, так как в нём так много случайных полезных вещей, поэтому мы решили, что будет хорошо выделить это в библиотеку.

39 — атомный номер иттрия. Можете произносить как «lib thirty nine», «lib three nine», «lib miku», как угодно.

Начало работы

Lib39 распространяется на Sleeping Town Maven. Добавьте следующее в ваш build.gradle:

repositories {
    maven {
        url 'https://repo.sleeping.town'
        content {
            includeGroup 'com.unascribed'
        }
    }
}

dependencies {
    modApi include("com.unascribed:lib39-core:2.0.7+1.20.1")
    // put any other modules you want here
    // loom won't JiJ transitive deps, so you need to include all of them
}

Lib39 также распространяется на Modrinth, но мы настоятельно рекомендуем JiJ-ить модули. Они маленькие.

Замените core на нужный вам модуль (или модули).

Lib39 1.4 и более ранние поддерживают только 1.19-1.19.2. Lib39 1.5 добавляет поддержку 1.18.2 и 1.19.3, а серия «экспериментальных» сборок обеспечивает поддержку 1.20.1. Lib39 2.0 API-совместим с 1.x и в настоящее время доступен только для 1.20.1, разрабатывается в тандеме с Yttr.

Модули

• Core
  Разные утилитарные классы, такие как AutoRegistry, AutoMixin, и общие классы с другими модулями. Также содержит разные мелкие штуки, например звуки крафта.
• Lockpick
  Миксины, позволяющие убрать искусственные ограничения, такие как углы поворота моделей, размеры рецептов крафта и многое другое. Также разные связанные утилиты, например возможность наследовать элементы от родительских моделей.
• Ripple
  Позволяет настраивать сплэш-тексты.
• Tunnel
  Добавляет удобную сетевую систему на основе Concrete Network из 1.12.
• Phantom
  Добавляет возможность временно «выфазировать» блоки из мира. Блоки никогда не удаляются из мира, просто скрываются.
• Waypoint
  Добавляет дополнительный запечённый слой мира с аддитивным смешиванием для отрисовки различных видов светящихся эффектов.
• Weld
  Добавляет систему «больших блоков» для создания «префаб»-блоков вроде ванильных кроватей, но гораздо приятнее и теоретически без ограничений по размеру.
• Sandman
  Добавляет возможность делать предметы «всегда тикающими», используя случайные тики.
• Crowbar
  Добавляет события для низкоуровневых фаз генерации мира, таких как построение surface rules, и сырой доступ к чанкам во время фаз surface и population для вызова кастомных генераторов.
• Keygen
  Добавляет возможность загружать музыку в форматах XM, S3M и MOD через IBXM2.
• Dessicant
  Реализует «логические значения по умолчанию» для таблиц лута и автоматически управляет разблокировкой рецептов на основе ключа «discovered_by» в JSON рецептов. Blockstates и модели блоков/предметов скоро.
• Machination
  Добавляет новые типы рецептов, такие как рецепт «замачивания» для бросания предметов в жидкость и рецепт «разбивания» для дробления блока между двумя другими с помощью поршня. Идёт с поддержкой EMI.
• Recoil
  События, позволяющие вмешиваться в камеру и FOV, и способ подавить ванильное поведение и перехватить сырые атаку/использование. Всё, что нужно для создания приятного мода на оружие, по сути.
• Util
  Разные утилитарные классы. Документации пока нет.
• AQI
  Исправляет ванильную отрисовку частиц за полупрозрачными блоками на графике Fancy/Fast, отрисовывая в два прохода, как до 1.14.
• Mesh
  Добавляет эффективную графовую систему сетей блоков, для труб и подобного. Документации пока нет.
• Wrangle
  Добавляет систему «подсказок управления». Документации пока нет.

Бывшие модули

• Fractal
  Добавляет систему «подгрупп» для ещё более дробного разделения творческих вкладок. Теперь поддерживается DaFuqs как отдельная библиотека.

Будущие модули

В Yttr много странных миксинов и утилит, и я бы тут надолго застрял, если бы выносил их все сразу. Вот что я хочу выделить, но пока не собрался:

• Equivalence
  Добавляет систему «заменителей», позволяющую делать предметы функционально одинаковыми с другими в ингредиентах рецептов и тегах.
• Conflagration
  Добавляет систему конфигурации на основе CSS и фреймворк для создания GUI, взаимодействующих с ней.