Paper サーバ向けプラグイン。プレイヤーが座標を名前付きで保存・表示・削除し、必要なら他のプレイヤーと共有できる。
- 対象: Paper 1.26.1.2 系 (Java 25 以上)
- 保存先:
plugins/SavePosition/positions.yml
- このリポジトリの Actions タブを開く
- 緑チェックの最新の
Buildワークフロー実行を開く - 下の Artifacts セクションから
SavePosition-jarをクリックしてダウンロード（zip） - zip を展開すると
SavePosition-x.y.z.jarが出てくる
Artifact の保持期間はデフォルト 30 日。古い場合はワークフローを再実行（
workflow_dispatch）してください。
ビルド を参照。
- 取得した
SavePosition-*.jarを Paper サーバのplugins/ディレクトリに置く - サーバを 再起動 する（
/reloadは非推奨） - 起動ログに
[SavePosition] SavePosition を有効化しました。が出れば成功
| コマンド | 動作 |
|---|---|
/pos save <名前> |
現在地を 名前 で保存（既存名は上書き、共有フラグは維持） |
/pos list |
自分の保存一覧 |
/pos show <名前> |
指定した保存地点の座標を表示 |
/pos delete <名前> |
削除（remove / del も可） |
/pos share <名前> |
共有 ON |
/pos unshare <名前> |
共有 OFF |
/pos shared |
サーバ全員の共有座標一覧 |
/pos shared <プレイヤー名> |
指定プレイヤーの共有座標一覧 |
/pos goto <名前> |
BossBar に方位矢印と距離を表示してガイド開始 |
/pos goto stop |
ガイドを停止 |
/pos goto <名前> は 自分の保存名 → 共有中の他人の保存名 の順で探索する。
別ワールドの地点を指定した場合は矢印の代わりに「別ワールド <world名> (X, Y, Z)」と表示する。
自動到着検知はないので、不要になったら /pos goto stop で消す。
別名: /position, /savepos
権限: saveposition.use（default: true）
./build_on_nix.sh # build (デフォルト)
./build_on_nix.sh test # テストのみ
./build_on_nix.sh clean build # クリーンビルドnix-shell -p gradle_9 jdk25 で一時的に Java 25 + Gradle 9 を用意してビルドする。
初回のみ MockBukkit をローカル準備する必要がある。
./scripts/install_mockbukkit.sh # 数分。~/.m2 へ MockBukkit を publish
./gradlew buildMockBukkit 公式は MC 26 対応モジュールを Maven Central に公開していないため、dev/26.1.1 ブランチをローカルでビルドして mavenLocal に publish する運用。
- 利用する commit SHA は
.mockbukkit-shaに書かれている（フル SHA、改行可） build.gradle.ktsは同ファイルから先頭 12 文字を読んでmockbukkit-v26.1:dev-XXXXXXXXXXXXという座標を組み立てるscripts/install_mockbukkit.shは MockBukkit の clone 内でgit config core.abbrev 12を設定して publish するので、shallow / full clone の差で artifact 名がブレない- 上流の更新を取り込みたいときは
.mockbukkit-shaを編集してからinstall_mockbukkit.shを再実行
.github/workflows/build.yml で push / PR / workflow_dispatch 時に以下を実行:
- JDK 25 (Temurin) を
actions/setup-javaで導入 ~/.gradle/caches、~/.gradle/wrapperをキャッシュ（キー: gradle ファイル +.mockbukkit-sha）~/.m2/repository/org/mockbukkitをキャッシュ（キー:.mockbukkit-sha）- キャッシュミス時のみ
scripts/install_mockbukkit.shを実行 ./gradlew buildを実行build/libs/*.jarをSavePosition-jarという Artifact として upload（30 日保持）- テストレポート（
build/reports/tests/test）をtest-reportとして upload（7 日保持）
.mockbukkit-sha を更新しない限り、MockBukkit のビルドはキャッシュから即取得される。
MIT License — Copyright (c) 2026 Kazuhiko UNO