已有市场的数据准备
切换已有环境前先备份并在独立副本核对迁移。不要混跑新旧构件或覆盖原币种身份。
- 准备环境
准备目标服务器与 Java及实际可用的网络许可证。单服可使用内置 SQLite；多服共享市场准备 MySQL 8 或 MariaDB 10.11。每个市场网络使用同一数据库、Minecraft 版本、币种定义和物品配置；节点 ID 不能重复。
将与服务器版本匹配的一个 KiteMarket 分发 JAR 放入 plugins/，不要同时安装多个分发包。首次启动生成 plugins/KiteMarket/config.yml 后停止服务器，编辑配置。
- 配置网络与数据库
以下为单服新安装的 config.yml 示例；数据库文件保存在插件目录：
.db 文件。运行中变更网络、币种或数据库需要停服规划，不能当作普通热重载。
只启用需要的交易模式
market.enabled-types 可配置任意非空子集。只启用竞拍时填写：
/km reload 后，新交易按新配置处理，已有订单仍可撤回、到期结算和领取。
数量与价格
market.minimum-purchase-quantity 为出售草稿的默认最低购买量，默认1；卖家在发布条款页可设为1至发布数量。
单品出售和收购输入每件单价，整包出售输入不可拆分标的的总价，拍卖输入整标起拍总价。单品出售余量不足最低购买量时须一次买完全部余量；整包不支持部分购买。
批量上架产生独立订单，每一单都单独确认；混合整包则作为一个订单整体交易。具体步骤见出售和竞拍。
语言与成交税
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 基点。
费用按订单创建时的设置结算，修改配置不改写旧单。新费用规则可分别配置上架、买方和卖方费用，部分成交累计分摊固定费用与舍入；已收上架费不会随正常撤单退回。完整示例见费用与限制。
- 配置币种
在 currencies 中设置 provider、精度、网关和安全上限。可使用 Vault、PlayerPoints、CoinsEngine、ExcellentEconomy，或原版经验点、等级及完整样品物品币。同网络的币种定义必须一致，不要为同一个实际币种创建两个重复入口。
外部经济适配器的 certified-versions 默认留空，充提保持关闭；验证具体版本后登记真实版本号。经验点和等级在网络中二选一；物品币需要实际序列化样品和正整数面额，不能只填材料名。
币种配置
查看 PlayerPoints、经验点和物品币配置，了解最小单位、完整身份与显示名称。
- 配置网络授权
保留默认值并填写自己的密钥；不要填写产品名或私钥。
程序在服务根地址后追加
/api/v2/license/activate 或 /api/v2/license/heartbeat，远程端点要求 HTTPS。首次启动需要成功联网验证。
许可证可通过商品页购买，并在许可证管理查看。
- 重启与部署检查
重新启动，检查插件、数据库、网络会话和许可证状态。
使用隔离测试玩家检查实际启用的交易模式、充提和领取；共享部署再检查双节点竞争。逐个核对启用的 provider，仅有 JAR 成功加载不代表充提可用。确认金额、税费与资产去向，保留真实失败或待核对状态。
重启还是重载
网络、数据库、币种、授权和市场数量/时长限制变更后使用完整重启。risk、notifications、developer、automation、integrations、imports 和 items 配置也在启动时固定，修改后正常重启。
显示配置、新单费用、policy 和 market.enabled-types 可使用 /km reload 校验更新；无效配置会被拒绝并保留当前设置。共享市场各节点均需更新并重载。不使用服务端 /reload 或插件热卸载。
管理命令见命令与权限，异常处理见运维指南。
- 界面配置
默认原版采用暖色54槽界面，无需资源包。gui 控制呈现后端、通用槽位布局、首页选择和玩家偏好。
玩家可从个人页或 /km ui 选择后端和已安装主题。资源包或主题不可用不触发市场清退。
界面与布局
查看 gui 示例、紧凑首页槽位、商品说明与 ItemsAdder 资源包配置。
原版 GUI 个性化
服主在config.yml 的 menus 中个性化市场、发布、社区、自动化及管理等页面。编辑后执行 /km reload 并重新开页；无效候选保留上一份有效配置。
显示设置只改变外观与位置，不改变原有动作、权限、交易规则或资产处理，也不能新增交易按钮。
原版菜单个性化
查看双语标题与 Lore、真实物品保护、原始槽位交换和全部页面 ID。
- 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。对应命名为 KiteMarket-legacy-<版本>.jar、KiteMarket-modern-<版本>.jar、KiteMarket-current-<版本>.jar；API、sources、Javadoc JAR 均不是服务器运行插件。下载组件只展示实际公开资产，不用其他 JAR 替代缺失文件。
下载的中英文配置包按 zh_CN／en_US 区分，保留正式默认产品 ID、授权端点和可信公钥，只替换自己的许可证、数据库和经济配置。
更新已有配置前先备份并逐项合并，不用整份示例覆盖自己的数据库、币种或网络信息。
按 SHA256SUMS.txt 核对文件并保存使用版本。不能使用隔离测试签发公钥或凭据作为正式配置。
公开 SDK 与可运行示例在同一公开仓库提供，见市场 API和界面开发；兼容说明区分目标范围与已验证结果。
- 按任务完成配置
交易与物品
设置高级收购，发布单品或整包，预览真实内容并完成交付。
钱包与自动化
查看真实上限、缺口补款、收益预约和默认关闭的自动任务。
社区与发现
收藏、保存搜索、订阅、通知、卖家排行与同币种价格参考。
管理与风险复核
带原因的管理确认、导出、真实资产操作和人工复核线索。