legacy-lands-library

Enterprise-grade modular framework for Minecraft server development with multi-tier caching, Redis Streams, resilient data processing, and modern Java concurrency. Supports Spigot, Paper and Folia.

Overview

A Modular Plugin Toolkit built on Fairy Framework, featuring modular design and leveraging modern Java 21 features. It provides essential tools and utilities for modern Minecraft plugin development with cross-platform support for Spigot, Paper, and Folia.

Quick Start

1. Add the repository and the modules you need (no authentication required):

repositories {
    maven("https://repo.qwqdev.top/releases")
}

dependencies {
    compileOnly("net.legacy.library:annotation:<version>")
}

The latest <version> is shown in the Maven badge above.

2. Install on the server: put fairy-lib-plugin and the jars of the modules you use (including the modules they depend on) into the plugins folder.

3. Declare the dependency in your plugin so it loads after the library:

fairy {
    bukkitProperties().depends.add("annotation")
}

Core Modules

• foundation - Core foundation module providing essential testing infrastructure, utilities, and base abstractions for all library modules.

• annotation - Powerful annotation processing framework with flexible scanning options and lifecycle management.

• aop - Enterprise-grade Aspect-Oriented Programming framework with ClassLoader isolation, providing performance monitoring, thread safety, logging, and exception handling aspects.

• commons - Essential utilities including VarHandle injection, task scheduling, virtual thread scheduling, JSON operations, and random object generation.

• configuration - Flexible configuration framework built on SimplixStorage with serialization support.

• mongodb - Streamlined MongoDB integration with Morphia for efficient data persistence.

• cache - Multi-tier caching system integrating Caffeine and Redis, providing comprehensive lock management and a generic framework for thread-safe resource access.

• player - Enterprise-grade distributed data management framework building high-performance entity-relationship data layers. Capable of seamlessly handling thousands of inter-entity relationship networks and state synchronization.

• script - Powerful, flexible, extensible, and high-performance script execution engine wrapper that supports Rhino, Nashorn and V8 JavaScript engines.

• experimental - Some experimental modules that can significantly improve performance, but may be too complex to use or temporarily unstable.

  • third-party-schedulers - Achieves distributed task processing via gRPC external task schedulers (currently implemented in Rust), enabling large plugin decoupling and performance improvements (for backends that cannot directly access the Bukkit API). Ideal for machine learning, anti-cheat large data computation, mathematics, and similar applications.

• security - Coming soon.

Usage

Distribution Packages

Download from Actions:

• -javadoc: Generated API documentation
• -plugin: Compiled plugin for direct server use
• -sources: Source code with compiled classes (recommended for development)

Detailed documentation in each module’s README

Maven Repository

No authentication required.

Gradle (Kotlin DSL):

repositories {
    maven("https://repo.qwqdev.top/releases")
}

dependencies {
    compileOnly("net.legacy.library:module-name:version")
}

Maven:

<repositories>
    <repository>
        <id>legacy-lands</id>
        <url>https://repo.qwqdev.top/releases</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>net.legacy.library</groupId>
        <artifactId>module-name</artifactId>
        <version>version</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

Available versions can be browsed at repo.qwqdev.top.

GitHub Packages

Artifacts are also published to GitHub Packages, which requires GitHub authentication (Learn More)

repositories {
    maven {
        url = uri("https://maven.pkg.github.com/LegacyLands/legacy-lands-library")
        credentials {
            username = project.findProperty("gpr.user") as String? ?: System.getenv("USERNAME")
            password = project.findProperty("gpr.key") as String? ?: System.getenv("TOKEN")
        }
    }
}

dependencies {
    compileOnly("net.legacy.library:module-name:version")
}

Versioning

Although the version number is currently still a SNAPSHOT, this does not mean it is unsuitable for production use. In fact, we plan to extensively utilize this version in a large-scale plugin development project, and will release the first official version once we have thoroughly validated its stability and functionality.

Community

• 中文文档
• QQ Group
• Github Issues
• Bilibili (Chinese tutorials)

We will release more development tutorials and experience sharing about this module or Fairy Framework in the Bilibili channel!

Sponsors

Fully sponsored and maintained by LegacyLands.

Luminol is a Folia fork with many useful optimizations, configurable vanilla features, and more API supports.

We are deeply heartbroken and outraged to see an outstanding open-source project—built on countless sleepless nights and community love—forced into hiatus because Canvas blatantly plagiarized and washed its code, erased author credits and contributions, and trampled upon the GPL-3.0 license. Open source is never a safe haven for plagiarists to plunder the fruits of others’ hard labor. Canvas’s disgraceful behavior of stealing achievements while wiping out all recognition is a direct insult to the Luminol team and all contributors, as well as a destructive blow to the entire Minecraft open-source ecosystem.

We stand resolutely with Luminol, expressing our strongest condemnation and total boycott against Canvas—a foundation built on theft can never stand tall, and plagiarists who betray the open-source spirit will inevitably be rejected by the community!

We are using YourKit to optimize our performance. They support open-source with innovative Java and .NET profiling tools.

Contributing

We warmly welcome more developers to join our open source project and contribute their strength. Whether it’s sharing ideas, creating Issues, or submitting Pull Requests, every contribution is significant!

We are very liberal with our use of AI. You can use any AI you want to write and contribute code, as long as it all works and meets the requirements in CLAUDE.md (this is a Chinese document).

Future plans

We are treating this library as a major dependency for keeping our entire server running (LegacyLands Minecraft server), and we are actively introducing Scala 3 into it. There will be small portions of non-breaking migration to Scala 3 in the future, leveraging its superior type system, concurrency model, and functional programming capabilities for better performance and maintainability.

Star History