Simple Voicechat N word detection

Features

• Real-time voice transcription
• Groq Speech-to-Text integration
• STT.ai fallback system
• Discord webhook logging
• Audio evidence upload (.wav / .mp3)
• DetectID review workflow
• Ingame moderation GUI
• /nwordban moderation command
• Autocomplete for unresolved detections
• Staff review system (no automatic bans)
• Persistent detection storage
• Async processing for performance
• Production-ready Paper support

Moderation Workflow

1. Player voice audio is recorded
2. Audio is transcribed using Groq STT
3. If Groq fails, STT.ai is used automatically
4. Detected violations generate a unique DetectID
5. Transcript + audio are sent to Discord
6. Staff review the detection ingame
7. Staff can decide whether to ban the player

Commands

/nwordban <detectId>

Open the moderation review menu for a detection.

GUI Features

• View transcript
• Review evidence
• Ban player for 30 days
• Ignore detection
• Browse unresolved detections

Configuration Example

groq:
  api-key-env: "GROQ_API_KEY"
  model: "whisper-large-v3-turbo"

sttai:
  enabled: true
  api-key-env: "STT_API_KEY"

discord:
  webhook-url: "YOUR_WEBHOOK"

moderation:
  ban-duration: "30d"

timeouts:
  transcription-ms: 20000