REPKA.Commander beta 1

[Small_Bee]

REPKA.Commander public beta v1

Важно! Для корректной работы коммандер требует прав администратора, установленного .NET Framework 4, и на всякий случай, файловую систему NTFS ))

1. Инструкция по установке.

- Разархивируйте содержимое архива в любую папку на Вашем компьютере - это будет папка коммандера. Откройте папку и скопируйте содержимое папки Game в папку игры.
- Двойным щелчком запустите файл CommanderUI.exe. Будет предложено указать местоположение пользовательской папки игры. Например, "C:\Users\Small_Bee\Documents\1C SoftClub\il-2 sturmovik cliffs of dover\" Это сделать нужно обязательно, если папку не указывать или указать неправильно, за работоспособность коммандера не ручаюсь.
После того, как Вы укажите требуемую папку, запустите коммандер еще раз. В пользовательской папке игры будет создана папка "REPKA.Commander". Не переносите и не удаляйте ее! С этого момента коммандер готов к работе. Запускается он в свернутом в трей виде. Что бы увидеть окно коммандера, щелкните по значку в трее правой клавишей и выберите "Показать окно коммандера".

2. Настройки коммандера.

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

Базовые настройки

- Путь к Launcher.exe. Если программа некорректно определила путь, задайте его вручную, щелкнув по небольшой кнопке справа.
- Параметры запуска. Для запуска выделенного сервера используется ключ -server, назначен по умолчанию.
- Команда после запуска. Определите в этом окошке команду, которая будет выполнена сразу после запуска сервера. Например "f 1.cmd".

- Приоритет процесса сервера. Не меняйте эту настройку, если не вполне понимаете что это и каковы могут быть последствия.

- Автозапуск сервера после старта коммандера. Если отмечено, коммандер попытается запустить сервер сразу же после своего старта.
- Скрывать окно сервера после запуска. Если отмечено, коммандер скроет консольное окошко сервера.
- перезапустить сервер в случае аварийной остановки. Если отмечено, коммандер попытается перезапустить сервер, если тот самовольно завершит свою работу по какой либо причине.
- сохранять логи сервера в папке коммандера. Если отмечено, коммандер переместит лог сервера в свою папку, а в папке игры лог удалит. Имя файла будет отражать даты начала и завершения лога. Скопированные логи находятся в папке ServerLogs папки коммандера.
- очистить кэш перед запуском сервера. Если отмечено, коммандер очистит кэш игры перед запуском сервера.
- только скомпилированные сборки скриптов. Если отмечено, из кэша будут удалены только dll файлы.
Внимание: очистка кэша не затрагивает папку shaders

По остальным разделам все должно быть ясно без слов. Настройки категории "Игровая статистика" сейчас ни на что не влияют - отключены.

3. Ротатор карт

- Что бы добавить карты в ротатор, переместите их в папку Repka.Commander/Missions в пользовательской папке игры.
- Перейдите на вкладку Ротатора (правый верхний угол окна коммандера, значок с двумя стрелочками) и нажмите кнопку "Обновить список карт". В списке справа появятся карты, а также к каждой карте, если у нее нет скрипта, автоматически будет добавлен таковой, минимально необходимый для корректного функционирования командера. Последовательно выберите каждую и нажмите кнопку "Создать настройки карты". Теперь ротатор готов к работе.
Важно! Имена файлов миссий не должны содержать пробелов!

3.1 Настройки карт ротатора.

- Название и Комментарий используются сугубо для информативности и на карту не влияют.
- Длительность. Продолжительность проигрывания карты. По истечению времени будет загружена следующая карты в списке и т.д. Если карта в списке последняя, будет загружена первая карта.
- Эта карта участвует в ротации. Если отключить, Ротатор будет пропускать эту карту
- Предустановленные скрипты. На данный момент не реализовано.
- Кнопки в верхней части. Стрелки вверх и вниз меняют порядок следования карт. Зеленая кнопка со стрелочкой отмечает карту как следующую (будет запущена вне очереди). Остальные кнопки сохраняют и откатывают несохраненные изменения в настройках карты.

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

4. Запуск сервера

- Перейдите на главную страницу и нажмите кнопку "Запустить сервер". Также сервер будет запущен автоматически, если отмечена соответствующая опция в настройках.
- В зависимости от настроек, будет предпринята попытка запуска Steam; будет очищен кэш, файл лога сервера скопирован, запущен сервер и установлены настройки реализма и маркеров. Если в Ротаторе есть хоть одна карта, которая не исключена из ротации, будет запущено сражение с этой картой.
- После запуска сервера поле ввода внизу главной страницы можно использовать непосредственно для ввода команд в консоль сервера.

5. Остановка сервера/сражения.

- Перейдите на главную страницу и нажмите кнопку "Остановить сервер". Если в данный момент идет сражение, оно будет предварительно остановлено.
- Что бы немедленно запустить следующее сражение в ротации, нажмите кнопку "Следующее сражение".

6. Требования к скрипту миссии.

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

- первой строкой поместить строку
//$reference REPKA.Stat.dll
- класс миссии должен наследоваться от RSTMission
- переопределить метод Inited(), в котором указать имя сражение и название карты, так, как она выглядит в mis файле, исключая все, что до знака $.
В качестве примера можно использовать скрипт, который коммандер добавляет к картам автоматически.

7. Новые методы класса RSTMission

Если Вы все сделали правильно, и унаследовали класс своей миссии от класса RSTMission, Вам будет доступно несколько новых возможностей (пока немного )

- Метод SendServerCommand(string command)
Отправляет команду в консоль сервера. Например "kick Small_Bee", что вызовет кик указанного игрока с сервера.

- Метод DrawnBattle()
Вызывает сообщение, что битва закончилась ничьей и загружает следующее сражение по истечении 1 минуты.
- Метод RedArmyWon()
Вызывает сообщение, что битва закончилась победой красных и загружает следующее сражение по истечении 1 минуты.
- Метод BlueArmyWon()
Вызывает сообщение, что битва закончилась победой синих и загружает следующее сражение по истечении 1 минуты.

За одно сражение можно вызвать только один метод из вышеуказанных трех и только 1 раз. Т.е. нельзя будет сначала показать победу красных, а после ничью.

Важно! При переопределении методов в скрипте всегда вызывайте первой строкой базовый метод! В противном случае корректная работа коммандера не гарантируется.

8. Сброс настроек к настройкам по умолчанию.

Удалите файл settings.dat в папке Data папки коммандера.

9. Фон окна коммандера.

При желании вы можете заменить фоновую картинку коммандера на свою. Для этого замените файл Media/Images/bg.png в папке коммандера на свой. Поддерживаемые форматы - png, bmp, jpg. Можете вообще его удалить, получится весело, но неудобно. )

===============================================

UPD 25/05/2012

Небольшое исправление (REPKA.Stat.rar) неприятной ошибки, когда запуск битвы в обход ротатора приводил к появлению диалогового окна с ошибкой. Файл из архива положить в папку игры с заменой.