feat: add SurfCoreCommand and enhance player management

- Introduce `surfCoreCommand` with subcommands for reloading configuration and clearing player caches.
- Add `clearPlayers` and `invalidateServerPlayers` methods to `SurfPlayerService` for better cache management.
- Update `PermissionRegistry` with `COMMAND_CORE` for the new command.
- Override `equals` and `hashCode` in `SurfPlayer` for proper equality checks.

Author: TheBjoRedCraft

surf-core-api/surf-core-api-common/src/main/kotlin/dev/slne/surf/core/api/common/player/SurfPlayer.kt

@@ -14,4 +14,17 @@ data class SurfPlayer(
 ) {
     var currentServer: String? = null
     fun isOnline() = surfCoreApi.getOnlinePlayers().any { it.uuid == uuid }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) return true
+        if (other !is SurfPlayer) return false
+
+        if (uuid != other.uuid) return false
+
+        return true
+    }
+
+    override fun hashCode(): Int {
+        return uuid.hashCode()
+    }
 }

surf-core-backend/src/main/kotlin/dev/slne/surf/core/fallback/service/SurfPlayerServiceImpl.kt

@@ -41,6 +41,10 @@ class SurfPlayerServiceImpl : SurfPlayerService, Services.Fallback {
         )
 
     override suspend fun savePlayer(player: SurfPlayer) = surfPlayerRepository.savePlayer(player)
+    override fun clearPlayers() {
+        globalPlayers.clear()
+    }
+
     override fun cachePlayer(player: SurfPlayer) {
         if (players.any { it.uuid == player.uuid }) {
             return
@@ -52,4 +56,8 @@ class SurfPlayerServiceImpl : SurfPlayerService, Services.Fallback {
     override fun invalidatePlayer(uuid: UUID) {
         globalPlayers.removeIf { it.uuid == uuid }
     }
+
+    override fun invalidateServerPlayers(server: String) {
+        globalPlayers.removeIf { it.currentServer == server }
+    }
 }

surf-core-core/surf-core-core-common/src/main/kotlin/dev/slne/surf/core/core/common/player/SurfPlayerService.kt

@@ -25,6 +25,8 @@ interface SurfPlayerService {
 
     suspend fun savePlayer(player: SurfPlayer)
 
+    fun clearPlayers()
     fun cachePlayer(player: SurfPlayer)
     fun invalidatePlayer(uuid: UUID)
+    fun invalidateServerPlayers(server: String)
 }

surf-core-paper/src/main/kotlin/dev/slne/surf/core/paper/PaperMain.kt

@@ -5,10 +5,12 @@ import dev.slne.surf.core.api.common.event.SurfServerOnlineEvent
 import dev.slne.surf.core.api.common.event.SurfServerStoppingEvent
 import dev.slne.surf.core.core.common.database.databaseLoader
 import dev.slne.surf.core.core.common.event.surfEventBus
+import dev.slne.surf.core.core.common.player.surfPlayerService
 import dev.slne.surf.core.core.common.redis.redisApi
 import dev.slne.surf.core.paper.command.lastSeenCommand
 import dev.slne.surf.core.paper.command.networkListCommand
 import dev.slne.surf.core.paper.command.networkTeleportCommand
+import dev.slne.surf.core.paper.command.surfCoreCommand
 import dev.slne.surf.core.paper.event.SurfServerEventListener
 import dev.slne.surf.core.paper.listener.ConnectionListener
 import dev.slne.surf.surfapi.bukkit.api.event.register
@@ -33,11 +35,14 @@ class PaperMain : SuspendingJavaPlugin() {
         lastSeenCommand()
         networkListCommand()
         networkTeleportCommand()
+        surfCoreCommand()
     }
 
     override fun onDisable() {
         surfEventBus.fire(SurfServerStoppingEvent(surfServerConfig.serverName))
 
+        surfPlayerService.invalidateServerPlayers(surfServerConfig.serverName)
+
         databaseLoader.disconnect()
         redisApi.disconnect()
     }

surf-core-paper/src/main/kotlin/dev/slne/surf/core/paper/command/SurfCoreCommand.kt

@@ -0,0 +1,34 @@
+package dev.slne.surf.core.paper.command
+
+import dev.jorel.commandapi.kotlindsl.anyExecutor
+import dev.jorel.commandapi.kotlindsl.commandTree
+import dev.jorel.commandapi.kotlindsl.literalArgument
+import dev.slne.surf.core.core.common.player.surfPlayerService
+import dev.slne.surf.core.paper.PaperBootstrap
+import dev.slne.surf.core.paper.permission.PermissionRegistry
+import dev.slne.surf.surfapi.core.api.messages.adventure.sendText
+
+fun surfCoreCommand() = commandTree("core") {
+    withPermission(PermissionRegistry.COMMAND_CORE)
+    literalArgument("reload") {
+        anyExecutor { executor, _ ->
+            PaperBootstrap.surfServerConfigHolder.reload()
+
+            executor.sendText {
+                appendPrefix()
+                success("Die Konfiguration wurde neu geladen.")
+            }
+        }
+    }
+
+    literalArgument("clearinternalplayercache") {
+        anyExecutor { executor, _ ->
+            surfPlayerService.clearPlayers()
+
+            executor.sendText {
+                appendPrefix()
+                success("Die Spieler-Caches wurden geleert.")
+            }
+        }
+    }
+}

surf-core-paper/src/main/kotlin/dev/slne/surf/core/paper/permission/PermissionRegistry.kt

@@ -9,4 +9,6 @@ object PermissionRegistry : PermissionRegistry() {
     val COMMAND_LAST_SEEN = create("$BASE_COMMAND.lastseen")
     val COMMAND_NETWORK_LIST = create("$BASE_COMMAND.networklist")
     val COMMAND_NETWORK_TELEPORT = create("$BASE_COMMAND.networkteleport")
+
+    val COMMAND_CORE = create("$BASE_COMMAND.core")
 }