> For the complete documentation index, see [llms.txt](https://doc.stellarvan.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.stellarvan.cn/readme/tiao-shi-yu-fa-bu/da-bao-yu-fa-bu.md).

# 打包与发布

## 打包与发布

当插件功能稳定后，就可以准备发布。

发布前至少做这三件事：

* 打包
* 测试
* 写清版本说明

### 本地打包

如果你用的是 Maven，直接运行：

```bash
mvn package
```

构建成功后，jar 一般会出现在 `target/` 目录。

### 发布前检查

正式发布前，至少确认这些内容：

* 插件名称清晰
* 版本号明确
* 目标服务端版本明确
* 主要命令和权限写清楚
* 基本功能已在干净服务器测试过

### 兼容性说明要写清楚

玩家最关心这几个问题：

* 支持哪个 Minecraft 版本
* 支持哪个服务端核心
* 需要哪些前置插件
* 是否支持旧数据迁移

这些信息越清楚，后续问题越少。

### 常见发布渠道

常见选择有：

* Modrinth
* Hangar
* SpigotMC
* GitHub Releases

如果你想先做小范围测试，直接发 GitHub Releases 就够了。

### 发布说明建议包含什么

可以至少写这几项：

* 新增了什么
* 修复了什么
* 破坏性改动是什么
* 升级时要注意什么

### 一个简单发布流程

{% stepper %}
{% step %}

### 锁定版本

先确认这次发布的版本号。 比如 `1.0.0`。
{% endstep %}

{% step %}

### 在干净环境测试

不要只在自己长期开发的测试服里试。 新开一个干净服务端更靠谱。
{% endstep %}

{% step %}

### 生成 jar 并归档

保留这次发布的源码标签、jar 和变更记录。
{% endstep %}

{% step %}

### 发布并收集反馈

先收第一批真实用户反馈。 再安排下一次修复版本。
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.stellarvan.cn/readme/tiao-shi-yu-fa-bu/da-bao-yu-fa-bu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
