> ## Documentation Index
> Fetch the complete documentation index at: https://www.kitemc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装与配置

> 按步骤完成环境、数据库、币种和网络授权，再检查部署。

<span id="安装与配置" />

本指南对应 `1.0.0` 的配置。从[下载页](/kitemarket/download)选择与服务器匹配的运行包，按以下步骤安装，无需取得闭源源码或自行构建插件。

<h2 id="_1-准备环境">
  1. 准备环境
</h2>

准备[目标服务器与 Java](/kitemarket/compatibility)、MySQL 8 或 MariaDB 10.11，以及实际可用的网络许可证配置。每个市场网络使用同一数据库、Minecraft 版本、币种定义和物品配置；节点 ID 不能重复。

将与服务器版本匹配的一个 KiteMarket 分发 JAR 放入 `plugins/`，不要同时安装多个分发包。首次启动生成 `plugins/KiteMarket/config.yml` 后停止服务器，编辑配置。

<h2 id="_2-配置网络与数据库">
  2. 配置网络与数据库
</h2>

以下为 `config.yml` 中需要按实际部署填写的字段，密码等值仅为占位示例：

```yaml theme={null}
language: zh_CN

network:
  name: survival
  node-id: survival-1
  item-profile: default
  # 新市场不填写升级来源；协议由安装包确定。
  # 已有协议1/2/3升级到4前须完成EXIT_ONLY清退，停全网、备份并等待租约失效。
  # upgrade-from-protocol: '3' # 仅首节点临时填写实际来源协议。

database:
  url: "jdbc:mysql://127.0.0.1:3306/kitemarket"
  username: "kitemarket"
  password: "REPLACE_ME"

market:
  order-limit: 10
  minimum-purchase-quantity: 1
  maximum-quantity: 1000000
  maximum-duration-seconds: 604800
  tax-bps: 0
```

创建独立数据库并授予插件账户所需权限。数据库不通、网络定义不一致或插件尚未初始化时，不应允许交易。运行中变更网络、币种或数据库需要停服规划，不能当作普通热重载。

### 数量与价格

`market.minimum-purchase-quantity` 为出售草稿的默认最低购买量，默认1；卖家在发布条款页可设为1至发布数量。

出售和收购输入每件单价，拍卖输入整标起拍总价。余量不足最低购买量时须一次买完全部余量。

已有网络使用协议4构件前，遵守[升级说明](/kitemarket/operations)的清退、备份及停网门禁；新市场无需填写升级来源。

### 语言与成交税

`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 基点。

费用按订单创建时的设置结算，修改配置不改写旧单。

<h2 id="_3-配置币种">
  3. 配置币种
</h2>

在 `currencies` 中为实际经济插件设置 provider、精度、网关和安全上限。同网络的币种定义必须一致，不要为同一个实际币种创建两个重复入口。

`certified-versions` 默认留空，充提保持关闭；在隔离环境测试过具体版本后，才登记实际版本号。

<Card title="币种配置" icon="coins" href="/kitemarket/configuration/currencies">
  查看完整 PlayerPoints 示例、各经济适配器要求、显示名称与重启规则。
</Card>

<h2 id="_4-配置网络授权">
  4. 配置网络授权
</h2>

```yaml theme={null}
license:
  key: "REPLACE_WITH_LICENSE_KEY"
```

正式默认配置已提供下列产品与信任信息，服主**不需要自行查找或填写产品 ID、公钥**：

| 设置 | 默认值 |
| - | - |
| `license.endpoint` | `https://license.kitemc.com` |
| `license.product-id` | `57ef7c59-7c76-4192-abeb-4c4d7ac0a00f` |
| `license.public-key` | 随配置提供的 KiteMC 生产 RSA 公钥，沿用现有信任体系 |

保留默认值并填写自己的密钥；不要填写产品名或私钥。

程序在服务根地址后追加 `/api/v2/license/activate` 或 `/api/v2/license/heartbeat`，远程端点要求 HTTPS。首次启动需要成功联网验证。

许可证可通过[商品页](https://license.kitemc.com/products/kitemarket)购买，并在[许可证管理](https://license.kitemc.com/dashboard/licenses)查看。

<h2 id="_5-重启与部署检查">
  5. 重启与部署检查
</h2>

重新启动，检查插件、数据库、网络会话和许可证状态。

先用隔离测试玩家完成一笔充值、一口价、收购供货、竞拍与提现，再验证领取和双节点并发。必须逐个测试实际开启的 provider；仅有 JAR 成功加载不代表充提可用。

### 重启还是重载

网络、数据库、币种、授权和市场数量/时长限制变更后使用完整重启。

显示配置与新单费率可使用 `/km reload` 校验更新；无效配置会被拒绝并保留当前设置。不使用服务端 `/reload` 或插件热卸载。

管理命令见[命令与权限](/kitemarket/commands)，异常处理见[运维指南](/kitemarket/operations)。

<h2 id="_6-界面配置">
  6. 界面配置
</h2>

默认原版采用暖色54槽界面，无需资源包。`gui` 控制呈现后端、通用槽位布局、首页选择和玩家偏好。

玩家可从个人页或 `/km ui` 选择后端和已安装主题。资源包或主题不可用不触发市场清退。

<Card title="界面与布局" icon="table-cells-large" href="/kitemarket/configuration/gui">
  查看 gui 示例、紧凑首页槽位、商品说明与 ItemsAdder 资源包配置。
</Card>

<h3 id="原版-gui-个性化">
  原版 GUI 个性化
</h3>

服主在 `config.yml` 的 `menus` 中个性化全部35个页面。编辑后执行 `/km reload` 并重新开页；无效候选保留上一份有效配置。

显示设置只改变外观与位置，不改变原有动作、权限、交易规则或资产处理，也不能新增交易按钮。

<Card title="原版菜单个性化" icon="sliders" href="/kitemarket/configuration/menus">
  查看双语标题与 Lore、真实物品保护、原始槽位交换和全部页面 ID。
</Card>

<h2 id="_7-bstats-基础统计">
  7. bStats 基础统计
</h2>

KiteMarket 默认启用标准 bStats 基础统计，插件 ID 为 **34434**。legacy、modern、current 三个分发使用同一 ID；它不是网络许可证 ID。

KiteMarket 不添加自定义玩家、交易、许可证或数据库统计项，不上传交易记录、玩家身份、许可证密钥、网络 token、数据库连接或凭据作为自定义统计。

若只关闭 KiteMarket 的统计，在 `plugins/KiteMarket/config.yml` 设置：

```yaml theme={null}
metrics:
  enabled: false
```

默认值为 `true`。也可以在 `plugins/bStats/config.yml` 将全局 `enabled` 设置为 `false`，关闭该服务器遵循此配置的 bStats 统计。

任一开关关闭即可停用相应统计，修改后完整重启。统计开关不改变交易功能或许可证规则。

<h2 id="_8-运行包、配置与-sdk">
  8. 运行包、配置与 SDK
</h2>

从[下载页](/kitemarket/download)选择与服务器匹配的**一份** 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](/kitemarket/api)和[界面开发](/kitemarket/ui-development)；[兼容说明](/kitemarket/compatibility)区分目标范围与已验证结果。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.