Skip to content

SnipeFactory/Aion2-Scouter

Repository files navigation

Aion2 Scouter

아이온2 게임 클라이언트의 네트워크 패킷을 캡처하여, 파티 신청자와 파티원의 닉네임·직업·레벨·전투력·서버 정보를 실시간으로 표시하는 투명 오버레이 앱입니다.

License

⚠️ 운영 정책 안내 본 프로젝트는 게임 운영측의 요청, 패킷 암호화 등의 조치, 또는 공식적인 사용 중단 언급이 있을 경우 즉시 개발이 중단되며 비공개 상태로 전환됩니다.


목차


요구 사항

  • Java 21 (Amazon Corretto 21 권장)
  • Npcap — 패킷 캡처 드라이버 (설치 필요)

빌드하기

# 개발 실행
./gradlew run

# 배포용 실행 파일 생성 (build/compose/binaries/)
./gradlew createDistributable

# MSI 인스톨러 생성
./gradlew packageMsi

빌드 환경에 Java 21이 필요합니다. IntelliJ IDEA를 사용하는 경우 JAVA_HOME을 JBR(JetBrains Runtime) 경로로 설정하세요.


사용법

1. Npcap 설치

https://npcap.com/ 에서 Npcap을 설치합니다. 설치 옵션에서 "WinPcap API-compatible Mode" 를 체크하세요.

2. 앱 실행

배포 패키지를 압축 해제한 뒤 Aion2-Scouter.exe를 실행합니다. (또는 개발 환경에서 ./gradlew run)

3. 네트워크 인터페이스 선택 (설정)

설정 패널의 서버 IP / 포트 항목에서 게임 서버 주소를 확인합니다. (기본값으로 대부분의 환경에서 자동 감지됩니다.)

4. 게임에서 파티 신청 받기

게임 내 파티 게시판에서 파티원을 모집하면, 신청자의 정보가 오버레이에 실시간으로 표시됩니다.

5. 데이터 초기화

설정한 단축키(기본: Ctrl+R)를 누르면 파티 목록과 신청 목록이 초기화됩니다.


UI 각 요소 설명

헤더

버튼 설명
× 앱 종료
⚙ (설정) 설정 패널 열기

파티 신청 섹션

image
파티 게시판을 통해 신청이 들어오면 자동으로 표시됩니다.

  • 닉네임, 직업 아이콘, 레벨, 전투력, 서버명 표시
  • 설정한 파티 신청 만료(초) 시간이 지나면 자동으로 목록에서 제거

파티원 섹션 ⚠️ BETA

image

⚠️ 주의: 이 기능은 베타 상태입니다. 파티원 목록은 게임 서버의 파티 패킷을 파싱하여 표시하지만, 게임 업데이트나 특수 상황(던전 입장, 추방, 재접속 등)에 따라 목록이 부정확하게 표시되거나 갱신되지 않을 수 있습니다. 정보 불일치가 발생하면 단축키(기본: Ctrl+R)로 수동 초기화하세요.

  • 현재 파티원의 닉네임, 직업, 레벨, 전투력, 서버명 표시

설정 패널

항목 설명
테마 다크 / 라이트 전환
레이아웃 기본(우측) / 반전(좌측) — 화면 방향에 맞게 선택
리셋 단축키 파티·신청 목록 초기화 단축키 설정 (Ctrl/Alt 조합)
패킷 로그 덤프 활성화 시 ./packet-dump/ 에 패킷 hex 덤프 저장 (디버그용)
파티 신청 만료 (초) 신청 목록에서 항목이 자동 제거되기까지의 시간 (5~120초)

라이선스

MIT License

About

Aion2 party overlay — 파티 신청자·파티원 정보 실시간 표시

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors