Skip to main content
KiteMarket 提供完整原版 GUI 和 ItemsAdder v4 兼容。服主与开发者可以使用自己的资源制作配置主题或 Java 呈现器，自用、免费分发或独立销售，无需额外的 KiteMC 主题授权。交易、真实物品、输入校验和确认仍由共用服务端流程处理。
先准备主题资源插件不内置 IA 主题资源。可以安装服主自有主题、第三方主题或公开的 MIT 开发示例；没有主题时继续使用完整原版界面。

​
安装自己的主题

  1. 取得合法的 ItemsAdder v4 运行插件和配套 ProtocolLib，确认支持目标服务器；已有代表组合见兼容说明。仅有 API JAR 不能运行。
  2. 按主题说明安装其独立 ItemsAdder 命名空间，将 KiteMarket 主题声明放入 plugins/KiteMarket/themes/*.yml。Java 主题还需安装提供者插件。可运行配置和 Java 示例见界面与第三方开发。
  3. 按实际 IA 指南手动 /iareload，等待加载完成，再 /iazip 重建和下发资源包；KiteMarket 不代替管理员执行第三方重建命令。
  4. 登记实际下发且包含主题的资源包的 SHA-1（40位十六进制）及 UUID。临时启用 gui.itemsadder.diagnostics: true 并 /km reload，可从 [KITEMARKET_PACK] 读取观察到的 UUID、SHA-1和 URL。登记后重新 /km reload，再关闭诊断。
  5. 玩家成功加载指定包后使用 /km ui itemsadder example-ia，或配置该主题为默认后 /km ui auto。用 /km ui 核对实际界面和回退原因。
示例中 example-ia 必须是已经安装的主题 ID；资源包身份占位值必须替换为实际观察值：
未安装 IA 主题时使用 gui.default-themes: {}。第三方主题也可通过 requires 登记自己的包身份，详见开发指南。无效候选保留当前有效配置，主题无需登记 KiteMC 商品 ID 或下载端点。

​
使用与回退

偏好按市场网络和玩家保存，换服保持一致；主题缺失或回退不覆盖原偏好。切换保留发布草稿，不重复提交交易。两种界面共用真实物品、订单版本、报价、最终背包重查和操作编号。 资源注册、适配器及玩家对指定资源包的成功加载都需就绪；发送或接受不等于加载成功。拒绝、失败、对应包丢弃／移除或不匹配时回退，无关资源包不清空 IA 就绪记录。断线、换节点、全量移除和 IA 重载后重新确认。更新内容需使用新的实际下发 UUID 和对应摘要，不能只在 KiteMarket 配置中生成随机 UUID，也不能给已登记 UUID 换摘要。

​
开发自己的界面

基础库存布局、共用页面和金额输入保留；开发者可使用自己的字体图片、按钮物品图标及逐页配置。SDK 的动作／输入仍接受服务端校验，不能以主题绕过确认或直接扣款。完整示例、35页键和生命周期说明见开发指南。 迁移时保留主题声明、资源和玩家偏好，先备份再更新，见运维说明。公开示例的 MIT 许可仅覆盖示例内注明的源码与资源，其他主题遵循各自许可。