OnUserBanned

OxideCarbonPlayer

Called when an user is banned.

void OnUserBanned(string playerName, string playerId, string address, string reason, long expiry)

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

Параметры

playerName: string
playerId: string
address: string
reason: string
expiry: long

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

voidВозвращаемое значение игнорируется — хук только уведомляет.

Пример

private void OnUserBanned(string playerName, string playerId, string address, string reason, long expiry)
{
    Puts("OnUserBanned");
}

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

Где вызывается

ядро Oxide (Oxide.Rust)

RustCore::OnServerUserSet(ulong steamId, ServerUsers.UserGroup group, string playerName, string reason, long expiry)

Код ядра Oxide — отсюда вызывается хук

private void OnServerUserSet(ulong steamId, ServerUsers.UserGroup group, string playerName, string reason, long expiry)
{
    if (serverInitialized && group == ServerUsers.UserGroup.Banned)
    {
        string playerId = steamId.ToString();
        IPlayer player = Covalence.PlayerManager.FindPlayerById(playerId);
        Interface.CallHook("OnPlayerBanned", playerName, steamId, player?.Address ?? "0", reason, expiry);
        Interface.CallHook("OnUserBanned", playerName, playerId, player?.Address ?? "0", reason, expiry);
    }
}

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

Rust.opj (Oxide)

void ServerUsers.Set(ulong, ServerUsers.UserGroup, string, string, long)

Встроен служебный хук OnServerUserSet — этот хук вызывает его обработчик в ядре Oxide/Carbon

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

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

// …
	User value = new User
	{
		steamid = uid,
		group = group,
		username = username,
		notes = notes,
		expiry = expiry
	};
	Interface.CallHook("OnServerUserSet", uid, group, username, notes, expiry);
	users.Add(uid, value);
}

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