AlphaMapleGuild

메이플스토리 길드원 참여 현황(주간미션·지하 수로·플래그 레이스)을 화면에서 자동으로 읽어 result.xlsx로 정리하는 도구입니다.

사용 방법

1. 메이플 길드 창에서 길드원 참여 현황(컨텐츠 참여 현황 탭) 화면을 엽니다.
   • 길드 창을 확대/축소하지 말고, 위치를 고정한 채 사용하세요.
   • (대안) 전체 화면 캡처 이미지를 확대/축소 없이 띄워 두고 넘겨도 됩니다.
2. 프로그램을 실행합니다.
   • .exe 또는 .py 모두 실행 가능합니다. (.py는 requirements.txt 참고)
     • .exe는 옆에 data 폴더가 같이 있어야 합니다.
   • 대중적으로 사용된 적 없는 프로그램이라 백신이 오탐(바이러스로 탐지)하거나 실행을 차단할 수 있습니다.
3. 프로그램이 길드 창 위치를 자동으로 찾습니다. 이후 길드원 목록 위에 마우스를 두고 위/아래로 천천히 스크롤해 전체를 훑으세요.
   • 캡처된 화면들이 자동으로 이어붙어 목록 전체가 하나의 긴 이미지로 재구성됩니다. (확인용으로 stitched.png에 저장됩니다.)
   • 시작 위치·스크롤 방향은 상관없고, 이미 지나간 구간을 다시 지나가도 됩니다. 단, 한 번에 화면 전체를 건너뛰지 말고 일부가 겹치도록 천천히 굴리세요.
   • 스크롤을 멈추면 잠시 후 자동으로 종료되고 result.xlsx가 저장됩니다.
4. (최초 1회) result.xlsx의 [닉네임 정보] 시트에서 닉네임 이미지에 해당하는 닉네임을, 필요 시 대표캐릭을 입력해 줍니다.
   • OCR 기능이 없어 닉네임을 자동으로 문자 변환할 수 없으므로 수동 입력이 필요합니다.
   • 한 번 입력해 두면 이후 실행부터는 자동으로 닉네임 필드가 채워집니다.

접속 중 캐릭터 / 대표캐릭 매핑

• 접속 중인 길드원은 닉네임이 흰색으로 바뀌고 뒤에 (대표캐릭)이 붙어 표시됩니다. (오프라인은 회색, 대표캐릭만 표시)
• 한 계정이 부캐 여러 개를 함께 가입시킨 경우, 그때 접속한 캐릭에 따라 같은 계정이 서로 다른 형태로 보입니다.
• 이들을 한 사람으로 묶으려면 [닉네임 정보] 시트의 [대표캐릭] 칼럼에 대표 닉네임을 적어 주세요. 기록 시트에서는 대표캐릭으로 표시됩니다. (대표캐릭이 비어 있으면 닉네임으로 표시)

주의사항

• 프로그램 실행 중에는 길드 창의 위치를 바꾸거나 가려서는 안 됩니다.
• 스크롤하는 동안 닉네임·주간미션·지하 수로·플래그 레이스 값이 마우스 커서 등으로 가려지지 않게 하세요.
  • 닉네임이 가려진 채 캡처되면 다른 사람으로 잘못 기록될 수 있습니다.
  • 주간미션·지하 수로·플래그 레이스 숫자가 가려지면 해당 값은 0으로 인식됩니다.
• 직업·레벨·직위 칸 위에 마우스 커서를 두거나, 우측 스크롤 바로 스크롤하면 값 가림을 피하기 쉽습니다.
• 클릭으로 행이 하늘색으로 강조되거나, 온/오프라인에 따른 글자색 변화는 점수 판독에 영향을 주지 않습니다.
• 스캔 종료 후, 기존에 기록돼 있던 닉네임이 누락되었거나 새 닉네임이 추가된 경우 안내 메시지가 출력됩니다.

면책 조항

• 이 프로그램은 개인적으로 작성되었으며, 특정 단체의 승인, 사용 허가 등을 받지 않았습니다.
• 이 프로그램은 있는 그대로 제공됩니다. 프로그램 사용에 대한 책임은 각 사용자에게 있습니다.