RustTip

OnCCTVDirectionChange

OxideCarbonElectronic

Called when a CCTV direction is changed.

object OnCCTVDirectionChange(CCTV_RC cCTV_RC, BasePlayer local0)
Works — the game method in this build is the one the hook was written for.

Parameters

cCTV_RC
CCTV_RC
local0
BasePlayer

Return value

objectReturn non-null to cancel the game action.

Example

object — you can affect the game: return a value to change or cancel the action.

private object OnCCTVDirectionChange(CCTV_RC cCTV_RC, BasePlayer local0)
{
    Puts("OnCCTVDirectionChange");

    // change nothing — the game continues as usual
    return null;

    // to affect the game:
    // return false; // non-null cancels the game action
}

Works in both Oxide and Carbon: Carbon loads Oxide plugins as is.

Injection point

Rust.opj (Oxide)
void CCTV_RC.Server_SetDir(BaseEntity.RPCMessage)

Passes: CCTV_RC cCTV_RC, BasePlayer local0

WorksReturnBehavior: ExitWhenValidTypeArgumentBehavior: UseArgumentString (this, l0)Assembly-CSharp.dll

Where it is called (this branch's game code)

[RPC_Server]
public void Server_SetDir(RPCMessage msg)
{
	if (!IsStatic())
	{
		BasePlayer player = msg.player;
		if (player.CanBuild() && player.IsBuildingAuthed())
		{
			if (Interface.CallHook("OnCCTVDirectionChange", this, player) != null)
			{
				return;
			}
			Vector3 direction = Vector3Ex.Direction(player.eyes.position, yaw.transform.position);
			direction = transform.InverseTransformDirection(direction);
			Vector3 vector = BaseMountable.ConvertVector(Quaternion.LookRotation(direction).eulerAngles);
			pitchAmount = Mathf.Clamp(vector.x, pitchClamp.x, pitchClamp.y);
			yawAmount = Mathf.Clamp(vector.y, yawClamp.x, yawClamp.y);
// …

Sources: Rust.opj from OxideMod/Oxide.Rust (MIT) and hook metadata of the Carbon documentation (MIT). Method code is decompiled from this branch's server.