Luminol

Designed for survival and anarchy servers, providing optimizations, configurable vanilla features, and rich API support

English | 中文

---

✨ Core Features

• 🔧 Configurable Vanilla Features - Flexibly adjust game mechanics to suit different server needs
• 📊 Tpsbar Support - Real-time server performance monitoring
• 🐛 Folia Bug Fixes - Targeted fixes for known Folia issues
• 💾 Multiple World Format Support - Support for linear and b_linear (linear reimplementation) world formats
• 🔌 Extended API Support - More API interfaces for plugin developers (ongoing development)
• ⚡ Performance Optimizations - Optimized specifically for high-load survival and anarchy servers

📥 Download

Stable Releases

All release versions can be found on the Releases page.

Development Builds

If you want to experience the latest features, you can build it yourself following the steps below.

Build Steps

# Clone the project
git clone https://github.com/LuminolMC/Luminol.git
cd Luminol

# Apply patches and build Paperclip JAR
chmod 755 ./scripts/setup_and_build.sh && ./scripts/setup_and_build.sh

After building, you can find the generated JAR file in the build/libs directory.

🔌 API Usage

Gradle Configuration

repositories {
    maven {
        url = "https://repo.bacteriawa.com/repository/maven-public/"
    }
}

dependencies {
    compileOnly("me.earthme.luminol:luminol-api:26.2.build.+")
}

Maven Configuration

<repositories>
    <repository>
        <id>repository</id>
        <url>https://repo.bacteriawa.com/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>me.earthme.luminol</groupId>
        <artifactId>luminol-api</artifactId>
        <version>[26.2.build,)</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

💬 Community & Support

If you're interested in this project or have any questions, feel free to ask us.

Join Our Community

• QQ Group: 1015048616
• QQ Channel: Join Here
• Telegram: Join Here
• Discord: Join Here

Get Help

• 📋 Submit Issues
• 💬 GitHub Discussions
• 📖 Project Documentation

🐛 Bug Reports

When you encounter any issues, please ask us and we'll do our best to resolve them. Please remember to:

• 📝 Describe the problem clearly - Provide detailed information about the specific issue
• 📋 Provide complete logs - Include error logs and relevant configuration information
• 🔍 Environment details - Specify server version, plugin list, and other environment details
• 🔄 Reproduction steps - If possible, provide specific steps to reproduce the issue

🤝 Contributing

We welcome community contributions! For detailed contribution guidelines, please see:

• 📖 Contributing Guide (English)
• 📖 贡献指南 (中文)

📊 Project Statistics

🎉 Special Thanks

Project Sponsors

Thanks to LegacyLands for sponsoring this project
If you want to develop cross-Folia/non-Folia platform plugins, legacy-lands-library would be a great choice

---

International multi-route selection with cloud storage support
7-day satisfaction guarantee with refund option, powerful technical support team and high-availability customer service
RainYun Cloud Servers - stability and cost-effectiveness to help you get to the cloud quickly
Visit RainYun

---

If you need a Java profiler for analyzing performance issues, Jprofiler will be a great choice

---

⭐ Give Us a Star!

Every free ⭐Star you give is the motivation for our every step forward.

Star History

If this project helps you, please don't forget to give us a ⭐Star!