TranForLanguage(TFL)
Free Minecraft plugin development from the limitations of programming languages and server platforms.
Project repository: GitHub - hekuo5310/TranForLanguage · GitHub
TranForLanguage (hereinafter referred to as TFL) is an open-source, multilingual Mod/Plugin development and runtime framework for Minecraft servers.
Traditional Minecraft Mod/Plugin development generally relies on Java or other JVM languages, while different server platforms have differences in APIs and compatibility.
TFL aims to break through these limitations, allowing developers to write Minecraft plugins in the programming language they are familiar with while minimizing the migration costs between different server platforms.
TFL currently supports nine languages: C, C++, Python, Rust, JavaScript, Go, Ruby, PHP, and Java. It also provides a unified runtime protocol, enabling TFL Plugins written in different languages to coexist, communicate, and call one another.
Furthermore, TFL Plugins can interact with Minecraft servers through interfaces provided by TFL and cooperate with other TFL Plugins.
What are the advantages of TFL?
1. One plugin, multiple server platforms
Write once, run on multiple servers that support TFL.
TFL provides adaptation layers for different Minecraft servers, unifying the way plugins interact with servers as much as possible.
The server platforms currently supported include:
-
Spigot / Paper
-
Fabric
-
Forge
-
NeoForge
Developers do not need to completely rewrite the same TFL Plugin for each platform and can reuse most of their business logic.
The specific features available depend on platform support, the Minecraft version, and the scope of API support.
2. Use the programming language you know best
Who says Minecraft plugins can only be written in Java?
Whether you are a Python developer, a JavaScript developer, or prefer C++, Rust, or Go, you can use TFL to participate in Minecraft server development.
You do not need to learn an entirely unfamiliar programming language from scratch just to develop a Minecraft plugin.
TFL provides built-in SDKs for supported languages, helping developers handle game events, send messages, execute commands, and communicate with other plugins.
You can choose the tools that suit you best instead of being limited to a single technology stack.
3. Hot reload without restarting the server
Update plugins without interrupting players’ games.
Traditional Mods or some Plugins require the server to be restarted after updates, which wastes time and may affect online players.
TFL supports the following operations while the server is running:
-
Install new TFL Plugins
-
Reload installed TFL Plugins
-
Stop or uninstall specified TFL Plugins
-
Start specified TFL Plugins individually
Administrators can perform these operations using the management commands provided by TFL, without restarting the entire Minecraft server to manage TFL Plugins.
Note that reloading restarts the corresponding plugin process, so in-memory state that has not been persisted will not be retained automatically.
4. Cross-language plugin communication
A plugin written in Python can directly call a plugin written in Go.
TFL not only supports running plugins in multiple languages, but also provides a unified inter-plugin communication mechanism.
For example:
-
Use Go to write an economy system
-
Use Python to write a shop system
-
Use JavaScript to write a player welcome plugin
-
Use Rust to write game rule logic
These plugins can call one another through a unified protocol, without requiring developers to implement complex cross-language communication services themselves.
TFL supports method calls, result returns, one-way notifications, message publishing, and other mechanisms, enabling plugins written in different languages to work together.
5. Plugins run independently without interfering with one another
Each TFL Plugin can run in its own independent process.
This means that:
-
Plugins written in different languages can run simultaneously
-
A plugin compilation failure will not directly prevent other plugins from starting
-
Plugin runtime status can be viewed individually
-
Plugins can be stopped, updated, or reloaded individually
-
Each plugin can maintain its own code, configuration, and runtime logs
Compared with concentrating all logic in a single program, this architecture improves plugin independence and maintainability.
It should be noted that an independent process is not the same as a security sandbox. TFL Plugins still need to be reviewed and trusted by the server administrator.
6. A unified development experience
Through a unified protocol and language SDKs, TFL encapsulates common Minecraft server operations into relatively consistent interfaces.
Developers can use the SDK for their chosen language to handle game events such as player joins, send chat messages, execute server commands, and call features provided by other TFL Plugins.
The syntax differs between languages, but the core development approach remains consistent.
You implement the features; TFL connects them to Minecraft.
7. Reduce development and maintenance costs
For developers who need to maintain plugins over the long term, cross-platform support and hot reload can eliminate a great deal of repetitive work.
You can develop features in a familiar language environment and update and debug them through TFL’s plugin management capabilities, without rebuilding, installing, and restarting the entire server every time.
For development teams supporting multiple server platforms, a unified development interface also helps share code and reduce the costs of maintaining multiple sets of plugins.
8. Open source, free, and extensible
TFL is an open-source project licensed under the Apache License 2.0.
Developers can inspect the source code, study its implementation, contribute improvements, and explore more ways to extend it based on its protocol and SDKs.
TFL does not aim to become a closed plugin runtime environment. Instead, it aims to build an open, multilingual, cross-platform Minecraft plugin development ecosystem.
Who is TFL for?
For Minecraft server owners:
You can manage TFL Plugins without restarting the server and run plugins written in different languages on the same server.
For plugin developers:
You can use the language you are most skilled in to develop Minecraft server features, reducing your reliance on specific languages and server APIs.
For development teams:
Members with different technology stacks can take responsibility for different plugins and collaborate through TFL’s communication mechanisms.
For people learning to program:
You can try writing Minecraft plugins in a familiar language and learn about event handling, inter-process communication, and software development in a real game environment.
Our goal
We hope Minecraft plugin development will no longer be limited by programming languages, runtime platforms, or cumbersome deployment processes.
Let developers freely choose their languages, let plugins cross platforms, and make server management simpler.
This is TranForLanguage.
GitHub: GitHub - hekuo5310/TranForLanguage · GitHub
License: Apache License 2.0