Skip to content

Commit 13052f8

Browse files
committed
update readme
1 parent e15929d commit 13052f8

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

README.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,17 @@
55
[![Maven Central](https://maven-badges.sml.io/sonatype-central/tech.aliorpse/mcutils/badge.svg)](https://central.sonatype.com/artifact/tech.aliorpse/mcutils)
66
[![View on DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Aliorpse/mcutils)
77

8-
A Kotlin-based Minecraft request library provides utility functions related to Minecraft queries.
8+
A Kotlin-based library that provides utility functions for Minecraft-related queries.
9+
10+
This project has not been widely tested, so use it at your own risk in production environments. Contributions to improve it are welcome.
911

1012
## Installation
1113

1214
```kotlin
1315
dependencies {
1416
implementation("tech.aliorpse:mcutils:$version")
15-
implementation("io.ktor:ktor-client-cio:$version") // or the client you want
17+
// Add the HTTP client you prefer
18+
implementation("io.ktor:ktor-client-cio:$version")
1619
}
1720
```
1821

@@ -27,14 +30,12 @@ runBlocking {
2730
var status
2831
status = JavaServer.getStatus("mc.hypixel.net")
2932

30-
// more options
3133
status = JavaServer.getStatus(
3234
host = "wdsj.net",
3335
port = 25565,
3436
enableSrv = true
3537
)
3638

37-
// bedrock servers
3839
status = BedrockServer.getStatus("play.easecation.net")
3940
}
4041
```
@@ -68,13 +69,15 @@ runBlocking {
6869
}
6970
```
7071

72+
Check out the project's [dokka](https://aliorpse.github.io/mcutils/) for the full API reference. There may be some extension functions you’ll find useful.
73+
7174
## Java Usage
7275

73-
The project uses [kotlin-suspend-transform-compiler-plugin](https://github.com/ForteScarlet/kotlin-suspend-transform-compiler-plugin) to generate varints automatically.
76+
The project uses [kotlin-suspend-transform-compiler-plugin](https://github.com/ForteScarlet/kotlin-suspend-transform-compiler-plugin) to generate variants automatically.
7477

7578
For every suspending API, both **async** and **blocking** variants are available.
7679

7780
```java
7881
CompletableFuture<JavaServerStatus> status =
79-
JavaServer.getStatusAsync("mc.hypixel.net", 25565, 2000);
82+
JavaServer.getStatusAsync("mc.hypixel.net");
8083
```

0 commit comments

Comments
 (0)