OnNpcTarget

OxideNPC

object OnNpcTarget(BaseEntity owner, BaseEntity baseEntity)
object OnNpcTarget(HumanNPC humanNPC, BaseEntity baseEntity)

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

Параметры

owner: BaseEntity
baseEntity: BaseEntity

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

objectВерните не null, чтобы прервать метод игры.

Пример

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

private object OnNpcTarget(BaseEntity owner, BaseEntity baseEntity)
{
    Puts("OnNpcTarget");

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

    // повлиять на игру:
    // return false; // не null — действие игры отменяется
}

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

Где вызывается

ядро Oxide (Oxide.Rust)

RustCore::IOnNpcTarget(BaseNpc npc, BaseEntity target)

Код ядра Oxide — отсюда вызывается хук

private object IOnNpcTarget(BaseNpc npc, BaseEntity target)
{
    if (Interface.CallHook("OnNpcTarget", npc, target) != null)
    {
        npc.SetFact(BaseNpc.Facts.HasEnemy, 0);
        npc.SetFact(BaseNpc.Facts.EnemyRange, 3);
        npc.SetFact(BaseNpc.Facts.AfraidRange, 1);

        //TODO: Find replacements of those:
        // npc.AiContext.EnemyPlayer = null;
        // npc.AiContext.LastEnemyPlayerScore = 0f;
// …

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

Rust.opj (Oxide)

BaseEntity AIBrainSenses.GetNearest(List<BaseEntity>, float)

Передаёт: BaseEntity owner, BaseEntity baseEntity

РаботаетReturnBehavior: ExitWhenNonNullAssembly-CSharp.dll

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

// …
	return null;
}
float num = float.PositiveInfinity;
BaseEntity result = null;
foreach (BaseEntity entity in entities)
{
	if (!(entity == null) && !(entity.Health() <= 0f))
	{
		if (Interface.CallHook("OnNpcTarget", this.owner, baseEntity) == null)
		{
			return;
		}
		float num2 = Vector3.Distance(entity.transform.position, owner.transform.position);
		if (num2 <= rangeFraction * maxRange && num2 < num)
		{
			result = entity;
		}
// …

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

Rust.opj (Oxide)

BaseEntity HumanNPC.GetBestTarget()

Передаёт: HumanNPC humanNPC, BaseEntity baseEntity

РаботаетReturnBehavior: ExitWhenNonNullAssembly-CSharp.dll

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

public BaseEntity GetBestTarget()
{
	BaseEntity result = null;
	float num = -1f;
	foreach (BaseEntity player in Brain.Senses.Players)
	{
		if (!(player == null) && !(player.Health() <= 0f))
		{
			if (Interface.CallHook("OnNpcTarget", this, baseEntity) == null)
			{
				return;
			}
			float value = Vector3.Distance(player.transform.position, transform.position);
			float num2 = 1f - Mathf.InverseLerp(1f, Brain.SenseRange, value);
			float value2 = Vector3.Dot((player.transform.position - eyes.position).normalized, eyes.BodyForward());
			num2 += Mathf.InverseLerp(Brain.VisionCone, 1f, value2) / 2f;
			num2 += (Brain.Senses.Memory.IsLOS(player) ? 2f : 0f);
// …

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