RustTip

OnXmasGiftsDistribute

OxideCarbonSeasonal

Called when xmas gifts distribute occurs.

object OnXmasGiftsDistribute(XMasRefill xMasRefill, BasePlayer player)
Работает — метод игры в этой сборке тот же, под который написан хук.

Параметры

xMasRefill
XMasRefill
player
BasePlayer

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

objectРезультат проверяется особым образом — смотрите код вызова ниже.

Пример

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

private object OnXmasGiftsDistribute(XMasRefill xMasRefill, BasePlayer player)
{
    Puts("OnXmasGiftsDistribute");

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

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

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

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

Rust.opj (Oxide)
bool XMasRefill.DistributeGiftsForPlayer(BasePlayer)

Передаёт: XMasRefill xMasRefill, BasePlayer player

РаботаетReturnBehavior: CustomAssembly-CSharp.dll

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

public bool DistributeGiftsForPlayer(BasePlayer player)
{
	object result = Interface.CallHook("OnXmasGiftsDistribute", this, player);
	// … проверка результата (Modify-хук, см. Rust.opj)
	int num = GiftsPerPlayer();
	int num2 = GiftSpawnAttempts();
	for (int i = 0; i < num2; i++)
	{
		if (num <= 0)
		{
			break;
// …

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