About

Temper is a Minecraft server implementation written in Rust, with the goals of being extremely fast and memory efficient, while also being easy to use and set up. With a focus on community, extensibility, and performance, we hope to create a server that can be used by everyone from casual players to large server owners.

Originally a fork of the FerrumC project, Temper aims to supersede its predecessor by providing a more polished and user-friendly experience, while still maintaining the same high standards for performance and efficiency. We are committed to building a strong community around Temper and welcome contributions from developers of all skill levels.

Project Links

• Official Website: temper-mc.com
• Discord Community: Join our Discord
• GitHub Repository: temper-mc/temper

Key Features and goals

• High Performance: Temper is built with performance in mind, using Rust's powerful features and optimizations

to offer the best possible performance.

• Memory Efficiency: Temper is designed to use as little memory as possible, making it suitable for servers of all

sizes.

• Ease of Use: One major goal of Temper is to be easy to set up and use, even for those who may not be familiar with

server administration. We aim to make setup and administration as straightforward as possible, while still providing the flexibility and power that advanced users need.

• Community Focus: We want to build a strong community around Temper, and we welcome contributions from developers

of all skill levels. We believe that a strong community is essential for the success of a project like this, and we are committed to fostering a welcoming and inclusive environment for all contributors.

• Quality and Stability: We are committed to providing a high-quality and stable server implementation. We will

prioritize fixing bugs and improving stability over adding new features, and we will always strive to maintain a high standard of quality in our codebase.

• Maintainable Codebase: We want to maintain a clean and well-organized codebase that is easy to understand and

contribute to. We will follow the best practices for code organization and documentation, and we will strive to make our code as readable and maintainable as possible. We will also prioritize code reviews and testing to ensure that our codebase remains healthy and maintainable over time.

Getting Started

Installing a pre-compiled binary

While it is recommended to compile from source for the best performance and latest features, we understand that not everyone may be comfortable with that process. Therefore, we provide pre-compiled binaries for Windows, Linux, and macOS on our GitHub Actions.

Option 1: Download our latest release

• Go to the Releases page

• Download the latest version for your operating system

• Extract the archive to your desired location

• Run the extracted binary and follow the instructions in the Usage section

Option 2: Download the latest build from GitHub Actions

• Go to the Actions tab
• Click on the latest build
• Scroll all the way down to the Artifacts section
• Download the artifact for your operating system (Windows, Linux, or macOS)
• Follow the instructions in the Usage section

Compile from source

What you'll need

• The Rust compiler, plus it's build system Cargo
• A Java 21 (or higher) JDK installed and available in your

PATH so assets can be extracted from the vanilla server

Clone and build the project.

# Clone the repository
git clone https://github.com/temper-mc/temper
cd temper
Build the project
cargo build --release

The binary will be in target/release/

Usage

Usage: temper.exe [OPTIONS] [COMMAND]
Commands: setup   Sets up the config import  Import the world data run     Start the server (default, if no command is given) help    Print this message or the help of the given subcommand(s) validate Checks the stored world for any errors
Options: --log <LOG>  [default: debug] [possible values: trace, debug, info, warn, error] -h, --help       Print help --no-tui         Disable the TUI (terminal user interface)

• Move the Temper binary (temper.exe or temper depending on the OS) to your desired server directory
• Open a terminal in that directory
• (Optional) Generate a config file: ./temper setup

- Edit the generated config.toml file to customize your server settings

• Run the server:

- Windows: .\temper.exe - Linux/macOS: ./temper

Development

We welcome contributions! If you'd like to contribute to Temper, please follow these steps:

• Fork the repository
• Create a new branch for your feature
• Implement your changes
• Write or update tests as necessary
• Submit a pull request

The Discord server is where most of the development discussion happens, so feel free to join and ask any questions you may have or discuss your ideas with the community.

License

FerrumC was licensed under the MIT License, but Temper has moved to the GNU General Public License v3.0 (GPL-3.0) to better align with our values of open source and community involvement. The GPL-3.0 is a copyleft license that requires any derivative works to also be licensed under the same terms, which we believe will help to ensure that Temper remains free and open for everyone to use and contribute to.

Due to this, commits to FerrumC and prior to 14/02/2026 are licensed under the MIT License, while commits to Temper and after 14/02/2026 are licensed under the GPL-3.0. This is not a dual license, rather a change in license that occurred at a specific point in time.

Star History

Stats