API

DaisyFilter exposes a small, stable public API for other plugins. The API is registered through Bukkit’s ServicesManager.

DaisyFilterApi filter = Bukkit.getServicesManager()
    .load(DaisyFilterApi.class);

FilterResult result = filter.scanPlain(actorId, FilterSurface.CUSTOM, text);
if (!result.isAllowed()) {
    // react to result.getDisposition(), result.getSeverity(), etc.
}

Surface

interface DaisyFilterApi {
    FilterResult scan(FilterInput input);
    FilterResult scanPlain(UUID actorId, FilterSurface surface, String text);
    boolean isAllowed(UUID actorId, FilterSurface surface, String text);
    EngineStatus status();
}

scan is synchronous, thread-safe, and pure: it performs no logging, no spam-state mutation, no punishment, and no Bukkit side effects. It is safe to call from async chat threads. Inputs are bounded; custom API input is capped at 4,096 code points.

Types

FilterInput, MessageContext, FilterSurface, NormalizedText, FilterDisposition, FilterAction, RuleMatch, HeuristicMatch, FilterResult, EngineStatus. Results are immutable and expose only safe metadata (masked previews and rule IDs), never stored raw content.

Events

Observational, non-cancellable Paper events fire for integrations:

• DaisyFilterViolationEvent
• DaisyFilterActionEvent
• DaisyFilterReloadEvent

They expose masked previews and rule IDs only.

Notes

The engine never exposes mutable internals or global singleton state. Do not retain FilterResult spans to reconstruct blocked terms — censoring is one-way.