Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cryptomorin/xseries
Library for cross-version Minecraft Bukkit support and various efficient API methods.
https://github.com/cryptomorin/xseries
algorithm api bukkit efficiency java java-edition library maven minecraft minecraft-plugin mojang-minecraft packet papermc performance plugin reflection spigot xseries
Last synced: about 2 hours ago
JSON representation
Library for cross-version Minecraft Bukkit support and various efficient API methods.
- Host: GitHub
- URL: https://github.com/cryptomorin/xseries
- Owner: CryptoMorin
- License: mit
- Created: 2019-06-15T11:15:58.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-20T09:43:45.000Z (4 months ago)
- Last Synced: 2024-05-20T10:51:43.430Z (4 months ago)
- Topics: algorithm, api, bukkit, efficiency, java, java-edition, library, maven, minecraft, minecraft-plugin, mojang-minecraft, packet, papermc, performance, plugin, reflection, spigot, xseries
- Language: Java
- Homepage: https://www.spigotmc.org/threads/378136/
- Size: 1.17 MB
- Stars: 364
- Watchers: 14
- Forks: 123
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# XSeries
[](https://shields.io/)
[](https://shields.io/)
[](https://app.travis-ci.com/github/CryptoMorin/XSeries)
[](https://www.codefactor.io/repository/github/cryptomorin/xseries)
Library mainly designed to provide cross-version support for Minecraft Bukkit plugins,
but it also includes numerous extra methods to help developers design their plugins easier and efficiently.
Some utilities are completely unrelated to cross-version support such as NoteBlockMusic.
Don't forget to add `api-version: "1.13"` to your `plugin.yml`.
This will keep the plugin working even if the server is not 1.13
This project aims to provide quality utilities with high performance using the latest, yet efficient techniques.
Although support for old versions (like 1.8) will still remain for future updates, I highly encourage all developers
drop support for anything below 1.12
### Links
This project was mainly posted in [SpigotMC](https://www.spigotmc.org/threads/378136/)\
Most of the updates and news will be announced there.
### Getting Started
When compiling your plugin you should be using the latest version that your plugin is going to support.\
Which means, at least you have to use 1.13 (for cross-version support utilities only)
You can clone the project using: `git clone https://github.com/CryptoMorin/XSeries.git`
All the methods are explained in the JavaDocs. Please read them before using a method.
It's quite common to miss the whole purpose of cross-version support and the efficiency
of the utility by using the wrong methods.
You can use most of these utilities individually or use the maven dependency.
Most of the utilities are intended to be independent. However, some
utilities such as [XParticle](src/main/java/com/cryptomorin/xseries/particles/XParticle.java) are intended to use
another class ([ParticleDisplay](src/main/java/com/cryptomorin/xseries/particles/ParticleDisplay.java))
#### Maven 
```xml
com.github.cryptomorin
XSeries
version
minecraft-libraries
Minecraft Libraries
https://libraries.minecraft.net/
com.mojang
authlib
6.0.54
provided
```
Gradle
```kotlin
repositories {
mavenCentral()
}
dependencies {
implementation("com.github.cryptomorin:XSeries:version")
}
```
You shouldn't worry if the reflection or other classes are going to use your memory with heavy useless static cache.
As long as you don't use them anywhere in your code, they won't initialize.
The memory usage of these utilities are extremely enhanced.
# Shading
DO NOT extract the JAR into your project if you're using maven. You have to shade the library,
otherwise your plugin or other plugins will break due to version mismatch.
To shade the library, add the following under your maven plugins:
### [Apache Maven Shade Plugin](https://maven.apache.org/plugins/maven-shade-plugin/)
```xml
org.apache.maven.plugins
maven-shade-plugin
3.6.0
com.cryptomorin.xseries
my.plugin.utils
*:*
com/cryptomorin/xseries/XBiome*
com/cryptomorin/xseries/NMSExtras*
com/cryptomorin/xseries/NoteBlockMusic*
com/cryptomorin/xseries/SkullCacheListener*
package
shade
```
### [Gradle Shadow plugin](https://imperceptiblethoughts.com/shadow/)
Gradle (Kotlin DSL)
```kotlin
plugins {
java
id("com.github.johnrengelman.shadow") version ("8.1.1")
}
tasks {
shadowJar {
relocate("com.cryptomorin.xseries", "my.plugin.utils")
}
}
```
Gradle (Groovy)
```groovy
plugins {
id 'com.github.johnrengelman.shadow' version '8.1.1'
id 'java'
}
tasks {
shadowJar {
relocate 'com.cryptomorin.xseries', 'my.plugin.utils'
}
}
```
### Contributing
There's always room for improvement. If you know better ways of doing things,
I really appreciate it if you can share it with me,
but please make sure you know what you're doing and tested the project on different versions.
Any new ideas are welcome as long as they're useful; not just for you, but for everyone else.\
Please refer to [contributing guidelines](CONTRIBUTING.md) for more info.