OnPlayerAttack

OxidePlayer

object OnPlayerAttack(BaseMelee baseMelee, HitInfo info)
object OnPlayerAttack(BasePlayer basePlayer, HitInfo hitInfo)

Работает — метод игры в этой сборке тот же, под который написан хук.

Параметры

baseMelee: BaseMelee
info: HitInfo

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

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

Пример

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

private object OnPlayerAttack(BaseMelee baseMelee, HitInfo info)
{
    Puts("OnPlayerAttack");

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

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

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

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

Rust.opj (Oxide)

void BaseMelee.DoAttackShared(HitInfo)

Передаёт: BaseMelee baseMelee, HitInfo info

РаботаетReturnBehavior: ExitWhenValidTypeArgumentBehavior: UseArgumentString (this, a0)Assembly-CSharp.dll

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

public virtual void DoAttackShared(HitInfo info)
{
	if (Interface.CallHook("OnPlayerAttack", this, info) != null)
	{
		return;
	}
	GetAttackStats(info);
	if (info.HitEntity != null)
	{
		using (TimeWarning.New("OnAttacked", 50))
		{
// …

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

Rust.opj (Oxide)

void BasePlayer.OnProjectileAttack(BaseEntity.RPCMessage)

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

РаботаетReturnBehavior: ExitWhenValidTypeArgumentBehavior: UseArgumentString (this, l0.hitInfo)Assembly-CSharp.dll

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

// …
else
{
	float num26 = hitEntity.PenetrationResistance(hitInfo) / hitInfo.ProjectilePrefab.penetrationPower;
	firedProjectile.integrity = Mathf.Clamp01(firedProjectile.integrity - num26);
}
if (flag6)
{
	stats.Add(firedProjectile.itemMod.category + "_hit_" + hitEntity.Categorize(), 1);
	if (Interface.CallHook("OnPlayerAttack", this, local0.hitInfo) != null)
	{
		return;
	}
	if (((firedProjectile.weaponPrefab is Food && firedProjectile.weaponPrefab.ShortPrefabName.Contains("pie")) & flag) && hitPlayer != this && !hitPlayer.IsNpc)
	{
		GiveAchievement("PIE_HIT_PLAYER");
	}
}
// …

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