# [HamsterBall](https://gitee.com/MiniDay/hamster-ball)

仓鼠球：一个基于 Redis 的 Minecraft 服务端通用消息中间件（原HamsterService）

该插件依赖于 [仓鼠核心](https://gitee.com/MiniDay/hamster-core)

# 环境变量

为了适配 docker 环境，本插件除了从 `config.yml` 中配置服务器信息以外，还支持从环境变量中读取

| 环境变量                        | 描述                 | 对应 config 值      |
|:----------------------------|:-------------------|:-----------------|
| BALL_LOCAL_SERVER_IP        | 本服务器 IP            | server-info.host |
| BALL_LOCAL_SERVER_PORT      | 本服务器端口             | server-info.port |
| BALL_LOCAL_SERVER_INFO_ID   | 本服务器唯一识别码，最长 32 字符 | server-info.id   |
| BALL_LOCAL_SERVER_INFO_NAME | 本服务端名称，用于展示给玩家看    | server-info.name |

# 添加依赖

## Gradle (`build.gradle`)

```groovy
// 添加仓库
repositories {
    maven {
        url "https://maven.airgame.net/maven-public"
    }
}

dependencies {
    // 对于 Bukkit 插件
    compileOnly "cn.hamster3.mc.plugin:ball-bukkit:1.4.1"
    // 对于 BungeeCord 插件
    compileOnly "cn.hamster3.mc.plugin:ball-bungee:1.4.1"
}
```

## Maven (`pom.xml`)

```xml

<project>
    <!--添加仓库-->
    <repositories>
        <repository>
            <id>airgame-repo</id>
            <name>AirGame Maven仓库</name>
            <url>https://maven.airgame.net/maven-public</url>
        </repository>
    </repositories>

    <dependencies>
        <!--对于 Bukkit 插件-->
        <dependency>
            <groupId>cn.hamster3.mc.plugin</groupId>
            <artifactId>ball-bukkit</artifactId>
            <version>1.4.1</version>
        </dependency>
        <!--对于 BungeeCord 插件-->
        <dependency>
            <groupId>cn.hamster3.mc.plugin</groupId>
            <artifactId>ball-bungee</artifactId>
            <version>1.4.1</version>
        </dependency>
    </dependencies>
</project>
```