추천 보상 (Votifier) 설정 안내

픽마크에서 누가 서버를 추천하면, 픽마크가 서버의 Votifier 로 "이 사람이 추천했어요" 하고 알려 줘요. 보상(아이템·돈 등)은 서버에 깔린 보상 플러그인이 줘요. 추천한 사람의 정품 인증된 마크 닉네임으로 보내요.

1. Votifier 플러그인 깔기

• VotifierPlus (추천) — 요즘 버전에서 잘 돌아가요.
• NuVotifier — 토큰(v2) 방식도 쓸 수 있어요. 번지코드·벨로시티 프록시에도 깔 수 있어요.

깔고 서버를 한 번 켰다 끄면 설정 파일과 키가 만들어져요.

2. 포트 열기

• Votifier 포트는 게임 포트와 다른 번호여야 해요 (보통 8192).
• 설정의 host 는 0.0.0.0 으로 두세요. 127.0.0.1 이면 밖에서 못 들어와요.
• 공유기·방화벽·호스팅 패널에서 그 포트를 TCP 로 열어 주세요.
• 집 안 주소(192.168…)나 localhost 로는 보낼 수 없어요. 밖에서 닿는 주소여야 해요.

3. 키 · 토큰 찾기

• 공개키: plugins/Votifier/rsa/public.key (VotifierPlus 는 plugins/VotifierPlus/rsa/public.key) 파일을 메모장으로 열어 내용을 통째로 복사해요.
• 토큰(NuVotifier): plugins/Votifier/config.yml 의 tokens: default: 값이에요.
• 둘 다 넣어 두면 서버가 지원하는 방식으로 알아서 골라 보내요. 키·토큰은 서버 주인과 관리자만 볼 수 있어요. 남에게 보여 주지 마세요.

4. 픽마크에 넣기

내 서버 → 정보 수정 → 「추천 보상 (Votifier)」에 포트와 키(또는 토큰)를 넣고 테스트하고 저장을 눌러요. MarkPickTest 이름으로 테스트 투표가 가요. 연결이 안 되면 저장되지 않으니 이유를 보고 고쳐 주세요.

서비스 이름은 항상 pickmc.kr 이에요. 보상 플러그인에서 사이트별 보상을 정할 때 이 이름을 쓰세요.

5. 중복 보상 주의

「자동 재전송」을 켜면 실패한 추천을 1·5·30분 뒤 다시 보내요. 드물게 서버는 받았는데 응답만 늦어서 같은 추천이 두 번 갈 수 있어요. 보상 플러그인에서 같은 사람의 같은 시각 추천을 한 번만 처리하게 하거나, 이 점을 감안하고 켜 주세요. 주인 화면의 「이번 달 추천 기록」에서 하나씩 다시 보낼 수도 있어요.

추천 보상 플러그인

• VotingPlugin — 보상·순위·연속 추천까지 다 되는 큰 플러그인
• CustomVoting — 가벼운 보상 플러그인 (검색 결과)
• Skript Votifier Hook — Skript 로 직접 보상을 짤 때 (검색 결과)
• skript-reflect — 훅 없이 Skript 에서 Votifier 이벤트를 직접 받을 때

Skript 예시 (Votifier 훅이 있을 때, 문법은 훅마다 조금 달라요):

on vote:
    if vote service name is "pickmc.kr":
        give 1 diamond to vote player
        broadcast "&a%vote player%님이 픽마크에서 추천해 줬어요!"