Dialect

AI-powered language enforcement, detection, translation, and moderation layer for Minecraft Paper servers.

Features

• Language Detection — Automatically detects the language of chat messages using AI
• Translation — Translates non-default language messages with AI or DeepL fallback
• Moderation — Enforce language rules via whitelist/blacklist with configurable actions
• Multi-Provider AI — Supports OpenRouter, OpenAI, Anthropic, Gemini, and HuggingFace
• Slang Validation — Detects and validates slang usage in context
• Redis/Dragonfly — Distributed caching for multi-server networks
• Chat Formatting — Integrates with PlaceholderAPI, LuckPerms, LPC, LPCX
• Actionbar & Effects — Visual and audio feedback for players
• PaperMC Updater — /lazydialect utils papermc update downloads latest Paper build

Commands

Command	Permission	Description
/lazydialect help	lazydialect.admin	Show command help
/lazydialect reload	lazydialect.admin.reload	Reload configuration
/lazydialect status	lazydialect.admin.status	View plugin status
/lazydialect detect <text>	lazydialect.admin.detect	Detect language of text
/lazydialect translate <lang> <text>	lazydialect.admin.translate	Translate text
/lazydialect cache clear	lazydialect.admin.cache	Clear cached data
/lazydialect utils papermc update	lazydialect.admin	Download latest Paper build
/language [code]	lazydialect.command.language	Set preferred language

Configuration

Configure AI providers in config.yml:

ai:
  provider: "openrouter"   # openrouter, openai, anthropic, gemini, huggingface
  api_key: ""              # Your API key
  model: ""                # Leave empty for provider default

AI Provider Defaults

Provider	Default Endpoint	Default Model
openrouter	https://openrouter.ai/api/v1	meta-llama/llama-3-8b-instruct:free
openai	https://api.openai.com/v1	gpt-4o-mini
anthropic	https://api.anthropic.com/v1	claude-3-haiku-20240307
gemini	https://generativelanguage.googleapis.com/v1beta	gemini-2.0-flash
huggingface	https://api-inference.huggingface.co	mistralai/Mistral-7B-Instruct

Requirements

• Java 21+
• Paper 1.21.11+
• An API key for at least one AI provider or DeepL

Building

./gradlew build              # Clean build
./gradlew deployPlugin       # Build + copy to server plugins

License

MIT