Package net.crux.ac.api.data

Interface CruxPlayer

public interface CruxPlayer
Safe, read-only wrapper representing a player monitored by CruxAC.

  • Method Summary

    Modifier and Type
    Method
    Description
    org.bukkit.entity.Player
    getBukkitPlayer()
    Associated Bukkit Player instance (or null if offline).
    String
    getName()
    Player name.
    int
    getPing()
    Average ping of the player in milliseconds.
    PlatformType
    getPlatform()
    Client platform type (JAVA or BEDROCK).
    double
    getTotalVl()
    Gets the cumulative violation level across all active checks.
    double
    getTrustScore()
    Gets the dynamic trust score of the player [0.0 - 1.0].
    UUID
    getUniqueId()
    Unique identifier of the player.
    double
    getVl(String checkName)
    Gets the current Violation Level (VL) for a specific check.
    boolean
    isBedrock()
    Whether the player joined via Bedrock (Geyser/Floodgate).
    void
    resetAllVl()
    Resets all violation levels for this player.
    void
    resetVl(String checkName)
    Resets the violation level for a specific check.

  • Method Details

    • getUniqueId

      UUID getUniqueId()
      Unique identifier of the player.

    • getName

      String getName()
      Player name.

    • getBukkitPlayer

      org.bukkit.entity.Player getBukkitPlayer()
      Associated Bukkit Player instance (or null if offline).

    • isBedrock

      boolean isBedrock()
      Whether the player joined via Bedrock (Geyser/Floodgate).

    • getPlatform

      PlatformType getPlatform()
      Client platform type (JAVA or BEDROCK).

    • getPing

      int getPing()
      Average ping of the player in milliseconds.

    • getVl

      double getVl(String checkName)
      Gets the current Violation Level (VL) for a specific check.
      Parameters:
      checkName - Name of the check (e.g. "Flight", "Speed", "Step")
      Returns:
      Current violation level

    • getTotalVl

      double getTotalVl()
      Gets the cumulative violation level across all active checks.

    • getTrustScore

      double getTrustScore()
      Gets the dynamic trust score of the player [0.0 - 1.0]. Higher score indicates trustworthy vanilla client behavior.

    • resetVl

      void resetVl(String checkName)
      Resets the violation level for a specific check.

    • resetAllVl

      void resetAllVl()
      Resets all violation levels for this player.