RustTip

OnUserChat

OxideCarbonPlayer

Called when an user chats.

void OnUserChat(Oxide.Core.Libraries.Covalence.IPlayer player, string message)
Работает — метод игры в этой сборке тот же, под который написан хук.

Параметры

player
Oxide.Core.Libraries.Covalence.IPlayer
message
string

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

voidПоведение не описано.

Пример

private void OnUserChat(Oxide.Core.Libraries.Covalence.IPlayer player, string message)
{
    Puts("OnUserChat");
}

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

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

ядро Oxide (Oxide.Rust)
RustCore::IOnPlayerChat(ulong playerId, string playerName, string message, Chat.ChatChannel channel, BasePlayer basePlayer)

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

// …
    if (basePlayer == null || !basePlayer.IsConnected)
    {
        // Call offline chat hook
        return Interface.CallHook("OnPlayerOfflineChat", playerId, playerName, message, channel);
    }

    // Call hooks for plugins
    object chatSpecific = Interface.CallHook("OnPlayerChat", basePlayer, message, channel);
    object chatCovalence = Interface.CallHook("OnUserChat", basePlayer.IPlayer, message);
    return chatSpecific is null ? chatCovalence : chatSpecific;
}

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

Rust.opj (Oxide)
void ConVar.Chat.<sayAs>d__22.MoveNext()

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

РаботаетReturnBehavior: UseArgumentStringArgumentBehavior: UseArgumentString (this.userId, this.username, this.<strChatText>5__2, this.targetChannel, this.player => l1)Assembly-CSharp.dll

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

// …
if (<strChatText>5__2.Length > 128)
{
	<strChatText>5__2 = <strChatText>5__2.Substring(0, 128);
}
if (<strChatText>5__2.Length <= 0)
{
	result = false;
}
Interface.CallHook("IOnPlayerChat", this.userId, this.username, this.<strChatText>5__2, this.targetChannel, this.player => l1);
else if (<strChatText>5__2.StartsWith("/") || <strChatText>5__2.StartsWith("\\"))
{
	result = false;
}
else
{
	<strChatText>5__2 = <strChatText>5__2.EscapeRichText();
	if (!Server.emojiOwnershipCheck || !<strChatText>5__2.Contains(":") || !(player != null))
// …

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