Camera Obscura

Запечатлейте мир Майнкрафта на фото! 🎮📸

С модом Camera Obscura вы получаете возможность делать снимки вашего игрового мира или сервера и сохранять их в виде карт. Самое главное — для работы на сервере мод не требуется устанавливать на клиенте: всё рендерится прямо на сервере с помощью технологии лучевого трассирования!

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

Мод добавляет в игру предмет "Камера", который внешне и функционально напоминает обычную подзорную трубу, но имеет особое предназначение. При использовании он создаёт карту с видимым пейзажем, потребляя при этом предмет карты (настраивается в конфигурации).

Рецепта создания камеры пока нет — предмет надо получить через творческий режим или команды.

⚙️ Настройки конфигурации

При первом запуске в папке configs/camera-obscura.json появится файл с параметрами:

{
  "renderDistance": 128,
  "showSystemMessages": false,
  "renderEntities": false,
  "renderEntitiesAmount": 20,
  "fullbright": false,
  "fov": 70,
  "biomeBlend": 1,
  "cameraItem": "minecraft:spyglass",
  "cameraConsumesItem": true,
  "cameraConsumeItem": "minecraft:map",
  "commandPermissionLevel": 2
}

• renderDistance — дистанция видимости в блоках
• showSystemMessages — показывать системные сообщения при создании фото (по умолчанию — выкл)
• renderEntities — экспериментальная функция рендеринга существ
• renderEntitiesAmount — количество существ для отрисовки (20 по умолчанию)
• fullbright — игнорировать уровень освещённости
• fov — поле обзора (от 30 до 110)
• biomeBlend — смешивание биомов
• cameraItem — используемый предмет как модель камеры (minecraft:spyglass)
• cameraConsumesItem — тратится ли предмет при съёмке
• cameraConsumeItem — предмет для расхода (minecraft:map)
• commandPermissionLevel — уровень прав для команд (по умолчанию 2)

🎮 Команды управления

Основные команды:

• /camera-obscura — сделать снимок от лица игрока и выдать ему карту
• /camera-obscura <сущность/игрок> <масштаб> — фото от лица указанной сущности, масштаб до 3 (карта 3×3)
• /camera-obscura save — сохранить снимок в PNG в папке renders/ под именем в формате даты
• /camera-obscura save <сущность> <масштаб> — фото сущности с сохранением PNG, масштаб до 10
• /camera-obscura clear-cache — очистить кеш текстур и моделей

Размер изображения по умолчанию — 128×128 пикселей.

🔐 Права доступа

Для системы прав используются стандартные разрешения:

• camera-obscura.command, camera-obscura.command.scale
• camera-obscura.command.entity, camera-obscura.command.entity.scale
• camera-obscura.command.save, camera-obscura.command.save.scale
• camera-obscura.command.save.entity, camera-obscura.command.save.entity.scale
• camera-obscura.clear-cache

⚠️ Известные особенности

Некоторые функции находятся в разработке:

• Рендеринг существ работает медленно и поддерживает не всех
• Жидкости отображаются "блочно"
• Жёсткое освещение
• Портал в Энд и шлюз отображаются чисто чёрными
• Большие модели могут обрезаться
• Сложности с рендерингом при координатах в миллионах

В основе работы — загрузка игровых ассетов с серверов Mojang и рендеринг мира с трассировкой лучей. Результат сохраняется как карта или PNG-изображение.