![MCLang [1.17x - 1.21x, 26.1][API]](https://www.spigotmc.org/data/resource_icons/125/125883.jpg?1749452014){kind=icon}
MCLang
Github Status
![[IMG]](//proxy.spigotmc.org/e24125d9af6bb8005b80c1d95de319beb8ddf3b6/68747470733a2f2f63616d6f2e67697468756275736572636f6e74656e742e636f6d2f366163623561313962646238353865343232376330363663616366363932383131393266353735396631653166333139373134303537353636663061383936352f36383734373437303733336132663266363936643637326537333638363936353663363437333265363936663266363736393734363837353632326636313633373436393666366537333266373736663732366236363663366637373266373337343631373437353733326633303666363237323639363136653666333032663464343334633631366536373266363237353639366336343265373936643663)
![[IMG]](//proxy.spigotmc.org/a9412033f768d1213403aecc68c70a837f73eb35/68747470733a2f2f63616d6f2e67697468756275736572636f6e74656e742e636f6d2f326566396539383132333664313236646665366565333837333036613532616530366531336439643333343366613131343362323434336561373733323862342f36383734373437303733336132663266363936643637326537333638363936353663363437333265363936663266363736393734363837353632326637363266373236353663363536313733363532663330366636323732363936313665366633303266346434333463363136653637)
SpigotMC Status
![[IMG]](//proxy.spigotmc.org/09490af7ce1864a57edb5f8dd09a654d1223ef10/68747470733a2f2f63616d6f2e67697468756275736572636f6e74656e742e636f6d2f393934626662636535383666336538613266353638653638653632333563643861366535353865363334663563386539353738656364303762663334383537372f363837343734373037333361326632663639366436373265373336383639363536633634373332653639366632663733373036393637363537343266373636353732373336393666366532663331333233353338333833333366363336663663366637323364373936353663366336663737)
![[IMG]](//proxy.spigotmc.org/13aec8f05bda69f75ce63f7be3a4e895818bd793/68747470733a2f2f63616d6f2e67697468756275736572636f6e74656e742e636f6d2f626337636134306538346265613635636363646461653532383164656266333964343765323037383662343239373037343532633865623361616237343032612f36383734373437303733336132663266363936643637326537333638363936353663363437333265363936663266373337303639363736353734326636343666373736653663366636313634373332663331333233353338333833333366363336663663366637323364373936353663366336663737)
bStats Status
![[IMG]](//proxy.spigotmc.org/80a6279ef288ce555e2d97138bb9df43f867edbd/68747470733a2f2f63616d6f2e67697468756275736572636f6e74656e742e636f6d2f643537386263313439363365636438653733343565336236653164363039663037306634363831353562653238383937313562316134656638376331613535302f363837343734373037333361326632663639366436373265373336383639363536633634373332653639366632663632373337343631373437333266373336353732373636353732373332663332333633313334333932653733373636373366363336663663366637323364363737323635363536653236366336313632363536633364346636653663363936653635353336353732373636353732373332363733373437393663363533643730366336313733373436393633)
![[IMG]](//proxy.spigotmc.org/413c9a0fc7b8224a8b6cd30bf712f8697840336f/68747470733a2f2f63616d6f2e67697468756275736572636f6e74656e742e636f6d2f303936306233323766623533616538666331343634363265393161326237613765356132636436393162633761353663353634393533393133663235326235312f363837343734373037333361326632663639366436373265373336383639363536633634373332653639366632663632373337343631373437333266373036633631373936353732373332663332333633313334333932653733373636373366363336663663366637323364363737323635363536653236366336313632363536633364346636653663363936653635353036633631373936353732373332363733373437393663363533643730366336313733373436393633)
Lightweight API to load and use official Minecraft language pack translations.
*Tested Minecraft versions: 1.17, 1.18, 1.19, 1.20, 1.21*, 26.1
*Folia 1.19.4+ support (version 1.1.3 add)
Features
Web API & Frontend Portal (version 1.2.0 add)
MCLang includes a built-in modern Web API and an interactive frontend portal, making it easy to query translations programmatically or test them directly via your browser.
Enable and configure in plugins/MCLang/config.yml:
Accessing the Services
Gradle
Maven
Full Example: https://github.com/0obriano0/MCLang-example
![[IMG]](//proxy.spigotmc.org/a93a2eaf24aa99c3ecfd0172a69cc997dee40e46/68747470733a2f2f692e706f7374696d672e63632f5352514d333243662f323032352d30382d32372d3032313434342e706e67)
Example
View updates and changelog here.
TODO
Github Status
SpigotMC Status
bStats Status
Lightweight API to load and use official Minecraft language pack translations.
*Tested Minecraft versions: 1.17, 1.18, 1.19, 1.20, 1.21*, 26.1
*Folia 1.19.4+ support (version 1.1.3 add)
Features
- Easy-to-use language pack management for Bukkit plugins
- Language packs for different Minecraft versions can be downloaded from [GitHub](https://github.com/0obriano0/MCLang/tree/main/Local%20Language%20Pack)
- Automatically downloads language packs from the official Minecraft resources if not present
- Hot-reload language files without server restart
- API for developers to integrate custom messages
Web API & Frontend Portal (version 1.2.0 add)
MCLang includes a built-in modern Web API and an interactive frontend portal, making it easy to query translations programmatically or test them directly via your browser.
Enable and configure in plugins/MCLang/config.yml:
Code (YAML):
web:
enabled : true # Master switch
ssl:
enabled : false
keystorePath : "keystore.jks"
keystorePassword : "password"
api:
host : 127.0.0.1
port : 8765
cors : true
maxEntriesPerRequest : 300
requireKey : false # Set to true to require a Bearer token
key : "YOUR_SECRET_KEY" # The token clients must provide
frontend:
enabled : true
host : 127.0.0.1
port : 8766
cors : true
staticDir : web # Automatically extracted on startup
enabled : true # Master switch
ssl:
enabled : false
keystorePath : "keystore.jks"
keystorePassword : "password"
api:
host : 127.0.0.1
port : 8765
cors : true
maxEntriesPerRequest : 300
requireKey : false # Set to true to require a Bearer token
key : "YOUR_SECRET_KEY" # The token clients must provide
frontend:
enabled : true
host : 127.0.0.1
port : 8766
cors : true
staticDir : web # Automatically extracted on startup
- Interactive Web Portal: http://127.0.0.1:8766/ (or https:// if SSL is enabled)
- Features a modern, multi-language (i18n) test playground.
- Dynamically extracts HTML/CSS/JS/JSON frontend files to plugins/MCLang/web/ on server start.
- Backend API Base URL: http://127.0.0.1:8765
- (Access is denied with 401 Unauthorized if requireKey is enabled and no token is passed)
- GET /api/languages: Returns a list of all currently loaded language codes and their versions.
- GET /api/languages/{lang}: Get keys/values for a specific language.
- Supported query parameters: version, prefix, limit, offset.
- GET /api/translate: Query a single translation string.
- Usage: ?lang=zh_tw&key=item.minecraft.diamond_sword
- POST /api/translate: Query a single translation string via POST.
- Usage: send JSON payload {"lang":"zh_tw","key":"item.minecraft.diamond_sword"}
Gradle
Code (Text):
repositories {
mavenCentral()
maven { url 'https://repo1.maven.org/maven2/' }
}
dependencies {
compileOnly 'org.tsob:MCLang-API:1.1.3'
}
mavenCentral()
maven { url 'https://repo1.maven.org/maven2/' }
}
dependencies {
compileOnly 'org.tsob:MCLang-API:1.1.3'
}
Code (Text):
<repositories>
<repository>
<id>maven</id>
<url>https://repo1.maven.org/maven2/</url>
</repository>
</repositories>
<dependency>
<groupId>org.tsob</groupId>
<artifactId>MCLang-API</artifactId>
<version>1.1.3</version>
<scope>provided</scope>
</dependency>
<repository>
<id>maven</id>
<url>https://repo1.maven.org/maven2/</url>
</repository>
</repositories>
<dependency>
<groupId>org.tsob</groupId>
<artifactId>MCLang-API</artifactId>
<version>1.1.3</version>
<scope>provided</scope>
</dependency>
Example
Code (Java):
import
org.tsob.MCLang.API.MCLang
;
import org.bukkit.Material ;
import org.bukkit.entity.EntityType ;
import org.bukkit.inventory.ItemStack ;
public class ExamplePlugin extends JavaPlugin {
@Override
public void onEnable ( ) {
MCLang lang = new MCLang ( "en" ) ;
// Get translation for an ItemStack
ItemStack item = new ItemStack (Material. DIAMOND_SWORD ) ;
String itemTranslation = lang. getItemTranslate (item ) ;
// Directly read the translation from the language pack.
String translation = getString ( "item.minecraft.diamond_sword" ) ;
// Get translation for an item name
String itemTranslationByName = lang. getItemTranslate ( "DIAMOND_SWORD" ) ;
// Get translation for an EntityType
String entityTranslation = lang. getEntityTranslate (EntityType. CREEPER ) ;
// Get translation by entity instance (version 1.1.0 add)
Entity entity = ... ; // your Entity instance
String entityTranslationFromEntity = lang. getEntityTranslate (entity ) ;
// Get translation for an entity name
String entityTranslationByName = lang. getEntityTranslate ( "CREEPER" ) ;
// Get translation for an enchantment (version 1.0.8 add)
String enchantmentTranslationByName = lang. getEnchantmentTranslate (Enchantment. SILK_TOUCH ) ;
// Get translation for an enchantment name (version 1.0.8 add)
String enchantmentTranslationByName = lang. getEnchantmentTranslate ( "SILK_TOUCH" ) ;
}
import org.bukkit.Material ;
import org.bukkit.entity.EntityType ;
import org.bukkit.inventory.ItemStack ;
public class ExamplePlugin extends JavaPlugin {
@Override
public void onEnable ( ) {
MCLang lang = new MCLang ( "en" ) ;
// Get translation for an ItemStack
ItemStack item = new ItemStack (Material. DIAMOND_SWORD ) ;
String itemTranslation = lang. getItemTranslate (item ) ;
// Directly read the translation from the language pack.
String translation = getString ( "item.minecraft.diamond_sword" ) ;
// Get translation for an item name
String itemTranslationByName = lang. getItemTranslate ( "DIAMOND_SWORD" ) ;
// Get translation for an EntityType
String entityTranslation = lang. getEntityTranslate (EntityType. CREEPER ) ;
// Get translation by entity instance (version 1.1.0 add)
Entity entity = ... ; // your Entity instance
String entityTranslationFromEntity = lang. getEntityTranslate (entity ) ;
// Get translation for an entity name
String entityTranslationByName = lang. getEntityTranslate ( "CREEPER" ) ;
// Get translation for an enchantment (version 1.0.8 add)
String enchantmentTranslationByName = lang. getEnchantmentTranslate (Enchantment. SILK_TOUCH ) ;
// Get translation for an enchantment name (version 1.0.8 add)
String enchantmentTranslationByName = lang. getEnchantmentTranslate ( "SILK_TOUCH" ) ;
}
TODO
- Improve API documentation
- Add more usage examples
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.17, 1.18, 1.19
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MCLang [1.17x - 1.21x, 26.1][API] is a free Minecraft Java mod. Compatible with Minecraft 1.17, 1.18, 1.19, 1.20 and newer. Downloaded 226 times (via Spigot). Download it and open it directly in the game.