Toby's Camera

TobysCamera

Превратите мир Minecraft перед собой в постоянные, доступные для обмена фотокарты.

Только фотографу нужен клиентский мод для Fabric. На сервере работает плагин для Paper/Folia, а готовые медиа выдаются как ванильные предметы filled_map, которые любой игрок может просматривать, держать, обменивать и размещать в рамках для предметов.

Поддерживает клиенты Fabric 1.21.11 / 26.1 / 26.2 и серверы Paper или Folia 1.21.11+.

Держите клиентский мод и серверный плагин на одной версии TobysCamera. Старые клиенты получают явный отказ для неподдерживаемых пакетов камеры.

Для игроков

Перед началом

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

Затвор по умолчанию — левая кнопка мыши, а не клавиша атаки. Любую привязку можно изменить в разделе Настройки → Управление → TobysCamera.

Сделать фото

1. Возьмите камеру и нажмите правой кнопкой мыши, чтобы открыть видоискатель.
2. Настройте кадр с помощью зума, направляющих и панели композиции. Панель поддерживает поворот, соотношение сторон, зум и направляющие; используйте 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 или введите своё соотношение.
3. Нажмите затвор. Клиент захватывает отрисованный мир и открывает предпросмотр.
4. Выберите размер отпечатка и используйте ли дизеринг Флойда–Стейнберга, затем нажмите Использовать фото. Нажмите Переснять, чтобы вернуться к видоискателю.
5. После того как сервер примет и сохранит загрузку, вы получите сумку с фото, содержащую предпросмотр, а также метаданные о фотографе, месте и времени.

Используйте сумку с фото одним из следующих способов:

• Удерживайте правую кнопку мыши около одной секунды в воздухе, чтобы распаковать её в ванильные фрагменты карты.
• Нажмите правой кнопкой мыши по пустой рамке для предметов. Если ближайшие пустые рамки образуют прямоугольник нужного размера и ориентации, всё изображение разместится сразу.
• Сломайте любую рамку в этой размещённой группе, чтобы вернуть всё изображение одной сумкой с фото, а не отдельными фрагментами.

FAQ

Почему затвор не работает? Убедитесь, что вы всё ещё держите предмет с меткой tobyscamera:camera, панель композиции закрыта, а в камере достаточно плёнки — или она не требует плёнки.

Нужен ли другим игрокам клиентский мод? Нет. Они получают и используют ванильные карты; клиентский мод нужен только фотографу.

Для администраторов серверов

Установка

1. Поместите `tobyscamera-plugin-.jarв директориюplugins/` сервера Paper или Folia и запустите сервер один раз.
2. Выдайте фотографам клиентский JAR для Fabric, соответствующий их версии Minecraft.
3. Отредактируйте plugins/TobysCamera/config.yml по необходимости, затем выполните /tobyscamera reload.

/tobyscamera reload требует tobyscamera.reload (по умолчанию для OP). Он перезагружает лимиты для последующих загрузок, не затрагивая сохранённые фото или подключения к базе данных.

Выдача камер и плёнки

TobysCamera читает корневые поля minecraft:custom_data предмета; он не читает Bukkit PDC. Записывайте ключи tobyscamera:* напрямую и не помещайте их внутрь PublicBukkitValues.

Следующие команды используют ключи по умолчанию и могут быть выполнены из консоли или игроком с соответствующими правами:

# Базовая камера: отпечаток до карты 4×4; изначально без плёнки
/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}]

# Одноразовая магическая камера: расходует одну камеру при начале допустимой загрузки фото; плёнка не требуется
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:magic_photo":1b}]

Загрузка плёнки помещает её в камеру и обновляет её описание. Один снимок стоит одну плёнку за конечный тайл карты: печать `2×2` стоит четыре плёнки. Если инвентарь игрока полон, доставленные карты падают ему под ноги; если доставка происходит, пока игрок офлайн, сервер повторит попытку при следующем входе.

### Компоненты предмета (`minecraft:custom_data`)

| Ключ | Значение | Назначение |
| --- | --- | --- |
| `tobyscamera:camera` | Любое значение; обычно `1b` | **Обязательно.** Помечает предмет как камеру. |
| `tobyscamera:film` | Любое значение; обычно `1b` | Помечает предмет как плёнку, которую можно зарядить в камеру. |
| `tobyscamera:max_grid_size` | Положительное целое | Максимальная длина стороны отпечатков. По умолчанию берётся из `upload.max-grid-size` сервера; обычные камеры также ограничены квадратным корнем из оставшейся плёнки. |
| `tobyscamera:no_film_required` | Любое значение; обычно `1b` | Камера не расходует плёнку. |
| `tobyscamera:magic_photo` | Любое значение; обычно `1b` | Одноразовая **фотокамера** без плёнки. Камера исчезает только после того, как сервер примет корректную загрузку. |

`tobyscamera:film_remaining` — внутреннее значение, которое плагин ведёт при зарядке и расходе плёнки. Обычно не задавай и не редактируй его вручную.

> Сейчас клиент распознаёт только `tobyscamera:camera`. Оставь значение по умолчанию `camera-tag-key: "tobyscamera:camera"`, чтобы Fabric-клиент и сервер совпадали.

### Конфигурация

Значения по умолчанию при первом запуске в `plugins/TobysCamera/config.yml`:

```yaml
camera-tag-key: "tobyscamera:camera"
film-tag-key: "tobyscamera:film"
token-ttl-seconds: 60

rate-limit:
  per-second: 1
  per-minute: 12

upload:
  max-grid-size: 4
  max-chunks-per-second: 120
  max-active-upload-bytes: 16777216

Чек-лист развёртывания

• У фотографов стоит Fabric-мод, совпадающий с версией сервера; на сервере стоит плагин.
• У каждой камеры tobyscamera:camera лежит в корне custom_data, а не внутри PublicBukkitValues.
• У обычных камер достаточно заряженной плёнки, либо используются tobyscamera:no_film_required / tobyscamera:magic_photo.
• Проверь на клиенте без мода, что доставленные карты отображаются, ставятся и переживают перезапуск сервера.

Совместимость и ограничения

• Один JAR-плагин поддерживает и Paper, и Folia.
• Готовые фото — это обычные карты, так что ванильные клиенты могут ими пользоваться.
• Видоискатель захватывает то, что реально отрисовывает клиент фотографа; сервер не рендерит мир за кадром.
• Привязки клавиш, композиция и зум хранятся локально в config/tobyscamera/viewfinder.properties.

TobysCamera

Преврати окружающий мир Minecraft в сохраняемые и доступные для обмена фото-карты.

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

Подходит для клиентов Fabric 1.21.11 / 26.1 / 26.2 и серверов Paper или Folia 1.21.11+.

Держи клиентский мод и серверный плагин на одной версии TobysCamera; старые клиенты при отправке неподдерживаемых пакетов камеры получат понятное сообщение об отказе.

Руководство игрока

Перед началом

Попроси у администратора камеру. Камеру можно держать в основной или во второй руке; ПКМ по камере открывает видоискатель. Если ПКМ занято другим действием предмета, видоискатель можно открыть клавишей P.

По умолчанию затвор камеры — левая кнопка мыши, а не атака; все клавиши можно переназначить в «Настройки → Управление → Камера Тоби».

Как сделать снимок

1. Возьми камеру и нажми ПКМ, чтобы войти в видоискатель.
2. Настрой кадр зумом, направляющими и панелью композиции. В панели композиции можно задать угол поворота, соотношение, зум и направляющие; поддерживаются 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, а также можно ввести своё соотношение.
3. Нажми затвор. Клиент захватит реально отрисованную картину мира и откроет предпросмотр.
4. В предпросмотре выбери размер отпечатка, включи или выключи дизеринг Floyd–Steinberg и нажми «Напечатать фото»; можно также нажать «Переснять».
5. После того как сервер подтвердит и сохранит снимок, ты получишь пакет для фото. В нём есть предпросмотр, информация о фотографе, месте и времени.

Использование фотопакета:

• Зажмите правую кнопку мыши примерно на 1 секунду в воздухе: фотопакет разбирается на соответствующее количество обычных карт.
• Нажмите правой кнопкой мыши по пустой рамке: если рядом есть прямоугольник из пустых рамок того же размера и ориентации, фотография автоматически заполнит его целиком.
• Сломайте любую рамку из этой группы: вся группа соберётся обратно в один фотопакет, чтобы многосекционная фотография не рассыпалась.

Частые вопросы

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

Почему затвор не срабатывает? Убедитесь, что вы всё ещё держите камеру с тегом tobyscamera:camera, видоискатель не перекрыт панелью композиции, и в камере достаточно плёнки (или это камера без плёнки).

Нужно ли другим игрокам устанавливать клиентский мод? Нет. Они видят обычные карты; клиентский мод нужен только фотографу.

Руководство для администраторов сервера

Установка

1. Поместите `tobyscamera-plugin-.jarв папкуplugins/` сервера Paper или Folia и запустите сервер один раз.
2. Передайте фотографу Fabric-клиентский JAR, соответствующий версии Minecraft фотографа, для установки.
3. При необходимости отредактируйте plugins/TobysCamera/config.yml, затем выполните /tobyscamera reload.

/tobyscamera reload требует разрешения tobyscamera.reload (по умолчанию OP). Он перечитывает ограничения последующих загрузок; сохранённые фотографии и подключение к базе данных остаются нетронутыми.

Выдача камер и плёнки

TobysCamera читает корневые поля minecraft:custom_data предмета, а не Bukkit PDC. Записывайте ключи tobyscamera:* напрямую, не помещайте их в PublicBukkitValues.

Следующие команды используют имена ключей по умолчанию и могут быть выполнены из консоли или игроком с правами:

# Базовая камера: печатает максимум карты 4×4; изначально без плёнки
/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}]

# Одноразовая магическая камера: расходуется при успешном начале загрузки одной фотографии, плёнка не нужна
/give @s minecraft:spyglass[minecraft:custom_data={"tobyscamera:camera":1b,"tobyscamera:max_grid_size":4,"tobyscamera:magic_photo":1b}]

При заряде плёнки она записывается в камеру и обновляет её описание. Расход плёнки на фотографию равен итоговому количеству карт: снимок 2×2 расходует 4 штуки. Если инвентарь игрока полон, снимок выпадет у его ног; если игрок офлайн в момент выдачи, сервер повторит попытку при его следующем входе.

Компоненты предмета (minecraft:custom_data)

tobyscamera:film_remaining — внутренний счётчик, который плагин ведёт при заряде или расходе плёнки; не рекомендуется выдавать или редактировать его вручную.

Клиент сейчас жёстко распознаёт tobyscamera:camera. Чтобы Fabric-клиент и сервер совпадали, оставляйте значение camera-tag-key: "tobyscamera:camera" по умолчанию.

Описание конфигурации

plugins/TobysCamera/config.yml после первого запуска по умолчанию выглядит так:

camera-tag-key: "tobyscamera:camera"
film-tag-key: "tobyscamera:film"
token-ttl-seconds: 60

rate-limit:
  per-second: 1
  per-minute: 12

upload:
  max-grid-size: 4
  max-chunks-per-second: 120
  max-active-upload-bytes: 16777216

Чек-лист развёртывания

• Фотограф установил Fabric-мод, соответствующий версии сервера; на сервере установлен плагин.
• В корне custom_data камеры присутствует tobyscamera:camera, а не вложено в PublicBukkitValues.
• В обычную камеру заряжено достаточно плёнки, либо она имеет tobyscamera:no_film_required / tobyscamera:magic_photo.
• Проверьте на клиенте без мода: полученные карты нормально просматриваются, отображаются и восстанавливаются после перезапуска сервера.

Совместимость и ограничения

• JAR плагина поддерживает и Paper, и Folia; достаточно развернуть один экземпляр.
• Снимок — это обычный предмет карты, поэтому его можно использовать на чистом ванильном клиенте.
• Видоискатель захватывает то, что фактически отрисовывает клиент фотографа; сервер не выполняет закадровый рендеринг.
• Клавиши клиента, композиция и масштаб сохраняются локально у фотографа в config/tobyscamera/viewfinder.properties.