---

Overview

LazyDialect is an AI-powered language detection, translation, and moderation plugin for Minecraft Paper servers. It helps server administrators manage multilingual communities, enforce chat language policies, and provide a better communication experience for players.

Features

Feature	Description
Language Detection	Automatically detect the language of player chat messages using AI.
Translation	Translate messages using AI, with DeepL fallback support.
Language Enforcement	Enforce language whitelists and blacklists with configurable actions.
Multi-Provider AI	Support for OpenRouter, OpenAI, Anthropic, Google Gemini, and Hugging Face.
Slang Validation	Detect and validate slang usage in context.
Distributed Caching	Redis and Dragonfly support for multi-server networks.
Chat Integrations	Integrations with PlaceholderAPI, LuckPerms, LPC, and LPCX.
Player Feedback	Actionbar messages, visual effects, and audio feedback.
PaperMC Updater	Download the latest Paper build using /lazydialect utils papermc update.

Commands

Administration

Command	Permission	Description
/lazydialect help	lazydialect.admin	Show available commands.
/lazydialect reload	lazydialect.admin.reload	Reload the configuration.
/lazydialect status	lazydialect.admin.status	View plugin status.
/lazydialect detect <text>	lazydialect.admin.detect	Detect the language of a text sample.
/lazydialect translate <lang> <text>	lazydialect.admin.translate	Translate text into the specified language.
/lazydialect cache clear	lazydialect.admin.cache	Clear cached data.
/lazydialect utils papermc update	lazydialect.admin	Download the latest Paper build.

Player Commands

Command	Permission	Description
/language [code]	lazydialect.command.language	Set your preferred language.

Configuration

Configure your AI provider in plugins/LazyDialect/config.yml.

AI Provider

ai:
  provider: "openrouter"
  api_key: ""
  model: ""

Option	Description
provider	AI provider: openrouter, openai, anthropic, gemini, or huggingface.
api_key	API key for the selected provider.
model	Model identifier. Leave empty to use the provider's default model.

[!IMPORTANT] Keep API keys private. Never commit real credentials to a public repository.

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
Google Gemini	https://generativelanguage.googleapis.com/v1beta	gemini-2.0-flash
Hugging Face	https://api-inference.huggingface.co	mistralai/Mistral-7B-Instruct

Provider defaults may change as APIs, endpoints, and model availability evolve.

Requirements

• Java 21 or newer
• Paper 1.21.11 or newer
• An API key for at least one supported AI provider, or a DeepL API key for DeepL translation

Redis, Dragonfly, and optional chat integrations may require additional services or plugins.

Building

Build the plugin using the included Gradle wrapper.

# Build the plugin
./gradlew build

# Build and deploy to the configured server plugins directory
./gradlew deployPlugin

The deployment task may depend on your local server configuration.

License

LazyDialect is licensed under the MIT License. See LICENSE for the full license text.

---