Данная статья использует возможности модуля Вы должны зарегистрироваться, чтобы видеть ссылки., поэтому для правильной работы описанных вещей необходима его установка на ваш сервер.
В играх, базирующихся на движке Half-Life, часть событий и правил сгруппированы в объекте GameRules. joaquimandrade собрал коллекцию виртуальных функций этого объекта для различных модов, что позволяет использовать их при скриптинге в своих плагинах.
1. Получение указателя на объект.
Прежде всего для начала работы с нужными нами функциями необходимо получить объект CGameRules:
- Код: Выделить всё
#include <amxmodx>
#include <orpheu>
#include <orpheu_stocks>
// Создаем переменную для хранения указателя на объект GameRules
new g_pGameRules
// Регистрируем хук установки объекта в игре на функцию OnInstallGameRules
public plugin_precache()
OrpheuRegisterHook(OrpheuGetFunction("InstallGameRules"), "OnInstallGameRules", OrpheuHookPost)
// Получаем указатель на объект GameRules и сохраняем в переменной g_pGameRules
public OnInstallGameRules()
g_pGameRules = OrpheuGetReturn()
Данный код перехватывает вызов функции движка InstallGameRules, которая создает нужный нам объект GameRules. Данная функция существует в каждом моде. После срабатывания перехвата функции, переменная g_pGameRules будет хранить указатель на объект, что позволит нам перехватывать и вызывать функции объекта GameRules. В TFC моде функция создания объекта немного отличается, поэтому она называется InstallGameRules_tfc (данная информация пригодится для тех, кто делает плагины для TFC).
2. Перехват вызова функций.
Рассмотрим пример перехвата вызова функции:
[pawn]GetNextBestWeapon(CBasePlayer *, CBasePlayerItem *) [/pawn]
Напишем данный код:
- Код: Выделить всё
public plugin_init()
{
/*
g_pGameRules - указатель на объект GameRules (код получения указан выше).
GetNextBestWeapon - название функции. Вы можете узнать названия функций из директории [i]..\configs\orpheu\virtualFunctions\CGameRules[/i]
CGameRules - базовый объект, который будет использоваться.
OnGetNextBestWeapon - название нашей функции, которая будет вызываться после вызова функции движка GetNextBestWeapon.
*/
OrpheuRegisterHookFromObject(g_pGameRules, "GetNextBestWeapon", "CGameRules", "OnGetNextBestWeapon")
}
public OnGetNextBestWeapon(i_GameRules, id, weapon_id)
{
// i_GameRules - объект, который будет всегда передаваться в первом аргументе, но он нам не нужен, потому что у нас уже есть g_pGameRules
}
Функция GetNextBestWeapon срабатывает, к примеру, при выбросе оружия и в других определенных случаях, где id - будет игрок, который выбросил оружие, а weapon_id - выбрасываемое оружие.
3. Вызов функций.
Рассмотрим примера вызова функции:
- Код: Выделить всё
GoToIntermission(void)
Напишем данный код:
- Код: Выделить всё
new OrpheuFunction:GoToIntermission = OrpheuGetFunctionFromObject(g_pGameRules, "GoToIntermission", "CGameRules")
// При вызове функции первым аргументом необходимо передавать g_pGameRules
// Так как данная фунция GoToIntermission не имеет аргументов, то больше ничего передавать не нужно
new i_Result = OrpheuCall(GoToIntermission, g_pGameRules)
Функция GoToIntermission используется при смене карты, когда высвечивается таблица результатов и игроки не могут ничего делать.
4. Список функций.
После установки необходимого пакета с функциями, вы можете узнать аргументы каждой функции из директории ..\configs\orpheu\virtualFunctions\CGameRules. Просто откройте необходимый файл с функцией и найдите поле "arguments". Также там можно узнать, какими модами данная функция поддерживается из поля "mod".
Список поддерживаемых модов:
- cstrike
- czero
- dod
- tfc
- ns
- ts
- SvenCoop
- valve
Список функций:
- Код: Выделить всё
AddToTeamScores
AllowAutoTargetCrosshair
AmmoShouldRespawn
BloodSprite
BloodStream
bodyDamage
Bubbles
BubbleTrails
BuildableBuilt
BuildableKilled
BuildMiniMap
BulletTracers
Camera
CanEntityDoDamageTo
CanHaveAmmo
CanHaveItem
CanHavePlayerItem
ChangeLevel
ChangePlayerTeam
ChangePlayerTeam_dod
CheckMapConditions
CheckWinConditions
CleanUpMap
ClientCommand
ClientCommandDeadOrAlive
ClientCommand_dod
ClientConnected
ClientDisconnected
ClientUserInfoChanged
DeadPlayerAmmo
DeadPlayerWeapons
DeathNotice
DeathNotice_dod
EndMultiplayerGame
Explosion
FAllowFlashlight
FAllowMonsters
FlAmmoRespawnTime
FlHealthChargerRechargeTime
FlHEVChargerRechargeTime
FlItemRespawnTime
FlPlayerFallDamage
FlPlayerSpawnTime
FlWeaponRespawnTime
FlWeaponTryRespawn
FPlayerCanRespawn
FPlayerCanTakeDamage
FShouldSwitchWeapon
gerVoice
GetArePlayersAllowedToJoinImmediately
GetCombatAttackingTeamNumber
GetCountdownStarted
GetGameDescription
GetGameStarted
GetGameTime
GetIndexedTeamName
GetIsClientAuthorizedToPlay
GetIsCombatMode
GetIsHamboneMode
GetIsIronMan
GetIsNSMode
GetIsTournamentMode
GetIsTrainingMode
getMapTime
GetMaxWaveTime
GetNextBestWeapon
GetPlayerSpawnSpot
GetTeamID
GetTeamIndex
getWaveTime
GiveC4
GoToIntermission
Init
InitHUD
IPointsForKill
IsAllowedToSpawn
IsClanMatch
IsClanMatchActive
IsCoOp
IsDeathmatch
IsFreezePeriod
IsMultiplayer
IsRoundFrozen
IsTeamplay
IsValidTeam
ItemShouldRespawn
Pain
PerformHardAuthorization
PlayerGotAmmo
PlayerGotItem
PlayerGotWeapon
PlayerKilled
PlayerKilled_dod
PlayerRelationship
PlayerSpawn
PlayerThink
PlayFootstepSounds
PlayTextureSounds
PopHelmet
ProcessRespawnCostForPlayer
Prone
RecalculateHandicap
RecalculateMapMode
RefreshSkillData
RemoveGuns
RestartRound
ReturnGameRules
RewardPlayerForKill
RoundReset
roundRestartSound
RoundState
ScreenFades
SelectSpawnPoint
SendMOTDToClient
SendTeamScores
ServerDeactivate
SetBloodSprite
SetBloodStream
SetbodyDamage
SetBubbles
SetBubbleTrails
SetBulletTracers
SetCamera
SetClanMatch
SetDefaultPlayerTeam
SetExplosion
SetGameStarted
SetgerVoice
SetMapChangeFromTime
setMapTime
SetPain
SetPopHelmet
SetProne
SetRestartTime
SetRocketTrail
SetRoundReset
SetroundRestartSound
SetRoundState
SetScreenFades
SetShards
SetSmoke
SetSparkShower
SetTeamScores
SetusVoice
setWaveTime
Shards
ShouldAutoAim
Smoke
SparkShower
StartTrail
TeamScores
Think
UpdateGameMode
usVoice
VoteKick
WeaponShouldRespawn
Кому интересно, то прикладываю также файл multiplay_gamerules.cpp из HL SDK, где можно найти исходники некоторых функций движка.