Interface AuditService

All Known Implementing Classes:
GrpcAuditService
public interface AuditService
Project Tachyon Interface AuditService

The core telemetry and auditing contract for the Tachyon ecosystem.

This service is responsible for securely recording and dispatching player actions, security events, and critical state changes. These logs are typically forwarded to the backend (via gRPC) for moderation, analytics, or debugging purposes.

Since:
1.0.0-SNAPSHOT
Version:
1.0
Author:
Jimmy (vSKAH) - 17/04/2026

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    log(@NotNull String uuid, @NotNull String action, @NotNull String details)
    Records a specific action performed by or affecting a player, along with its context.

  • Method Details

    • log

      void log(@NotNull @NotNull String uuid, @NotNull @NotNull String action, @NotNull @NotNull String details)
      Records a specific action performed by or affecting a player, along with its context.

      This method is designed to be fire-and-forget. The underlying implementation handle the asynchronous dispatching of the log to prevent any blocking on the main server thread.

      Parameters:
      uuid - The unique identifier (UUID) of the player associated with this event.
      action - A clear, categorizable identifier for the event (e.g., "TRADE_ACCEPT", "ITEM_DROP", "FLAG_TRIGGERED").
      details - Additional contextual information about the event.