Merge pull request #317 from m1sk9/ci/release-tag-scheme

Tag each release with exactly one platform (Paper: vX.Y.Z, Velocity: velocity/vX.Y.Z)

13 files changed, 51 insertions, 33 deletions

diff --git a/website/src/assets/changelog-default.md b/website/src/assets/changelog-default.md
index 1e9be22..1c8b653 100644
--- a/website/src/assets/changelog-default.md
+++ b/website/src/assets/changelog-default.md
@@ -6,7 +6,7 @@ layout: doc
 
 <!--
 - Download:
-  - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/paper/vX.Y.Z)
+  - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/vX.Y.Z)
   - [Modrinth](https://modrinth.com/plugin/lunaticchat/version/X.Y.Z)
 
 - Download:
diff --git a/website/src/changelog/overview.md b/website/src/changelog/overview.md
index b0e4a97..86fee92 100644
--- a/website/src/changelog/overview.md
+++ b/website/src/changelog/overview.md
@@ -32,13 +32,20 @@ Cutting a runtime environment loose — "support for Paper 26.1 has ended", "sup
 
 The plugin for Paper / Folia and the plugin for Velocity are released independently, so their version numbers advance separately. Numbers that do not line up are the normal state of affairs.
 
-Releases are cut with a tag naming the target.
+Each release tag carries exactly one platform.
 
 | Tag | Released target |
 |-----|-----------------|
-| `paper/vX.Y.Z` | The Paper / Folia build only |
-| `velocity/vX.Y.Z` | The Velocity build only |
-| `vX.Y.Z` | Both at once, for a change that affects them both — such as one in the shared `engine` module |
+| `vX.Y.Z` | The Paper / Folia build |
+| `velocity/vX.Y.Z` | The Velocity build |
+
+When both are updated together — for a change in the shared `engine` module, for example — the two tags are released at the same time, each with its own GitHub Release.
+
+::: info Tags up to v1.4.0
+
+Up to v1.4.0, a `vX.Y.Z` tag could ship both builds at once (`v1.0.0`, `v1.3.0`, `v1.4.0`), and some Paper-only releases were tagged `paper/vX.Y.Z`. Every later `vX.Y.Z` tag is the Paper / Folia build only.
+
+:::
 
 ### The plugin version does not express compatibility
 
diff --git a/website/src/changelog/paper/v1.3.0.md b/website/src/changelog/paper/v1.3.0.md
index 599a59a..2d53066 100644
--- a/website/src/changelog/paper/v1.3.0.md
+++ b/website/src/changelog/paper/v1.3.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.3.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/paper/v1.3.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.3.0)
     - [Modrinth](https://modrinth.com/plugin/lunaticchat/version/1.3.0)
 
 ## New Features
diff --git a/website/src/changelog/paper/v1.4.0.md b/website/src/changelog/paper/v1.4.0.md
index 0b88138..4460f51 100644
--- a/website/src/changelog/paper/v1.4.0.md
+++ b/website/src/changelog/paper/v1.4.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.4.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/paper/v1.4.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.4.0)
     - [Modrinth](https://modrinth.com/plugin/lunaticchat/version/1.4.0)
 
 ## New Features
diff --git a/website/src/changelog/velocity/v1.2.0.md b/website/src/changelog/velocity/v1.2.0.md
index 272fb50..5d5c147 100644
--- a/website/src/changelog/velocity/v1.2.0.md
+++ b/website/src/changelog/velocity/v1.2.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.2.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/velocity/v1.2.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.3.0)
     - [Modrinth (Velocity)](https://modrinth.com/plugin/lunaticchat/version/1.2.0-velocity)
 
 ## New Features
diff --git a/website/src/changelog/velocity/v1.3.0.md b/website/src/changelog/velocity/v1.3.0.md
index c458760..ab025ac 100644
--- a/website/src/changelog/velocity/v1.3.0.md
+++ b/website/src/changelog/velocity/v1.3.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.3.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/velocity/v1.3.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.4.0)
     - [Modrinth (Velocity)](https://modrinth.com/plugin/lunaticchat/version/1.3.0-velocity)
 
 ## New Features
diff --git a/website/src/docs/developers/resource.md b/website/src/docs/developers/resource.md
index 67e6d57..614597a 100644
--- a/website/src/docs/developers/resource.md
+++ b/website/src/docs/developers/resource.md
@@ -30,17 +30,19 @@ Paper and Velocity carry separate version numbers and can be released independen
 
 ## Release workflows
 
-The release target switches based on the tag pattern.
+One tag releases exactly one platform. The tag pattern selects which.
 
 | Workflow | Trigger tag | Build target | Version validation |
 |----------|-------------|--------------|--------------------|
-| `release.yaml` | `v*` | Both Paper + Velocity | extract both versions from gradle.properties |
-| `release-paper.yaml` | `paper/v*` | Paper only | requires the tag to match `paperVersion` |
-| `release-velocity.yaml` | `velocity/v*` | Velocity only | requires the tag to match `velocityVersion` |
-
-- Common flow: `validate` (check for a duplicate existing release) → `build` (mise + Gradle setup, `shadowJar`) → `release` (`gh release create --draft` + publish to Modrinth)
-- The per-platform workflows (paper / velocity) differ from `release.yaml` in requiring a strict match between the tag and `gradle.properties`
-- Modrinth game-versions are Paper=`26.2.x` (loaders: paper, folia) and Velocity=`1.21.x` + `26.1.x` + `26.2.x` (loader: velocity)
+| `release-paper.yaml` | `vX.Y.Z` | Paper only | requires the tag to match `paperVersion` |
+| `release-velocity.yaml` | `velocity/vX.Y.Z` | Velocity only | requires the tag to match `velocityVersion` |
+
+- Releasing both at once means pushing both tags together (`git push origin v1.5.0 velocity/v1.4.0`). Each produces its own GitHub Release
+- Paper keeps the bare `vX.Y.Z` tag because the update checker in already-deployed Paper builds only understands that form
+- Up to v1.4.0, a `vX.Y.Z` tag released both platforms (`v1.0.0`, `v1.3.0`, `v1.4.0`), and some Paper-only releases used `paper/vX.Y.Z`. Those tags are kept as they are
+- Both workflows call the shared `_release.yaml`: `validate` (tag format, match with `gradle.properties`, duplicate release check) → `build` (mise + Gradle setup, `shadowJar`) → `release` (`gh release create --draft` + publish to Modrinth)
+- The GitHub Release is created as a draft. Publish a Velocity release with `--latest=false`, so that the repository's latest release stays the Paper one
+- Modrinth game-versions are Paper=`26.2.x` (loaders: paper, folia) and Velocity=`1.21.x` + `26.1.x` + `26.2.x` (loader: velocity), set in each caller workflow
 
 ## CI
 
diff --git a/website/src/ja/changelog/overview.md b/website/src/ja/changelog/overview.md
index 3b03477..3cfcdc7 100644
--- a/website/src/ja/changelog/overview.md
+++ b/website/src/ja/changelog/overview.md
@@ -32,13 +32,20 @@ LunaticChat ではセマンティックバージョニングを採用してい�
 
 Paper / Folia 向けプラグインと Velocity 向けプラグインは独立してリリースされるため，バージョン番号も別々に進みます．番号が揃っていないのは正常な状態です．
 
-リリースは対象を示すタグで行います．
+リリースのタグ 1 つにつき，対象のプラットフォームは 1 つです．
 
 | タグ | リリース対象 |
 |------|-------------|
-| `paper/vX.Y.Z` | Paper / Folia 版のみ |
-| `velocity/vX.Y.Z` | Velocity 版のみ |
-| `vX.Y.Z` | 両方同時．共有モジュール `engine` の変更など，双方に影響する変更で使用します |
+| `vX.Y.Z` | Paper / Folia 版 |
+| `velocity/vX.Y.Z` | Velocity 版 |
+
+共有モジュール `engine` の変更などで両方を更新する場合は，2 つのタグを同時にリリースします．GitHub Release もそれぞれ作られます．
+
+::: info v1.4.0 までのタグ
+
+v1.4.0 までは，`vX.Y.Z` タグで両方を同時にリリースすることがありました (`v1.0.0`，`v1.3.0`，`v1.4.0`)．また，Paper 単独のリリースに `paper/vX.Y.Z` を使ったものもあります．それ以降の `vX.Y.Z` は Paper / Folia 版のみです．
+
+:::
 
 ### プラグインバージョンは互換性を表しません
 
diff --git a/website/src/ja/changelog/paper/v1.3.0.md b/website/src/ja/changelog/paper/v1.3.0.md
index 78e241a..c776cf5 100644
--- a/website/src/ja/changelog/paper/v1.3.0.md
+++ b/website/src/ja/changelog/paper/v1.3.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.3.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/paper/v1.3.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.3.0)
     - [Modrinth](https://modrinth.com/plugin/lunaticchat/version/1.3.0)
 
 ## New Features
diff --git a/website/src/ja/changelog/paper/v1.4.0.md b/website/src/ja/changelog/paper/v1.4.0.md
index 176b2b0..9b28c76 100644
--- a/website/src/ja/changelog/paper/v1.4.0.md
+++ b/website/src/ja/changelog/paper/v1.4.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.4.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/paper/v1.4.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.4.0)
     - [Modrinth](https://modrinth.com/plugin/lunaticchat/version/1.4.0)
 
 ## New Features
diff --git a/website/src/ja/changelog/velocity/v1.2.0.md b/website/src/ja/changelog/velocity/v1.2.0.md
index 18249c9..907c4b4 100644
--- a/website/src/ja/changelog/velocity/v1.2.0.md
+++ b/website/src/ja/changelog/velocity/v1.2.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.2.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/velocity/v1.2.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.3.0)
     - [Modrinth (Velocity)](https://modrinth.com/plugin/lunaticchat/version/1.2.0-velocity)
 
 ## New Features
diff --git a/website/src/ja/changelog/velocity/v1.3.0.md b/website/src/ja/changelog/velocity/v1.3.0.md
index 6367355..1a13c9b 100644
--- a/website/src/ja/changelog/velocity/v1.3.0.md
+++ b/website/src/ja/changelog/velocity/v1.3.0.md
@@ -5,7 +5,7 @@ layout: doc
 # v1.3.0
 
 - Download:
-    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/velocity/v1.3.0)
+    - [GitHub](https://github.com/m1sk9/LunaticChat/releases/tag/v1.4.0)
     - [Modrinth (Velocity)](https://modrinth.com/plugin/lunaticchat/version/1.3.0-velocity)
 
 ## New Features
diff --git a/website/src/ja/docs/developers/resource.md b/website/src/ja/docs/developers/resource.md
index 7bcc6c9..94dd046 100644
--- a/website/src/ja/docs/developers/resource.md
+++ b/website/src/ja/docs/developers/resource.md
@@ -30,17 +30,19 @@ Paper と Velocity は別々のバージョン番号を持ち，独立にリリ�
 
 ## リリースワークフロー
 
-タグのパターンでリリース対象が切り替わります．
+1 つのタグで 1 つのプラットフォームをリリースします．タグのパターンで対象が決まります．
 
 | ワークフロー | トリガタグ | ビルド対象 | バージョン検証 |
 |-------------|-----------|-----------|---------------|
-| `release.yaml` | `v*` | Paper + Velocity 両方 | gradle.properties から両バージョン抽出 |
-| `release-paper.yaml` | `paper/v*` | Paper のみ | タグと `paperVersion` の一致を必須検証 |
-| `release-velocity.yaml` | `velocity/v*` | Velocity のみ | タグと `velocityVersion` の一致を必須検証 |
-
-- 共通フロー: `validate` (既存リリースの重複チェック) → `build` (mise + Gradle setup, `shadowJar`) → `release` (`gh release create --draft` + Modrinth 公開)
-- 個別ワークフロー (paper / velocity) はタグと `gradle.properties` の厳密一致を要求する点が `release.yaml` と異なる
-- Modrinth の game-versions は Paper=`26.2.x` (loader: paper, folia)，Velocity=`1.21.x` + `26.1.x` + `26.2.x` (loader: velocity)
+| `release-paper.yaml` | `vX.Y.Z` | Paper のみ | タグと `paperVersion` の一致を必須検証 |
+| `release-velocity.yaml` | `velocity/vX.Y.Z` | Velocity のみ | タグと `velocityVersion` の一致を必須検証 |
+
+- 両方を同時に出す場合は 2 つのタグをまとめて push する (`git push origin v1.5.0 velocity/v1.4.0`)．GitHub Release もそれぞれ作られる
+- Paper が接頭辞なしの `vX.Y.Z` を使うのは，配布済みの Paper 版のアップデートチェッカーがこの形式しか解釈できないため
+- v1.4.0 までは `vX.Y.Z` タグで両方をリリースしていた (`v1.0.0`，`v1.3.0`，`v1.4.0`)．Paper 単独のリリースには `paper/vX.Y.Z` を使ったものもある．これらのタグはそのまま残している
+- どちらのワークフローも共通の `_release.yaml` を呼び出す: `validate` (タグの形式，`gradle.properties` との一致，既存リリースの重複チェック) → `build` (mise + Gradle setup，`shadowJar`) → `release` (`gh release create --draft` + Modrinth 公開)
+- GitHub Release は draft で作られる．Velocity のリリースは `--latest=false` を付けて公開し，リポジトリの Latest が Paper のリリースのままになるようにする
+- Modrinth の game-versions は Paper=`26.2.x` (loader: paper, folia)，Velocity=`1.21.x` + `26.1.x` + `26.2.x` (loader: velocity)．呼び出し側の各ワークフローで指定する
 
 ## CI