OnNpcEquipWeapon

OxideNPC

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

Метод изменился — проверить — код метода игры отличается от того, под который записан хук в Oxide. Хук всё равно вызывается, но место вызова могло сместиться — стоит проверить после обновления.

Параметры

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

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

// …
{
	return;
}
Item slot = inventory.containerBelt.GetSlot(0);
if (slot == null)
{
	return;
}
if (Interface.CallHook("OnNpcEquipWeapon", this, slot) != null)
{
	return;
}
UpdateActiveItem(inventory.containerBelt.GetSlot(0).uid);
BaseEntity heldEntity = slot.GetHeldEntity();
if (!(heldEntity != null))
{
	return;
// …

Место встраивания 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). Код методов — декомпиляция сервера этой ветки.