Player Management

Surf Core bietet einen Zugriff auf jeden Spieler der jemals auf dem Netzwerk registriert wurde und alle Spieler die im gesamten Netzwerk gerade online sind.

Online Spieler abfragen

Jeder Server verfügt über eine Liste aller Spieler welche gerade auf dem Netzwerk spielen. Diese können über die Schnittstellen abgefragt werden:

import dev.slne.surf.core.api.common.player.SurfPlayer
import dev.slne.surf.core.api.common.surfCoreApi

val surfPlayerByName: SurfPlayer? = surfCoreApi.getPlayer(name)
val surfPlayerByUuid: SurfPlayer? = surfCoreApi.getPlayer(uuid)

val onlinePlayers: ObjectSet<SurfPlayer> = surfCoreApi.getOnlinePlayers()

Offline Spieler abfragen

Ebenso können Spieler, welche bereits auf dem Server waren aber gerade nicht online sind, aus der Datenbank geladen werden.

import dev.slne.surf.core.api.common.player.SurfPlayer
import dev.slne.surf.core.api.common.surfCoreApi

val offlinePlayerByName: SurfPlayer? = surfCoreApi.getOfflinePlayer(name)
val offlinePlayerByUuid: SurfPlayer? = surfCoreApi.getOfflinePlayer(uuid)

Alle Datenbank abfragen (Offline-Spieler abfragen) müssen in einem Corountine Context aufgerufen werden.

Nachrichten senden und Spieler verschieben

Es können Nachrichten an einen SurfPlayer gesendet werden um Feedback oder Informationen mitzuteilen. Außerdem kann der Spieler auf einen anderen SurfServer verschoben werden.

import dev.slne.surf.core.api.common.util.sendText

surfPlayer.sendText {
    appendInfoPrefix()
    info("Eine Information über den SurfPlayer")
}

surfPlayer.send(otherSurfServer)

Der Spieler kann sowohl von Server zu Server, sowohl von Proxy zu Proxy gesendet werden. Wenn der Zielserver ein Proxy Server ist, wird ein verschlüsselter Transfer stattfinden.

Spielerargument in Commands

Außerdem gibt es die Möglichkeit einen Online Spieler, sowohl Offline Spieler per Command Argument auf Paper sowie Velocity abzufragen.

Dabei wird das SurfOfflinePlayerArgument und das SurfPlayerArgument verwendet.

Paper Beispiel (Offline-Spieler)

import com.github.shynixn.mccoroutine.folia.launch
import dev.jorel.commandapi.kotlindsl.anyExecutor
import dev.jorel.commandapi.kotlindsl.commandTree
import dev.jorel.commandapi.kotlindsl.getValue
import dev.slne.surf.core.api.common.player.SurfPlayer
import dev.slne.surf.core.api.paper.command.argument.surfOfflinePlayerArgument
import dev.slne.surf.example.paper.permission.PermissionRegistry
import dev.slne.surf.example.paper.plugin
import kotlinx.coroutines.Deferred

fun exampleCommand() = commandTree("example") {
    withPermission(PermissionRegistry.COMMAND_EXAMPLE)
    surfOfflinePlayerArgument("player") {
        anyExecutor { executor, args ->
            val player: Deferred<SurfPlayer?> by args

            plugin.launch {
                val surfPlayer = player.await() ?: run {
                    executor.sendText {
                        appendPrefix()
                        error("Der Spieler wurde nicht gefunden.")
                    }
                    return@launch
                }
                
                // Hier kannst du den SurfPlayer weiterverarbeiten
            }
        }
    }
}