KiteMarket

支持高级收购、一口价出售和公开竞拍的完整 Minecraft 市场插件。内置原版 GUI、钱包、领取箱、历史和管理功能；可选兼容 ItemsAdder v4，开发者可自行制作、免费分发或独立销售自有界面，无需额外的 KiteMC 主题授权。

本文档对应 KiteMarket v1.1.0。下载时按对应版本和准确文件名选择运行 JAR、SDK、示例及语言／配置包。

本仓库存放 SDK 源码、开发示例、文档及 Issues。推荐通过 GitHub Packages 引用两套 SDK。运行 JAR、SDK 直接下载、源码／Javadoc、示例及语言／配置包从 GitHub Releases 获取。

售价：¥68／USD 9.99，买断。一份许可证对应一个独立市场网络，网络内不限节点。包含基础插件更新，维护期间提供问题支持，不承诺永久维护服务。第三方经济插件、ItemsAdder 及其资源另行获取。

• English / 中文
• 购买许可证 / Purchase / English store
• Website / English docs
• Market SDK / SDK English
• UI SDK
• GitHub Packages / Packages English
• API example / IA example
• GUI configuration
• v1.1 user guide / Guide English
• 导入与迁移 / Import and migration
• Releases

v1.1 功能概览

• 多种上架与领取方式：不可拆整包出售／竞拍、逐单确认的批量上架、容器只读预览与分类批量领取。
• 更完整的条件与服主规则：业务物品 ID、标签与白名单字段条件；配置交易模式、费用、权限和物品限制。
• 钱包与个人自动化：经验点／等级和真实物品币、缺口补款、自动领取与提现设置。
• 发现与社区：收藏、保存搜索、订阅与持久通知；卖家资料、排行和同币种成交价参考。
• 管理与开发扩展：明确确认的资产操作、证据导出、人工风险复核与可选云端建议；公开 SDK 提供拥有者登记的扩展和玩家确认请求。
• 部署与可选集成：单服使用持久 SQLite，多服共享 MySQL／MariaDB；提供来源副本导入工具，以及 PlaceholderAPI、Citizens 和 LuckPerms 显示／入口集成。

具体操作、配置与功能边界见 v1.1 用户指南。

Maven packages / Maven 开发包

• com.kitemc:kitemarket-api:1.1.0 — immutable queries, extensions and player-confirmed requests / 不可变查询、扩展与玩家确认请求
• com.kitemc:kitemarket-ui-api:1.1.0 — renderer SDK / 界面 SDK

Repository: https://maven.pkg.github.com/kitemc/KiteMarket. GitHub requires authentication even for public Maven packages. Local consumers use a classic PAT with read:packages; setup examples explain Gradle, Maven and Actions. / GitHub 的公开 Maven 包也需要认证；本地使用具有 read:packages 的 classic PAT，见配置指南。The existing Release JAR downloads remain available without Maven registry authentication. / 也可继续从 Release 下载 SDK JAR，无需 Maven 仓库认证。

After configuring the registry and credentials from the guide, use: / 按指南配置仓库和用户级认证后使用：

dependencies {
    compileOnly("com.kitemc:kitemarket-api:1.1.0")
    compileOnly("com.kitemc:kitemarket-ui-api:1.1.0") // optional / 按需
}

The 1.0 query service and DTO constructors remain compatible. The separate 1.1 extension and request services register enabled owners and require host player confirmation; they grant no arbitrary wallet, inventory or recovery access. / 保留1.0查询服务与DTO构造器；1.1独立扩展和请求服务登记启用中的拥有者，交易仍需主插件玩家确认，不授予任意钱包、背包或恢复权限。

SDK dependencies must be compileOnly (Maven: provided). Never bundle, shade or relocate either SDK. KiteMarket supplies the only runtime copy. / SDK 必须以 compileOnly 引用（Maven 为 provided），不得打包、shade 或重定位。Follow each example's README to use Packages in your own example copy. / 示例 README 提供将自己的副本改为 Packages 构建的步骤。

Local source build / 本地源码构建

Install JDK 21 locally: this checkout's Gradle toolchain selects Java 21. SDK artifacts still target Java 11; the IA example targets Java 21. / 请在本机安装 JDK 21，公开构建会选择 Java 21 工具链；SDK 产物仍为 Java 11，IA 示例为 Java 21。

The unchanged example scripts support source and release builds with local SDK files: / 未修改的示例脚本使用本地 SDK 文件，供源码和发行构建使用：

.\gradlew.bat :market-api:jar :market-ui-api:jar
.\gradlew.bat -p examples/api-java -PmarketApiJar=$PWD/market-api/build/libs/KiteMarket-API-1.1.0.jar developerBundle
.\gradlew.bat -p examples/ui-java -PuiApiJar=$PWD/market-ui-api/build/libs/KiteMarket-UI-API-1.1.0.jar developerBundle

License / 许可

MIT applies only to the SDK modules and explicitly licensed examples. The closed-source runtime JAR is proprietary; MIT does not grant runtime redistribution or publication of its source. / MIT 仅覆盖 SDK 与标明许可的示例，不适用于闭源运行 JAR。

Minecraft compatibility targets start at 1.16.5. Target ranges are separate from tested combinations; consult the website for actual evidence. Legacy SDK identifiers for Germ and DragonCore are compatibility declarations only, not official support.