OnDispenserGather

OxideCarbonResource

Called when a dispenser gathers.

object OnDispenserGather(ResourceDispenser resourceDispenser, BasePlayer entity, Item local7)

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

Параметры

resourceDispenser: ResourceDispenser
entity: BasePlayer
local7: Item

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

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

Пример

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

private object OnDispenserGather(ResourceDispenser resourceDispenser, BasePlayer entity, Item local7)
{
    Puts("OnDispenserGather");

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

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

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

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

Rust.opj (Oxide)

void ResourceDispenser.GiveResourceFromItem(BasePlayer, ItemAmount, float, float, AttackEntity)

Передаёт: ResourceDispenser resourceDispenser, BasePlayer entity, Item local7

Метод изменился — проверитьReturnBehavior: ExitWhenValidTypeArgumentBehavior: UseArgumentString (this, a0, l7)Assembly-CSharp.dll

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

// …
}
if (!(f >= 1f))
{
	return;
}
int num5 = CalculateGatherBonus(entity, itemAmt, f);
int iAmount = BaseGameMode.ScaleGatherAmount(Mathf.FloorToInt(f) + num5);
Item item = ItemManager.CreateByItemID(itemAmt.itemid, iAmount, 0uL, 0uL);
if (Interface.CallHook("OnDispenserGather", this, entity, item) != null)
{
	return;
}
if (item != null)
{
	ApplyItemOwnership(entity, item);
	OverrideOwnership(item, attackWeapon);
	Analytics.Azure.OnGatherItem(item.info.shortname, item.amount, baseEntity, entity, attackWeapon);
// …

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