설치
Mapping Tools는 Windows, Linux, macOS용 네이티브 데스크톱 빌드를 제공합니다. 사용 중인 프로세서에 맞는 빌드를 다운로드 페이지 또는 GitHub 릴리스에서 받으세요.
모든 패키지는 자체 실행형이며 .NET 10 런타임을 포함합니다.
패키지 선택
- Windows: 설치 프로그램 또는 포터블 ZIP을 사용하세요. 대부분의 시스템에는 x64가 적합하고, x86은 32비트 Windows용입니다.
- Linux: x64 또는 ARM64용 AppImage나 포터블 ZIP을 사용하세요.
- macOS: Intel(x64) 또는 Apple silicon(ARM64)용 포터블 ZIP을 다운로드한 다음, 압축을 푼 폴더에서 Mapping Tools.app을 여세요.
기능 호환성
✅ 지원 · ❌ 지원 안 함. 지원되는 기능에도 아래 설정이 필요할 수 있습니다.
| OS | osu! 클라이언트 | 비트맵 읽기/쓰기 | 현재 비트맵 가져오기 | 실시간 편집기 상태 읽기 | 자동 새로고침 | 전역 단축키 | Geometry Dashboard 오버레이 |
|---|---|---|---|---|---|---|---|
| Windows | stable | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Windows | lazer | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ |
| Linux | stable | ✅ | ✅ | ✅ | ❌ | ✅ | ❌ |
| Linux | lazer | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ |
| macOS | stable | ✅ | ❌ | ❌ | ❌ | ✅ | ❌ |
| macOS | lazer | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ |
- osu! stable: Windows와 Linux(Wine)에서는 메모리 읽기로 현재 비트맵을 가져옵니다. Preferences의 Songs folder를 운영체제의 실제 파일 시스템 경로로 설정하세요. 실시간 편집기 상태 읽기는 Windows와 Linux(Wine)에서 사용할 수 있습니다. 자동 새로고침은 Windows에서만 사용할 수 있습니다. macOS에서는 현재 비트맵 가져오기가 지원되지 않습니다. gosumemory와 tosu도 macOS 네이티브 실행을 공식적으로 지원하지 않습니다.
- osu! lazer: File > Edit externally를 사용해 비트맵 파일을 외부에 노출하세요. Mapping Tools가 외부 편집 중인 비트맵을 자동으로 감지하며, 표에서는 이를 현재 비트맵 가져오기로 표시합니다. 변경 사항을 적용하려면 lazer에서 Finish editing and import changes를 사용하세요. lazer 가이드를 참고하세요.
- 전역 단축키: Linux에서는 X11 또는 전역 단축키 포털을 지원하는 데스크톱 환경이 필요합니다. macOS에서는 시스템이 요청하는 키보드 접근 권한을 허용하세요.
File > Open beatmap으로 언제든지 비트맵을 직접 선택할 수 있습니다.
설정
Mapping Tools를 설치한 뒤 왼쪽 위 버튼을 눌러 탐색 메뉴를 열고 Preferences로 이동해 Mapping Tools를 설정하세요.
먼저 다음 항목을 설정하는 것이 좋습니다.
- osu! folder: _osu!_가 설치된 폴더의 경로입니다.
- Songs folder: 모든 맵이 들어 있는 폴더의 경로입니다. 보통 osu! 폴더 바로 안에 있습니다.
- osu! config user file: osu! 사용자 설정 파일의 경로입니다. 보통 osu! 폴더 바로 안에 있는
osu.[username].cfg파일입니다.
참고
osu!stable을 사용한다면 이 경로가 올바른지 확인하세요. 경로가 잘못되면 Mapping Tools가 제대로 작동하지 않을 수 있습니다.