RustTip

IOnBasePlayerAttacked

OxidePlayer
object IOnBasePlayerAttacked(BasePlayer basePlayer, HitInfo info)
Метод изменился — проверить — код метода игры отличается от того, под который записан хук в Oxide. Хук всё равно вызывается, но место вызова могло сместиться — стоит проверить после обновления.

Параметры

basePlayer
BasePlayer
info
HitInfo

Возвращаемое значение

objectЕсли вернуть значение типа результата метода, игра сразу вернёт его; null — продолжит как обычно.

Пример

object — можно повлиять на игру: вернуть значение, чтобы изменить или отменить действие.

private object IOnBasePlayerAttacked(BasePlayer basePlayer, HitInfo info)
{
    Puts("IOnBasePlayerAttacked");

    // ничего не меняем — игра продолжит как обычно
    return null;

    // повлиять на игру:
    // return null; // null — игра продолжит как обычно
}

Работает и в Oxide, и в Carbon: Carbon загружает плагины Oxide без изменений.

Место встраивания

Rust.opj (Oxide)
void BasePlayer.OnAttacked(HitInfo)

Передаёт: BasePlayer basePlayer, HitInfo info

Метод изменился — проверитьReturnBehavior: ExitWhenValidTypeArgumentBehavior: AllAssembly-CSharp.dll

Где вызывается (код игры этой ветки)

public override void OnAttacked(HitInfo info)
{
	if (Interface.CallHook("IOnBasePlayerAttacked", this, info) != null)
	{
		return;
	}
	float oldHealth = health;
	if (isServer)
	{
		if (InSafeCombatZone())
		{
// …

Источники: Rust.opj из OxideMod/Oxide.Rust (MIT) и метаданные хуков документации Carbon (MIT). Код методов — декомпиляция сервера этой ветки.