Skip to main content
默认原版采用暖色54槽界面:分类首页、顶部工具区、中间36格列表、底部翻页与返回;无需资源包。 安装流程见安装与配置。标题、图标、Lore 和位置个性化见原版菜单个性化。

常用设置

当前呈现选项为 auto/vanilla/itemsadder。 auto-order 决定自动尝试顺序,默认 ItemsAdder→原版;default-themes 指定后端默认主题。 布尔字段使用 YAML 的 true/false,不能写成字符串。音效可通过 gui.sounds.enabled: false 关闭。

通用槽位布局

gui.vanilla.layout: auto|warm|legacy 控制通用槽位映射。 auto 在旧首页入口位置偏离默认或页面配置 slots/buttons.slot 时保留兼容布局;只修改标题、图标、名称、Lore 或背景不改变这项映射。 显式 warm 与自定义位置冲突会被拒绝。

首页布局

gui.home-layout 单独选择首页内容: 即使 menus.home 只修改标题或 Lore,home-layout: auto 也会保留旧首页。 两项布局设置作用不同:vanilla.layout 管理通用位置映射,home-layout 管理首页入口。

紧凑首页

默认紧凑首页的原始槽位与物理槽位相同: 挂单、待领和待核对提醒使用真实查询;查询失败显示暂不可用。 “我的集市”使用独立 profile 页面,返回首页和界面切换保留当前发布草稿。

发布入口

首页 31 号槽位的“发布 / 编辑草稿”按钮直接打开向导,继续编辑当前草稿。 各类市场及“我的挂单”列表顶部中央也保留该入口,默认原始槽位为 52,新版布局物理槽位为 4,页码显示在 Lore 中。 发布后的订单需要更改时,先撤单再重新发布,不能直接修改已发布的价格和条件。

商品说明与数量

默认商品说明分为商品信息和购买/供货/竞拍提示,保留原名称、附魔及 Lore。 数量显示单独数值,详情将总量与已成交分开;拍卖显示整个标的数量。 角标仅在物品原生堆叠允许范围内(最多99)显示真实数量,超出时使用单图标,精确数量始终以 Lore 为准,不改变真实物品数量。

日期与倒计时

上架和到期显示日期,中文为 yyyy年MM月dd日 HH:mm:ss,英文为 yyyy-MM-dd HH:mm:ss,使用服务器时区。 剩余时间自动更新:至少一小时显示整小时,至少一分钟显示整分钟,不足一分钟显示秒;到期提示不等于结算已经完成。

玩家界面偏好

玩家从头像进入个人页选择界面,也可用 /km ui 打开设置,或选择 /km ui <auto|vanilla|itemsadder> [theme-id]。 这是选择后端和已安装主题,不是样式编辑器;服主的样式个性化只通过 config.yml 完成,不提供游戏内样式编辑功能。 偏好保存在同网络共享数据库中,没有记录为 AUTO;allow-player-switch: false 禁用选择并采用服务器偏好。 默认不指定 IA 主题;安装自己的主题后,可将其 ID 填入 gui.default-themes.itemsadder。 实际资源包的 SHA-1 和 UUID 登记后,玩家加载指定包成功才可启用;完整步骤见ItemsAdder 接入。

ItemsAdder 与资源包身份

IA 运行插件与 ProtocolLib 必须另行合法安装;已有实测组合及摘要见兼容说明。 按实际 IA 指南安装主题,等待 /iareload 完成,再执行 /iazip。 可临时设置 gui.itemsadder.diagnostics: true 并 /km reload,从服务端 [KITEMARKET_PACK] 读取实际下发的 UUID、SHA-1及 URL,登记到上述字段后再次 /km reload;诊断完成后关闭。 发送或接受不等于加载成功,资源包内容更新必须使用新的实际下发 UUID和对应摘要,不能只在 KiteMarket 中填写一个随机 UUID。

第三方主题

第三方界面可自由开发和销售,无需额外的 KiteMC 主题授权:将独立主题放入 plugins/KiteMarket/themes/*.yml,使用自有资源和已注册 provider。格式与示例见界面 SDK。 旧 germ/dragoncore 偏好、配置和 SDK 扩展位置仍可读取,但不代表内置厂商适配器;没有已注册的实际 provider 时返回 UI_BACKEND_RETIRED 并回退,保留原偏好。 资源包或主题不可用不触发市场清退。