RustTip

CanBuild

OxideCarbonStructure

Called to determine whether to build.

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

object CanBuild(Planner planner, Construction local1, Construction.Target local3)
Работает — метод игры в этой сборке тот же, под который написан хук.

Параметры

planner
Planner
local1
Construction
local3
Construction.Target

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

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

Пример

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

private object CanBuild(Planner planner, Construction local1, Construction.Target local3)
{
    Puts("CanBuild");

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

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

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

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

Rust.opj (Oxide)
void Planner.DoBuild(ProtoBuf.CreateBuilding)

Передаёт: Planner planner, Construction local1, Construction.Target local3

РаботаетReturnBehavior: ExitWhenValidTypeArgumentBehavior: UseArgumentString (this, l1, l3)Assembly-CSharp.dll

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

// …
target.rotation = msg.rotation;
target.player = ownerPlayer;
target.isHoldingShift = msg.isHoldingShift;
target.snappingMode = msg.snappingMode;
target.isSnapped = msg.isSnapped;
target.snappedPosition = msg.snappedPosition;
target.snappedRotation = msg.snappedRotation;
target.valid = true;
if (Interface.CallHook("CanBuild", this, construction, target) != null)
{
	return;
}
target.shouldParent = ShouldParent(target.entity, deployable);
if (target.shouldParent)
{
	PlayerBoat parentPlayerBoat = PlayerBoat.GetParentPlayerBoat(target.entity, includeEntityItself: true);
	if (parentPlayerBoat != null && (!parentPlayerBoat.VerifyDeployablePlacement(ownerPlayer) || (!construction.canBypassBuildingPermission && !parentPlayerBoat.IsAuthedForBuilding(ownerPlayer))))
// …

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