Toby's Camera (Тобис камера)

Мод для Майнкрафт на Fabric, который превращает вид из камеры в сохраняемые фотографии на основе карт. Снимки можно передавать другим игрокам, размещать в рамках и собирать обратно в один фото-мешок; смотреть их смогут и игроки без мода.

Возможности

• Камера открывает видоискатель с приближением, направляющими и настройкой композиции: поворотом, масштабом и соотношением сторон 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 либо произвольным.
• После снимка можно выбрать размер отпечатка и дизеринг Floyd–Steinberg. Сервер выдаёт фото-мешок с превью, именем фотографа, местом и временем снимка.
• Фото-мешок распаковывается в обычные заполненные карты. При установке в рамку изображение автоматически заполняет подходящий прямоугольник из соседних пустых рамок.
• Если сломать любую рамку из такой группы, вся фотография вернётся одним фото-мешком, а не рассыплется на отдельные карты.
• Обычной камере нужна плёнка: на каждую карту в отпечатке тратится одна единица плёнки. Для сервера доступны камеры без расхода плёнки и одноразовые камеры.

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

Камеру можно держать в основной или второй руке. Откройте видоискатель правой кнопкой мыши; если это действие занято, используйте P. Кнопка затвора по умолчанию — левая кнопка мыши, а не атака.

• - / = — отдалить или приблизить изображение;
• G — переключить направляющие: выключены, правило третей, перекрестие;
• R — открыть панель композиции;
• правая кнопка мыши в видоискателе — закрыть его.

Снимок создаётся из того, что фактически отрисовал клиент игрока. После выбора параметров в предпросмотре подтвердите использование фотографии. Чтобы распаковать фото-мешок, удерживайте правую кнопку мыши в воздухе около секунды.

Клавиши можно изменить в меню «Настройки» → «Управление» → TobysCamera. Если затвор не срабатывает, проверьте, что в руке предмет с меткой tobyscamera:camera, панель композиции закрыта, а в камере достаточно плёнки либо она не требуется.

Настройки

Серверные ограничения задаются в plugins/TobysCamera/config.yml:

• camera-tag-key и film-tag-key — метки камеры и плёнки;
• token-ttl-seconds — срок действия токена загрузки;
• rate-limit.per-second и rate-limit.per-minute — лимиты съёмки и загрузки для игрока;
• upload.max-grid-size — максимальная длина стороны отпечатка;
• upload.max-chunks-per-second и upload.max-active-upload-bytes — ограничения скорости и памяти при загрузке.

Клиент сохраняет назначение клавиш, композицию и масштаб в config/tobyscamera/viewfinder.properties.

Для выдачи предметов используйте корневые поля minecraft:custom_data, а не PublicBukkitValues. Основные метки: tobyscamera:camera, tobyscamera:film, tobyscamera:max_grid_size, tobyscamera:no_film_required, tobyscamera:magic_photo.

/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4}]
/give @s minecraft:paper[minecraft:custom_data={"tobyscamera:film":1b}] 64
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:no_film_required":1b}]

После изменения конфига выполните /tobyscamera reload. Для команды требуется право tobyscamera.reload, которое по умолчанию есть у оператора.

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

Фотографу нужен клиентский мод Fabric, а серверу — плагин для Paper или Folia; их выпуски должны совпадать. Готовые фотографии являются обычными картами, поэтому игрокам без мода не требуется клиентская установка: они могут брать, передавать и размещать снимки в рамках.

Плагин читает изображения только у активных предметов и рамок в загруженных чанках; неиспользуемые данные освобождают память, а сохранённые снимки подгружаются с диска без остановки работы сервера.