投票報酬 (Votifier)

誰かがあなたのリスティングに投票すると、MineBuff はすぐにあなたの Minecraft サーバーに通知できるので、報酬プラグインでアイテム、ランク、またはキーを配布できます。

  1. プレイヤーの投票 彼らはあなたの MineBuff 投票ページを開き、彼らの Minecraft 名を入力します。
  2. 私たちはあなたのサーバーに通知します。 MineBuff があなたの Votifier ポートに接続して投票を届けます。
  3. 報酬が発動します。 NuVotifier / クラシック Votifier / GAListener(または類似のもの)が報酬を処理します。

4つのステップで設定します。

  1. あなたの Minecraft サーバーに Votifier をインストールします。

    クラシック Votifier または NuVotifier を使用してください。ポート 8192(または選択したポート)をファイアウォール / ホストパネルで開き、パブリックインターネットからアクセスできるようにします。

  2. キーまたはトークンをコピーします

    v1: plugins/Votifier/rsa/public.key(または NuVotifier rsa/public.key)に貼り付けます。v2: NuVotifier config.yml からトークンをコピーします(通常はデフォルト)。

  3. リスティングで有効にします

    ダッシュボード → サーバー編集 → Votifier。転送をオンにし、ホスト(空白のままにすると Java の IP を使用)、ポート、プロトコルを設定し、キー/トークンを貼り付けて保存します。

  4. テスト投票を送信します

    同じフォームで「テスト投票を送信」を使用します。それが機能すれば、本物の投票も機能します。

自動(推奨)

は、チャレンジ + トークンが利用可能な場合に NuVotifier v2 を選択します。それ以外の場合は v1 RSA にフォールバックします。

v1 — RSA キー

クラシック Votifier および NuVotifier RSA。公開鍵ファイルの内容が必要です。

v2 — トークン

config.yml からの NuVotifier HMAC トークン。すでに NuVotifier を使用している場合は高速で簡単です。

リストサイトでフィルタリングする報酬プラグインは、サービス名 "MineBuff" を許可する必要があります。配信に失敗しても、サイトの投票は有効です — ファイアウォールと資格情報を確認してください。

ダッシュボードを開く サーバーを追加する方法

投票確認 API

「このIPは今日すでに私のサーバーに投票しましたか?」と尋ねる。無料、公開、APIキー不要。

これは投票を行うものではありません

プレイヤーは依然としてMineBuff投票ページで投票します。これらのURLは今日すでに投票が存在するかどうか(UTC)を確認するだけです。

GET

プレーンテキスト

シンプルなプラグインに最適 — 全体の応答は単一の文字です。

https://minebuff.com/api/vote/{slug}/{ip}
1
今日すでに投票済み
0
まだ投票していない(または不明/未公開のサーバー)
curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"
GET

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 付きで返します。

投票ルール

プラグインのタイミングが私たちと一致するようにするための簡単なチェックリストです。

ヘルプ

報酬や API が正常に動作しない場合の一般的なトラブル。

テスト投票が失敗する、またはゲーム内に何も届かない

ポート8192(またはあなたのポート)がインターネットに開かれていること、ホストが到達可能なアドレスと一致していること、キー/トークンがプラグインファイルと完全に一致していること(余分なスペースなし)を確認してください。

どのプロトコルを選べばいいですか?

まずは自動(Auto)で始めましょう。NuVotifierトークンのみを持っている場合はv2を使用します。RSA公開鍵のみを持っている場合はv1を使用します。

APIは常に0を返します。

リスティングが公開されていること、スラッグが正確であること、プレイヤーの実際のIP(同じマシンから投票した場合を除き127.0.0.1ではない)が渡されていることを確認してください。

失敗したVotifierの配信は投票を取り消しますか?

いいえ。MineBuffの投票は依然として有効です。接続を修正して、ダッシュボードでのテスト投票をもう一度試してください。

APIを通じて投票することはできますか?

投票は公開投票ページで行われます。API は本日の投票を確認するための読み取り専用です。