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.

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
            }
        }
    }
}