Trusted Clients

Trusted Clients — это инструмент для мониторинга и контроля модов и ресурспаков, установленных у игроков при подключении к серверу.

Trusted Clients предназначен для идентификации сторонних модификаций и ресурспаков на устройствах игроков. При подключении к серверу клиент передает список своих дополнений, которые сервер затем сопоставляет с разрешенными правилами.

⚙️ Принцип работы

Процесс проверки построен на обмене пакетами данных: при попытке входа сервер отправляет специальный пакет, на который клиент должен ответить. Если ответа нет, система считает, что мод не установлен, и разрывает соединение с уведомлением о необходимости его установки.

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

Настройка системы контроля

Настройка осуществляется через файл конфигурации по пути SERVER_ROOT/config/trustedclients/main.json. В зависимости от целей администратора можно выбрать один из трех режимов:

Режимы конфигурации

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

Логирование и автоматические действия

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

Доступные параметры действий

⚠️ Важное предупреждение: данный мод не является полноценной защитой от опытных хакеров. Он предназначен как базовая мера против простых скриптов и низкоуровневых угроз, а не как комплексное решение для обеспечения безопасности сервера.

["Server Configuration"]
	# A list of all mods that should be added to either the blacklist or whitelist.
	mods = []
	# A list of all resource packs that should be added to either the blacklist or whitelist.
	resourcePacks = ["TotallyLegitResourcePack.zip"]
	# How should the mods in the list be treated?
	# BLACKLIST will flag all mods of the client that are in the list.
	# WHITELIST will flag all mods of the client that aren't in the list.
	#Allowed Values: BLACKLIST, WHITELIST
	mode = "WHITELIST"
	# What should be done, when a player uses a flagged mod?
	# NOTIFY will log the flagged mods in the console (and send a message to the operators).
	# RESTRICT will do the same as NOTIFY, but will additionally deny the player everytime they join with a flagged mod.
	# BAN will also do the same as NOTIFY, but is a bit harsher than RESTRICT and will ban the player, so once they joined with a flagged mod, they will never be able to join again, until they are pardoned by an operator.
	# This will only work, when the mode selected is either BLACKLIST or WHITELIST.
	#Allowed Values: NOTIFY, RESTRICT, BAN
	action = "RESTRICT"

Требования проверенного файла

• По манифесту для файла trustedclients-0.7.0.jar (Minecraft 26.3; Fabric) требуется fabric-api. Встроенных JAR-библиотек в проверенном файле нет.
• По манифесту для файла trustedclients-0.7.0.jar (Minecraft 26.3; Fabric) требуется fabric-language-kotlin. Встроенных JAR-библиотек в проверенном файле нет.