LingoAPI
Real-time AI Translation Plugin & Developer API (Groq LLaMA)
What is LingoAPI?
LingoAPI is a
developer-focused Minecraft plugin that lets you translate any string into any language — using
Groq's LLaMA 3/4 AI models .
Use it inside your own plugin with a simple one-liner:
Code (Text):
LingoAPI.translate("Hallo", "en");
⚙️ Installation
1. Place
LingoAPI-1.0.0-SNAPSHOT-shaded into your server’s `/plugins/` folder
2. Start the server once to generate `config.yml`
3. Open the config and paste your API key:
Code (YAML):
api_key
:
"your-key-here"
You can get a free API key at:
https://console.groq.com
Developer Usage
In your plugin's `plugin.yml`, add:
Code (YAML):
depend
:
[ LingoAPI
]
Now you can call the API like this:
Code (Java):
// Translate any string
String result
= LingoAPI.
translate
(
"Hallo" ,
"en"
)
;
player.
sendMessage
(
"Translation: "
+ result
)
;
✅ No async needed – LingoAPI handles threading internally.
API Key Security
Your Groq API key is:
Stored only in config.yml
Not exposed to players or other plugins
Used server-side only
Never logged, shared, or saved elsewhere
LingoAPI does
not log or store any messages or translations .
plugin.yml Example
Code (YAML):
name
: MyPlugin
main
: me.example.myplugin.Main
version
: 1.0
depend
:
[ LingoAPI
]
Maven Setup (Local JAR)
Place the JAR in a `libs/` folder inside your project root. Then add this to your `pom.xml`:
Spoiler: Maven Snippet
Code (XML):
<dependency>
<groupId> de.flugmodus
</groupId>
<artifactId> lingoapi
</artifactId>
<version> 1.0.0-SNAPSHOT
</version>
<scope> system
</scope>
<systemPath> ${project.basedir}/libs/LingoAPI-1.0.0-SNAPSHOT-shaded.jar
</systemPath>
</dependency>
This allows you to compile against LingoAPI in your own plugin.
Supported Languages
LingoAPI accepts all
ISO 639-1 language codes . Examples:
Code (Text):
en, de, es, fr, it, pt, pl, nl, ru, ja, ko, zh
Command
/lingoapi – Displays plugin info & checks if API key is set ✔
Useful for quick debugging or setup confirmation.
Need Help?
Send me a PM on SpigotMC if you need help or want to contribute.