GitHub/amxmodx
2
0
Fork 0
mirror of https://github.com/alliedmodders/amxmodx.git synced 2024-12-27 15:25:36 +03:00
Code Issues Projects Releases Wiki Activity
4662109980
amxmodx/plugins/include/cstrike.inc
Arkshine e87976bc09 Cstrike: Remove CS_OnGetItemPrice forward (reverted from commit 33a7d74b6da2ca4dcb621e9b306c386ba040571e) 
This is actually not possible to have a proper system to allow this.
This is two majors problems:
  - The item price text can't be changed, whatever old and VGUI menu (it's either harcoded in config file or in client binary)
  - Once you open VGUI menu, to know if user has enough money to select an item, client relies on the current HUD money value, this means, since we can't directly changed price, before opening the menu, money needs to be somehow faked and restored once closed. It's awful.

Overall it can't work properly, and at the end current forward doesn't make sense.

If an author wanted to have its own prices, the only only way would to force players to use old menu, then overwriting the whole buy menu, so you would be able to display what you want exactly.
2015-11-03 10:45:50 +01:00

1222 lines
42 KiB
SourcePawn
Executable File
Raw Blame History

// vim: set ts=4 sw=4 tw=99 noet:
//
// AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO").
// Copyright (C) The AMX Mod X Development Team.
//
// This software is licensed under the GNU General Public License, version 3 or higher.
// Additional exceptions apply. For full license details, see LICENSE.txt or visit:
// https://alliedmods.net/amxmodx-license
//
// Counter-Strike Functions
//
#if defined _cstrike_included
#endinput
#endif
#define _cstrike_included
#pragma reqlib cstrike
#if !defined AMXMODX_NOAUTOLOAD
#pragma loadlib cstrike
#endif
#include <cstrike_const>
/**
* Returns client's deaths.
*
* @param index Client index
*
* @return Client deaths
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_deaths(index);
/**
* Sets client's deaths.
*
* @param index Client index
* @param newdeaths New value to set
* @param scoreboard If true the scoreboard will be updated to reflect the new value.
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_set_user_deaths(index, newdeaths, bool:scoreboard = true);
/**
* Returns index of the entity that a hostage is following.
*
* @note Hostages can theoretically follow any entity in the game, so the
* returned entity index is not necessarily a client index.
*
* @param index Hostage entity index
*
* @return Entity index if hostage is following something, 0 otherwise
* @error If the provided entity index is not a hostage, an error will
* be thrown.
*/
native cs_get_hostage_foll(index);
/**
* Sets hostage to follow an entity.
*
* @note Hostages can theoretically follow any entity in the game, so the
* followedindex does not have to be a client index.
*
* @param index Hostage entity index
* @param followedindex New entity to follow
*
* @noreturn
* @error If the provided entity index is not a hostage, an
* error will be thrown.
*/
native cs_set_hostage_foll(index, followedindex = 0);
/**
* Returns unique id of a hostage.
*
* @param index Hostage entity index
*
* @return Unique hostage id
* @error If the provided entity index is not a hostage, an error will
* be thrown.
*/
native cs_get_hostage_id(index);
/**
* Returns amount of ammo in the client's backpack for a specific weapon.
*
* @note For a list of possible weapon ids see the CSW_* constants in
* amxconst.inc
* @note Some weapons share ammo types and therefore ammo backpack pools. List
* of ammo types:
* ammo_338magnum - awp
* ammo_762nato - scout, ak47, g3sg1
* ammo_556natobox - m249
* ammo_556nato - famas, m4a1, aug, sg550, galil, sg552
* ammo_buckshot - m3, xm1014
* ammo_45acp - usp, ump45, mac10
* ammo_57mm - fiveseven, p90
* ammo_50ae - deagle
* ammo_357sig - p228
* ammo_9mm - glock, mp5, tmp, elites
* / - hegrenade
* / - flashbang
* / - smokegrenade
*
* @param index Client index
* @param weapon Weapon id
*
* @return Amount of ammo in backpack
* @error If the client index is not within the range of 1 to
* MaxClients, the client is not connected, or an invalid
* weapon id is provided, an error will be thrown.
*/
native cs_get_user_bpammo(index, weapon);
/**
* Sets amount of ammo in the client's backpack for a specific weapon.
*
* @note For a list of possible weapon ids see the CSW_* constants in
* amxconst.inc
* @note Some weapons share ammo types and therefore ammo backpack pools. List
* of ammo types:
* ammo_338magnum - awp
* ammo_762nato - scout, ak47, g3sg1
* ammo_556natobox - m249
* ammo_556nato - famas, m4a1, aug, sg550, galil, sg552
* ammo_buckshot - m3, xm1014
* ammo_45acp - usp, ump45, mac10
* ammo_57mm - fiveseven, p90
* ammo_50ae - deagle
* ammo_357sig - p228
* ammo_9mm - glock, mp5, tmp, elites
* / - hegrenade
* / - flashbang
* / - smokegrenade
*
* @param index Client index
* @param weapon Weapon id
* @param amount New backpack ammo amount to set
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, the client is not connected, or an invalid
* weapon id is provided, an error will be thrown.
*/
native cs_set_user_bpammo(index, weapon, amount);
/**
* Returns if the client has a defuse kit.
*
* @param index Client index
*
* @return 1 if the client has a defuse kit, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, the client is not connected, or an invalid
* weapon id is provided, an error will be thrown.
*/
native cs_get_user_defuse(index);
/**
* Sets the client's defusekit status and allows to set a custom HUD icon and
* color.
*
* @param index Client index
* @param defusekit If nonzero the client will have a defusekit, otherwise
* it will be removed
* @param r Red component of icon color
* @param g Green component of icon color
* @param b Blue component of icon color
* @param icon HUD sprite to use as icon
* @param flash If nonzero the icon will flash red
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_set_user_defuse(index, defusekit = 1, r = 0, g = 160, b = 0, icon[] = "defuser", flash = 0);
/**
* Returns if the client is inside a buyzone.
*
* @param index Client index
*
* @return 1 if the client is inside a buyzone, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_buyzone(index);
/**
* Returns if the client has a primary weapon or a shield in the inventory.
*
* @param index Client index
*
* @return 1 if the client has a primary weapon or shield in the
* inventory, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_hasprim(index);
/**
* Retrieves the client's player model.
*
* @param index Client index
* @param model Buffer to copy model to
* @param len Maximum buffer size
*
* @return Number of cells written to buffer
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_model(index, model[], len);
/**
* Sets the client's player model.
*
* @note This is not a one-time set. The CStrike module will remember the
* selected model and try to prevent attempts at changing the player
* model, or immediately re-apply it if necessary.
* @note Updating modelindex is useful for custom models which don't have
* the same structure as the default ones (hitbox, etc..). Model must
* be precached before.
*
* @param index Client index
* @param model Model name
* @param update_index If true, the modelindex is updated as well
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, the client is not connected, the provided
* model is empty, or if modeindex is updated and the
* provided model is not precached, an error will be thrown.
*/
native cs_set_user_model(index, const model[], bool:update_index = false);
/**
* Resets the client's model.
*
* @note This lifts the model-lock set by a previous cs_set_user_model() call.
*
* @param index Client index
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_reset_user_model(index);
/**
* Returns the client's amount of money.
*
* @param index Client index
*
* @return Amount of money
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_money(index);
/**
* Sets the client's amount of money.
*
* @param index Client index
* @param money New amount to set
* @param flash If nonzero the HUD will flash the difference between new
* and old amount in red or green
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_set_user_money(index, money, flash = 1);
/**
* Returns if the client's has night vision goggles.
*
* @param index Client index
*
* @return 1 if user has NVG, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_nvg(index);
/**
* Sets the client's night vision goggles.
*
* @param index Client index
* @param nvgoogles If nonzero the NVG will be added to the client's
* inventory, otherwise they will be removed from it
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_set_user_nvg(index, nvgoggles = 1);
/**
* Returns if the client has the ability to plant the bomb.
*
* @note Only with this set can the client plant the bomb within the usual bomb
* target areas. If this is not set the user can not plant the bomb, even
* when he has one in the inventory.
*
* @param index Client index
*
* @return 1 if the client is able to plant the bomb, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_plant(index);
/**
* Sets the client's ability to plant the bomb and displays or hides the bomb
* HUD icon.
*
* @note Only with this set can the client plant the bomb within the usual bomb
* target areas. If this is not set the user can not plant the bomb, even
* when he has one in the inventory. This is only correctly set when the
* client touches a bomb and picks it up "manually" (only possible for
* Terrorists), so this should be used if the bomb is added to the
* inventory through other means.
*
* @param index Client index
* @param plant If nonzero the client will be able to plant the bomb,
* otherwise he will be unable to
* @param showbombicon If nonzero the green C4 icon will be displayed on the
* client's hud, otherwise it will be hidden
*
* @return 1 if the client is able to plant the bomb, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_set_user_plant(index, plant = 1, showbombicon = 1);
/**
* Sets the client's team without killing the player, and sets the client model.
*
* @note For a list of valid team ids see the CsTeams enum, and for a list of
* valid internal model ids see the CsInternalModel enum.
*
* @param index Client index
* @param team Team id
* @param model Internal model id, if CS_DONTCHANGE the game will choose the model
or if CS_NORESET the game will not update it.
* @param send_teaminfo If true, a TeamInfo message will be sent
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_set_user_team(index, any:team, any:model = CS_DONTCHANGE, bool:send_teaminfo = true);
/**
* Returns the client's team and optionally the model id.
*
* @note For a list of valid team ids see the CsTeams enum, and for a list of
* valid internal model ids see the CsInternalModel enum.
*
* @param index Client index
* @param model Optional variable to store model id in
*
* @return Team id
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native CsTeams:cs_get_user_team(index, &any:model = CS_DONTCHANGE);
/**
* Returns if the client is a VIP.
*
* @param index Client index
*
* @return 1 if the client is a VIP, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_vip(index);
/**
* Sets the client's VIP status and displayed model and scoreboard flag.
*
* @note This is mostly useful for removing VIP status so the client can change
* teams and/or buy items properly. It does not alter gameplay, the player
* that is selected as VIP at the start of a round will retain the
* internal VIP status and remain the primary objective for the game mode.
*
* @param index Client index
* @param vip If nonzero the client will be made a VIP, otherwise the
* VIP status will be removed
* @param model If nonzero the client's model will be changed to the VIP
* model, otherwise a random CT model will be selected
* @param scoreboard If nonzero the scoreboard will be updated to reflect the
* new VIP status
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_set_user_vip(index, vip = 1, model = 1, scoreboard = 1);
/**
* Returns if the client has committed a team kill in the current round.
*
* @note If this is set to 1 the client will be punished at the start of the
* next round depending on the value of the mp_tkpunish cvar. The team
* kill status is then reset.
*
* @param index Client index
*
* @return 1 if the client has committed a team kill, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_tked(index);
/**
* Sets the client's team kill status, indicating whether the client has
* committed a team kill in the current round.
*
* @note If this is set to 1 the client will be punished at the start of the
* next round depending on the value of the mp_tkpunish cvar. The team
* kill status is then reset.
*
* @param index Client index
* @param tk Team kill status
* @param subtract Amount of frags to subtract, negative values add frags
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_set_user_tked(index, tk = 1, subtract = 1);
/**
* Returns if the client is currently driving a vehicle and if so, indicates
* the speed.
*
* @param index Client index
*
* @return 0 if the client is not driving, 1 if driving a vehicle but
* not moving, 2 to 4 if driving positive speeds, 5 if
* driving at a negative speed (backing), see TRAIN_* constants
* in hlsdk_const.inc
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_driving(index);
/**
* Returns if the client has a shield in the inventory.
*
* @param index Client index
*
* @return 1 if the client has a shield, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_shield(index);
/**
* Returns if the client is using a stationary gun.
*
* @param index Client index
*
* @return 1 if the client uses a stationary gun, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_stationary(index);
/**
* Returns the client's armor value and retrieves the type of armor.
*
* @note For a list of possible armor types see the CsArmorType enum.
*
* @param index Client index
* @param armortype Variable to store armor type in
*
* @return Amount of armor, 0 if client has no armor
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_get_user_armor(index, &CsArmorType:armortype = CS_ARMOR_NONE);
/**
* Sets the client's armor value the type of armor.
*
* @note For a list of possible armor types see the CsArmorType enum.
* @note Sends the appropriate message to update the client's HUD.
*
* @param index Client index
* @param armorvalue Amount of armor to set
* @param armortype CS armor type
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error
* will be thrown.
*/
native cs_set_user_armor(index, armorvalue, CsArmorType:armortype);
/**
* Returns if the weapon is in burst mode.
*
* @note Only the Glock and Famas can return 1 as they are the only guns in the
* game that have a burst fire mode.
* @note This native does not verify that the provided entity is a weapon
* entity. It will return incorrect values for non-weapon entities.
*
* @param index Weapon entity index
*
* @return 1 if the weapon is in burst mode, 0 otherwise
* @error If an invalid entity index or a client index is provided,
* an error will be thrown.
*/
native cs_get_weapon_burst(index);
/**
* Sets the weapon's burst mode.
*
* @note Only the Glock and Famas can be set to burst fire mode as they are the
* only guns in the game that provide such a mode.
* @note This native does not verify that the provided entity is a weapon
* entity. It will result in undefined behavior if used on non-weapon
* entities.
*
* @param index Weapon entity index
* @param burstmode If nonzero the weapon will be put into burstmode,
* otherwise the burst mode will be removed
*
* @return 1 if burst mode set successfully, 0 if entity is not
* an applicable weapon
* @error If an invalid entity index or a client index is
* provided, an error will be thrown.
*/
native cs_set_weapon_burst(index, burstmode = 1);
/**
* Returns if the weapon is in silenced mode.
*
* @note Only the USP and M4A1 can return 1 as they are the only guns in the
* game that have a silenced fire mode.
* @note This native does not verify that the provided entity is a weapon
* entity. It will return incorrect values for non-weapon entities.
*
* @param index Weapon entity index
*
* @return 1 if the weapon is in silenced mode, 0 otherwise
* @error If an invalid entity index or a client index is provided,
* an error will be thrown.
*/
native cs_get_weapon_silen(index);
/**
* Sets the weapon's silenced mode.
*
* @note Only the USP and M4A1 can be set to silenced fire mode as they are the
* only guns in the game that provide such a mode.
* @note This native does not verify that the provided entity is a weapon
* entity. It will result in undefined behavior if used on non-weapon
* entities.
*
* @param index Weapon entity index
* @param silence If nonzero the weapon will be put into silenced
* mode, otherwise the silenced mode will be removed
* @param draw_animation If 1 and the weapon is currently held by a
* client, the appropriate weapon animation will be
* played
* If 2, same as 1 but follows game behavior by playing
* the associated player's model sequence and disallowing
* firing while animation is playing.
*
* @return 1 if silenced mode set successfully, 0 if entity is
* not an applicable weapon
* @error If an invalid entity index or a client index is
* provided, an error will be thrown.
*/
native cs_set_weapon_silen(index, silence = 1, draw_animation = 1);
/**
* Returns the amount of ammo in weapon's magazine.
*
* @note This native does not verify that the provided entity is a weapon
* entity. It will return incorrect values for non-weapon entities.
*
* @param index Weapon entity index
*
* @return Amount of ammo in magazine
* @error If an invalid entity index or a client index is provided,
* an error will be thrown.
*/
native cs_get_weapon_ammo(index);
/**
* Sets the amount of ammo in weapon's clip.
*
* @note This native does not verify that the provided entity is a weapon
* entity. It will result in undefined behavior if used on non-weapon
* entities.
*
* @param index Weapon entity index
* @param newammo New ammo amount
*
* @noreturn
* @error If an invalid entity index or a client index is provided,
* an error will be thrown.
*/
native cs_set_weapon_ammo(index, newammo);
/**
* Returns the weapon id of an entity.
*
* @note For a list of possible weapon ids see the CSW_* constants in
* amxconst.inc
* @note This native does not verify that the provided entity is a weapon
* entity. It will return incorrect values for non-weapon entities.
*
* @param index Weapon entity index
*
* @return Weapon id
* @error If an invalid entity index or a client index is provided,
* an error will be thrown.
*/
native cs_get_weapon_id(index);
/**
* Returns if "no knives" mode is enabled.
*
* @note "No knives" mode means that the CStrike module will prevent the game
* from creating (and thus attaching) "weapon_knife" entities. This means
* that clients will spawn without knives, but knives can still be put
* into the client inventories directly.
*
* @return 1 if "no knives" mode is enabled, 0 otherwise
*/
native cs_get_no_knives();
/**
* Enables or disables the "no knives" mode.
*
* @note "No knives" mode means that the CStrike module will prevent the game
* from creating (and thus attaching) "weapon_knife" entities. This means
* that clients will spawn without knives, but knives can still be put
* into the client inventories directly.
*
* @param noknives If nonzero enable "no knives" mode, disable otherwise
*
* @noreturn
*/
native cs_set_no_knives(noknives = 0);
/**
* Sets a dead client up for spawning.
*
* @note This sets the client deadflag and triggers a client think, effectively
* making the game respawn the client. Should only be used on dead
* clients.
*
* @param player Client index
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_user_spawn(player);
/**
* Returns the armoury entity's weapon id.
*
* @note Not all weapon ids are supported by Counter-Strike, an armoury entity
* can not be a pistol, a knife or a bomb for exmaple. The full list is:
* CSW_SCOUT, CSW_HEGRENADE, CSW_XM1014, CSW_MAC10, CSW_AUG,
* CSW_SMOKEGRENADE, CSW_AWP, CSW_MP5NAVY, CSW_M249, CSW_M3, CSW_M4A1,
* CSW_TMP, CSW_G3SG1, CSW_VEST, CSW_VESTHELM, CSW_FLASHBANG,
* CSW_SG552, CSW_AK47, CSW_P90
*
* @param index Armoury entity index
* @param count Optional variable to store in the number of times that an item can be retrieved
* from the same entity before being hidden
*
* @return Weapon id
* @error If a non-armoury entity is provided, an error will be
* thrown.
*/
native cs_get_armoury_type(index, &count = 1);
/**
* Sets the amoury entity type.
*
* @note Not all weapon ids are supported by Counter-Strike, an armoury entity
* can not be a pistol, a knife or a bomb for exmaple. The full list is:
* CSW_SCOUT, CSW_HEGRENADE, CSW_XM1014, CSW_MAC10, CSW_AUG,
* CSW_SMOKEGRENADE, CSW_AWP, CSW_MP5NAVY, CSW_M249, CSW_M3, CSW_M4A1,
* CSW_TMP, CSW_G3SG1, CSW_VEST, CSW_VESTHELM, CSW_FLASHBANG,
* CSW_SG552, CSW_AK47, CSW_P90
* @note This does not update the entity model.
* @note On restart, entity is always unhidden and the count is restored (this can not be below 1).
*
* @param index Armoury entity index
* @param type Weapon id
* @param count Number of times that an item can be retrieved from
* the same entity before being hidden
* If zero, the entity is hidden
* If below zero, nothing is set
* @noreturn
* @error If a non-armoury entity is provided, an error will be
* thrown.
*/
native cs_set_armoury_type(index, type, count = -1);
/**
* Returns the map zones the client is inside of as a bitflag value.
*
* @note If the user does not have the ability to plant (cs_get_user_plant()
* returns 0) then the bitflag will not contain CS_MAPZONE_BOMBTARGET.
* @nore For a list of possible zone flags see the CS_MAPZONE_* constants.
*
* @param index Client index
*
* @return Bitflag value of map zones
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_mapzones(index);
/**
* Sets a zoom type on the client.
*
* @note Zoom types are not tied to their intended weapons, so any zoom type can
* be combined with any weapon.
* @note For a list of possible zoom types see the zoom type enum above
* (CS_*_ZOOM constants).
*
* @param index Client index
* @param type Zoom type
* @param mode If zero (blocking) the client will be forced to use the zoom
* type set and won't be able to change it until it is reset
* with CS_RESET_ZOOM, otherwise the user can restore back to
* normal as usual
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, the client is not connected, or an invalid zoom
* type is provided, an error will be thrown.
*/
native cs_set_user_zoom(index, type, mode);
/**
* Returns if the client is zooming.
*
* @note For a list of possible zoom types see the zoom type enum above
* (CS_*_ZOOM constants).
*
* @param index Client index
*
* @return Zoom type if the user is zoomed in, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_zoom(index);
/**
* Returns if a submodel is set on the client.
*
* @note In Counter-Strike the submodel setting determines whether the user has
* a bomb backpack (if a Terrorist) or a defuse kit (if a CT) on their
* model.
*
* @param index Client index
*
* @return 1 if submodel is set, 0 otherwise
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
* thrown.
*/
native cs_get_user_submodel(index);
/**
* Sets the submodel on a client.
*
* @note In Counter-Strike the submodel setting determines whether the user has
* a bomb backpack (if a Terrorist) or a defuse kit (if a CT) on their
* model.
*
* @param index Client index
* @param value If nonzero the submodel is set, otherwise it is removed
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
*/
native cs_set_user_submodel(index, value);
/**
* Returns the client's last activity time.
*
* @note This is the time that the internal Counter-Strike afk kicker uses to
* see who has been inactive too long.
*
* @param index Client index
*
* @return Last activity time
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
*/
native Float:cs_get_user_lastactivity(index);
/**
* Sets the client's last activity time.
*
* @note This is the time that the internal Counter-Strike afk kicker uses to
* see who has been inactive too long.
*
* @param index Client index
* @param value New last activity time
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
*/
native cs_set_user_lastactivity(index, Float:value);
/**
* Returns the amount of hostages that the client has killed.
*
* @note This is the value that the internal Counter-Strike hostage punisher
* uses to determine if a client should be kicked, depending on the
* value of the mp_hostagepenalty value.
*
* @param index Client index
*
* @return Amount of hostages killed
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
*/
native cs_get_user_hostagekills(index);
/**
* Sets the amount of hostages that the client has killed.
*
* @note This is the value that the internal Counter-Strike hostage punisher
* uses to determine if a client should be kicked, depending on the
* value of the mp_hostagepenalty value. The punisher only checks this
* value when a hostage is killed, so setting this will not cause the
* client to be kicked until they actually kill a hostage.
*
* @param index Client index
* @param value New amount of hostages killed
*
* @noreturn
* @error If the client index is not within the range of 1 to
* MaxClients, or the client is not connected, an error will be
*/
native cs_set_user_hostagekills(index, value);
/**
* Returns the last time a hostage was used.
*
* @param index Hostage entity
*
* @return Last use time
* @error If the provided entity index is not a hostage, an error will
* be thrown.
*/
native Float:cs_get_hostage_lastuse(index);
/**
* Sets the last time a hostage was used.
*
* @param index Hostage entity
* @param value New last use time
*
* @noreturn
* @error If the provided entity index is not a hostage, an error will
* be thrown.
*/
native cs_set_hostage_lastuse(index, Float:value);
/**
* Returns the next time a hostage can be used.
*
* @param index Hostage entity
*
* @return Next use time
* @error If the provided entity index is not a hostage, an error will
* be thrown.
*/
native Float:cs_get_hostage_nextuse(index);
/**
* Sets the next time a hostage can be used.
*
* @param index Hostage entity
* @param value New next use time
*
* @noreturn
* @error If the provided entity index is not a hostage, an error will
* be thrown.
*/
native cs_set_hostage_nextuse(index, Float:value);
/**
* Returns the game time at which the bomb will explode.
*
* @param index C4 entity
*
* @return Explosion time
* @error If the provided entity index is not a bomb, an error will be
* thrown.
*/
native Float:cs_get_c4_explode_time(index);
/**
* Sets the game time at which the bomb will explode.
*
* @param index C4 entity
* @param value New explosion time
*
* @noreturn
* @error If the provided entity index is not a bomb, an error will be
* thrown.
*/
native cs_set_c4_explode_time(index, Float:value);
/**
* Returns if the bomb is being defused.
*
* @param c4index C4 entity
*
* @return 1 if the bomb is being defused, 0 otherwise
* @error If the provided entity index is not a bomb, an error will be
* thrown.
*/
native bool:cs_get_c4_defusing(c4index);
/**
* Sets if the bomb is being defused.
*
* @param c4index C4 entity
* @param defusing True if the bomb should be defused, false otherwise
*
* @noreturn
* @error If the provided entity index is not a bomb, an error will be
* thrown.
*/
native cs_set_c4_defusing(c4index, bool:defusing);
/**
* Creates an entity using Counter-Strike's custom CreateNamedEntity wrapper.
*
* @note Unlike other mods CS keeps track of entities using a custom hashtable.
* This function adds entities to this hashtable, providing benefits over
* the default CreateNamedEntity (used by create_entity() for example):
* - Storing entities in a hashtable allows CS to improve classname lookup
* performance compared to functions like FindEntityByString (used by
* find_ent_by_class() for example) that usually have to loop
* through all entities incrementally.
* - As CS exclusively uses the hashtable for classname lookup, entities
* created using the default engine functions will not be found by the
* game. For example "weaponbox" entities are supposed to be
* automatically cleaned up on round restart but are not considered if
* they have not been added to the hashtable.
* @note The faster hashtable lookup can be utilized with cs_find_ent_by_class()
* @note When creating an entity the classname has to be valid in the mod, as
* the engine needs to link the entity to an existing class internally.
* The classname string that is stored in the entvar struct
* (EV_SZ_classname) is separate from this association and can later be
* freely changed to serve other purposes.
*
* @param classname Entity class name
*
* @return Index of the created entity (> 0), 0 otherwise
*/
native cs_create_entity(const classname[]);
/**
* Finds an entity in the world using Counter-Strike's custom FindEntityByString
* wrapper.
*
* @note Unlike other mods CS keeps track of entities using a custom hashtable.
* This function utilizes the hasthable and allows for considerably faster
* classname lookup compared to the default FindEntityByString (used by
* find_ent_by_class() for example).
* @note This exclusively considers entities in the hashtable, created by the
* game itself or using cs_create_entity().
*
* @param start_index Entity index to start searching from. -1 to start from
* the first entity
* @param classname Classname to search for
*
* @return Entity index > 0 if found, 0 otherwise
*/
native cs_find_ent_by_class(start_index, const classname[]);
/**
* Finds an entity in the world using Counter-Strike's custom FindEntityByString
* wrapper, matching by owner.
*
* @note Unlike other mods CS keeps track of entities using a custom hashtable.
* This function utilizes the hasthable and allows for considerably faster
* classname lookup compared to the default FindEntityByString (used by
* find_ent_by_owner() for example).
* @note This exclusively considers entities in the hashtable, created by the
* game itself or using cs_create_entity().
*
* @param start_index Entity index to start searching from. -1 to start from
* the first entity
* @param classname Classname to search for
* @param owner Entity index to search for entity's owner
*
* @return Entity index > 0 if found, 0 otherwise
*/
native cs_find_ent_by_owner(start_index, const classname[], owner);
/**
* Returns the item id associated with an item name and its aliases.
*
* @note The item name is case sensitive an can be with or without
* weapon_ and item_ prefixes. This can be a command alias as well.
* Values examples: ak47, weapon_ak47, kevlar, item_kevlar, vest, bullpup, ...
*
* @param name Alias or classname
* @param classid If item is a weapon, variable to store the associated
* weapon class id in (CS_WEAPONCLASS_* constants)
*
* @return Item id (CSI_* constants)
*/
native any:cs_get_item_id(const name[], &CsWeaponClassType:classid = CS_WEAPONCLASS_NONE);
/**
* Returns an item name associated with a command alias.
*
* @note The alias is case sensitive.
* @note If not an alias to a weapon, buffer will be set with the original alias.
*
* @param alias Alias name
* @param itemname Buffer to store item name to
* @param maxlength Maximum buffer size
*
* @return True if alias is translated, false otherwise
*/
native bool:cs_get_translated_item_alias(const alias[], itemname[], maxlength);
/**
* Returns some information about a weapon.
*
* @param weapon_id Weapon id, see CSW_* constants
* @param type Info type, see CS_WEAPONINFO_* constants
*
* @return Weapon information value
* @error If weapon_id and type are out of bound, an error will be thrown.
*/
native any:cs_get_weapon_info(weapon_id, CsWeaponInfo:type);
/**
* Returns a weapon class id associated with a weapon id.
*
* @param weapon_id Weapon id (CSI_* constants)
*
* @return Weapon class id (CS_WEAPONCLASS_* constants)
*/
stock CsWeaponClassType:cs_get_weapon_class(weapon_id)
{
new CsWeaponClassType:type = CS_WEAPONCLASS_NONE;
if (cs_is_valid_itemid(weapon_id, .weapon_only = true) || weapon_id == CSI_SHIELD)
{
switch (weapon_id)
{
case CSI_SHIELDGUN, CSI_SHIELD:
{
type = CS_WEAPONCLASS_PISTOL;
}
case CSI_KNIFE:
{
type = CS_WEAPONCLASS_KNIFE;
}
default:
{
new const bits = (1 << weapon_id);
if(bits & CSI_ALL_PISTOLS)
{
type = CS_WEAPONCLASS_PISTOL;
}
else if(bits & CSI_ALL_GRENADES)
{
type = CS_WEAPONCLASS_GRENADE;
}
else if(bits & CSI_ALL_SMGS)
{
type = CS_WEAPONCLASS_SUBMACHINEGUN;
}
else if(bits & CSI_ALL_SHOTGUNS)
{
type = CS_WEAPONCLASS_SHOTGUN;
}
else if(bits & CSI_ALL_MACHINEGUNS)
{
type = CS_WEAPONCLASS_MACHINEGUN;
}
else if(bits & CSI_ALL_RIFLES)
{
type = CS_WEAPONCLASS_RIFLE;
}
else if(bits & CSI_ALL_SNIPERRIFLES)
{
type = CS_WEAPONCLASS_SNIPERRIFLE;
}
}
}
}
return type;
}
/**
* Checks whether an item id is not out of bounds.
*
* @param id Item id (CSI_* constants)
* @param weapon_only If true, only the real weapon ids will be checked,
* including shield as well
*
* @return True if item id is valid, false otherwise
*/
stock bool:cs_is_valid_itemid(id, bool:weapon_only = false)
{
if (id <= CSI_NONE)
{
return false;
}
if (id > CSI_LAST_WEAPON && id != CSI_SHIELDGUN && weapon_only)
{
return false;
}
if (id >= CSI_MAX_COUNT)
{
return false;
}
return true;
}
/**
* Called when CS internally fires a command to a player.
*
* @note This is most notably used by the rebuy/autobuy functionality,
* Condition Zero also uses this to pass commands to bots internally.
*
* @param id Client index
* @param cmd Command string
*
* @return PLUGIN_CONTINUE to let the command continue
* PLUGIN_HANDLED to block the command
*/
forward CS_InternalCommand(id, const cmd[]);
/**
* Called when a client attempts to purchase an item.
*
* @note This is called immediately when the client issues a buy command. The
* game has not yet checked if the client can actually buy the weapon.
* @note For a list of possible item ids see the CSI_* constants.
*
* @param index Client index
* @param item Item id
*
* @return PLUGIN_CONTINUE to let the buy attempt continue
* PLUGIN_HANDLED to block the buy attempt
*/
forward CS_OnBuyAttempt(index, item);
/**
* Called when a client purchases an item.
*
* @note This is called right before the user receives the item and before the
* money is deducted from their cash reserves.
* @note For a list of possible item ids see the CSI_* constants.
*
* @param index Client index
* @param item Item id
*
* @return PLUGIN_CONTINUE to let the buy continue
* PLUGIN_HANDLED to block the buy
*/
forward CS_OnBuy(index, item);
Reference in New Issue View Git Blame Copy Permalink