English | 简体中文

clang-mc

A Development Toolchain for Minecraft Datapacks

Note

clang-mc is in the early stages of development, and many features are not yet complete. Contributions and feedback are welcome!

Introduction

clang-mc is a compiler toolchain designed specifically for Minecraft datapack development. It aims to provide a more efficient and maintainable development environment while offering a standard library to reduce redundant implementations of common functionalities.

Minecraft datapack development has long suffered from poor readability, maintenance challenges, and functional limitations. For example:

• Lack of modern programming language features: String manipulation, floating-point arithmetic, and large integer operations are extremely difficult to implement.
• Disorganized code structure: Datapacks often rely on a large number of manually written commands, and many requirements must be indirectly implemented using multiple .mcfunction files, making reuse and expansion difficult.

This project seeks to address these issues to some extent.

Check out Wiki to learn more.

---

Roadmap

• Basic implementation of the stdlib standard library, establishing a low-overhead virtual machine model on mcfunction.
• Write a wiki to define calling conventions, register conventions, stack conventions, etc.
• Implement an assembler (IR) to translate IR into mcfunction code based on stdlib.
• Develop a parser to convert assembly code into IR objects.
• Create a showcase to demonstrate the advantages of this project and how it improves datapack readability while reducing redundant implementations.
• Enhance stdlib with more advanced abstractions.
• (Long-term goal) Implement an LLVM backend to generate assembly code (IR).
• (Long-term goal) Achieve compatibility with C/C++/Rust ecosystems, leveraging LLVM to extend the capabilities of mcfunction.

---

Contributions

Contributions are welcome! Feel free to submit issues or pull requests.
Please note that this project is still in its early stages, and we greatly appreciate any feedback or suggestions.

---

Acknowledgments

Without these projects, clang-mc would not exist:

• Minecraft - Minecraft, developed by Mojang Studios, clang-mc complies with the Minecraft EULA and related terms of use.
• LLVM - A powerful compiler infrastructure, open-sourced under the Apache License 2.0.
• ankerl::unordered_dense: A modern, high-performance, low-memory hash table implementation in C++, licensed under the MIT License.
• fmt - A fast and safe formatting library for C++, licensed under the MIT License.
• spdlog - A fast C++ logging library, licensed under the MIT License.
• yaml-cpp - A YAML parser and emitter for C++, licensed under the MIT License.

Special thanks to all contributors in the open-source community!