オーナー & プラグイン制作者
ドキュメント
プレイヤーが投票した際に報酬を与え、誰かが今日すでに投票したかを専門用語を調べずに確認できます。
投票報酬 (Votifier)
誰かがあなたのリスティングに投票すると、MineBuff はすぐにあなたの Minecraft サーバーに通知できるので、報酬プラグインでアイテム、ランク、またはキーを配布できます。
- プレイヤーの投票 彼らはあなたの MineBuff 投票ページを開き、彼らの Minecraft 名を入力します。
- 私たちはあなたのサーバーに通知します。 MineBuff があなたの Votifier ポートに接続して投票を届けます。
- 報酬が発動します。 NuVotifier / クラシック Votifier / GAListener(または類似のもの)が報酬を処理します。
4つのステップで設定します。
-
あなたの Minecraft サーバーに Votifier をインストールします。
クラシック Votifier または NuVotifier を使用してください。ポート 8192(または選択したポート)をファイアウォール / ホストパネルで開き、パブリックインターネットからアクセスできるようにします。
-
キーまたはトークンをコピーします
v1: plugins/Votifier/rsa/public.key(または NuVotifier rsa/public.key)に貼り付けます。v2: NuVotifier config.yml からトークンをコピーします(通常はデフォルト)。
-
リスティングで有効にします
ダッシュボード → サーバー編集 → Votifier。転送をオンにし、ホスト(空白のままにすると Java の IP を使用)、ポート、プロトコルを設定し、キー/トークンを貼り付けて保存します。
-
テスト投票を送信します
同じフォームで「テスト投票を送信」を使用します。それが機能すれば、本物の投票も機能します。
自動(推奨)
は、チャレンジ + トークンが利用可能な場合に NuVotifier v2 を選択します。それ以外の場合は v1 RSA にフォールバックします。
v1 — RSA キー
クラシック Votifier および NuVotifier RSA。公開鍵ファイルの内容が必要です。
v2 — トークン
config.yml からの NuVotifier HMAC トークン。すでに NuVotifier を使用している場合は高速で簡単です。
リストサイトでフィルタリングする報酬プラグインは、サービス名 "MineBuff" を許可する必要があります。配信に失敗しても、サイトの投票は有効です — ファイアウォールと資格情報を確認してください。
投票確認 API
「このIPは今日すでに私のサーバーに投票しましたか?」と尋ねる。無料、公開、APIキー不要。
プレイヤーは依然としてMineBuff投票ページで投票します。これらのURLは今日すでに投票が存在するかどうか(UTC)を確認するだけです。
プレーンテキスト
シンプルなプラグインに最適 — 全体の応答は単一の文字です。
https://minebuff.com/api/vote/{slug}/{ip}
1- 今日すでに投票済み
0- まだ投票していない(または不明/未公開のサーバー)
curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"
JSON
同じ答えに加えて、いつ投票したかと毎日のリセットまでの時間。
https://minebuff.com/api/vote/{slug}/{ip}/json
| フィールド | 意味 |
|---|---|
vote |
“1” または “0”(文字列)— 今日投票したかどうか。 |
voted_at |
今日の投票時刻、または null。 |
reset_at_midnight |
常に真 — 日次投票確認ウィンドウは UTC の 00:00 にリセットされます(ランキング合計は別で、だいたい毎月リセットされます)。 |
time_until_next_vote |
すでに投票済みの場合は次の UTC の深夜までの秒数、そうでなければ 0。 |
{
"vote": "1",
"voted_at": "2026-09-12T14:32:01Z",
"reset_at_midnight": true,
"time_until_next_vote": 34199
}
URL に入れるもの
| URL 内 | 意味 |
|---|---|
{slug} |
リスト URL からのサーバーのスラッグ(例:/servers/your-slug)。 |
{ip} |
プレイヤーの IP アドレス。ハッシュ化します;UTC 日ごとに IP ごとにサーバーあたり 1 投票。 |
ブラウザからも動作します(CORS)。不明なサーバーはプレーンテキストで 0 を返すか、HTTP 404 JSON を error server_not_found 付きで返します。
投票ルール
プラグインのタイミングが私たちと一致するようにするための簡単なチェックリストです。
- 各サーバーごとに、各IPアドレス1回ずつ UTC 日(00:00 UTC)に投票できます。ランキングの投票総数は約1か月ごとにリセットされます。
- 公開されているサーバーごとに、各IPアドレス1日1回 UTC 投票できます。
- 投票には MineBuff フォーム上で Minecraft ユーザー名が必要です(Votifier に必要)。
- チェック API は投票を作成しません。本日の日付の状態のみを報告します。
ヘルプ
報酬や API が正常に動作しない場合の一般的なトラブル。
テスト投票が失敗する、またはゲーム内に何も届かない
ポート8192(またはあなたのポート)がインターネットに開かれていること、ホストが到達可能なアドレスと一致していること、キー/トークンがプラグインファイルと完全に一致していること(余分なスペースなし)を確認してください。
どのプロトコルを選べばいいですか?
まずは自動(Auto)で始めましょう。NuVotifierトークンのみを持っている場合はv2を使用します。RSA公開鍵のみを持っている場合はv1を使用します。
APIは常に0を返します。
リスティングが公開されていること、スラッグが正確であること、プレイヤーの実際のIP(同じマシンから投票した場合を除き127.0.0.1ではない)が渡されていることを確認してください。
失敗したVotifierの配信は投票を取り消しますか?
いいえ。MineBuffの投票は依然として有効です。接続を修正して、ダッシュボードでのテスト投票をもう一度試してください。
APIを通じて投票することはできますか?
投票は公開投票ページで行われます。API は本日の投票を確認するための読み取り専用です。