pymodcs 0.17.1__py3-none-any.whl

pymod/__init__.pyi

@@ -0,0 +1,1413 @@
+"""IDE definitions for PyMod 0.17.1. Do not deploy this SDK as the server runtime."""
+from typing import Any, Callable, Iterator
+from asyncio import Task
+from ._movement import PlayerMovement as PlayerMovement
+from ._movement import Vector as Vector
+from ._movement import Movement as Movement
+from ._movement import Buttons as Buttons
+from ._movement import PlayerFlags as PlayerFlags
+from ._movement import MoveType as MoveType
+from ._color import Color as Color
+from ._position import Position as Position
+from ._player import PlayerActions as PlayerActions
+from ._player import WeaponId as WeaponId
+from ._player import WeaponState as WeaponState
+from ._player import AmmoState as AmmoState
+from ._player import Rendering as Rendering
+from ._geometry import PlayerStateHelpers as PlayerStateHelpers
+from ._geometry import Team as Team
+from ._geometry import Box as Box
+from ._geometry import Zone as Zone
+from ._services import CommandContext as CommandContext
+from ._services import config as config
+from ._services import storage as storage
+from ._services import permissions as permissions
+from ._services import targeting as targeting
+from ._services import server as server
+from ._database import database as database
+from ._menus import Menu as Menu
+from ._menus import MenuItem as MenuItem
+from . import web as web
+from ._hooks import hooks as hooks
+from ._hooks import HookResult as HookResult
+from ._entities import Entity as Entity
+from ._entities import EntityState as EntityState
+from ._entities import entities as entities
+from ._entities import trace as trace
+from ._entities import Trace as Trace
+from ._entities import Hull as Hull
+from ._entities import Solid as Solid
+from ._entities import sounds as sounds
+from ._resources import resources as resources
+from ._cvars import cvars as cvars
+from ._cvars import Cvar as Cvar
+from ._cvars import CvarFlags as CvarFlags
+from ._cvars import CvarChange as CvarChange
+from ._hud import Hud as Hud
+from ._events import PlayerSpawn as PlayerSpawn
+from ._events import PlayerDeath as PlayerDeath
+from ._events import RoundEvent as RoundEvent
+from ._events import GameMessage as GameMessage
+from ._cs import cs as cs
+from ._cs import CsInfo as CsInfo
+from ._cs import CsContext as CsContext
+from ._cs import CsSnapshot as CsSnapshot
+from ._cs import DamageType as DamageType
+from ._cs import CsHookContext as CsHookContext
+from ._cs import CsHookSnapshot as CsHookSnapshot
+from ._cs_types import CsTrace as CsTrace
+from ._cs_types import CsMovement as CsMovement
+from ._cs_types import CsPhysent as CsPhysent
+from ._cs_types import GameRulesState as GameRulesState
+from ._cs_types import CsLifecycleRecord as CsLifecycleRecord
+from ._effects import effects as effects
+from ._messages import Packet as Packet
+from ._plugins import services as services
+from ._voice import voice as voice
+from ._chat import chat as chat
+from ._i18n import i18n as i18n
+from ._i18n import tr as tr
+from ._simple_db import SQLite as SQLite
+from ._simple_db import Table as Table
+from ._simple_db import Record as Record
+from ._assets import Model as Model
+from ._assets import Sound as Sound
+from ._assets import Sprite as Sprite
+from ._assets import Music as Music
+from ._plugin import Plugin as Plugin
+from ._plugin import Players as Players
+from ._plugin import PlayerGroup as PlayerGroup
+from ._plugin import command as command
+from ._plugin import console_command as console_command
+from ._plugin import every as every
+from ._plugin import hook as hook
+from ._plugin import listen as listen
+from ._plugin import service as service
+from ._plugin import page as page
+from . import hook_events as hook_events
+from ._hook_api import Event as Event
+from ._hook_api import HookEvent as HookEvent
+from ._hook_api import HookSnapshot as HookSnapshot
+from ._timing import Cooldown as Cooldown
+from ._timing import chance as chance
+from ._timing import wait as wait
+from ._schema import Config as Config
+from ._schema import ConfigField as ConfigField
+from ._plugin import Settings as Settings
+from ._player import WeaponState, AmmoState, Rendering
+__version__: str
+
+class Player:
+    """RU:
+Игрок и конкретное подключение. Сохранённый объект не начнёт управлять другим игроком при повторном использовании слота.
+
+EN:
+A player connection handle. A retained object never targets a different connection reusing the same slot."""
+
+    @property
+    def bounds(self) -> tuple[Vector, Vector]:
+        """RU:
+Фактические границы тела объекта, включая приседание.
+
+EN:
+Actual entity hull bounds, including crouching."""
+        ...
+
+    @property
+    def is_crouching(self) -> bool:
+        """RU:
+Игрок присел.
+
+EN:
+Whether the player is crouching."""
+        ...
+    on_ground: bool
+
+    @property
+    def in_air(self) -> bool:
+        """RU:
+Игрок находится в воздухе.
+
+EN:
+Whether the player is airborne."""
+        ...
+
+    @property
+    def speed(self) -> float:
+        """RU:
+Полная скорость в единицах карты в секунду.
+Примечания реализации / Implementation notes:
+Полная скорость игрока.
+
+EN:
+Full speed in map units per second.
+Implementation notes / Примечания реализации:
+Полная скорость игрока."""
+        ...
+
+    @property
+    def horizontal_speed(self) -> float:
+        """RU:
+Горизонтальная скорость в единицах карты в секунду.
+Примечания реализации / Implementation notes:
+Скорость в горизонтальной плоскости.
+
+EN:
+Horizontal speed in map units per second.
+Implementation notes / Примечания реализации:
+Скорость в горизонтальной плоскости."""
+        ...
+
+    @property
+    def is_moving(self) -> bool:
+        """RU:
+Игрок движется со скоростью больше 1.
+
+EN:
+Whether the player moves faster than 1 map unit per second."""
+        ...
+
+    @property
+    def is_playing(self) -> bool:
+        """RU:
+Живой игрок в команде T или CT; вход до выбора команды исключается.
+Примечания реализации / Implementation notes:
+Живой игрок в T/CT. Вход до выбора команды не считается игрой.
+
+EN:
+A living player on T or CT; initial connection before team selection is excluded.
+Implementation notes / Примечания реализации:
+Живой игрок в T/CT. Вход до выбора команды не считается игрой."""
+        ...
+
+    @property
+    def team_id(self) -> Team:
+        """RU:
+Команда как значение Team.
+
+EN:
+The team as a Team value."""
+        ...
+
+    def in_team(self, team) -> bool:
+        """RU:
+Проверяет команду игрока; используйте Team.T, Team.CT или Team.SPECTATOR.
+Параметры: team.
+
+EN:
+Checks the player's team; use Team.T, Team.CT or Team.SPECTATOR.
+Parameters: team."""
+        ...
+
+    def inside(self, zone) -> bool:
+        """RU:
+Проверяет нахождение игрока в зоне с учётом размеров тела и фильтра команды.
+Параметры: zone.
+
+EN:
+Checks zone membership using the player's hull and the zone's team filter.
+Parameters: zone."""
+        ...
+
+    def presses(self, button) -> bool:
+        """RU:
+Проверяет, нажата ли кнопка сейчас; используйте Buttons.JUMP и другие значения Buttons.
+Параметры: button.
+
+EN:
+Checks whether a button is currently pressed; use Buttons.JUMP and other Buttons values.
+Parameters: button."""
+        ...
+
+    def was_pressing(self, button) -> bool:
+        """RU:
+Проверяет состояние кнопки в предыдущем игровом кадре.
+Параметры: button.
+
+EN:
+Checks a button's state in the preceding game frame.
+Parameters: button."""
+        ...
+
+    @property
+    def is_human(self) -> bool:
+        """RU:
+Обычный игрок, не бот и не HLTV.
+
+EN:
+A human player, excluding bots and HLTV."""
+        ...
+
+    @property
+    def is_swimming(self) -> bool:
+        """RU:
+Игрок погружён в воду как минимум по пояс.
+
+EN:
+Whether the player is at least waist-deep in water."""
+        ...
+
+    @property
+    def is_walking(self) -> bool:
+        """RU:
+Используется обычный тип движения WALK.
+
+EN:
+Whether the player uses WALK movement."""
+        ...
+
+    def launch(self, up: float=275) -> None:
+        """RU:
+Задаёт вертикальную скорость 0..4000, сохраняя горизонтальную скорость игрока.
+Параметры: up.
+Примечания реализации / Implementation notes:
+Вертикальная скорость прыжка от 0 до 4000. Горизонтальная скорость сохраняется.
+
+EN:
+Sets upward velocity from 0 to 4000 while preserving horizontal momentum.
+Parameters: up.
+Implementation notes / Примечания реализации:
+Вертикальная скорость прыжка от 0 до 4000. Горизонтальная скорость сохраняется."""
+        ...
+
+    def distance_to(self, other) -> float:
+        """RU:
+Возвращает расстояние до точки или поддерживаемого игрового объекта в единицах карты.
+Параметры: other.
+
+EN:
+Returns distance to a point or supported game object in map units.
+Parameters: other."""
+        ...
+
+    def nearby(self, radius, *, alive=True) -> PlayerGroup:
+        """RU:
+Возвращает других игроков в радиусе от текущего игрока; alive фильтрует живых.
+Параметры: radius, alive.
+
+EN:
+Returns other players within the radius; alive controls the alive-player filter.
+Parameters: radius, alive."""
+        ...
+
+    def push_away(self, position: Vector | tuple[float, float, float], *, speed=300, lift=180) -> None:
+        """RU:
+Отталкивает игрока от точки: speed — горизонтальная скорость, lift — подъём.
+Параметры: position, speed, lift.
+
+EN:
+Pushes the player away from a point: speed is horizontal velocity and lift is upward velocity.
+Parameters: position, speed, lift."""
+        ...
+
+    def glow(self, color: Color | str | tuple[int, int, int] | None='#00AAFF', *, seconds: float=5, amount: float=25) -> Any:
+        """RU:
+Временно задаёт цветное свечение; seconds — время, amount — интенсивность.
+Параметры: color, seconds, amount.
+
+EN:
+Applies temporary colored glow; seconds is duration and amount is intensity.
+Parameters: color, seconds, amount."""
+        ...
+
+    def set_speed(self, speed, *, seconds: float=10) -> Any:
+        """RU:
+Временно меняет предел скорости игрока; seconds задаёт срок эффекта.
+Параметры: speed, seconds.
+
+EN:
+Temporarily changes the player's speed limit; seconds sets effect duration.
+Parameters: speed, seconds."""
+        ...
+
+    def set_gravity(self, multiplier, *, seconds: float=10) -> Any:
+        """RU:
+Временно меняет множитель гравитации игрока.
+Параметры: multiplier, seconds.
+
+EN:
+Temporarily changes the player's gravity multiplier.
+Parameters: multiplier, seconds."""
+        ...
+
+    def give(self, item, *, reserve=None) -> Entity | None:
+        """RU:
+Выдаёт оружие по короткому имени, например 'awp', WeaponId или classname. reserve задаёт запас патронов.
+Параметры: item, reserve.
+Примечания реализации / Implementation notes:
+Выдать оружие, например player.give("awp", reserve=30).
+
+EN:
+Gives a short weapon name such as 'awp', WeaponId or classname. reserve sets reserve ammunition.
+Parameters: item, reserve.
+Implementation notes / Примечания реализации:
+Выдать оружие, например player.give("awp", reserve=30)."""
+        ...
+
+    def has(self, weapon) -> bool:
+        """RU:
+Проверяет наличие указанного оружия у игрока.
+Параметры: weapon.
+
+EN:
+Checks whether the player has the specified weapon.
+Parameters: weapon."""
+        ...
+
+    def remove_weapon(self, weapon, *, remove_ammo=False) -> Any:
+        """RU:
+Удаляет указанное оружие у игрока.
+Параметры: weapon, remove_ammo.
+
+EN:
+Removes the specified weapon from the player.
+Parameters: weapon, remove_ammo."""
+        ...
+
+    async def grant(self, permission: str, *, duration=None) -> Any:
+        """RU:
+Доверенная операция плагина: выдаёт право игроку; пустой срок означает навсегда. Проверяйте полномочия вызывающего перед выдачей.
+Параметры: permission, duration.
+Асинхронный метод: используйте await.
+Примечания реализации / Implementation notes:
+Trusted plugin operation; checks do not grant rights automatically.
+
+EN:
+Trusted plugin operation: grants a player permission; an omitted duration means permanent. Check the caller's authority before granting.
+Parameters: permission, duration.
+Asynchronous method: use await.
+Implementation notes / Примечания реализации:
+Trusted plugin operation; checks do not grant rights automatically."""
+        ...
+
+    async def revoke(self, permission: str) -> Any:
+        """RU:
+Отзывает прямое право игрока; права групп управляются отдельно.
+Параметры: permission.
+Асинхронный метод: используйте await.
+
+EN:
+Revokes a direct player permission; group permissions are managed separately.
+Parameters: permission.
+Asynchronous method: use await."""
+        ...
+
+    async def join_group(self, group, *, duration=None) -> Any:
+        """RU:
+Добавляет игрока в группу с необязательным сроком действия.
+Параметры: group, duration.
+Асинхронный метод: используйте await.
+
+EN:
+Adds a player to a group with an optional expiration.
+Parameters: group, duration.
+Asynchronous method: use await."""
+        ...
+
+    async def leave_group(self, group) -> Any:
+        """RU:
+Удаляет игрока из указанной группы.
+Параметры: group.
+Асинхронный метод: используйте await.
+
+EN:
+Removes a player from the named group.
+Parameters: group.
+Asynchronous method: use await."""
+        ...
+
+    @property
+    def nightvision(self) -> Any:
+        """RU:
+API PyMod: Player.nightvision. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Player.nightvision. See the signature and original implementation notes below."""
+        ...
+
+    @nightvision.setter
+    def nightvision(self, value) -> None:
+        """RU:
+API PyMod: Player.nightvision. Сигнатура и исходные примечания приведены ниже.
+Параметры: value.
+
+EN:
+PyMod API: Player.nightvision. See the signature and original implementation notes below.
+Parameters: value."""
+        ...
+
+    @property
+    def address(self) -> Any:
+        """RU:
+API PyMod: Player.address. Сигнатура и исходные примечания приведены ниже.
+Примечания реализации / Implementation notes:
+Normalized connection IP, without port or authentication credentials.
+
+EN:
+PyMod API: Player.address. See the signature and original implementation notes below.
+Implementation notes / Примечания реализации:
+Normalized connection IP, without port or authentication credentials."""
+        ...
+
+    def ammo(self, weapon) -> Any:
+        """RU:
+Читает количество патронов выбранного оружия.
+Параметры: weapon.
+Примечания реализации / Implementation notes:
+Actual clip/reserve via the optional ReGameDLL PyMod interface.
+
+EN:
+Reads ammunition counts for the selected weapon.
+Parameters: weapon.
+Implementation notes / Примечания реализации:
+Actual clip/reserve via the optional ReGameDLL PyMod interface."""
+        ...
+
+    def set_ammo(self, weapon, *, clip=None, reserve=None) -> Any:
+        """RU:
+Меняет патроны в магазине и/или запасе указанного оружия.
+Параметры: weapon, clip, reserve.
+
+EN:
+Changes clip and/or reserve ammunition for the selected weapon.
+Parameters: weapon, clip, reserve."""
+        ...
+
+    def set_score(self, *, frags=0, deaths=0) -> Any:
+        """RU:
+Устанавливает фраги и смерти игрока.
+Параметры: frags, deaths.
+
+EN:
+Sets the player's frags and deaths.
+Parameters: frags, deaths."""
+        ...
+
+    def add_account(self, amount: float) -> Any:
+        """RU:
+Изменяет встроенные деньги Counter-Strike.
+Параметры: amount.
+Примечания реализации / Implementation notes:
+Change the built-in CS account through ReGameDLL AddAccount.
+
+EN:
+Changes the built-in Counter-Strike money balance.
+Parameters: amount.
+Implementation notes / Примечания реализации:
+Change the built-in CS account through ReGameDLL AddAccount."""
+        ...
+
+    @property
+    def money(self) -> Any:
+        """RU:
+Встроенные деньги CS.
+Примечания реализации / Implementation notes:
+Latest built-in CS Money update. Raises before the first update.
+
+EN:
+Built-in CS money balance.
+Implementation notes / Примечания реализации:
+Latest built-in CS Money update. Raises before the first update."""
+        ...
+
+    @property
+    def frags(self) -> int:
+        """RU:
+Количество фрагов.
+
+EN:
+Frag count."""
+        ...
+
+    @property
+    def deaths(self) -> int:
+        """RU:
+Количество смертей.
+
+EN:
+Death count."""
+        ...
+
+    def drop_primary(self) -> Any:
+        """RU:
+Выбрасывает основное оружие игрока.
+
+EN:
+Drops the player's primary weapon."""
+        ...
+
+    @property
+    def active_weapon(self) -> Any:
+        """RU:
+API PyMod: Player.active_weapon. Сигнатура и исходные примечания приведены ниже.
+Примечания реализации / Implementation notes:
+Latest CurWeapon observation, or None before the first active update.
+
+EN:
+PyMod API: Player.active_weapon. See the signature and original implementation notes below.
+Implementation notes / Примечания реализации:
+Latest CurWeapon observation, or None before the first active update."""
+        ...
+
+    @property
+    def view_model(self) -> Any:
+        """RU:
+API PyMod: Player.view_model. Сигнатура и исходные примечания приведены ниже.
+Примечания реализации / Implementation notes:
+Current engine first-person model; reflects Deploy before CurWeapon.
+
+EN:
+PyMod API: Player.view_model. See the signature and original implementation notes below.
+Implementation notes / Примечания реализации:
+Current engine first-person model; reflects Deploy before CurWeapon."""
+        ...
+
+    def drop_secondary(self) -> Any:
+        """RU:
+Выбрасывает пистолет игрока.
+
+EN:
+Drops the player's secondary weapon."""
+        ...
+
+    def remove_item(self, classname: str, *, remove_ammo=False) -> Any:
+        """RU:
+Удаляет предмет игрока по classname.
+Параметры: classname, remove_ammo.
+
+EN:
+Removes a player item by classname.
+Parameters: classname, remove_ammo."""
+        ...
+
+    def join_team(self, team) -> Any:
+        """RU:
+Переводит игрока в указанную команду через игровой API.
+Параметры: team.
+Примечания реализации / Implementation notes:
+ReGameDLL JoinTeam performs observer/team state transitions.
+
+EN:
+Moves the player to a team through the game API.
+Parameters: team.
+Implementation notes / Примечания реализации:
+ReGameDLL JoinTeam performs observer/team state transitions."""
+        ...
+
+    def set_model(self, path) -> Any:
+        """RU:
+Назначает модель игроку.
+Параметры: path.
+
+EN:
+Assigns the player's model.
+Parameters: path."""
+        ...
+
+    def reset_model(self) -> Any:
+        """RU:
+Восстанавливает стандартную модель игрока.
+
+EN:
+Restores the player's default model."""
+        ...
+
+    def reload_weapons(self, *, refill=False) -> Any:
+        """RU:
+Запрашивает перезарядку оружия через GameDLL.
+Параметры: refill.
+
+EN:
+Requests weapon reloading through GameDLL.
+Parameters: refill."""
+        ...
+
+    def set_animation(self, animation) -> None:
+        """RU:
+Устанавливает анимацию игрока через GameDLL.
+Параметры: animation.
+
+EN:
+Sets a player animation through GameDLL.
+Parameters: animation."""
+        ...
+
+    def client_command(self, command, *args) -> None:
+        """RU:
+Отправляет разрешённую клиентскую команду отдельному игроку; аргументы передаются отдельно.
+Параметры: command.
+Примечания реализации / Implementation notes:
+Queue one command; client restrictions may decline it. No separators.
+
+EN:
+Sends an allowed client command to one player; pass arguments separately.
+Parameters: command.
+Implementation notes / Примечания реализации:
+Queue one command; client restrictions may decline it. No separators."""
+        ...
+
+    @property
+    def is_bot(self) -> bool:
+        """RU:
+Подключение является ботом.
+
+EN:
+Whether the connection is a bot."""
+        ...
+
+    @property
+    def is_hltv(self) -> bool:
+        """RU:
+Подключение является HLTV.
+
+EN:
+Whether the connection is HLTV."""
+        ...
+
+    @property
+    def ping(self) -> int:
+        """RU:
+API PyMod: Player.ping. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Player.ping. See the signature and original implementation notes below."""
+        ...
+
+    @property
+    def packet_loss(self) -> int:
+        """RU:
+API PyMod: Player.packet_loss. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Player.packet_loss. See the signature and original implementation notes below."""
+        ...
+
+    @property
+    def observer_target(self) -> Player | None:
+        """RU:
+API PyMod: Player.observer_target. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Player.observer_target. See the signature and original implementation notes below."""
+        ...
+
+    def give_item(self, classname: str) -> Entity | None:
+        """RU:
+Выдаёт предмет по classname и возвращает объект предмета, если он создан.
+Параметры: classname.
+
+EN:
+Gives an item by classname and returns its entity if created.
+Parameters: classname."""
+        ...
+
+    def strip_items(self) -> None:
+        """RU:
+Удаляет предметы из инвентаря игрока.
+
+EN:
+Removes items from the player's inventory."""
+        ...
+
+    def give_ammo(self, amount: int, ammo, *, maximum=-1) -> int:
+        """RU:
+Выдаёт патроны выбранного типа и возвращает результат GameDLL.
+Параметры: amount, ammo, maximum.
+
+EN:
+Gives ammunition of the selected type and returns the GameDLL result.
+Parameters: amount, ammo, maximum."""
+        ...
+
+    @property
+    def weapons(self) -> tuple[WeaponState, ...]:
+        """RU:
+Оружие в инвентаре игрока.
+
+EN:
+Weapons in the player's inventory."""
+        ...
+
+    def has_weapon(self, weapon) -> bool:
+        """RU:
+Проверяет наличие оружия в инвентаре игрока.
+Параметры: weapon.
+
+EN:
+Checks whether the player's inventory contains a weapon.
+Parameters: weapon."""
+        ...
+
+    def take_damage(self, amount: float, *, damage_type=0, attacker=None, inflictor=None) -> bool:
+        """RU:
+Наносит урон через игровой API с указанным источником и типом.
+Параметры: amount, damage_type, attacker, inflictor.
+
+EN:
+Applies damage through the game API with the specified source and damage type.
+Parameters: amount, damage_type, attacker, inflictor."""
+        ...
+
+    def heal(self, amount: float=100, *, maximum=None, damage_type=0) -> bool | float:
+        """RU:
+Лечит игрока. Ограниченный вариант с maximum возвращает фактическую прибавку; обычный вызов использует GameDLL.
+Параметры: amount, maximum, damage_type.
+Примечания реализации / Implementation notes:
+Normal healing uses GameDLL; explicit maximum permits bounded bonus HP.
+
+EN:
+Heals a player. The bounded maximum variant returns the actual increase; the ordinary call uses GameDLL.
+Parameters: amount, maximum, damage_type.
+Implementation notes / Примечания реализации:
+Normal healing uses GameDLL; explicit maximum permits bounded bonus HP."""
+        ...
+
+    def kill(self, *, attacker=None, gib=0) -> None:
+        """RU:
+Убивает игрока через игровой API.
+Параметры: attacker, gib.
+
+EN:
+Kills the player through the game API.
+Parameters: attacker, gib."""
+        ...
+
+    def respawn(self) -> bool:
+        """RU:
+Возрождает игрока через GameDLL; результат сообщает об успешности операции.
+
+EN:
+Respawns the player through GameDLL; returns whether the operation succeeded."""
+        ...
+
+    def reset_max_speed(self) -> None:
+        """RU:
+Пересчитывает предельную скорость игрока по правилам игры.
+
+EN:
+Recalculates the player's maximum speed using game rules."""
+        ...
+
+    @property
+    def team(self) -> str:
+        """RU:
+Команда игрока.
+
+EN:
+The player's team."""
+        ...
+
+    def add_frags(self, amount: float, *, allow_negative=False) -> Any:
+        """RU:
+Изменяет количество фрагов игрока.
+Параметры: amount, allow_negative.
+
+EN:
+Changes the player's frag count.
+Parameters: amount, allow_negative."""
+        ...
+
+    @property
+    def rendering(self) -> Any:
+        """RU:
+API PyMod: Player.rendering. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Player.rendering. See the signature and original implementation notes below."""
+        ...
+
+    @rendering.setter
+    def rendering(self, style) -> None:
+        """RU:
+API PyMod: Player.rendering. Сигнатура и исходные примечания приведены ниже.
+Параметры: style.
+
+EN:
+PyMod API: Player.rendering. See the signature and original implementation notes below.
+Parameters: style."""
+        ...
+
+    @property
+    def eye_position(self) -> Vector:
+        """RU:
+API PyMod: Player.eye_position. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Player.eye_position. See the signature and original implementation notes below."""
+        ...
+
+    def look_at(self, distance=4096, *, ignore_players=False) -> Trace:
+        """RU:
+Трассирует направление взгляда и возвращает Trace с точкой и объектом попадания.
+Параметры: distance, ignore_players.
+Примечания реализации / Implementation notes:
+Trace from the CS player's eyes; returns hit/end/fraction, not a raw tuple.
+
+EN:
+Traces along the player's view and returns Trace with the endpoint and hit entity.
+Parameters: distance, ignore_players.
+Implementation notes / Примечания реализации:
+Trace from the CS player's eyes; returns hit/end/fraction, not a raw tuple."""
+        ...
+
+    def teleport(self, position: Vector | tuple[float, float, float], *, stop=True) -> None:
+        """RU:
+Перемещает игрока в указанные координаты; дополнительные параметры управляют направлением и скоростью.
+Параметры: position, stop.
+Примечания реализации / Implementation notes:
+Relink through the engine; use look_at/trace to choose a safe destination.
+
+EN:
+Teleports the player to coordinates; optional parameters control orientation and velocity.
+Parameters: position, stop.
+Implementation notes / Примечания реализации:
+Relink through the engine; use look_at/trace to choose a safe destination."""
+        ...
+
+    def accelerate_forward(self, amount: float, *, maximum_speed=1200, horizontal=True) -> None:
+        """RU:
+API PyMod: Player.accelerate_forward. Сигнатура и исходные примечания приведены ниже.
+Параметры: amount, maximum_speed, horizontal.
+
+EN:
+PyMod API: Player.accelerate_forward. See the signature and original implementation notes below.
+Parameters: amount, maximum_speed, horizontal."""
+        ...
+    movement: Movement
+    origin: Vector
+    velocity: Vector
+    base_velocity: Vector
+    punch_angle: Vector
+    view_angles: Vector
+    buttons: Buttons
+    old_buttons: Buttons
+    move_type: MoveType
+    gravity: float
+    friction: float
+    max_speed: float
+    jump_slowdown: float
+    flags: PlayerFlags
+    water_level: int
+
+    def __init__(self, index, token) -> None:
+        ...
+
+    def __eq__(self, other) -> Any:
+        ...
+
+    def __hash__(self) -> Any:
+        ...
+
+    @property
+    def index(self) -> int:
+        """RU:
+Номер игрового слота.
+
+EN:
+Engine slot index."""
+        ...
+
+    @property
+    def token(self) -> int:
+        """RU:
+Идентификатор конкретного подключения.
+
+EN:
+Token identifying this exact connection."""
+        ...
+
+    @property
+    def entity(self) -> Entity:
+        """RU:
+Игровой объект игрока.
+
+EN:
+The player's game entity."""
+        ...
+
+    @property
+    def connected(self) -> bool:
+        """RU:
+Подключён ли ещё именно этот игрок.
+
+EN:
+Whether this exact player connection is still active."""
+        ...
+
+    @property
+    def name(self) -> str:
+        """RU:
+Текущее имя игрока.
+
+EN:
+Current player name."""
+        ...
+
+    @property
+    def steam_id(self) -> str:
+        """RU:
+Идентификатор Steam подключения.
+
+EN:
+Connection Steam ID."""
+        ...
+
+    @property
+    def userid(self) -> int:
+        """RU:
+Серверный userid подключения.
+
+EN:
+Server userid for this connection."""
+        ...
+
+    @property
+    def alive(self) -> bool:
+        """RU:
+Жив ли игрок.
+
+EN:
+Whether the player is alive."""
+        ...
+
+    @property
+    def observing(self) -> bool:
+        """RU:
+Режим наблюдения, включая мёртвых игроков.
+Примечания реализации / Implementation notes:
+In observer mode, including spectators and dead players watching others.
+
+EN:
+Observer mode, including dead players watching others.
+Implementation notes / Примечания реализации:
+In observer mode, including spectators and dead players watching others."""
+        ...
+
+    @property
+    def health(self) -> float:
+        """RU:
+Количество здоровья игрока.
+
+EN:
+The player's health."""
+        ...
+
+    @health.setter
+    def health(self, value) -> None:
+        """RU:
+API PyMod: Player.health. Сигнатура и исходные примечания приведены ниже.
+Параметры: value.
+
+EN:
+PyMod API: Player.health. See the signature and original implementation notes below.
+Parameters: value."""
+        ...
+
+    @property
+    def armor(self) -> float:
+        """RU:
+Количество брони игрока.
+
+EN:
+The player's armor."""
+        ...
+
+    @armor.setter
+    def armor(self, value) -> None:
+        """RU:
+API PyMod: Player.armor. Сигнатура и исходные примечания приведены ниже.
+Параметры: value.
+
+EN:
+PyMod API: Player.armor. See the signature and original implementation notes below.
+Parameters: value."""
+        ...
+
+    def say(self, message: str, *, color: Color | str | tuple[int, int, int] | None=None, prefix=None, **values) -> None:
+        """RU:
+Отправляет сообщение игроку. color — цвет, prefix — префикс этого сообщения; цвета чата ограничены палитрой CS.
+Параметры: message, color, prefix.
+Примечания реализации / Implementation notes:
+Сообщение конкретному игроку. prefix задаёт префикс этого сообщения; HEX чата переводится в палитру CS.
+
+EN:
+Sends a player a chat message. color sets color and prefix sets this message's prefix; CS chat has a limited palette.
+Parameters: message, color, prefix.
+Implementation notes / Примечания реализации:
+Сообщение конкретному игроку. prefix задаёт префикс этого сообщения; HEX чата переводится в палитру CS."""
+        ...
+    message = say
+
+    def in_group(self, name) -> bool:
+        """RU:
+Проверяет членство игрока в указанной группе.
+Параметры: name.
+
+EN:
+Checks whether the player belongs to the named group.
+Parameters: name."""
+        ...
+
+    def sound(self, resource) -> Any:
+        """RU:
+API PyMod: Player.sound. Сигнатура и исходные примечания приведены ниже.
+Параметры: resource.
+
+EN:
+PyMod API: Player.sound. See the signature and original implementation notes below.
+Parameters: resource."""
+        ...
+
+    def hud(self, text: str, *, color: Color | str | tuple[int, int, int] | None=None, seconds: float=3, position: Position | str | None=None, x: float=-1, y: float=0.2, channel: int | None=None) -> None:
+        """RU:
+Показывает HUD-сообщение: text — текст, seconds — секунды, position — Position или имя, color — Color/HEX/RGB.
+Параметры: text, color, seconds, position, x, y, channel.
+Примечания реализации / Implementation notes:
+Показать HUD игроку. position=Position.Center / Top / percent(...); seconds — время, color — RGB/HEX.
+
+EN:
+Shows a HUD message: text, seconds of visibility, position as Position or a name, and color as Color/HEX/RGB.
+Parameters: text, color, seconds, position, x, y, channel.
+Implementation notes / Примечания реализации:
+Показать HUD игроку. position=Position.Center / Top / percent(...); seconds — время, color — RGB/HEX."""
+        ...
+
+    def console(self, message: str) -> None:
+        """RU:
+Печатает сообщение в игровой консоли игрока.
+Параметры: message.
+
+EN:
+Prints a message in the player's game console.
+Parameters: message."""
+        ...
+
+    def kick(self, reason: str='Kicked by administrator') -> None:
+        """RU:
+Отключает конкретное подключение игрока с указанной причиной.
+Параметры: reason.
+
+EN:
+Disconnects this exact player connection with the supplied reason.
+Parameters: reason."""
+        ...
+
+    def has_permission(self, permission: str) -> bool:
+        """RU:
+Проверяет наличие права у игрока с учётом групп и срока действия.
+Параметры: permission.
+
+EN:
+Checks a player's permission including group membership and expiration.
+Parameters: permission."""
+        ...
+
+    def can(self, permission: str, *, description: str=None) -> bool:
+        """RU:
+Проверяет прямые права игрока и права его групп. Регистрирует неизвестное право, но не выдаёт его.
+Параметры: permission, description.
+Примечания реализации / Implementation notes:
+Проверяет право игрока и его групп. Само право автоматически регистрируется, но не выдаётся.
+
+EN:
+Checks direct and inherited group permissions. Registers an unknown permission but never grants it.
+Parameters: permission, description.
+Implementation notes / Примечания реализации:
+Проверяет право игрока и его групп. Само право автоматически регистрируется, но не выдаётся."""
+        ...
+
+    def can_any(self, *names) -> bool:
+        """RU:
+Истина, если у игрока есть хотя бы одно из перечисленных прав.
+Примечания реализации / Implementation notes:
+Any exact permission; all names are automatically registered.
+
+EN:
+True if the player has at least one of the listed permissions.
+Implementation notes / Примечания реализации:
+Any exact permission; all names are automatically registered."""
+        ...
+
+    def can_all(self, *names) -> bool:
+        """RU:
+Истина, если у игрока есть все перечисленные права.
+Примечания реализации / Implementation notes:
+Every exact permission; an empty request never grants access.
+
+EN:
+True if the player has every listed permission.
+Implementation notes / Примечания реализации:
+Every exact permission; an empty request never grants access."""
+        ...
+
+    def add_armor(self, amount: float=100, *, maximum=100) -> float:
+        """RU:
+Добавляет броню с ограничением maximum и возвращает фактическую прибавку.
+Параметры: amount, maximum.
+Примечания реализации / Implementation notes:
+Add armor points up to maximum; helmet/equipment type is unchanged.
+
+EN:
+Adds armor up to maximum and returns the actual increase.
+Parameters: amount, maximum.
+Implementation notes / Примечания реализации:
+Add armor points up to maximum; helmet/equipment type is unchanged."""
+        ...
+
+    def motd(self, content, title='PyMod') -> None:
+        """RU:
+Открывает MOTD игрока с указанным содержимым и заголовком.
+Параметры: content, title.
+Примечания реализации / Implementation notes:
+Send HTML/text/URL (1..1200 UTF-8 bytes); rendering depends on client.
+
+EN:
+Opens the player's MOTD using the supplied content and title.
+Parameters: content, title.
+Implementation notes / Примечания реализации:
+Send HTML/text/URL (1..1200 UTF-8 bytes); rendering depends on client."""
+        ...
+
+def log(message) -> Any:
+    """RU:
+Печатает сообщение в серверный журнал с контекстом плагина.
+Параметры: message.
+
+EN:
+Writes a message to the server log in the plugin's context.
+Parameters: message."""
+    ...
+
+class Disconnect:
+    """RU:
+API PyMod: Disconnect. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: Disconnect. See the signature and original implementation notes below."""
+    index: int
+    name: str
+    steam_id: str
+    userid: int
+
+def players(*, alive=None, team=None, permission=None, exclude=None) -> list[Player]:
+    """RU:
+API PyMod: players. Сигнатура и исходные примечания приведены ниже.
+Параметры: alive, team, permission, exclude.
+
+EN:
+PyMod API: players. See the signature and original implementation notes below.
+Parameters: alive, team, permission, exclude."""
+    ...
+
+def broadcast(message, **options) -> Any:
+    """RU:
+API PyMod: broadcast. Сигнатура и исходные примечания приведены ниже.
+Параметры: message.
+
+EN:
+PyMod API: broadcast. See the signature and original implementation notes below.
+Parameters: message."""
+    ...
+
+def cvar(name, value=None) -> Any:
+    """RU:
+API PyMod: cvar. Сигнатура и исходные примечания приведены ниже.
+Параметры: name, value.
+
+EN:
+PyMod API: cvar. See the signature and original implementation notes below.
+Parameters: name, value."""
+    ...
+
+class events:
+    """RU:
+API PyMod: events. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: events. See the signature and original implementation notes below."""
+
+    @staticmethod
+    def on(name) -> Any:
+        """RU:
+API PyMod: events.on. Сигнатура и исходные примечания приведены ниже.
+Параметры: name.
+Примечания реализации / Implementation notes:
+Events: map_start(str), player_join(Player), player_disconnect(Disconnect).
+
+EN:
+PyMod API: events.on. See the signature and original implementation notes below.
+Parameters: name.
+Implementation notes / Примечания реализации:
+Events: map_start(str), player_join(Player), player_disconnect(Disconnect)."""
+        ...
+
+    @staticmethod
+    def filter(name) -> Any:
+        """RU:
+API PyMod: events.filter. Сигнатура и исходные примечания приведены ниже.
+Параметры: name.
+Примечания реализации / Implementation notes:
+Synchronous filter: True consumes. chat_format runs after chat moderation
+and only for messages that are not registered chat commands.
+
+EN:
+PyMod API: events.filter. See the signature and original implementation notes below.
+Parameters: name.
+Implementation notes / Примечания реализации:
+Synchronous filter: True consumes. chat_format runs after chat moderation
+and only for messages that are not registered chat commands."""
+        ...
+
+class commands:
+    """RU:
+API PyMod: commands. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: commands. See the signature and original implementation notes below."""
+
+    @staticmethod
+    def client(name, *, permission=None) -> Any:
+        """RU:
+API PyMod: commands.client. Сигнатура и исходные примечания приведены ниже.
+Параметры: name, permission.
+Примечания реализации / Implementation notes:
+Client-only command (including legacy binds); callback(context, args).
+
+Uses an owned ClientCommand filter, so unloading restores engine handling.
+Server/RCON commands continue to use the py_ namespace via console().
+
+EN:
+PyMod API: commands.client. See the signature and original implementation notes below.
+Parameters: name, permission.
+Implementation notes / Примечания реализации:
+Client-only command (including legacy binds); callback(context, args).
+
+Uses an owned ClientCommand filter, so unloading restores engine handling.
+Server/RCON commands continue to use the py_ namespace via console()."""
+        ...
+
+    @staticmethod
+    def chat(name, *, consume=True, permission=None, help='') -> Any:
+        """RU:
+API PyMod: commands.chat. Сигнатура и исходные примечания приведены ниже.
+Параметры: name, consume, permission, help.
+Примечания реализации / Implementation notes:
+Handler(player, args: list[str]); consume decision is synchronous.
+
+EN:
+PyMod API: commands.chat. See the signature and original implementation notes below.
+Parameters: name, consume, permission, help.
+Implementation notes / Примечания реализации:
+Handler(player, args: list[str]); consume decision is synchronous."""
+        ...
+
+    @staticmethod
+    def console(name, *, permission=None, help='') -> Any:
+        """RU:
+Печатает сообщение в игровой консоли игрока.
+Параметры: name, permission, help.
+Примечания реализации / Implementation notes:
+Handler(context, args); available in both client and server console.
+
+EN:
+Prints a message in the player's game console.
+Parameters: name, permission, help.
+Implementation notes / Примечания реализации:
+Handler(context, args); available in both client and server console."""
+        ...
+
+    @staticmethod
+    def catalog(player=None) -> Any:
+        """RU:
+API PyMod: commands.catalog. Сигнатура и исходные примечания приведены ниже.
+Параметры: player.
+
+EN:
+PyMod API: commands.catalog. See the signature and original implementation notes below.
+Parameters: player."""
+        ...
+
+class timers:
+    """RU:
+API PyMod: timers. Сигнатура и исходные примечания приведены ниже.
+
+EN:
+PyMod API: timers. See the signature and original implementation notes below."""
+
+    @staticmethod
+    def every(seconds) -> Any:
+        """RU:
+Запускает метод периодически с интервалом в секундах, пока плагин активен.
+Параметры: seconds.
+Примечания реализации / Implementation notes:
+A non-overlapping repeating async timer, restarted on each map.
+
+EN:
+Runs a method periodically at the given interval in seconds while the plugin is active.
+Parameters: seconds.
+Implementation notes / Примечания реализации:
+A non-overlapping repeating async timer, restarted on each map."""
+        ...
+
+    @staticmethod
+    def after(seconds, callback, *args) -> Any:
+        """RU:
+API PyMod: timers.after. Сигнатура и исходные примечания приведены ниже.
+Параметры: seconds, callback.
+
+EN:
+PyMod API: timers.after. See the signature and original implementation notes below.
+Parameters: seconds, callback."""
+        ...
+
+def create_task(coroutine) -> Task[Any]:
+    """RU:
+API PyMod: create_task. Сигнатура и исходные примечания приведены ниже.
+Параметры: coroutine.
+Примечания реализации / Implementation notes:
+Owned task: automatically cancelled on reload, unload and map change.
+
+EN:
+PyMod API: create_task. See the signature and original implementation notes below.
+Parameters: coroutine.
+Implementation notes / Примечания реализации:
+Owned task: automatically cancelled on reload, unload and map change."""
+    ...
+
+async def run_in_thread(function, /, *args, **kwargs) -> Any:
+    """RU:
+API PyMod: run_in_thread. Сигнатура и исходные примечания приведены ниже.
+Параметры: function.
+Асинхронный метод: используйте await.
+Примечания реализации / Implementation notes:
+Run blocking I/O in a worker. Game APIs are prohibited in that worker.
+
+Reload waits for the worker to finish. Always use I/O timeouts.
+
+EN:
+PyMod API: run_in_thread. See the signature and original implementation notes below.
+Parameters: function.
+Asynchronous method: use await.
+Implementation notes / Примечания реализации:
+Run blocking I/O in a worker. Game APIs are prohibited in that worker.
+
+Reload waits for the worker to finish. Always use I/O timeouts."""
+    ...
+
+async def http_get(url, *, timeout=5.0, max_bytes=1048576) -> bytes:
+    """RU:
+API PyMod: http_get. Сигнатура и исходные примечания приведены ниже.
+Параметры: url, timeout, max_bytes.
+Асинхронный метод: используйте await.
+Примечания реализации / Implementation notes:
+GET http(s); return bytes. Uses the bundled stdlib, no pip packages needed.
+
+EN:
+PyMod API: http_get. See the signature and original implementation notes below.
+Parameters: url, timeout, max_bytes.
+Asynchronous method: use await.
+Implementation notes / Примечания реализации:
+GET http(s); return bytes. Uses the bundled stdlib, no pip packages needed."""
+    ...
+from ._sdk_native import ServerRequiredError as ServerRequiredError
+__all__ = ['log', 'PlayerMovement', 'Vector', 'Movement', 'Buttons', 'PlayerFlags', 'MoveType', 'Color', 'Position', 'PlayerActions', 'WeaponId', 'WeaponState', 'AmmoState', 'Rendering', 'PlayerStateHelpers', 'Team', 'Box', 'Zone', 'Player', 'Disconnect', 'players', 'broadcast', 'cvar', 'events', 'commands', 'timers', 'create_task', 'run_in_thread', 'http_get', 'CommandContext', 'config', 'storage', 'permissions', 'targeting', 'server', 'database', 'Menu', 'MenuItem', 'web', 'hooks', 'HookResult', 'Entity', 'EntityState', 'entities', 'trace', 'Trace', 'Hull', 'Solid', 'sounds', 'resources', 'cvars', 'Cvar', 'CvarFlags', 'CvarChange', 'Hud', 'PlayerSpawn', 'PlayerDeath', 'RoundEvent', 'GameMessage', 'cs', 'CsInfo', 'CsContext', 'CsSnapshot', 'DamageType', 'CsHookContext', 'CsHookSnapshot', 'CsTrace', 'CsMovement', 'CsPhysent', 'GameRulesState', 'CsLifecycleRecord', 'effects', 'Packet', 'services', 'voice', 'chat', 'i18n', 'tr', 'SQLite', 'Table', 'Record', 'Model', 'Sound', 'Sprite', 'Music', 'Plugin', 'Players', 'PlayerGroup', 'command', 'console_command', 'every', 'hook', 'listen', 'service', 'page', 'hook_events', 'Event', 'HookEvent', 'HookSnapshot', 'Cooldown', 'chance', 'wait', 'Config', 'ConfigField', 'ServerRequiredError']