OnNpcEquipWeapon

OxideNPC

object OnNpcEquipWeapon(NPCPlayer nPCPlayer, Item item)
object OnNpcEquipWeapon(ScientistNPC scientistNPC, Item item)

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

Параметры

nPCPlayer: NPCPlayer
item: Item

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

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

Пример

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

private object OnNpcEquipWeapon(NPCPlayer nPCPlayer, Item item)
{
    Puts("OnNpcEquipWeapon");

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

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

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

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

Rust.opj (Oxide)

void NPCPlayer.EquipWeapon(bool)

Передаёт: NPCPlayer nPCPlayer, Item item

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

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

public virtual void EquipWeapon(bool skipDeployDelay = false)
{
	if (inventory == null || inventory.containerBelt == null)
	{
		return;
	}
	Item slot = inventory.containerBelt.GetSlot(0);
	if (Interface.CallHook("OnNpcEquipWeapon", this, slot) != null)
	{
		return;
	}
	if (slot == null)
	{
		return;
	}
	UpdateActiveItem(inventory.containerBelt.GetSlot(0).uid);
// …

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

Rust.opj (Oxide)

void ScientistNPC.EquipWeapon(bool)

Передаёт: ScientistNPC scientistNPC, Item item

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

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

// …
{
	return;
}
Item item = heldEntity.GetItem();
if (item == null || item.contents == null)
{
	return;
}
if (Interface.CallHook("OnNpcEquipWeapon", this, item) != null)
{
	return;
}
if (Random.Range(0, 3) == 0)
{
	Item item2 = ItemManager.CreateByName("weapon.mod.flashlight", 1, 0uL);
	if (!item2.MoveToContainer(item.contents))
	{
// …

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