RustTip

CanEquipItem

OxideCarbonItem

Called to determine whether to equip item.

Return true to allow the action and false to block it.

object CanEquipItem(PlayerInventory playerInventory, Item item, int targetSlot, BasePlayer player)
Работает — метод игры в этой сборке тот же, под который написан хук.

Параметры

playerInventory
PlayerInventory
item
Item
targetSlot
int
player
BasePlayer

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

objectВозвращённое значение заменяет результат игры; null — игра решает сама.

Пример

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

private object CanEquipItem(PlayerInventory playerInventory, Item item, int targetSlot, BasePlayer player)
{
    Puts("CanEquipItem");

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

    // повлиять на игру:
    // return false; // своё значение вместо результата игры
}

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

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

Rust.opj (Oxide)
bool PlayerInventory.CanEquipItem(BasePlayer, Item, int)

Передаёт: PlayerInventory playerInventory, Item item, int targetSlot, BasePlayer player

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

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

private bool CanEquipItem(BasePlayer player, Item item, int targetSlot)
{
	object returnvar = Interface.CallHook("CanEquipItem", this, item, targetSlot, player);
	if (returnvar is bool)
	{
		return (bool)returnvar;
	}
	if ((item.info.flags & ItemDefinition.Flag.NotAllowedInBelt) != 0)
	{
		return false;
	}
// …

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