Camera Obscura (Камера обскура)

Мод для Майнкрафт на Fabric, который добавляет на сервер съёмку фотографий и видео от лица игрока или любого существа. Результат создаётся как карта: снимок можно получить в инвентарь, а запись — включать в рамке; мод работает на стороне сервера и не требует установки у игроков.

Возможности

• Фотографии от первого лица игрока, моба или другой живой сущности.
• Видеокамеры, записывающие мир в виде анимированной карты. Кликните по карте в рамке, чтобы запустить или остановить воспроизведение.
• Сохранение отдельных снимков в PNG в папку config/cameraobscura/renders/.
• Встроенные камеры и видеокамеры с цветным, чёрно-белым, серым и сепийным изображением.
• Настройка разрешения, цветового режима, дизеринга, частоты кадров, длины записи и повтора через компоненты предмета, датапаки, таблицы добычи и собственные рецепты.
• Рендеринг выполняется отдельно от основного потока сервера.

Крафты

Камеры можно добавлять своими рецептами датапака. В результате рецепта укажите предмет camera-obscura:camera и нужные компоненты, например camera-obscura:color, camera-obscura:resolution и camera-obscura:dither.

Для видеокамеры добавьте компонент camera-obscura:video с параметрами frame_rate и max_frames.

Как пользоваться

Держите камеру в основной руке и используйте её: после отсчёта фотография появится в инвентаре, а при заполненном инвентаре выпадет на землю. Для видеокамеры удерживайте использование, чтобы записывать, и отпустите кнопку для завершения; записи сохраняются в config/cameraobscura/camera_videos/.

Основная команда — /camera-obscura.

• /camera-obscura [scale] — сделать карту от своего лица; масштаб 1 соответствует 128×128, можно указать до 3.
• /camera-obscura <entity> <player> [scale] — снять вид выбранной сущности и выдать карту игроку.
• /camera-obscura save [entity] [scale] — сохранить изображение в PNG.
• /camera-obscura give <preset> [player] — выдать камеру из пресета.
• /camera-obscura reload — перечитать основной конфиг и presets.json.
• /camera-obscura clear-cache — очистить кэш ресурсов и моделей.

Для команд требуется право cameraobscura.command; базовый уровень доступа задаётся параметром commandPermissionLevel.

В presets.json можно создать свои камеры на основе любого предмета: задать материал, название, разрешение, цвет, дизеринг и параметры видео. Готовые пресеты включают camera, camcorder, instant, polaroid, pro_camera, handycam и cctv.

Настройки

Основной файл — config/cameraobscura/config.json.

• renderDistance — дальность рендеринга; большее значение увеличивает время обработки.
• renderEntities — показывать на снимке игроков, мобов и рамки.
• fullbright — игнорировать освещение.
• fov — угол обзора камеры.
• biomeBlend — смешивание оттенков биомов.
• ssaa — сглаживание через сверхдискретизацию.
• maxChunkRebuildsPerTick — ограничение перестроения чанков для записей и живых карт.
• cameraConsumesItem и cameraConsumeItem — расходуемый предмет для снимка, например map или paper.
• showSystemMessages и debug — сообщения о съёмке и отладочная информация.

Высокие разрешение, дальность рендеринга, ssaa и частота кадров заметно повышают нагрузку на процессор. Если снимки создаются долго, уменьшите эти значения.

Требования и совместимость

Для Fabric-сервера требуются Fabric API и Polymer. Для камер с нестандартным внешним видом поддерживаются Nexo и ItemsAdder. Карты и записи отображаются у игроков с обычным клиентом Майнкрафт без клиентских модов.