OSP Tourney DM/CA/CTF Commands for Quake3
----------------------------------------------------------
http://www.OrangeSmoothie.org
rhea@OrangeSmoothie.org
v(1.0)
14 Декабря 2001

Здесь приводится описание всех доступных клиентских
и серверных команд OSP Tourney DM/CA/CTF (далее OSP).

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

В описаниях команд используется общая семантика Unix
в определении необходимости параметров:

  - Любой параметр, заключенный в < ... > НЕОБХОДИМ.
  - Любой параметр, заключенный в [ ... ] НЕОБЯЗАТЕЛЬНЫЙ.

Параметры к некоторым из нижеприведенных команд содержат
"номер_игрока" - порядковое число, присвоенное игроку во время
присоединения к серверу. Для нахождения "номера_игрока" выполните
команду "\players", которая выведет список всех игроков с
соответствующими им номерами.

Примечание: все нижеприведенные команды являются 
дополнительными к списку стандартных команд Quake3.

Замечания по переводу шлите по адресу: olzah@quakeshit.com

============================
Общие команды (для всех режимов игры)
============================
autorecord
	Мгновенная запись демки с информативным
	уникальным именем (долько для клиентов OSP).

autoscreenshot
	Мгновенное сохранение образа экрана (screenshot) c
	информативным уникальным именем (долько для клиентов OSP).

+button5
	Активация крюка/захвата, если это позволяет сервер.

callvote <параметр>
	Голосование.  Список всех доступных <параметров>
	будет дан далее в этом документе.

credits
	Вывод информации о людях, принявших участие в создании OSP.

currenttime
	Вывод текущего времени.

followpowerup
	Включает в режиме наблюдения (chase-cam) автопереключение
	камеры на взявшего рулез (powerup)	игрока.

help / commands
	Вывод списка доступных для текущего режима игры команд.	

menu
	Вызов клиентского меню для настройки специфических
	переменных OSP (очень полезная вещь). Клавиши weapnext/weapprev
	для движения вниз/вверх, backward/forward - вперед/назад.

motd
	Вывод текущего серверного MOTD
	(сообщение дня, информация о сервере).

players
	Вывод списка всех активных игроков на сервере с их номерами
	плюс некоторая дополнительная информация.

ref / referee <пароль>
	Стать судьей (referee).

settings
	Показ текущих установок сервера. Зеленым цветом показаны значения
	по умолчанию, красным - измененные в соответствии с режимом игры.

speconly
	Включение/исключение присоединившихся
	игроков из очереди на дуэль. При включенном
	speconly игроки будут оставаться наблюдателями,
	пока кто-либо из играющих не отсоединится.

stats [номер_игрока]
	Показывает статистику попаданий из всего
	задействованного игроком оружия. Если номер_игрока
	не указан, выводится статистика на текущего игрока.

statsall
	Вывод статистики на всех игроков.

statsblue/statsred
	Вывод статистики на игроков синей/красной команды.

statsdump
	Сбрасывает текущую статистическую информацию
	в файл: <корень_osp>/stats/<дата>/<имя_файла>.txt
                
team s
	Переключение в режим наблюдения.

topshots [аббревиатура_оружия]
	Показывает лучшего по эффективности использования конкретного 
	оружия игрока. Игрок должен сделать минимум 10 выстрелов из этого 
	оружия.	Если после указать аббревиатуру оружия - 
	MG, SG, GL, RL, LG, RG, PG, BFG, то команда покажет точность всех 
	играющих для данного типа оружия.

+wstats
	Вывод информационной панели со статистикой (та же,
	что и при stats) на текущего игрока. В режиме мульти-наблюдения
	выводится статистика на игрока с выделенным окошком.

vc_follow [номер_игрока]
	Камера наблюдения.

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

vc_view
	Переключение камеры наблюдения из динамического в
	статический режим и наоборот (камера двигается или
	просто показывает в определенном направлении).

viewall
	Наблюдение сразу за всеми активными игроками на сервере.

viewblue/viewred
	Наблюдение сразу за всеми игроками только синей/красной команды.

viewcam
	Переключение камеры наблюдения в "киношный" режим.

viewadd <номер_игрока>
	Добвление на экран вид от другого игрока.

viewremove [номер_игрока]
	Удаляет выделенный вид от другого игрока.

viewred / viewblue
	Добавляет виды от всех игроков красной/синей команды.

viewfollow
	Переключение на камеру наблюдения за игроком.

viewnone
	Удаление всех добавленных видов.

viewnext / viewprev
	Переключение вперед/назад по добавленным видам
	от другогих игроков.  (Примечание: команды follownext / followprev
	в режиме мульти-наблюдения делают ту же работу).

viewcyclenext / viewcycleprev
	Циклическое перемещение по видам от каждого игрока
	одной команды. Если вид от этого игрока уже есть, то он
	пропускается. Для режимов 1v1 или FFA перемещение 
	будет производиться по всем игрокам.

	      --> Удобные клавиши для режима мульти-наблюдения:
		bind "[" followprev
		bind "]" follownext
		bind ";" viewprev
		bind "'" viewnext
		bind "." viewcycleprev
		bind "/" viewcyclenext
		bind backspace viewremove
		bind enter viewfollow


=====================================
Команды статуса игры/игроков (g_doWarmup = 1)
=====================================
ready		Устанавливает статус игрока в "готов".
notready		Устанавливает статус игрока в "не готов".
time		Вызов (окончание) тайм-аута.
pause		Вызов (окончание) паузы в игре (только для судей).


=============================================
Команды для командных игр [общие] (g_gametype = 3, 4 или 5)
=============================================
captains
	Показ имен капитанов обеих команд.

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

coachdecline
	Отказ от приглашения стать "тренером".

coachinvite <номер_игрока>
	Приглашение игроку стать "тренером".

coachkick <номер_игрока>
	Удаление "тренера" из команды.

drop <предмет>
	Сбрасывание имеющегося в наличии оружия/боеприпасов
	или флага (только для TDM и CTF). Просто наберите "\drop"
	для получения списка доступных предметов.

joincode [пароль]
	Показывает текущий пароль для входа в игру или используется
	(при указанном пароле) для присоединения к "закрытой" команде.

lock
	"Закрывает" команду от дальнейшего присоединения к ней игроков.

unlock
	"Открывает" команду для дальнейшего присоединения к ней игроков.

scores
	Показывает текущую командную статистику.

team <r|b|s>
	Выбор команды для присоединения (r=красная, b=синяя,
	s=наблюдатель) или вывод текущей команды.

time / timeout / pause
	Вызов тайм-аута.

timein / unpause
	Завершение тайм-аута.


=================================================
Команды для командных игр [капитанские] (g_gametype = 3, 4 или 5)
=================================================
invite / pickplayer <номер_игрока>
	Приглашение игроку войти в капитанскую команду.

remove / kickplayer <номер_игрока>
	Исключение игрока из капитанской команды

resign [номер_игрока]
	Отказ от капитанских полномочий. При указании номера_игрока
	капитанские полномочия передаются этому партнеру по команде.

specinvite <номер_игрока>
	Приглашение игроку следить за закрытой для наблюдателей командой.

speclock
	Запрещает наблюдателям иметь возможность следить за командой.

teamready / readyteam
	Переводит всех игроков команды в состояние "готов" для начала матча.


========================
Команды судьи (администратора)
========================
ref <vote_option> <param>	Работает как голосование.
r_abort			Прерывает матч (в основном для CA).
r_allcaptain		Дает всем игрокам ограниченные капитанские полномочия.
r_allready		Переводит всех игроков в состояние "готов".
r_ban <номер_игрока>	Выбрасывает и банит (запрещает заход) игрока с сервера.
r_help			Вывод списка судейских команд.
r_kick <номер_игрока>	Кикает (выбрасывает) игрока с сервера.
r_lock / lock		Закрывает не закрытые еще команды для входа в них.
r_lockblue		Закрывает "синюю" команду.
r_lockred			Закрывает "красную" команду.
r_map <имя_карты>	Загружает карту.
r_mutespecs		Запрещает/разрешает вывод сообщений наблюдателей.
r_pause / pause		Приостанавливает/продолжает матч.
r_promote <номер_игрока>	Переводит игрока в статус капитана.
r_putblue <номер_игрока>	Включает игрока в состав "синей" команды.
r_putred <номер_игрока>	Включает игрока в состав "красной" команды.
r_remove <номер_игрока>	Исключает игрока из состава команды.
r_restart			Перезагрузка текущей карты.
r_speclock		Запрет на наблюдение за обеими командами.
r_speclockblue		Запрет на наблюдение за "синей" команой.
r_speclockred		Запрет на наблюдение за "красной" командой.
r_specunlock		Разрешение на наблюдение за обеими командами.
r_specunlockblue		Разрешение на наблюдение за "синей" команой.
r_specunlockred		Разрешение на наблюдение за "красной" командой.
r_unlock			Открывает обе команды для входа в них игроков.
r_unlockblue		Открывает "синюю" команду для входа в нее игроков.
r_unlockred		Открывает "красную" команду для входа в нее игроков.

Примечание:	Судья может вызвать голосование по всем доступным для голосования
		переменным, такое голосование ВСЕГДА пройдет успешно.


================================
Команды для работы с камерой наблюдения
================================
Изучите, пожалуйста, документ osp/Docs/osp-q3-Viewcam.txt
для подробного описания этих команд:

range
snapshot
snapshotdump
vc_proximity
vc_info


===================================
Команды для редактирования "нашлепок" (decals)
===================================
Изучите, пожалуйста, документ osp/Docs/osp-q3-Decal-Editing.txt
для разьяснений и более подробного описания этих команд:

decaladd		- Добавление "нашлепки".  Она будет добавлена
		  в ЗАКРЫТОМ режиме. Поменяйте режим для
		  начала каких-либо изменений.
decaldec		- Уменьшение размера текущей "нашлепки".
decaldisable	- Закрытие текущей "нашлепки".
decaldump	- Сброс текущего списка ОТКРЫТЫХ "нашлепок" в
		  <корень_Quake3/osp/decals/decal-<имя_карты>.txt
decaledit		- Включает/выключает режим редактирования "нашлепок".
decalenable	- Открытие текущей "нашлепки".
decalgfxnext	- Присваивает текущей  "нашлепке" следующую картинку из списка.
decalgfxprev	- Присваивает текущей  "нашлепке" предыдущую картинку из списка.
decalinc		- Увеличение размера текущей "нашлепки".
decalnext		- Переход к следующей открытой "нашлепке".
decalprev		- Переход к предыдущей открытой "нашлепке".
decalrotclock	- Поворот текущей "нашлепки" по часовой стрелке.
decalrotcounter	- Поворот текущей "нашлепки" против часовой стрелки.


====================
Команды голосования
====================
Ниже будет приведен список опций, которые можно изменить
посредством голосования. Большинство из них вызывается 
с параметрами "0" или "1", то бишь "ВЫКЛ" или "ВКЛ"
(0=ВЫКЛ/OFF/ЗАПРЕЩЕНО, 1=ВКЛ/ON/РАЗРЕШЕНО).

Вы можете получить список всех доступных голосованию
опций для текущего режима игры:

	\callvote ?

Получить описание, способ использования и текущие установки
какой-либо опции:

	\callvote <имя_опции> ?

Например, просмотреть настройки сервера для BFG:

	\callvote bfg ?


Список всех опций для голосования:
----------------------------------------------
** Общие **
altgraphics <0|1>
	Возможность клиенту использовать альтернативную
	графику для плазмы, шафта и гранат.

dropitems <0|1>
	Возможность сбрасывать оружие/боеприпасы или флаг.

instagib <0|1>
	Включает режим "instagib" для текущего типа игры.
	"Instagib" - это когда на карте нет никаких предметов,
	игроки появляются лишь с рельсой, которая наносит
	400 пунктов повреждений, и кулаком. Режим работает
	для всех типов игры.

fallingdamage <0|1>
	Включение/выключение повреждений при падении.

fastrail <0|1>
	Опция используется для Promode (CPM), где 
	можно устанавливать время переключения с рельсы
	в 1500ms или 1000ms - "0" или "1" соответственно.

hook <0|1>
	Включение крюка.

kick <номер_игрока>
	Выкидывание игрока с сервера.

lgcooldown <0|1>
	Опция используется для Promode (CPM), где можно
	устанавливать время "остывания" шафта в 0ms или 200ms
 	(100ms при включенном fastrail) -  "0" или "1" соответственно.

map <имя_карты|номер_карты>
	Инициирует голосование для смены карты на указанную.
	Для получения списка доступных для текущего режима игры 
	карт и их номеров:
		\callvote map

map_restart
	Рестартует текущую карту.

maxpackets_min <значение>
	Устанавливает минимальное значение cl_maxpackets для 
	клиентов (0 снимает какие-либо ограничения).

maxpackets_max <значение>
	Устанавливает максимальное значение cl_maxpackets для 
	клиентов (0 снимает какие-либо ограничения).

mg_damage <значение>
	Устанавливает значение повреждения, наносимого пулей 
	машны (min = 1, max = 10).

mg_startammo <значение>
	Устанавливает количество боеприпасов к мошне при
	появлении игрока (min = 0, max = 500).

mode <доступные_режимы>
	Загружает специфическую серверную конфигурацию
	для определенного режима игры. 

mutespecs <0|1>
	Разрешает/запрещает вывод для игроков разговоров наблюдателей.

nextmap
	Загружает следующую карту из списка карт.

osphud <0|1>
	Возможность использования клиентом cg_enableOSPHUD.

overtime <0|1|2|3>
	Установка режима овертайма:
		0 - Sudden Death (остановка игры после первого набранного фрага)
		1 - Sudden Death-Timed Overtime (sudden death после X раундов)
		2 - No Overtime (отановка матча - ничья)
		3 - Tie-Timed overtime (ничья после X раундов)

pmove <0|1|2>
	Возможность использования клиентом улучшенной обработки физики 
	движений (pmove_fixed):
		0 - pmove_fixed запрещено
		1 - стандартный pmove_fixed
		2 - улучшенный pmove_fixed

promode <0|1>
	Включает режим "ProMode" для текущего типа игры.

qil|kit [имя_карты]
	Изменение настроек игры для лиги QIL TeamDM. Необязательный
	параметр [имя_карты] указывает на карту, которая загрузится
	при смене режима игры.

referee <имя_игрока>
	Присваивание игроку судейских полномочий.

reload <100-5000>
	Установка времени перезарядки рельсы (в ms).
	Работает только в режиме instagib.

respawn <значение>
	Установка времени, через которое игрок принудительно
	появляется на карте после своей смерти (forced respawn).

setffa [имя_карты]
	Изменение режима игры на Free For All (мясо).

set1v1 [имя_карты]
	Изменение режима игры на 1v1 (дуэльный).

setca [имя_карты]
	Изменение режима игры на Clan Arena.

setctf [имя_карты]
	Изменение режима игры на CTF.

settdm [имя_карты]
	Изменение режима игры на Team Deathmatch.

thrufloors <0|1>
	Возможность пробивания полов.

timenudge_min <значение>
	Устанавливает максимальное значение cl_timenudge для 
	клиентов (0 снимает какие-либо ограничения).

timenudge_max <значение>
	Устанавливает максимальное значение cl_timenudge для 
	клиентов (0 снимает какие-либо ограничения).

unreferee <имя_игрока>
	Лишение игрока судейских привилегий.

cl / capturelimit <значение>
	Изменение текущего лимита по захвату флага.

fl / fraglimit <значение>
	Изменение текущего лимита по набранному количеству фрагов.

rl / roundlimit <значение>
	Изменение текущего лимита раундов.

tl / timelimit <значение>
	Изменение текущего лимита времени.

** Параметры для всех режимов кроме Clan Arena **
bfg <0|1>		Запрещает/разрешает BFG.
bsuit <0|1>                  	Запрещает/разрешает BattleSuit.
invis <0|1>	           	Запрещает/разрешает Invisibility.
medkit <0|1>                      	Запрещает/разрешает MedKit.
quad <0|1>                      	Запрещает/разрешает Quad Damage.
regen <0|1>                      	Запрещает/разрешает Regeneration.
teleporter <0|1>		Запрещает/разрешает Teleporter.

** Параметры для режима Clan Arena **
armordamage <0|1>
	Определяет нанесение себе повреждений (при рокетджампах например).

startrespawn <0|1>
	Делать респавн игрока в начале раунда.

warmupfire <0|1>
	Возможность стрелять во время разминки.

** Параметры для командных режимов **
allcaptain <0|1>
	Присвоение всем игрокам команды капитанских прав.

teamdamage <0|1>
	Возможность нанесения повреждений партнерам по команде.


===============
Серверные команды
===============
Эти команды есть дополнение к стандартному списку Quake3,
вводятся с консоли выделенного сервера.

addbot
	Добавление бота в игру. Если имя бота не будет совпадать
	с имеющимся списком, то OSP хитрым образом выберет и
	бота для загрузки, и уровень его игры.

allready
	Делает статус игроков "готов".

ban <номер_игрока>
	Банит (запрещает заход) игрока на сервер.

filterlist / banlist
	Выводит список всех фильтров на сервере.

filterload / playernames / banload
	Загружает указанные в filter_file и player_file
	фильтры/список запрещенных к заходу на сервер игроков.

loadmaps
	Перезагружает серверную очередность карт.

pause / mpause
	Приостанавливает матч.

players
	Выводит список игроков, как это делает клиентская команда "\players".
