Uoext. Расширяя Возможности Клиента, We do what EA can't. Опции

[Warstone]

UOExt - Ultima Online protocol Extender

Текущая версия: 0.1.0-RC1

Данная программа позволяет вам добавить еще один уровень абстракции в связке клиент - сервер для более эффективного управления как ресурсами так и самим клиентом.

Данная программа выполнена в виде dll, которая подключается к клиенту во время запуска (клиента). Она запускает в адресном пространстве клиента еще один "прокси-сервер" и перенаправляет весь протокол через себя. В отличие от других программ того-же класса, которые перехватывают recv/send, прокси сервер работает в отдельном потоке, что положительно сказывается на плавности картинки клиента, однако налагает дополнительные требования к программисту. В частности: Если прокси-сервер, по приходу какого-то пакета должен сделать серьезную обработку этого пакета, то клиент все-еще может сделать несколько шагов, до того, как переполнится локальный буфер действий клиента и он встанет (эффект потери соединения с сервером). Для игрока - это не большое время, но для программы - это миллиарды тактов.
Побочный эффект данного подхода состоит в том, что вам больше не надо следить за тем, является-ли ваш клиент шифрованным, так как программа автоматически расшифрует протокол, если сервер не принимает зашифрованный протокол.

Так как данная программа выполняется в адресном пространстве клиента, ей так-же доступны любые данные клиента. Более того, перехват API распространяется и на клиент. Поэтому вы имеете все данные клиента и можете производить относительно долгие вычисления без "фризов" клиента.

Сам исходный код данной программы доступен по адресу: http://code.google.com/p/uo-ext/ и имеет лицензию GPL. Однако плагины, написанные вами, являются самостоятельным продуктом (так-же dll) и, насколько я понимаю, могут не попадать под лицензию GPL. Если это не так, и тут есть кто-нибудь, кто разбирается в лицензиях - свяжитесь со мной, пожалуйста, для консультаций по лицензиям.

Исходный код программы написан на Object Pascal, однако плагины могут быть написаны на любом языке (соглашение о вызовах stdcall или, в терминах Си это должно быть, WINAPI соглашение).

История версий (с r53)

r60
- UOExt.GUI: Убрано мерцание при частом обновлении картинки.
- UOExt.GUI: Добавлен проект-тест для UOExt.gui.dll
r57
- Добавлен проект UOExt.GUI. Это шкурка "по умолчанию". Нет поддержки UOExt. Сама картинка сделана командой сервера "Квинтэссенция". Все скопировано правильно!

r56
- UOExt выгружается на старте клиента, если она не поддерживается сервером.

r55
- Убран проект UOLoader из репозитория. Фактически, он не использовался в работе с тех пор, как заработало заражение ехе
- Добавлена проверка на поддержку сервером UOExt в купе с передачей настроек. Аналог Razor'овского Negotiate features with server.
- Поправлен баг с падением клиента при разрыве соединения во время игры.
- В репозиторий добавился код для RunUO для поддержки UOExt

r53
Первый релиз, относительно которого будет вестись история.

Мини FAQ по работе с UOExt

Начальная установка
UOExt поставляется в 2-х основных форматах: debug и release. Отличие их в том, что debug "выкидывает" консоль и пишет туда отладочные сообщения. release, же работает без дополнительного окна.
На данный момент предпочтительный метод работы с UOExt состоит в заражении выполняемого файла клиента игры UO вызовом UOExt при запуске.
Процесс заражения происходит так: Скопировать UOExt.dll в папку с клиентом, открыть командную строку (Пуск - Выполнить cmd.exe), перейти в папку с клиентом и выполнить следующую команду:

Код

%windir%\system32\rundll32.exe UOExt.dll,Infect32 client.exe

Где client.exe - название выполняемого файла клиента УО. Так-же рекомендуется сохранить резервную копию, так как UOExt пропишет себя в текущем exe и будет запускаться каждый раз при старте модифицированного клиента.
После этой операции вы можете работать с клиентом, как раньше. Просто он будет загружать UOExt.

Поддерживаемые программы
На данный момент UOExt умеет работать с клиентом с которого снято или не снято шифрование (авто определение факта снятия шифрования).
Так-же UOExt запускается с Razor.
Тесты совместимости с другими сопутствующими программами не проводились.

Механизм проверки сервера на работу с UOExt
UOExt проверяет сервер на поддержку UOExt путем отсылки серверу пакета 0xEF с пустыми значениями. Если в ответ в течении 5 секунд не прилетит пакет 0x00, то считается что сервер не поддерживает UOExt. Содержание пакета можно почитать в комментариях в коде.

Механизм расширения функционала путем написания плагинов
Будет позже.

Roadmap

r53 (29.04.2012) - UOExt: Решение косяков с шифрованием.
- UOExt: Очередь загрузки плагинов
- UOExt: Взаимодействие между плагинами
r53 (29.04.2012) - UOExt: PE_PROXYEND - добавить в параметры наличие коннекта до клиента и сервера, а так-же причину завершение прокси.
- UOExt (фича): Поддержка старого шифрования (Которое основано на Pi... Это 2-е клиенты что-ли)
Устарело - UOExt (фича): Если UOExt словило какой-то неизвестный пакет, то его надо записать в отдельный файл на диске.
- UOExt (фича): Автоматическое чтение протокола зи запущенного ехе (только для 2д версий).
- UOExt (фича): Если пришел неизвестный пакет с сервера (с клиента он придти не может ибо выше), то просто не пропускать его дальше. Заодно и сдампить.
- UOExt (фича): В дебаг режиме пользуясь VEH уметь ловить ошибки и откатываться до вызова плагина. (с возможным продолжением работы, хотя этого скорее всего не будет)
r54 (01.05.2012) - UOExt (фича): Ловить первый пакет с сервера и проверять его на "каноничность". Если он "каноничен", то UOExt не поддерживается этим сервером, если он специальный, то из него прочитать настройки для UOExt.
r56 (01.05.2012) - UOExt (фича): Если сервер не поддерживает UOExt, то она выгружается из АП клиента, позволяя ему продолжать работать в штатном режиме.
r57 (15.05.2012) - UOExt (фича): Добавить специальную dll'ку, которая будет заниматься визуализацией процесса клиенту.
- UOExt (правка): Сделать проверку что на этапе инициализации IP/порт те-же что и на этапе коннекта самого клиента.
- UOExt (правка): При заражении ставить метку о заражении. Это нужно для того, чтобы убрать возможность повторного заражения и/или перезаражать, если механизм заражения изменился.

[Warstone]

На вопрос общаственности... Как делать систему плагинов?

Сейчас в планах 2 типа плагинов: Клиентские и серверные. Клиентские - пользователь может сам ставить/писать (получается этакое макро средство для упертых), тут могут быть всякие свисто-перделки...

Серверные - вот тут вопрос... Их ставит Администратор сервера путем прописывания еще одного пакета в протокол... Вообще, планирую сделать инкапсуляцию своего протокола в протокол УО (По принципу 0xBF пакета). Серверные плагины скачиваются непосредственно с сервера (с Game сервера) и тут-же инициализируются. Клиент не может управлять этими плагинами, если это запрещено сервером.

Плагины пока-что планируются как dll файлы, у которых есть Initialize функция, которой и передается управление. В параметрах будет, скорей всего, описание функций, по принципу OpenGL'ного выбора разрешения экрана (кажется, давно дело было... Если коротко: На каждую функцию будет 8 байт: ID функции и ссыль на участок памяти. Таким образом, при изменении хоста, плагины не всегда переписывать надо).

Пока список функций довольно простой:
RegisterPacketHandler(Header:Byte; Handler: TPacketHandler);
UnRegisterPacketHandler(Header: Byte; Handler: TPacketHandler);
RegisterPacketType(Header:Byte; Size:Word);
SendPacket(ToServer:Boolean; Data: Pointer; Size: Word);

TPacketHandler = function (Data: Pointer; var Size:Word; var Send: Boolean):Boolean;
Для последнего - Если вы поменяли пакет, то возвращаете True, если нет, то False. Пакет можно менять (вплоть до смены типа пакета), но нельзя вылезать за рамки Size. Надо послать больше? SendPacket и Send := False;. Да, если ставите Send := False; то следующие плагины этот пакет не обработают... То есть пакет как будто и не приходил вовсе.

При SendPacket он так-же будет проходить стек обработчиков.

Да, все функции stdcall(WinAPI соглашение).

Как-то так...

С# планируется, но на далекое будущее.

Предложения, пожелания?

[StaticZ]

Серверные плагины скачиваются непосредственно с сервера (с Game сервера) и тут-же инициализируются. Клиент не может управлять этими плагинами, если это запрещено сервером.

Нужна система защиты иначе могут просто подменить плагин на одноименную пустышку.

Плагины пока-что планируются как dll файлы, у которых есть Initialize функция, которой и передается управление. В параметрах будет, скорей всего, описание функций, по принципу OpenGL'ного выбора разрешения экрана (кажется, давно дело было... Если коротко: На каждую функцию будет 8 байт: ID функции и ссыль на участок памяти. Таким образом, при изменении хоста, плагины не всегда переписывать надо).

Чето вообще не уловил логики.. Причем тут изменение хоста? и для чего вообще переписывать плагины при изменении хоста?

ЗЫ: насколько я понимаю каждый плагин работает в своем потоке?
Может лучше сделать чето типа плагинс.сфг где прописать названия функций что вызывать?

[Warstone]

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

ЗЫ: насколько я понимаю каждый плагин работает в своем потоке?
Может лучше сделать чето типа плагинс.сфг где прописать названия функций что вызывать?

Насчет хоста - я имел в виду саму программу. Пока оставим... Мне тут самому еще продумать место надо.

Нет, все плагины "работают" в одном потоке... потоке Прокси. Вернее так: Сначала Прокся проходится по всем плагинам (тут куча оговорок, потом распишу) и вызывает инициализацию. Так как это обыкновенные длл(то тут вы можете спавнить сколько хотите потоков, но их смысл пока ускользает), в коде инициализации вам передают ссылки на API, вы регистрируете расширения протокола и обработчики пакетов. Дальше, как только все плагины инициализированы, начинается сам процесс "перехвата"... Как только приходит пакет с клиента или сервера, он расшифровывается (разархивируется Хаффман, возможно потом и снятие шифрования будет) и вызываются обработчики, которые зарегистрированы для этого пакета. Во время работы обработчика можно регистрировать новые обработчики, разрегестрировать старые, в том числе и текущий, посылать дополнительные пакеты в обе стороны. Если пакет прошел все обработчики и с него не снят статус отправления, то он опять упаковывается, если это надо и посылается дальше клиенту или серверу.

Как-то так...

Сотерик... Я сарказм понял и он вполне имеет место быть. Вообще - ты прав. В частности... Посмотрим.