Developer 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)

获取玩家是否可以看到详细消息（verbose message）

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)

客户端方块指的是仅存在于客户端上的方块，服务器端并不存在该方块。