OnPlayerSpawn

OxideCarbonPlayer

Called when a player is spawned.

object OnPlayerSpawn(BasePlayer basePlayer, Network.Connection connection)

Метод изменился — проверить — код метода игры отличается от того, под который записан хук в Oxide. Хук всё равно вызывается, но место вызова могло сместиться — стоит проверить после обновления.

Параметры

basePlayer: BasePlayer
connection: Network.Connection

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

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

Пример

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

private object OnPlayerSpawn(BasePlayer basePlayer, Network.Connection connection)
{
    Puts("OnPlayerSpawn");

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

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

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

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

Rust.opj (Oxide)

void ServerMgr.SpawnNewPlayer(Network.Connection)

Передаёт: BasePlayer basePlayer, Network.Connection connection

Метод изменился — проверитьReturnBehavior: ExitWhenNonNullAssembly-CSharp.dll

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

public BasePlayer SpawnNewPlayer(Connection connection)
{
	RelationshipManager.PlayerTeam playerTeam = RelationshipManager.ServerInstance.FindPlayersTeam(connection.userid);
	BasePlayer.SpawnPoint spawnPoint = FindSpawnPoint(null, playerTeam?.teamID ?? 0);
	BasePlayer basePlayer = GameManager.server.CreateEntity("assets/prefabs/player/player.prefab", spawnPoint.pos, spawnPoint.rot).ToPlayer();
	if (Interface.CallHook("OnPlayerSpawn", basePlayer, connection) != null)
	{
		return basePlayer;
	}
	basePlayer.health = 0f;
	basePlayer.lifestate = BaseCombatEntity.LifeState.Dead;
	basePlayer.ResetLifeStateOnSpawn = false;
	basePlayer.limitNetworking = true;
	if (connection == null)
// …

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