LunaticChat

日本語

English

日本語

English

Appearance

ビルド・リリース・バージョニング ​

Gradle マルチモジュール構成で，engine を共有しつつ Paper / Velocity を独立した成果物としてビルド・リリースします．

ビルド構成 ​

  • ルート build.gradle.kts — Kotlin 2.4.0 + serialization / Shadow / ktlint / dokka を管理．JVM ターゲットは JVM_25．テストは JUnit Platform + jacoco で，共通テスト依存を全モジュールへ注入
  • engine — コアライブラリ (serialization / coroutines / ktor) を api() で公開しプラットフォームへ伝播．Adventure は compileOnly．Shadow を持たない純ライブラリ
  • platform-paper — version = paperVersion．api(project(":engine"))．paper-api を compileOnly，KAML + kotlin-reflect を implementation．成果物は LunaticChat-<ver>.jar (classifier なし，jar は無効化)
  • platform-velocity — version = velocityVersion．api(project(":engine"))．velocity-api を compileOnly．成果物は LunaticChat-<ver>-velocity.jar (classifier で区別)
  • dokka — engine/paper/velocity を集約し HTML に README を include

両プラットフォームのバージョンは isNightly から導出されます．-PisNightly=true を付けるとベースバージョンに -nightly.<git short hash> が付き (LunaticChat-1.3.0-nightly.44132f3.jar)，開発ビルドを同じベースバージョンのリリースと取り違えることがなくなります．フラグを付けない場合は paperVersion / velocityVersion そのままで，リリースワークフローはこちらをビルドします．

processResources はこの version と gitCommitHash / channel を paper-plugin.yml / velocity-plugin.json と build-info.properties にトークン展開します．

独立バージョニング ​

properties
# gradle.properties
paperVersion=1.3.0
velocityVersion=1.2.0

Paper と Velocity は別々のバージョン番号を持ち，独立にリリースできます．互換性を数値バージョンではなく engine 共有の ProtocolVersion で保証しているため，更新頻度の異なる 2 プラットフォームをそれぞれのペースでバンプ・公開できるからです．ワイヤ形式は JSON + ignoreUnknownKeys で前方互換，プロトコルの MAJOR 一致 + MINOR 範囲チェックで後方互換をコントロールします．

リリースワークフロー ​

1 つのタグで 1 つのプラットフォームをリリースします．タグのパターンで対象が決まります．

ワークフロートリガタグビルド対象バージョン検証
release-paper.yamlvX.Y.ZPaper のみタグと paperVersion の一致を必須検証
release-velocity.yamlvelocity/vX.Y.ZVelocity のみタグと 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.3.x (loader: paper, folia)，Velocity=1.21.x + 26.1.x + 26.2.x (loader: velocity)．呼び出し側の各ワークフローで指定する

CI ​

ci.yaml は main への push / PR / 手動実行で動きます．

  • build_plugin — ktlintCheck → test + jacocoTestReport → Codecov アップロード → nightly shadowJar (-PisNightly=true) → LunaticChat-paper-<sha> / LunaticChat-velocity-<sha> としてプラットフォームごとに artifact 保持 (JAR は artifact 直下)
  • build_dokka / deploy_dokka — Dokka 生成 → GitHub Pages デプロイ (main push のみ)
  • build_docs — website/ を bun で format/lint/build → Cloudflare Workers (wrangler) へデプロイ (main push のみ)

開発環境 ​

  • mise.toml — bun / java zulu-25 (JVM_25 と整合)
  • x — bash 製のデバッグサーバースクリプト．./x <action> <platform> [--stable] で start/stop/log/clean/rcon/help．--stable 省略時は nightly ビルド．velocity 指定時は 1 Velocity + 2 Paper を立ち上げ，サーバー間チャット中継を実地検証できる
  • docker/ — paper / velocity / folia の 3 環境に compose.yaml (itzg/minecraft-server:java25 等)．velocity.toml は bungee-plugin-message-channel=true でプラグインメッセージを有効化
  • サーバーのバージョンは x が build.gradle.kts の paper-api / velocity-api から導出し，PAPER_MC_VERSION / PAPER_BUILD / VELOCITY_VERSION として Compose に渡す．そのためデバッグ環境は常にプラグインのコンパイル対象と同じビルドで動く．docker compose を直接叩くと ./x を経由するよう促すメッセージで失敗する．Folia のビルド番号だけは Paper と別系列のため手動固定

関連 ​