开发者 API

本页面是为希望将 Matrix 集成到其插件中的开发者准备的。

将 Matrix 作为依赖导入

1. 从我们的网页面板下载最新的 Matrix jar 文件，如果你没有购买 Matrix，你可以购买一个试用版本，它是免费的，并且 jar 文件与付费版本相同。
2. 将 jar 文件导入到你的项目中

Maven(pom.xml)

<dependencies>
    <dependency>
        <groupId>me.rerere.matrix</groupId>
        <artifactId>Matrix</artifactId>
        <version>1.0.0</version>
        <scope>system</scope>
        <systemPath>PATH TO THE MATRIX JAR</systemPath>
    </dependency>

    <!-- 其他依赖 -->
</dependencies>

Gradle(build.gradle)

dependencies {
    compileOnly files('PATH TO THE MATRIX JAR')

    // 其他依赖
}

Gradle Kotlin DSL(build.gradle.kts)

dependencies {
    compileOnly(files("PATH TO THE MATRIX JAR"))

    // 其他依赖
}

获取 Matrix API 实例

Kotlin

val api = MatrixAPIProvider.getAPI()

Java

MatrixAPI api = MatrixAPIProvider.getAPI();

API 方法

获取服务器当前的 TPS 值

double getTPS()

获取玩家的延迟（ping）

int getLatency(Player player)

设置玩家某个检查的违规等级

void setViolations(Player player, HackType hackType, int violations)

获取玩家某个检查的违规等级

int getViolations(Player player, HackType hackType)

确定检查是否启用

boolean isEnable(HackType hackType)

设置检查是否启用

void setEnable(HackType hackType, boolean enable)

检查玩家是否可以绕过反作弊

boolean isBypass(Player player)

获取玩家是否可以看到详细信息消息

boolean hasVerbose(Player player)

设置玩家是否可以看到所有人的详细信息消息

void setVerbose(Player player, boolean enable)

设置玩家是否可以看到某个玩家的详细信息消息

void setVerbose(Player player, boolean enable, Player target)

重新加载权限缓存系统

void reloadPermissionCache(Player player)

标记此玩家使用作弊 已移除

void flag(Player player, HackType hackType, String message, String component, int vlAddd)

允许玩家暂时绕过某些检查

void tempBypass(Player player, HackType hackType, Long milliseconds)

将此位置的方块注册为“客户端方块”

void registerClientBlock(Block blockLoc)

客户端方块是指该方块仅存在于客户端，服务器端没有此方块