Class GrpcAuditService

java.lang.Object

tech.skworks.tachyon.plugin.core.grpc.AbstractGrpcService

tech.skworks.tachyon.plugin.core.audit.GrpcAuditService

All Implemented Interfaces:

AuditService

public class GrpcAuditService
extends AbstractGrpcService
implements AuditService

Project Tachyon Class AuditManager

Since:

1.0.0-SNAPSHOT

Version:

1.0

Author:

Jimmy (vSKAH) - 06/04/2026

Field Summary

Fields inherited from class AbstractGrpcService

backendStubProvider, tachyonMetrics

Constructor Summary

Constructors

Constructor	Description
GrpcAuditService(@Nullable TachyonMetrics tachyonMetrics, @NotNull BackendStubProvider backendStubProvider, @NotNull TachyonConfig config)

Method Summary

Modifier and Type	Method	Description
protected <T> void	handleGrpcExceptions(@NotNull String actionName, @NotNull tech.skworks.tachyon.libs.io.grpc.StatusRuntimeException ex, CompletableFuture<T> future)
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.
void	shutdown()

Methods inherited from class AbstractGrpcService

asyncCall, asyncRun, recordError, recordError, startTimer

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

GrpcAuditService

public GrpcAuditService(@Nullable
 @Nullable TachyonMetrics tachyonMetrics,
 @NotNull
 @NotNull BackendStubProvider backendStubProvider,
 @NotNull
 @NotNull TachyonConfig config)

Method Details

log

public void log(@NotNull
 @NotNull String uuid,
 @NotNull
 @NotNull String action,
 @NotNull
 @NotNull String details)

Description copied from interface: AuditService

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.

Specified by:

log in interface AuditService

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.

handleGrpcExceptions

protected <T> void handleGrpcExceptions(@NotNull
 @NotNull String actionName,
 @NotNull
 @NotNull tech.skworks.tachyon.libs.io.grpc.StatusRuntimeException ex,
 CompletableFuture<T> future)

Specified by:

handleGrpcExceptions in class AbstractGrpcService

shutdown

public void shutdown()

Specified by:

shutdown in class AbstractGrpcService