CanPurchaseItem

OxideCarbonVending

Called to determine whether to purchase item.

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

object CanPurchaseItem(BasePlayer buyer, Item item, Action<BasePlayer, Item> onItemPurchased, VendingMachine vendingMachine, ItemContainer targetContainer)

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

Параметры

buyer: BasePlayer
item: Item
onItemPurchased: Action<BasePlayer, Item>
vendingMachine: VendingMachine
targetContainer: ItemContainer

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

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

Пример

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

private object CanPurchaseItem(BasePlayer buyer, Item item, Action<BasePlayer, Item> onItemPurchased, VendingMachine vendingMachine, ItemContainer targetContainer)
{
    Puts("CanPurchaseItem");

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

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

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

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

Rust.opj (Oxide)

bool VendingMachine.DoTransaction(BasePlayer, int, int, ItemContainer, Action<BasePlayer, Item>, Action<BasePlayer, Item>, MarketTerminal)

Передаёт: BasePlayer buyer, Item item, Action<BasePlayer, Item> onItemPurchased, VendingMachine vendingMachine, ItemContainer targetContainer

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

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

// …
else
{
	num9 += item4.amount;
	RecordSaleAnalytics(item4, sellOrderId, sellOrder.currencyAmountPerItem);
	if (targetContainer == null)
	{
		GiveSoldItem(item4, buyer);
	}
	object returnvar = Interface.CallHook("CanPurchaseItem", buyer, item4, onItemPurchased, this, targetContainer);
	if (returnvar != null)
	{
		return returnvar is bool && (bool)returnvar;
	}
	else if (!item4.MoveToContainer(targetContainer))
	{
		item4.Drop(targetContainer.dropPosition, targetContainer.dropVelocity);
	}
// …

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