1.0.0 的配置。从下载页选择与服务器匹配的运行包，按以下步骤安装，无需取得闭源源码或自行构建插件。
- 准备环境
准备目标服务器与 Java、MySQL 8 或 MariaDB 10.11，以及实际可用的网络许可证配置。每个市场网络使用同一数据库、Minecraft 版本、币种定义和物品配置；节点 ID 不能重复。
将与服务器版本匹配的一个 KiteMarket 分发 JAR 放入 plugins/，不要同时安装多个分发包。首次启动生成 plugins/KiteMarket/config.yml 后停止服务器，编辑配置。
- 配置网络与数据库
以下为 config.yml 中需要按实际部署填写的字段，密码等值仅为占位示例：
market.minimum-purchase-quantity 为出售草稿的默认最低购买量，默认1；卖家在发布条款页可设为1至发布数量。出售和收购输入每件单价，拍卖输入整标起拍总价。余量不足最低购买量时须一次买完全部余量。已有网络使用协议4构件前，遵守升级说明的清退、备份及停网门禁；新市场无需填写升级来源。
language 可选 zh_CN、en_US 或 auto；语言文件在 plugins/KiteMarket/lang/。tax-bps 使用基点，100 表示 1%；费用从收款方收入扣除，不收上架费。market.taxes.<buy/sell/auction>.<币种ID> 可覆盖该类型的 default，未设置则使用 market.tax-bps；可配置范围为 0–9999 基点。费用按订单创建时的设置结算，修改配置不改写旧单。
- 配置币种
例如，一个整数 PlayerPoints 币种：
maximum 使用最小货币单位，不能超过实际后端安全范围。certified-versions 默认留空，充提保持关闭；在隔离环境测试过具体版本后，才登记实际版本号。该列表不是官方认证报告。
币种显示名称与内部 ID 分开。语言文件中的 currency-names.coins、currency-names.points 默认显示为“金币”“点券”；自定义币种也可在各语言文件的 currency-names.<币种ID> 配置名称，执行 /km reload 后生效。也可显式配置：
points 配置，不替换它的经济字段。display-name 可写共同字符串或中英映射，优先于语言文件；未配置的语言使用该语言文件名称，仍未配置时使用内部 ID。名称不改变钱包、精度、后端币种或网络身份；currencies 下的修改仍需完整重启。只改显示名称时，优先编辑语言文件。商品、确认和钱包使用显示名称，不额外附加内部 ID。
可选 provider 为 vault、playerpoints、coinsengine、excellenteconomy。Vault 需要 vault-provider 与实际 Economy 服务名称一致；后两者需要正确的 native-id。不要复制别人的版本号，也不要为同一个实际币种创建两个重复入口。钱包说明包含网关和失败处理。
- 配置网络授权
保留默认值并填写自己的密钥；不要填写产品名或私钥。程序在服务根地址后追加
/api/v2/license/activate 或 /api/v2/license/heartbeat，远程端点要求 HTTPS。首次启动需要成功联网验证。许可证可通过商品页购买，并在许可证管理查看。
- 重启与部署检查
重新启动，检查插件、数据库、网络会话和许可证状态。先用隔离测试玩家完成一笔充值、一口价、收购供货、竞拍与提现，再验证领取和双节点并发。必须逐个测试实际开启的 provider；仅有 JAR 成功加载不代表充提可用。
网络、数据库、币种、授权和市场数量/时长限制变更后使用完整重启。显示配置与新单费率可使用 /km reload 校验更新；无效配置会被拒绝并保留当前设置。不使用服务端 /reload 或插件热卸载。管理命令见命令与权限，异常处理见运维指南。
- 界面配置
默认原版采用暖色54槽界面：分类首页、顶部工具区、中间36格列表、底部翻页与返回；无需资源包。常用设置：
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 接入。
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 并回退，保留原偏好。资源包或主题不可用不触发市场清退。
原版 GUI 个性化
在plugins/KiteMarket/config.yml 的 menus 中可个性化全部35个页面，包括 profile、ui、themes 和 result。无需资源包或 IA。编辑后执行 /km reload，再重新打开页面；重载先校验候选，无效配置保留上一份有效配置。显示设置只改变外观与位置，不改变原有动作、权限、交易规则或资产处理，也不能新增交易按钮。
下面示例保留旧首页的“我的挂单”原始槽位 32，因此明确选择 home-layout: legacy。合并到已有 gui 和 menus 中，不要重复写顶层键。未填写的字段保留默认值：
菜单槽位为
0..53，不包括下方玩家背包。buttons、slots、icons 按原始槽位配置，不按新版布局移位后的视觉位置：列表原始 0..35 对应新版物理 9..44，所以第一件商品的附加说明配置 buttons.'0'。旧首页 32 为“我的挂单”，34 为“交易历史”；紧凑首页使用上表槽位。位置变更必须完整交换，不能只移动一边；以下示例明确保留旧首页：
buttons.slot 与 slots 共用位置机制，不要重复配置同一来源；旧写法可改为 slots: {'32': 34, '34': 32}。位置改动要求 gui.vanilla.layout: auto 使用兼容布局，原始槽位直接对应物理槽位；不要同时强制 warm。gui.home-slots 的旧首页位置配置仍可读取；切换为 compact 后应迁移为对应的新首页槽位。旧 menus.<页面>.switch 配置保留读取，不向页面注入按钮；界面偏好从个人页或 /km ui 进入。
标题和名称可写单一字符串或双语映射，Lore 可写单一列表或双语列表映射。&／§ 支持原版颜色和格式，生成名称默认金色、Lore 默认灰色，未明确设置斜体时不使用斜体。标题／名称中的 {default} 保留原文；Lore 独占一行的 '{default}' 展开默认市场说明。省略 lore 保留原说明，lore: [] 只清除附加说明。${字段名} 读取本页已有只读字段，如 ${wizard.step}；缺失字段显示 —，不执行脚本。金额原值为最小单位，优先保留 {default} 中的格式化金额与资产去向。
功能按钮可改材料和名称；商品、样品、供货背包物品及领取资产仍保留真实材料、名称、附魔和原 Lore，material／name 不能把它们伪装成另一种物品。只能调整其位置及附加市场说明，不改变背包、托管快照或交易标的。
全部配置页 ID：
claims／wizard-confirm 应分别使用 assets／confirm。每条文本最多512字符，Lore 最多64行；材料必须在当前服务端存在。未知配置字段、无效槽位或不完整交换会使候选无效，command、action、脚本与表达式不属于样式配置。重载失败按反馈和日志中的字段路径修正；未显示修改时重新开页并检查原始槽位、布局及第三方主题是否使用自己的模板。上述设置不安装或下载 IA 资源。
- bStats 基础统计
KiteMarket 默认启用标准 bStats 基础统计，插件 ID 为 34434。legacy、modern、current 三个分发使用同一 ID；它不是网络许可证 ID。
KiteMarket 不添加自定义玩家、交易、许可证或数据库统计项，不上传交易记录、玩家身份、许可证密钥、网络 token、数据库连接或凭据作为自定义统计。
若只关闭 KiteMarket 的统计，在 plugins/KiteMarket/config.yml 设置：
true。也可以在 plugins/bStats/config.yml 将全局 enabled 设置为 false，关闭该服务器遵循此配置的 bStats 统计。任一开关关闭即可停用相应统计，修改后完整重启。统计开关不改变交易功能或许可证规则。
- 运行包、配置与 SDK
从下载页选择与服务器匹配的一份 Legacy、Modern 或 Current JAR。1.0.0 文件名为 KiteMarket-legacy-1.0.0.jar、KiteMarket-modern-1.0.0.jar、KiteMarket-current-1.0.0.jar；API、sources、Javadoc JAR 均不是服务器运行插件。
下载的中英文配置包按 zh_CN／en_US 区分，保留正式默认产品 ID、授权端点和可信公钥，只替换自己的许可证、数据库和经济配置。更新已有配置前先备份并逐项合并，不用整份示例覆盖自己的数据库、币种或网络信息。
按 SHA256SUMS.txt 核对文件并保存使用版本。不能使用隔离测试签发公钥或凭据作为正式配置。公开 SDK 与可运行示例在同一公开仓库提供，见市场 API和界面开发；兼容说明区分目标范围与已验证结果。