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

Oxygen использует собственную систему конфигурации на основе json файлов. Файлы конфигурации по умолчанию создаются в папке «./minecraft/config/oxygen» при первом запуске игры с модификациями. Кроме файлов конфигурации в этой папке так же хранятся вспомогательные данные проекта (данные системы привилегий, пресеты, настройки клиента и т.п.), поэтому не рекомендуется удалять папку oxygen целиком - для сброса конфигурации удалите только файлы конфигурации.

Параметры в файлах конфигурации находятся в двух разделах: «client» и «server». Опции в разделе «client» применяются только к клиенту. Опции из раздела «server» применяются и к клиенту и к серверу. Так же некоторые параметры из этого раздела синхронизируются с клиентом (при подключении к серверу, файлы при этом не модифицируются) для корректной работы графических интерфейсов и т.п. - вам не нужно беспокоится о соответствии конфигов.

Core

Core имеет два файла конфигурации: «core.json» и «core-privileges.json». Основные настройки Oxygen и опции Core содержатся в файле «core.json», файл «core-privileges.json» содержит настройки системы привилегий.

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

Структура файла:

Параметры:

Клиент
  • «region_id» - [string] - идентификатор временной зоны, в которой расположен клиент (пример: «Europe/Moscow» или «UTC+3»)
  • «data_save_peroid_seconds» [int] - период сохранения данных в секундах. Данные всех модулей сохраняются только при наличии изменений, период проверки наличия изменений и сохранения задан этим значением (данные клиента).
  • «enable_notifications_key» [boolean] - разрешить добавление клавиши «открыть меню уведомлений». Если «true», то будет создана привязка клавиши «открыть меню уведомлений» и добавлена в меню настроек управления.
  • «enable_accept_key» [boolean] - разрешить добавление клавиши «принять запрос»
  • «enable_reject_key» [boolean] - разрешить добавление клавиши «отклонить запрос»
  • «enable_interaction_key» [boolean] - разрешить добавление клавиши «взаимодействие»
  • «date_time_formatter_pattern» [string] - паттерн формата отображения даты. Схема отображения даты в некоторых меню, заданная строкой для объекта java SimpleDateFormat.
Сервер
  • «region_id» - [string] - идентификатор временной зоны, в которой расположен сервер (пример: «Europe/Moscow» или «UTC+3»)

Идентификатор временной зоны используется для корректного определения часового пояса, в котором расположен сервер и дальнейшей работы с временными метками. Если вы хотите что бы сервер использовал конкретную временную зону, то вы должны указать её (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Если не указать временную зону, то будет использоваться временная зона по умолчанию, определённая системой.

  • «io_threads_amount» [int] - количество потоков для обработки операций ввода-вывода

Операции ввода вывода в Oxygen ассинхронны, этот параметр отвечает за количество потоков для обработки этих операций.

  • «routine_threads_amount» [int] - количество потоков для обработки рутинных операций

Большенство рутинных операций в Oxygen ассинхронны, этот параметр отвечает за количество потоков для обработки этих операций.

  • «scheduler_threads_amount» [int] - количество потоков для обработки отложенных задач

Отложенные задачи в Oxygen ассинхронны, этот параметр отвечает за количество потоков для обработки этих операций.

  • «data_save_period_seconds» [int] - период сохранения данных в секундах

Данные всех модулей сохраняются только при наличии изменений, период проверки наличия изменений и сохранения задан этим значением (данные сервера).

  • «sync_configs» [boolean] - разрешить синхронизацию помеченных опций конфига с клиентами

Некоторые опции конфигурации раздела «server» помечены для синхронизации с клиентом, это нужно для корректной работы графических интерфейсов. Если «true», то конфигурация будет синхронизирована с клиентом при подключении к серверу.

  • «enable_privileges» [boolean] (синхронизируется) - разрешить использование системы привилегий

Если «true», то будет использоваться встроенная система разрешений.

  • «sync_entities_health» [boolean] - разрешить синхронизацию данных о запасе здоровья отслеживаемых сущностей

Oxygen содержит собственный трекер параметров отслеживаемых сущностей. Если «true», то показатели здоровья отслеживаемых сущностей будут синхронизированы с клиентом.

  • «sync_entities_absorption_value» [boolean] - разрешить синхрониацию данных о значении поглощения отслеживаемых сущностей
  • «sync_entities_armor_value» [boolean] - разрешить синхронизацию данных о запасе брони отслеживаемых сущностей
  • «sync_entities_active_effects» [boolean] - разрешить синхронизацию данных об активных эффектах отслеживаемых сущностей

Конфигурация Привилегий

Структура файла:

}}

Параметры:

Сервер

  • «enable_formatted_chat» [boolean] (синхронизируется) - разрешить форматирование чата (роли)

Если «true», то сообщения будут отформатированы в соответствии с форматированием, установленным для роли игрока.

  • «enable_chat_formatting_role_management» [boolean] (синхронизируется) - разрешить смену активного режима форматирования чата для игрока (при наличии ролей)

Если «true», то игрок при наличии нескольких ролей сможет переключать форматирование чата из списка доступных ролей или отключить его вовсе.

  • «enable_custom_formatted_chat» [boolean] - разрешить использование кастомного паттерна для форматирования чата

Если «true», то будет использована схема для форматирования, представленная параметрами «custom_formatted_chat_pattern» и «custom_formatted_chat_prefix_pattern». Цвет сообщений игроков без ролей (без форматирования) и цвет дополнительных символов в схеме форматирования определяется параметром «custom_formatted_default_chat_color».

  • «custom_formatted_chat_pattern» [string] - паттерна для форматирования чата (если у игрока нет префикса)

Схема форматирования сообщения игрока при отсутствии у него префикса. Элемент «@username» заменяется на имя пользователя при отправке сообщения.

  • «custom_formatted_chat_prefix_pattern» [string] - паттерна для форматирования чата (если у игрока есть префикс)

Схема форматирования сообщения игрока при наличии префикса. Элементы «@prefix» и «@username» заменяются на префикс и имя пользователя соответственно при отправке сообщения.

  • «custom_formatted_default_chat_color» [int] - индекс цвета чата по умолчанию (индекс элемента TextFormatting)

Индекс элемента перечисления TextFormatting, определяющий цвет чата и дополнительных символов схем форматирования чата.

  • «show_prefix» [boolean] - показывать заданный ролью префикс
  • «enable_nickname_color» [boolean] - использовать заданный ролью цвет имени пользователя
  • «enable_prefix_color» [boolean] - использовать заданный ролью цвет префикса
  • «enable_chat_color» [boolean] - использовать заданный ролью цвет сообщения