Wuma Tracker는 게임 명조: 워더링 웨이브의 인게임 플레이어 위치를 실시간으로 공유하고 웹 맵과 연동할 수 있도록 도와주는 데스크톱 애플리케이션입니다. 이 프로그램을 사용하면 친구와 함께 탐험할 때 서로의 위치를 쉽게 확인하거나, 개인 방송 등에서 자신의 위치를 지도 위에 표시하는 등 다양하게 활용할 수 있습니다.
Tauri, SvelteKit, TypeScript를 기반으로 제작되었습니다.
- 실시간 위치 추적: 게임 클라이언트의 메모리를 직접 읽어 플레이어의 좌표(x, y, z)와 방향(pitch, yaw, roll) 데이터를 실시간으로 감지합니다.
- WebRTC 기반 위치 공유: WebRTC 기술을 활용하여 다른 유저와 P2P로 위치 데이터를 공유하거나, 로컬 웹소켓 서버를 통해 다른 애플리케이션으로 데이터를 전송할 수 있습니다.
- 간편한 연결 코드: 8자리의 Base36 코드를 생성하여 다른 사용자와 쉽 96C8 연결을 공유할 수 있습니다.
- 외부 서버 연동: 중앙 서버(
wss://concourse.wuwa.moe)와 연결하여 원격으로 위치 데이터를 공유하는 기능을 지원합니다. - 자동 업데이트: 새로운 버전이 출시되면 앱 내에서 자동으로 업데이트를 확인하고 설치할 수 있습니다.
- 직관적인 UI: SvelteKit과 Tailwind CSS를 기반으로 한 깔끔하고 사용하기 쉬운 인터페이스를 제공합니다.
- 프로그램 실행: Wuma Tracker를 실행합니다.
- 게임 프로세스 연결:
프로세스 찾기 및 연결버튼을 클릭하여 실행 중인 '명조: 워더링 웨이브' 클라이언트에 연결합니다. - 위치 공유:
- 친구와 공유:
외부 연결 시작버튼을 눌러 생성된 8자리 코드를 친구에게 알려주세요. 친구는 해당 코드를 사용하여 당신의 위치를 지도에서 볼 수 있습니다. - 외부 프로그램 연동: 로컬 웹소켓 주소(
ws://127.0.0.1:46821)를 사용하여 OBS 같은 방송 프로그램이나 다른 웹 애플리케이션에 실시간 위치 데이터를 전송할 수 있습니다.
- 친구와 공유:
이 프로젝트를 개발하기 위한 추천 환경입니다.
- VS Code: 코드 에디터
- Svelte for VS Code: Svelte 언어 지원
- Tauri: Tauri 프레임워크 지원
- rust-analyzer: Rust 언어 지원
-
저장소 복제:
git clone https://github.com/wuwamoe/wuma-tracker.git cd wuma-tracker -
의존성 설치: 이 프로젝트는
pnpm을 사용합니다.pnpm install
-
개발 서버 실행: Tauri 개발 환경을 시작합니다.
pnpm tauri dev
.
├── src/ # SvelteKit 프론트엔드 소스 코드
│ ├── lib/ # Svelte 라이브러리 (컴포넌트, 유틸리티 등)
│ ├── routes/ # SvelteKit 라우팅
│ └── app.html # 메인 HTML 템플릿
├── src-tauri/ # Rust 백엔드 (Tauri) 소스 코드
│ ├── src/
│ │ ├── main.rs # 프로그램 진입점
│ │ ├── lib.rs # Tauri 앱 설정 및 명령어
│ │ ├── rtc_supervisor.rs # WebRTC 및 데이터 수집 총괄
│ │ ├── peer_manager.rs # WebRTC Peer 연결 관리
│ │ ├── signaling_handler.rs # WebSocket 시그널링 처리
│ │ ├── native_collector.rs # 게임 프로세스 데이터 수집
│ │ └── win_proc.rs # Windows 프로세스 메모리 접근
│ ├── Cargo.toml # Rust 의존성 관리
│ └── tauri.conf.json # Tauri 설정 파일
├── package.json # Node.js 의존성 및 스크립트
└── svelte.config.js # SvelteKit 설정 파일