RustTip

OnFuelCheck

OxideCarbonFuel

Called when fuel check occurs.

object OnFuelCheck(EntityFuelSystem entityFuelSystem)
Работает — метод игры в этой сборке тот же, под который написан хук.

Параметры

entityFuelSystem
EntityFuelSystem

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

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

Пример

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

private object OnFuelCheck(EntityFuelSystem entityFuelSystem)
{
    Puts("OnFuelCheck");

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

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

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

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

Rust.opj (Oxide)
bool EntityFuelSystem.HasFuel(bool)

Передаёт: EntityFuelSystem entityFuelSystem

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

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

public bool HasFuel(bool forceCheck = false)
{
	if ((Time.time > nextFuelCheckTime) | forceCheck)
	{
		object returnvar = Interface.CallHook("OnFuelCheck", this);
		if (returnvar is bool)
		{
			return (bool)returnvar;
		}
		cachedHasFuel = (float)GetFuelAmount() > 0f;
		nextFuelCheckTime = Time.time + Random.Range(1f, 2f);
	}
	return cachedHasFuel;
// …

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