Greenlight

Greenlight

Greenlight — это библиотечный мод. Сам по себе он не добавляет меню, переключатель функций или какие-либо видимые изменения в геймплее.

Устанавливайте его, если другой мод заявляет о поддержке или требует Greenlight.

Для чего нужен Greenlight

Некоторые клиентские функции — безобидная косметика. Другие могут влиять на геймплей: например, отключение тумана, изменение темноты или раскрытие информации, которую сервер обычно не ожидает показывать игрокам.

Greenlight даёт серверам и клиентским модам общий способ это регулировать:

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

Цель проста: совместимые моды должны по умолчанию оставаться безопасными для ваниллы, а затем включать функции только когда сервер это разрешает.

Как серверы разрешают функции

Сервер может публиковать политику Greenlight через свой серверный ресурспак.

Серверный мод Greenlight не требуется. Ни Paper, ни Fabric, ни NeoForge, ни плагин Bukkit не нужны только для отправки файлов политики. Если ваш сервер умеет отправлять ресурспак, он может публиковать политики Greenlight.

Greenlight доверяет политике только из ресурспаков, которые Minecraft помечает как пришедшие с текущего сервера. Локальный ресурспак с теми же файлами ничего не даёт.

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

Когда вы покидаете сервер, разрешения исчезают.

Чего Greenlight не делает

Greenlight — не античит.

Модифицированный клиент может игнорировать клиентские правила. Greenlight — для честных клиентов, модпаков и серверных сообществ, которые хотят чистую общую систему разрешений вместо того, чтобы каждый мод изобретал собственное рукопожатие.

Greenlight также не навязывает функции. Он лишь сообщает совместимым модам, что разрешает сервер.

Для игроков

Greenlight нужен вам только если используемый мод поддерживает или требует его.

Установка одного Greenlight не изменит игру.

Если сервер не предоставляет политику для функции, совместимые моды должны считать эту функцию запрещённой в мультиплеере.

Для владельцев серверов

Добавьте по одному JSON-файлу политики на каждую функцию в ваш серверный ресурспак.

Начните здесь:

https://github.com/FlashyReese/greenlight/wiki/Server-Owner-Guide

Формат файла политики:

https://github.com/FlashyReese/greenlight/wiki/Policy-Files

Для разработчиков модов

Greenlight предоставляет один небольшой API для модов на Fabric и NeoForge.

Вы можете либо:

• Требовать полный рантайм Greenlight.
• Поддерживать Greenlight опционально, включив API в свой мод и безопасно отключаясь при отсутствии рантайма.

Руководство для разработчиков:

https://github.com/FlashyReese/greenlight/wiki/Mod-Developer-Guide

Лицензия

LGPL-3.0-or-later