◆ Ostrak

Плагин цифровых документов и идентификации для ролевых серверов Minecraft.

Ядро — конструктор документов: администратор описывает тип документа (паспорт, права, лицензия, медкарта) в YAML, а плагин сам делает интерфейс, выдачу, срок действия, изъятие и запись в реестр. Java-код при добавлении нового типа не пишется.

Эта документация — про free-версию (Ostrak-Free.jar, Modrinth).

Разделы

• Установка — требования, куда класть jar, первый запуск
• Команды и права — /doc, /passport, /registry, /ostrak
• Настройка — каждый ключ config.yml
• Паспорт и его поля — встроенный тип документа
• Тексты и оформление — свой цвет/градиент/префикс сообщений
• Частые вопросы — то, что обычно спрашивают в первую неделю

Коротко о философии

• Документы предъявляют, а не подсматривают. /doc inspect шлёт запрос игроку рядом — тот сам решает показать документ или отказать. Отказ — легальное игровое действие, а не баг.
• Видимость полей по правам. Поле медкарты с группой крови видит только тот, у кого есть право ostrak.medic — остальным (включая владельца) оно скрыто, если так решил администратор.
• 1 игрок = 1 гражданин. Паспорт — не особый случай в коде, а такой же тип документа, как и любой другой, просто поставляется вместе с плагином.

Free vs Premium

Free-сборка — это полноценный движок документов с одним встроенным типом (паспорт) и SQLite. Premium добавляет собственные типы документов (documents/*.yml), заявки на выдачу с очередью на утверждение, продление документов, историю реестра и веб-портал на PostgreSQL. Здесь документируется то, что есть в free — возможности premium будут описаны в отдельном разделе, когда сборка выйдет.