Votifier

Votifier란?

Votifier 프로토콜은 플레이어가 마인리스트 서버를 추천했을 때, 서버에서 이와 관련된 처리를 할 수 있게 해주는 프로토콜입니다. 마인리스트 추천시 서버 내에서 보상을 지급하거나, 일정 인원 이상이 추천하는 경우 서버 인원 전체에 보상을 지급하는 등의 이벤트를 개최하는 등 다양한 방식으로 사용할 수 있어요.

Votifier 수신 플러그인 설치

추천 신호를 서버에서 수신하려면 플러그인을 설치해야 합니다. 플러그인을 설치한 후 서버를 재시작합니다.

VotifierPlus
NuVotifier
Votifier

현재 NuVotifier나 Votifier는 개발이 중단되었으므로, VotifierPlus 플러그인을 사용하는 것을 권장합니다.

Votifier 구성

서버 재시작 후 플러그인 폴더가 생성됩니다. 이 폴더의 config.yml 파일을 열어 IP와 포트를 설정하고 서버를 새시작합니다.

Votifier가 정상적으로 작동하기 위해서는 이 포트가 마인크래프트 서버의 포트와 달라야 하며, 마인리스트에서 접근이 가능해야 합니다.

방화벽에서 해당 TCP 포트의 접근이 허용되어 있고, 포트 포워드 등이 정상적으로 되어 있는지 꼭 확인해 주세요.

서버가 여러 IP를 사용 중이며, 특정 IP로만 바인드할 것이 아니라면 IP는 0.0.0.0 을 사용하세요.

마인리스트에 Votifier 등록

마인리스트의 Votifier 설정에 들어가 공개키와 IP, 포트를 설정하세요. 공개키는 플러그인 폴더에서 찾을 수 있습니다. 접속이 성공하면 Votifier 설정이 저장됩니다. 저장되지 않는다면 접속이 되지 않았다는 것이므로 구성을 다시 확인해 보세요.

Votifier 재전송 전략

마인리스트에서는 최대한 안정적인 연결을 제공하고자 노력합니다. 하지만 인터넷 환경의 특성 상 예상치 못한 변수가 발생해 Votifier 전송이 누락되는 경우가 발생할 수 있습니다.

이 경우 서버 운영자가 추천 목록 페이지에서 직접 전송되지 않은 추천을 재전송할 수 있습니다. 재전송은 자동 재전송, 일괄 재전송, 수동 재전송이 가능합니다.

자동 재전송

자동 재전송 기능은 Votifier 설정에서 설정할 수 있습니다. 기본적으로 마인리스트 추천은 Votifier 신호 전송이 실패하면 더 이상 재전송하지 않습니다.

자동 재전송 기능을 사용하면 전송이 실패하는 경우 여러 번 전송되도록 구성할 수 있습니다. 단, 이 경우 Votifier 신호가 최소 한번 이상 (At least once) 전송되는 것이므로 서버의 추천 보상 시스템을 꼭 멱등적으로 구성해야 합니다.

일괄 재전송

일괄 재전송 기능은 Votifier 설정에서 사용할 수 있습니다. 이 기능을 사용하면 "당일 Votifier 신호가 전송되지 않은 모든 추천"에 대해 모두 재전송을 시작합니다. 시간이 걸릴 수 있으므로 충분한 여유를 두고 시도해주시기 바랍니다.

수동 재전송

추천 목록 페이지에서 추천의 "재전송" 버튼을 누르면 Votifier 신호가 재전송됩니다.

멱등성 고려

멱등성이란?

멱등성이란 동일한 연산을 여러 번 적용해도 결과가 변하지 않는 성질을 의미해요.

마인리스트 시스템

마인리스트는 추천 전송 시 At-least-once 정책을 사용합니다. 이는 서버나 네트워크 상황에 따라 최소 한번 이상 추천 신호가 서버에 전송될 수 있다는 것을 의미합니다. 특히 자동 재시도인 경우에는 더욱 많은 추천 신호가 전송될 가능성도 있습니다.
마인리스트는 추천 전송 시 추천 일시를 함께 전송합니다. 이 데이터로 해당 날짜에 이미 보상이 지급되었는지 확인하고, 어제 추천인지 오늘 추천인지를 명확하게 처리하세요.