https://github.com/legacylands/legacy-lands-library
A comprehensive toolkit for Minecraft server plugin development, supporting Spigot/Paper/Folia platforms.
https://github.com/legacylands/legacy-lands-library
bukkit bukkit-library folia folia-library folia-plugin folia-plugins folia-server java library minecraft minecraft-library minecraft-plugin minecraft-plugin-api minecraft-plugin-library minecraft-plugin-utility minecraft-plugins minecraft-server spigot spigotmc
Last synced: 15 days ago
JSON representation
A comprehensive toolkit for Minecraft server plugin development, supporting Spigot/Paper/Folia platforms.
- Host: GitHub
- URL: https://github.com/legacylands/legacy-lands-library
- Owner: LegacyLands
- License: mit
- Created: 2024-12-18T13:08:39.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-04-08T04:41:28.000Z (15 days ago)
- Last Synced: 2025-04-08T08:11:56.849Z (15 days ago)
- Topics: bukkit, bukkit-library, folia, folia-library, folia-plugin, folia-plugins, folia-server, java, library, minecraft, minecraft-library, minecraft-plugin, minecraft-plugin-api, minecraft-plugin-library, minecraft-plugin-utility, minecraft-plugins, minecraft-server, spigot, spigotmc
- Language: Java
- Homepage: https://www.legacylands.cn
- Size: 4.24 MB
- Stars: 445
- Watchers: 47
- Forks: 83
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Based on Fairy Framework, it runs as a plugin, aiming to encapsulate various existing libraries to simplify the development of plugins.
## Overview
A comprehensive library built on [Fairy Framework](https://github.com/FairyProject/fairy), providing essential tools and
utilities for modern Minecraft plugin development. It is cross-platform and supports Spigot Paper and Folia.
## Core Modules
- [**annotation**](annotation/README.md) - Powerful annotation processing framework with flexible scanning options and
lifecycle management.
- [**commons**](commons/README.md) - Essential utilities including VarHandle injection, task scheduling, and JSON
operations.
- [**configuration**](configuration/README.md) - Flexible configuration framework built on SimplixStorage with
serialization support.
- [**mongodb**](mongodb/README.md) - Streamlined MongoDB integration with Morphia for efficient data persistence.
- [**cache**](cache/README.md) - Multi-tier caching system integrating Caffeine and Redis, providing comprehensive lock
management and a generic framework for thread-safe resource access.
- [**player**](player/README.md) - High-performance player data management with multi-tier caching and real-time
synchronization.
- [**script**](script/README.md) - Powerful, flexible, extensible, and high-performance script execution engine wrapper
that supports `Rhino`, `Nashorn` and `V8` `JavaScript` engines.
- [**experimental**](experimental/README.md) - Some experimental modules that can significantly improve performance, but
may be too complex to use or temporarily unstable.
- **security** - *Coming soon.*
## Usage
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.
### Distribution Packages
Download from [Actions](https://github.com/LegacyLands/legacy-lands-library/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
Configure GitHub authentication
first ([Learn More](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens))
```kotlin
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")
}
```
### Jenkins
[Link](http://129.226.219.222:8080/job/legacy-lands-library/)
## Community
- [中文文档](README_ZHCN.md)
- [QQ Group](http://qq.legacylands.cn)
- [Github Issues](https://github.com/LegacyLands/legacy-lands-library/issues)
- [Bilibili](https://space.bilibili.com/1253128469) (Chinese tutorials)
We will release more development tutorials and experience sharing about this module
or [Fairy Framework](https://github.com/FairyProject/fairy) in the [Bilibili](https://space.bilibili.com/1253128469)
channel!
## Sponsors
Fully sponsored and maintained by [LegacyLands](https://github.com/LegacyLands).
[Luminol](https://github.com/LuminolMC/Luminol)
is a Folia fork with many useful optimizations, configurable vanilla features, and more API supports.
## Star History
[](https://star-history.com/#LegacyLands/legacy-lands-library&Date)