Vote Rewards

投票報酬のしくみ

投票報酬は、ゲームサーバーへの投票1回1回を、プレイヤーが使える特典に変えるしくみです。プレイヤーはランキングサイト（TopGames、DayZ Servers、TrackyServer）で投票し、Discordでその投票分のトークンを受け取り、トークンショップでDiscordのロール、ゲーム内アイテム、スタッフが用意する特典などと交換できます。

Discordサーバー上で動き、ゲームのModは必要ありません。プレイヤーにお願いするのは、Steamアカウントを一度連携してもらうことだけです。Premium 3の機能です。

• 1. プレイヤーが投票するサーバーのランキングサイトで、サイトが許す回数だけ投票できます（通常は数時間に1回）。
• 2. プレイヤーがトークンを受け取るDiscordで /votes collect を使います。Botがサイトで投票を確認し、そのサイトに設定したトークンを付与します。1回の投票で付与されるのは一度だけで、二重に付与されることはありません。
• 3. プレイヤーがトークンを使うあなたが作ったトークンショップで /votes buy を使います。ロールはすぐに付与されます。ゲーム内アイテムはゲーム内で、またはスタッフが手渡します。詳しくは下の「報酬の渡し方」をご覧ください。
• 4. みんなでランキングを見るBotが今週と今月の投票上位者をチャンネルに投稿できます。投票を続けてもらうきっかけになります。

ステップごとの手順：10分で設定

Premium 3のサーバーと、Discordサーバーを管理する権限が必要です。

1. 01

   ページを開く

   dayzhub.net にログインしてダッシュボードを開き、サーバーを選んで、サイドメニューから投票報酬を選びます。

2. 02

   オンにして、使う投票サイトを選ぶ

   設定で投票報酬をオンにします。使うランキングサイトごとにオンにして、キー（入手場所は次のセクションを参照）を貼り付け、1票あたりのトークン数を決めます。キーは保存後は点で隠して表示され、あなただけが差し替えられます。

3. 03

   トークンショップを作る

   プレイヤーが買えるものを追加します。名前、トークンでの価格、任意の在庫数、そして中身（Discordのロール、ゲーム内アイテムのリスト、またはスタッフが手渡すもの）を設定します。

4. 04

   投稿先を選ぶ

   ショップのメッセージを投稿するチャンネルと、週間・月間ランキングを投稿するチャンネルを選びます。どちらも任意です。

5. 05

   報酬の渡し方を決める

   DayzHUB Console を連携していれば、プレイヤーは !claim でゲーム内アイテムを自分で受け取れます。連携していない場合はスタッフ用チャンネルを選んでください。ゲーム内アイテムの購入ごとに、スタッフ向けのリクエストスレッドが作られ、お渡し済みボタンが付きます。「報酬の渡し方」をご覧ください。

6. 06

   プレイヤーに知らせる

   投票リンクと短い案内を投稿しましょう。「/link-steam でSteamを連携し、投票して、/votes collect を入力してください」。これで完了です。

投票サイトごとの設定

1つでも2つでも3つすべてでも使えます。サイトごとに専用のキーと、1票あたりのトークン数があります。Botが読み取るのは、プレイヤーが投票したかどうかだけです。あなたに代わって投稿することはなく、サイトのパスワードを見ることもありません。

• TopGames（top-games.net）TopGamesのサーバー管理ページ（APIセクション）で、サーバーの「votes token」を見つけ、TopGamesキーの欄に貼り付けます。プレイヤーはTopGamesのサーバーページで投票し、投票フォームの任意のユーザー名欄にSteam ID（7656119で始まる17桁の長い数字）を入力します。そのあと /votes collect を実行します。TopGamesでは2時間後にもう一度投票でき、Botは投票から最大2時間以内の票を見つけられるので、投票したらなるべく早く受け取ってください。
• DayZ Servers（dayz-servers.org）DayZ Serversのサーバー管理ページでWeb APIセクションを開き、表示されているvotes tokenをコピーして、DayZ Serversキーの欄に貼り付けます。プレイヤーはDayZ Serversのサーバーページで投票し、/votes collect を実行します。Botはトークンを付与したあと、サイト上でその投票を使用済みにするため、二重に付与されることはありません。
• TrackyServer（trackyserver.com）TrackyServerのサーバー管理ページからサーバーのvote keyをコピーして、TrackyServerキーの欄に貼り付けます。プレイヤーはTrackyServerのサーバーページで投票し、/votes collect を実行します。TrackyServerは1票につき一度だけ応答し、それが受け取りの確定になります。

プレイヤーにやってもらうこと

コミュニティにこの手順を共有してください。コマンドはどのチャンネルでも使え、返信はそのプレイヤーにだけ表示されます。

1. 01

   Steamを一度だけ連携する

   Discordで /link-steam を入力し、案内に従います。認証で使うものと同じ連携です。

2. 02

   投票する

   ランキングサイトのサーバーページで投票します。TopGamesでは、ユーザー名欄にSteam IDを入力してください。

3. 03

   受け取る

   Discordで /votes collect を入力します。受け取ったトークンと残高がメッセージで表示されます。サイトの反応が遅いと、投票が表示されるまで1分ほどかかることがあります。

4. 04

   残高とショップを確認する

   /votes balance でトークン残高、/votes shop で買えるものを確認できます。

5. 05

   買う

   /votes buy を入力してアイテムを選びます。トークンが引かれるのは購入が成功したときだけです。失敗したときは請求されません。

6. 06

   報酬を受け取る

   ロールはすぐに付与されます。ゲーム内アイテムは、ゲームのチャットで !claim を入力する（DayzHUB Console があるサーバー）か、スタッフが手渡すのを待ちます（リクエストスレッドでメンションされます）。

7. 07

   Confirm you got it

   After the staff hands over an item, the bot sends you a private message. Press "I received it" when the item is with you, or "I did not receive it" if something is missing and the staff will check again.

トークンショップの作り方

すべてのアイテムに、名前、トークンでの価格、任意の在庫数があります。在庫が0になると売り切れになります。在庫を空欄にすると無制限です。アイテムは3種類あります。

• Discordのロール購入した瞬間にロールが付与されます。「VIP投票者」や色分けなど、ふつうのロールを選んでください。安全のため、Botは（サーバー管理やメンバーのBANのような）スタッフ権限を持つロールや、サーバーがスタッフ用・認証用に使っているロールを拒否します。購入によって誰かがモデレーターになることはありません。
• ゲーム内アイテムのリストプレイヤーが受け取るものを、クラス名と数量をセミコロンで区切って書きます。例：BandageDressing:2;Canteen:1。プレイヤーはゲーム内でそのリストどおりに受け取ります。クラス名がわからないときは、ゲームサーバーを運営している人に聞いてください。
• スタッフが手渡すものそれ以外のすべて、たとえば拠点の修理、カスタムスキン、乗り物などです。購入はスタッフへのリクエストになり、スタッフがゲーム内などで渡してから、お渡し済みを押します。

報酬の渡し方

方法は2つあり、サーバーに合ったほうが自動で使われます。投票報酬ページのスタッフリクエスト設定で変更できます。

• DayzHUB Console なしの場合：スタッフリクエストプレイヤーがゲーム内アイテムや「スタッフが手渡す」アイテムを買うと、Botは選んだスタッフ用チャンネルに非公開スレッドを作ります。スレッドには、誰が何を買ったか、価格、プレイヤーのSteam ID、渡すものが書かれ、選んだロールにメンションが飛びます。別のメッセージに、お渡し済みとトークン返金の2つのボタンがあります。スタッフがゲーム内でアイテムを渡して、お渡し済みを押します。すると報酬はログ上で、スタッフの名前と時刻つきでお渡し済みになり、スレッドでプレイヤーにメンションが飛び、スレッドは閉じられます。アイテムを渡せない場合は、トークン返金を押すとトークンが戻り、報酬は取り消されます。ボタンを押せるのはスタッフだけ（サーバー管理権限、メンションするロール、またはチケットのサポートロール）で、同時に押されても有効になるのはどちらか一方だけです。
• Confirming the delivery (items only)After a staff member presses Delivered, the player gets a private message from the bot asking if the item arrived, with the buttons "I received it" and "I did not receive it". If the player confirms, the reward is marked complete and your staff is told in the thread. If the player says it did not arrive, the request opens again with your staff role pinged, and the Delivered and Refund tokens buttons work again. If the player has private messages closed, the same question is posted in the request thread. Roles are never asked, because they arrive at once.
• With the DayzHUB Console linked: !claimThe DayzHUB Console is our game server tool (dayzhub.cloud) with an agent mod that sits on your server. When your Console server is linked to your Discord server, nobody on your staff has to do anything: the player types !claim in the game chat and the Console hands the items out by itself within seconds, right next to the player. The Console works on every Console plan for this link, only your Discord server needs Premium 3.
• When the Console is releasedThe Console is not open to everyone yet. Until it is, use the staff requests. The day you link your Console server, nothing else has to change: purchases from then on are handed out with !claim, and requests that were already open stay in their threads for your staff to finish. Switch the mode to "Always" if you prefer to keep the staff requests even with the Console.
• The modesAutomatic (default): staff requests only on servers without a linked Console. Always: staff requests for every in-game purchase, also with the Console. Off: no requests, the rewards wait in the list on the Vote Rewards page.

スタッフ向け：報酬一覧とウォレット

プレイヤーが購入したものはすべて、投票報酬ページの1つの一覧に、待機中・お渡し済み・返金済みのステータス付きで表示されます。誰がいつ渡したかも確認できます。

1. 01

   待機中の報酬

   待機中の報酬ごとに、プレイヤー、アイテム、価格が表示されます。渡し終えたら「お渡し済みにする」を、トークンを戻すときは「キャンセルして返金」を押します。

2. 02

   ウォレット

   Steam IDでプレイヤーを検索すると、トークンと履歴を確認できます。スタッフは理由を書いてトークンを追加・削除できます。変更はすべて、スタッフの名前つきでログに記録されます。

3. 03

   ランキング

   ランキング用のチャンネルを選ぶと、Botがそこに今週と今月の投票上位者を載せたメッセージを1つ保ち、自動で更新します。

4. 04

   プランが終了したら

   Premium 3が終了すると、投票報酬は自動で一時停止します。削除されるものはありません。ウォレット、アイテム、ログはそのまま残り、Premium 3に戻った日から再開します。

公平で安全な設計

• 1票につき1回の付与投票は一度しか受け取れません。2つのDiscordアカウントから、または同時に受け取ろうとしても、二重に付与されることはありません。
• 投票はSteamアカウントのものトークンは、受け取ったDiscordアカウントに連携されているSteam IDに付与されます。他の人の分を受け取ることはできず、入力したSteam IDで付与されるのは、そのIDの本当の持ち主だけです。
• トークンがなくなることはありません購入は「すべて成功」か「何も起きない」かのどちらかです。支払いのあとで何か失敗しても、トークンと在庫は自動で元に戻ります。
• キーはあなただけのもの投票サイトのキーはあなたのサーバー専用に保存され、全体が表示されることも、ログに書かれることもありません。

困ったときは

• 「新しい投票が見つかりません」投票がまだサイトに届いていない（1分ほど待ってください）、投票が2時間より古い（TopGames）、または別のSteam IDの投票の可能性があります。TopGamesでは、ユーザー名欄にSteam IDを入力したか確認してください。サイトが許すタイミングでもう一度投票して、改めて受け取ってください。
• 「今はサイトを確認できませんでした」サイトが応答しなかったか、ダッシュボードのキーが間違っている、または変更されています。数分たってからもう一度お試しください。オーナーの方は、設定でキーを貼り付け直して保存してください。
• 「Steamアカウントを連携する必要があります」先に /link-steam を入力してください。投票はSteam IDで照合されます。
• アイテムを買ったのにゲーム内で何も起きないConsoleがある場合：ゲームのチャットで !claim を入力してください。Consoleがない場合：スタッフ側にリクエストスレッドがあり、スタッフが手渡してからお渡し済みを押します。そこでメンションされます。
• The bot asked me if I received an itemThat is the delivery confirmation: your staff pressed Delivered for an item you bought. Press "I received it" if the item is with you. If not, press "I did not receive it" and the staff will check again. Only you can answer, and only once.
• The buttons in the request thread do not workOnly staff can press them. If you are staff and still cannot, you need Manage Server, the ping role set in Staff requests, or a Tickets support role.
• The bot cannot create the threadGive the bot the permissions View Channel, Send Messages and Create Private Threads in the staff channel. The purchase itself is never affected: the reward waits in the list on the Vote Rewards page.