pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <artifactId>UltiTools-API</artifactId>
    <groupId>com.ultikits</groupId>
    <version>6.2.5</version>
    <modelVersion>4.0.0</modelVersion>
    <name>UltiTools-API</name>
    <description>This project is the base of the Ultitools plugin development.</description>
    <url>https://dev.ultikits.com/</url>

    <licenses>
        <license>
            <name>MIT License</name>
            <url>https://raw.githubusercontent.com/UltiKits/UltiTools-Reborn/main/LICENSE</url>
            <distribution>repo</distribution>
        </license>
    </licenses>

    <scm>
        <connection>scm:git@github.com:UltiKits/UltiTools-Reborn.git</connection>
        <developerConnection>scm:git@github.com:UltiKits/UltiTools-Reborn.git</developerConnection>
        <url>https://github.com/UltiKits/UltiTools-Reborn</url>
    </scm>

    <developers>
        <developer>
            <name>wisdomme</name>
            <email>xia.erich03@gmail.com</email>
            <organization>UltiKits</organization>
            <timezone>+10</timezone>
        </developer>
    </developers>

    <properties>
        <java.version>1.8</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <gui.version>4.3.0</gui.version>
        <!-- Default excluded test groups - override with -DexcludedGroups= to run isolated tests -->
        <excludedGroups>isolated</excludedGroups>
        <!-- Default API URL for production; override with -Dultitools.api.url=http://localhost:8787 for dev -->
        <ultitools.api.url>https://api.ultikits.com</ultitools.api.url>
        <!--
            Target folder for the ultitools-maven-plugin deploy goal. Defaults to a directory inside
            target/ so a clean checkout never writes outside the project. Developers who want the
            built JAR copied straight into a local test server should override it locally, either
            with -Dultitools.deploy.folder=/path/to/server/plugins on the command line or with a
            profile in ~/.m2/settings.xml. Do not hard-code a machine-specific path here.
        -->
        <ultitools.deploy.folder>${project.build.directory}/deploy</ultitools.deploy.folder>
    </properties>

    <distributionManagement>
        <snapshotRepository>
            <id>ultikits-sonatype</id>
            <url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
        </snapshotRepository>
        <repository>
            <id>ultikits-sonatype</id>
            <url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
        </repository>
    </distributionManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>flatten-maven-plugin</artifactId>
                <version>1.6.0</version>
                <configuration>
                    <flattenMode>ossrh</flattenMode>
                    <pomElements>
                        <dependencies>remove</dependencies>
                    </pomElements>
                </configuration>
                <executions>
                    <execution>
                        <id>flatten</id>
                        <phase>process-resources</phase>
                        <goals>
                            <goal>flatten</goal>
                        </goals>
                    </execution>
                    <execution>
                        <id>flatten.clean</id>
                        <phase>clean</phase>
                        <goals>
                            <goal>clean</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok-maven-plugin</artifactId>
                <version>1.18.20.0</version>
                <configuration>
                    <encoding>UTF-8</encoding>
                    <sourceDirectory>src/main/java</sourceDirectory>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <annotationProcessorPaths>
                        <path>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                            <version>1.18.38</version>
                        </path>
                    </annotationProcessorPaths>
                </configuration>
            </plugin>
            <!--
                Animal Sniffer — 看守 Java 8 API 边界。
                编译用的是 source/target 1.8 而不是 <release>8</release>，所以 javac
                链接的是 JDK 21 的类库：误用 Java 9+ 的 API（String.strip、List.of、
                Map.entry 等）能编译通过，直到在真 Java 8 上运行才抛 NoSuchMethodError。
                这里在字节码层比对 java18 签名，把那个缺口补上。

                不要改用 <release>8</release> —— 它会拒绝本项目已在使用的
                @Deprecated(since=, forRemoval=)，而那些元数据是废弃契约的一部分。

                Animal Sniffer — guards the Java 8 API boundary.
                The build uses source/target 1.8 rather than <release>8</release>, so
                javac links against the JDK 21 class library and Java 9+ API calls
                compile cleanly, only failing with NoSuchMethodError on a real Java 8
                runtime. This checks the emitted bytecode against the java18 signature.
            -->
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>animal-sniffer-maven-plugin</artifactId>
                <version>1.27</version>
                <configuration>
                    <signature>
                        <groupId>org.codehaus.mojo.signature</groupId>
                        <artifactId>java18</artifactId>
                        <version>1.0</version>
                    </signature>
                </configuration>
                <executions>
                    <execution>
                        <id>check-java18-api</id>
                        <phase>verify</phase>
                        <goals>
                            <goal>check</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.2.5</version>
                <configuration>
                    <!-- Exclude tests tagged as 'isolated' - they must run separately -->
                    <!-- To run isolated tests: mvn test -Dtest=JsonStoreTest -DskipExcludedGroups=true -->
                    <excludedGroups>${excludedGroups}</excludedGroups>
                </configuration>
            </plugin>
            <!-- JaCoCo 覆盖率插件 -->
            <plugin>
                <groupId>org.jacoco</groupId>
                <artifactId>jacoco-maven-plugin</artifactId>
                <version>0.8.11</version>
                <executions>
                    <!-- 准备代理 -->
                    <execution>
                        <id>prepare-agent</id>
                        <goals>
                            <goal>prepare-agent</goal>
                        </goals>
                    </execution>
                    <!-- 生成报告 -->
                    <execution>
                        <id>report</id>
                        <phase>test</phase>
                        <goals>
                            <goal>report</goal>
                        </goals>
                    </execution>
                    <!-- 覆盖率检查 (可选，暂时注释以避免构建失败) -->
                    <!--
                    <execution>
                        <id>check</id>
                        <goals>
                            <goal>check</goal>
                        </goals>
                        <configuration>
                            <rules>
                                <rule>
                                    <element>BUNDLE</element>
                                    <limits>
                                        <limit>
                                            <counter>LINE</counter>
                                            <value>COVEREDRATIO</value>
                                            <minimum>0.70</minimum>
                                        </limit>
                                    </limits>
                                </rule>
                            </rules>
                        </configuration>
                    </execution>
                    -->
                </executions>
                <configuration>
                    <excludes>
                        <!-- 排除生成的代码 -->
                        <exclude>**/*$$*</exclude>
                        <!-- 排除纯数据类 -->
                        <exclude>**/entity/*Entity.class</exclude>
                    </excludes>
                </configuration>
            </plugin>
            <!--发布源码插件 -->
            <!--            <plugin>-->
            <!--                <groupId>org.apache.maven.plugins</groupId>-->
            <!--                <artifactId>maven-source-plugin</artifactId>-->
            <!--                <version>2.2.1</version>-->
            <!--                <executions>-->
            <!--                    <execution>-->
            <!--                        <phase>package</phase>-->
            <!--                        <goals>-->
            <!--                            <goal>jar</goal>-->
            <!--                        </goals>-->
            <!--                    </execution>-->
            <!--                </executions>-->
            <!--            </plugin>-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.1.0</version>
                <configuration>
                    <archive>
                        <addMavenDescriptor>false</addMavenDescriptor>
                        <!-- 清单文件 -->
                        <manifest>
                            <mainClass>com.ultikits.ultitools.UltiTools</mainClass>
                        </manifest>
                    </archive>
                    <!-- 指定需要把哪些文件打入到jar包中,  -->
                    <!-- ** 代表jar包根目录 -->
                    <!-- **/com/ 代表jar包根目录下仅包含com目录(我所有的程序都在com包下), 当然打好之后还会包含生成的manifest目录 -->
                    <!-- 注意com后面的/一定不要省去,不然maven会认为这是一个文件名 -->
                    <!-- includes或者excludes一定要指定,不然会把target下所有的文件都打进去 -->
                    <includes>
                        <!--                        <include>**/com/ultikits/</include>-->
                        <include>**/</include>
                    </includes>
                    <excludes>
                        <exclude>**/mappings/</exclude>
                    </excludes>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.5.1</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>
                        <configuration>
                            <createDependencyReducedPom>false</createDependencyReducedPom>
                            <minimizeJar>false</minimizeJar>
                            <filters>
                                <filter>
                                    <artifact>*:*</artifact>
                                    <excludes>
                                        <exclude>META-INF/*.SF</exclude>
                                        <exclude>META-INF/*.DSA</exclude>
                                        <exclude>META-INF/*.RSA</exclude>
                                        <exclude>META-INF/MANIFEST.MF</exclude>
                                        <exclude>META-INF/LICENSE*</exclude>
                                        <exclude>META-INF/NOTICE*</exclude>
                                        <exclude>META-INF/DEPENDENCIES</exclude>
                                        <exclude>META-INF/maven/**</exclude>
                                        <exclude>META-INF/versions/**</exclude>
                                        <exclude>META-INF/native-image/**</exclude>
                                        <exclude>META-INF/proguard/**</exclude>
                                        <exclude>META-INF/services/java.sql.Driver</exclude>
                                        <exclude>META-INF/*.kotlin_module</exclude>
                                        <exclude>**/module-info.class</exclude>
                                        <exclude>LICENSE*</exclude>
                                        <exclude>NOTICE*</exclude>
                                        <exclude>about.html</exclude>
                                        <exclude>changelog.txt</exclude>
                                        <exclude>DebugProbesKt.bin</exclude>
                                    </excludes>
                                </filter>
                                <!-- 排除 obliviate-invs 子模块中的重复 UniversalScheduler 类 -->
                                <filter>
                                    <artifact>com.github.hamza-cskn.obliviate-invs:advancedslot</artifact>
                                    <excludes>
                                        <exclude>com/github/Anon8281/universalScheduler/**</exclude>
                                    </excludes>
                                </filter>
                                <filter>
                                    <artifact>com.github.hamza-cskn.obliviate-invs:core</artifact>
                                    <excludes>
                                        <exclude>com/github/Anon8281/universalScheduler/**</exclude>
                                        <exclude>mc/obliviate/util/versiondetection/**</exclude>
                                    </excludes>
                                </filter>
                                <filter>
                                    <artifact>com.github.hamza-cskn.obliviate-invs:configurablegui</artifact>
                                    <excludes>
                                        <exclude>mc/obliviate/util/versiondetection/**</exclude>
                                    </excludes>
                                </filter>
                            </filters>
                            <!-- 防止 minimizeJar 移除反射加载的类 -->
                            <transformers>
                                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                    <mainClass>com.ultikits.ultitools.UltiTools</mainClass>
                                </transformer>
                            </transformers>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <!-- 拷贝依赖的jar包到lib目录 (已移除，改为shade打包) -->

            <!-- 解决资源文件的编码问题 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-resources-plugin</artifactId>
                <version>3.1.0</version>
                <configuration>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <!-- 打包source文件为jar文件 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>2.2.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.6.3</version>
                <configuration>
                    <show>private</show>
                    <nohelp>true</nohelp>
                    <charset>UTF-8</charset>
                    <encoding>UTF-8</encoding>
                    <docencoding>UTF-8</docencoding>
                    <locale>en_US</locale>
                    <failOnWarnings>false</failOnWarnings>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.sonatype.central</groupId>
                <artifactId>central-publishing-maven-plugin</artifactId>
                <version>0.9.0</version>
                <extensions>true</extensions>
                <configuration>
                    <publishingServerId>ultikits-sonatype</publishingServerId>
                    <autoPublish>true</autoPublish>
                    <waitUntil>published</waitUntil>
                </configuration>
            </plugin>
            <plugin>
                <groupId>com.ultikits</groupId>
                <artifactId>ultitools-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <name>UltiTools-API</name>
                    <identifyString>UltiTools-API</identifyString>
                    <shortDescription>UltiTools-API</shortDescription>
                    <accessKeyFile>access_key.txt</accessKeyFile>
                    <pluginFolder>${ultitools.deploy.folder}</pluginFolder>
                </configuration>
            </plugin>
        </plugins>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>

    <repositories>
        <repository>
            <id>papermc</id>
            <url>https://repo.papermc.io/repository/maven-public/</url>
        </repository>
        <repository>
            <id>placeholderapi</id>
            <url>https://repo.extendedclip.com/releases/</url>
        </repository>
        <repository>
            <id>spigotmc-repo</id>
            <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
        </repository>
        <repository>
            <id>sonatype</id>
            <url>https://oss.sonatype.org/content/groups/public/</url>
        </repository>
        <repository>
            <id>jitpack.io</id>
            <url>https://jitpack.io</url>
        </repository>
    </repositories>

    <dependencies>
        <dependency>
            <groupId>io.papermc.paper</groupId>
            <artifactId>paper-api</artifactId>
            <version>1.21.11-R0.1-SNAPSHOT</version>
            <scope>provided</scope>
        </dependency>
        <!-- <dependency>
            <groupId>org.spigotmc</groupId>
            <artifactId>spigot-api</artifactId>
            <version>1.19.3-R0.1-SNAPSHOT</version>
            <scope>provided</scope>
        </dependency> -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.38</version>
            <scope>provided</scope>
        </dependency>
        <!--
            JetBrains @ApiStatus —— 只用来标 API 稳定性边界，是给人和 IDE 看的信号，
            不产生任何运行期约束。全系注解都是 RetentionPolicy.CLASS，运行时不需要
            这个 jar：所以 scope 用 provided、plugin.yml 的 libraries: 不加条目、
            shaded JAR 里也不该出现 org/jetbrains/**。这三件事是一套的，动一个要一起动。

            JetBrains @ApiStatus — used only to mark API stability boundaries. It is a
            signal for humans and IDEs, and enforces nothing at runtime. Every annotation
            in the family is RetentionPolicy.CLASS, so the jar is not needed at runtime:
            hence provided scope, no plugin.yml libraries: entry, and no org/jetbrains/**
            inside the shaded JAR. Those three facts move together.
        -->
        <dependency>
            <groupId>org.jetbrains</groupId>
            <artifactId>annotations</artifactId>
            <version>26.0.2</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>com.github.MilkBowl</groupId>
            <artifactId>VaultAPI</artifactId>
            <version>1.7.1</version>
            <scope>provided</scope>
        </dependency>
        <!-- JSON 统一使用 Gson - Paper libraries 自动下载 -->
        <dependency>
            <groupId>com.google.code.gson</groupId>
            <artifactId>gson</artifactId>
            <version>2.10.1</version>
            <scope>provided</scope>
        </dependency>
        <!-- fastjson 已迁移到 Gson，不再需要 -->
        <!-- commons-dbutils - Paper libraries 自动下载 -->
        <dependency>
            <groupId>commons-dbutils</groupId>
            <artifactId>commons-dbutils</artifactId>
            <version>1.8.1</version>
            <scope>provided</scope>
        </dependency>

        <!-- MySQL Connector - Paper libraries 自动下载 -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <version>8.3.0</version>
            <scope>provided</scope>
        </dependency>
        <!--
            protobuf-java —— 不是本项目直接用的库，是 mysql-connector-j 的传递依赖。
            显式声明只为把版本从 3.25.1 抬到 3.25.5，规避 GHSA-735f-pc8j-v9w8。
            provided 作用域与 plugin.yml 的 libraries: 对应（Paper 在运行时下载）。
            删掉这一条会静默退回 3.25.1，因为传递解析还在。见 issue #220。
        -->
        <dependency>
            <groupId>com.google.protobuf</groupId>
            <artifactId>protobuf-java</artifactId>
            <version>3.25.5</version>
            <scope>provided</scope>
        </dependency>
        <!-- Java-WebSocket - Paper libraries 自动下载 -->
        <dependency>
            <groupId>org.java-websocket</groupId>
            <artifactId>Java-WebSocket</artifactId>
            <version>1.5.4</version>
            <scope>provided</scope>
        </dependency>
        <!-- Adventure - Paper 1.16.5+ 原生支持，无需打包 -->
        <dependency>
            <groupId>net.kyori</groupId>
            <artifactId>adventure-platform-bukkit</artifactId>
            <version>4.3.2</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>com.github.hamza-cskn</groupId>
            <artifactId>obliviate-invs</artifactId>
            <version>${gui.version}</version>
            <exclusions>
                <!-- 排除重复的 UniversalScheduler (core 和 advancedslot 都包含) -->
                <exclusion>
                    <groupId>com.github.Anon8281</groupId>
                    <artifactId>UniversalScheduler</artifactId>
                </exclusion>
                <!-- 排除重复的 version-detection -->
                <exclusion>
                    <groupId>com.github.hamza-cskn.obliviate-utils</groupId>
                    <artifactId>version-detection</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <!-- 单独引入 UniversalScheduler 避免重复 -->
        <dependency>
            <groupId>com.github.Anon8281</groupId>
            <artifactId>UniversalScheduler</artifactId>
            <version>0.1.6</version>
        </dependency>
        <dependency>
            <groupId>me.clip</groupId>
            <artifactId>placeholderapi</artifactId>
            <version>2.11.6</version>
            <scope>provided</scope>
        </dependency>
        <!-- XSeries for cross-version compatibility (1.8.8 - 1.21+) -->
        <dependency>
            <groupId>com.github.cryptomorin</groupId>
            <artifactId>XSeries</artifactId>
            <version>13.0.0</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/com.zaxxer/HikariCP -->
        <dependency>
            <groupId>com.zaxxer</groupId>
            <artifactId>HikariCP</artifactId>
            <version>5.1.0</version>
            <scope>provided</scope>
        </dependency>
        <!-- JUnit 5 dependencies for testing -->
        <dependency>
            <groupId>net.kyori</groupId>
            <artifactId>adventure-text-minimessage</artifactId>
            <version>4.13.1</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.10.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.10.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-params</artifactId>
            <version>5.10.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.mockbukkit.mockbukkit</groupId>
            <artifactId>mockbukkit-v1.21</artifactId>
            <version>4.101.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.mockito</groupId>
            <artifactId>mockito-core</artifactId>
            <version>5.5.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.mockito</groupId>
            <artifactId>mockito-junit-jupiter</artifactId>
            <version>5.5.0</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.assertj</groupId>
            <artifactId>assertj-core</artifactId>
            <version>3.27.7</version>
            <scope>test</scope>
        </dependency>
        <!-- H2 Database for integration testing -->
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <version>2.2.224</version>
            <scope>test</scope>
        </dependency>
        <!-- CGLIB for AOP proxy support - Paper libraries 自动下载 -->
        <dependency>
            <groupId>cglib</groupId>
            <artifactId>cglib-nodep</artifactId>
            <version>3.3.0</version>
            <scope>provided</scope>
        </dependency>
        <!-- JavaMail for email service - Paper libraries 自动下载 -->
        <dependency>
            <groupId>com.sun.mail</groupId>
            <artifactId>javax.mail</artifactId>
            <version>1.6.2</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

    <profiles>
        <!--
            发布 profile：GPG 签名只在这里激活，别处一律不签。
            只有 Maven Central 需要签名产物，而私钥只存在于发布环境。
            把 maven-gpg-plugin 无条件绑在 verify 上，会让任何没有私钥的人
            跑 mvn verify 或 mvn install 都失败，CI 也得处处传 gpg.skip 才能绕开。
            发布时漏掉 -P release 的后果是产物没有签名、被 Central 的校验直接拒绝，
            是一次响亮的失败，而不是静默发出未签名产物。

            Release-only profile: GPG signing is activated here and nowhere else.
            Only Maven Central needs signed artifacts, and the private key exists
            only in the release environment. Binding maven-gpg-plugin to verify
            unconditionally breaks mvn verify and mvn install for everyone without
            a key. Forgetting -P release fails loudly at Central's validation
            instead of silently publishing unsigned artifacts.
        -->
        <profile>
            <id>release</id>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-gpg-plugin</artifactId>
                        <version>1.6</version>
                        <executions>
                            <execution>
                                <id>sign-artifacts</id>
                                <phase>verify</phase>
                                <goals>
                                    <goal>sign</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>
</project>