feat: add companion object operator functions for centralized entity retrieval

- Introduced `operator fun get(...)` methods in `CloudServer`, `CommonCloudServer`, `ProxyCloudServer`, `CloudPlayer`, and `OfflineCloudPlayer` for streamlined access to entities via `CloudManager` instances.
- Enhanced API consistency and usability with unified retrieval patterns.

Author: twisti-dev

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/CloudPlayer.kt

@@ -189,6 +189,12 @@ interface CloudPlayer : Audience, OfflineCloudPlayer { // TODO: conversation but
     fun playSound(sound: Sound, emitter: Sound.Emitter, permission: String)
 
     suspend fun hasPermission(permission: String): Boolean
+
+    companion object {
+        operator fun get(uuid: UUID) = CloudPlayerManager.getPlayer(uuid)
+        operator fun get(name: String) = CloudPlayerManager.getPlayer(name)
+        fun all() = CloudPlayerManager.getOnlinePlayers()
+    }
 }
 
 /**

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/player/OfflineCloudPlayer.kt

@@ -63,4 +63,8 @@ interface OfflineCloudPlayer {
      */
     suspend fun getLuckpermsMetaData(key: String): String?
 
+    companion object {
+        operator fun get(uuid: UUID, createIfNotExists: Boolean = true) =
+            CloudPlayerManager.getOfflinePlayer(uuid, createIfNotExists)
+    }
 }

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/server/CloudServer.kt

@@ -29,6 +29,13 @@ interface CloudServer : CommonCloudServer {
     suspend fun pullPlayers(players: Collection<CloudPlayer>): @Unmodifiable ObjectList<Pair<CloudPlayer, ConnectionResultEnum>>
 
     companion object {
+        operator fun get(uid: Long) = CloudServerManager.retrieveServerById(uid) as? CloudServer
+        operator fun get(category: String, name: String) =
+            CloudServerManager.retrieveServerByCategoryAndName(category, name) as? CloudServer
+
+        operator fun get(name: String) =
+            CloudServerManager.retrieveServerByName(name) as? CloudServer
+
         fun all() = CloudServerManager.retrieveServers()
     }
 }

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/server/CommonCloudServer.kt

@@ -121,6 +121,13 @@ interface CommonCloudServer : ForwardingAudience {
     fun shutdown()
 
     companion object {
+        operator fun get(uid: Long) = CloudServerManager.retrieveServerById(uid)
+        operator fun get(category: String, name: String) =
+            CloudServerManager.retrieveServerByCategoryAndName(category, name)
+
+        operator fun get(name: String) = CloudServerManager.retrieveServerByName(name)
         fun all() = CloudServerManager.retrieveAllServers()
+
+
     }
 }

surf-cloud-api/surf-cloud-api-common/src/main/kotlin/dev/slne/surf/cloud/api/common/server/ProxyCloudServer.kt

@@ -15,6 +15,12 @@ import org.jetbrains.annotations.ApiStatus
 @ApiStatus.NonExtendable
 interface ProxyCloudServer : CommonCloudServer {
     companion object {
+        operator fun get(uid: Long) = CloudServerManager.retrieveServerById(uid) as? ProxyCloudServer
+        operator fun get(category: String, name: String) =
+            CloudServerManager.retrieveServerByCategoryAndName(category, name) as? ProxyCloudServer
+
+        operator fun get(name: String) = CloudServerManager.retrieveServerByName(name) as? ProxyCloudServer
+
         fun all() = CloudServerManager.retrieveProxies()
     }
 }