Secret Lab Kotlin

Caution

Not all api endpoints have been implemented yet. Also, many of the already implemented endpoints weren't tested due to it being just too many. If you conduct your own test/find out that some aren't working correctly then create an issue so it can be fixed

Dependencys

Dependency	Version	Github page
Gson	2.11.0	https://github.com/google/gson
Kotlin	2.0.20	https://github.com/JetBrains/kotlin
Okhttp3	4.12.0	https://github.com/square/okhttp
Kotlinx Serialization Json	1.7.3	https://github.com/Kotlin/kotlinx.serialization

Compatibilty

Api	Implementation Begon	Fully Implemented	link	Documentation Entry
Secret Laboratory Api	✅	✅	https://api.scpslgame.com/	existing entry
Cedmod Api	✅	❌	Only avaidible on instance	existing entry
Scplist Api	✅	✅	https://scplist.kr/api	existing entry

Secret Laboratory Standard Api

Feature	Included	Easy to use
Get Basic Server Info	✅	✅
Get Playercount	✅	✅
Interact with Server	❌	❌
Complex Systems	❌	❌
Query Player Specific Info	❌	❌

Cedmod Api

Feature	Included	Easy to use
Get Basic Server Info	✅	❌
Get Playercount	✅	✅
Interact with Server	✅	❌
Complex Systems	✅	❌
Query Player Specific Info	✅	✅

Scplist Api

Feature	Included	Easy to use
Get Basic Server Info	✅	✅
Get Playercount	✅	✅
Interact with Server	❌	❌
Complex Systems	❌	❌
Query Player Specific Info	❌	❌

Examples

Get current playercount with the SecretLabApi

package dev.vxrp

import dev.vxrp.secretlab.SecretLab

fun main() {
    // The server-specific api key can be obtained by typing !api show into the server console
    val api = "API_KEY"
    // The account id can be optained by the same way
    val accountId = "ACCOUNT_ID"
    
    // Get current online players using the SecretLab Api
    val players = SecretLab(api, accountId).serverInfo(false, players = true)?.servers?.get(0)?.players
}

Get the current playercount with the ScpListApi

package dev.vxrp

import dev.vxrp.scplist.ScpList

fun main() {
    // Get players using the ScpListApi
    val players = ScpList().serverGet("ID")?.players
}

Ban a player using the cedmod api

package dev.vxrp

import dev.vxrp.cedmod.Cedmod

fun main() {
    // The api key of the server. This can only be obtained after asking cedmod staff to active it for the specific instance
    val api = "API_KEY"
    // Url of the instance being normally https://myservername.cmod.app
    val instanceUrl = "INSTANCE_URL"

    // Issues a ban to the cedmod api. The userId is typically steam/discord id with @steam or @discord attached.
    // The reason will be sent to the player
    // the duration here '1' corresponds to seconds
    // the 'true' stands for whether the ban can be appealed
    // at last you have to provide the banlist id in the list
    Cedmod(api, instanceUrl).banPostIssue("USER_ID", "REASON", 1, true, listOf(1111))
}