• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

CryptoMorin/XSeries: Library for cross-version Minecraft Bukkit support and vari ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

CryptoMorin/XSeries

开源软件地址(OpenSource Url):

https://github.com/CryptoMorin/XSeries

开源编程语言(OpenSource Language):

Java 100.0%

开源软件介绍(OpenSource Introduction):

XSeries

Bukkit Version Java Build Status maven-central

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
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 are intended to use another class (ParticleDisplay)

Maven maven-central

<dependency>
    <groupId>com.github.cryptomorin</groupId>
    <artifactId>XSeries</artifactId>
    <version>version</version>
</dependency>

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.

Note: 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:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.4</version>
    <configuration>
        <relocations>
            <relocation>
                <pattern>com.cryptomorin.xseries</pattern>
                <!-- Be sure to change the package below -->
                <shadedPattern>my.plugin.utils</shadedPattern>
            </relocation>
        </relocations>
        <!-- Here you can remove the classes you don't use. -->
        <!-- These are some examples. -->
        <!-- The "unused" package and SkullCacheListener are excluded by default. -->
        <!-- Some utilities such a XItemStack depend on more than 3 other classes, so watch out. -->
        <filters>
            <filter>
                <artifact>*:*</artifact>
                <excludes>
                    <exclude>com/cryptomorin/xseries/XBiome*</exclude>
                    <exclude>com/cryptomorin/xseries/NMSExtras*</exclude>
                    <exclude>com/cryptomorin/xseries/NoteBlockMusic*</exclude>
                    <exclude>com/cryptomorin/xseries/SkullCacheListener*</exclude>
                </excludes>
            </filter>
        </filters>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
        </execution>
    </executions>
</plugin>

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 for more info.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap