Beat Saber 플레이리스트 만들기 — .bplist 편집하기

읽는 데 약 3분 · 2026-08-04

Beat Saber에서 커스텀 곡이 수백 개 쌓이면 목록에서 원하는 곡을 찾기가 어려워집니다. 플레이리스트로 묶어 두면 훨씬 편한데, 그 파일이 .bplist 형식입니다.

Beat Saber 목록 편집기는 이 파일을 브라우저에서 열어 편집하고 다시 저장하는 도구입니다.

.bplist가 무엇인가

이름은 낯설지만 안은 JSON입니다. 플레이리스트 제목, 만든 사람, 커버 이미지, 그리고 곡 목록이 들어 있습니다.

곡 하나를 식별하는 데 쓰이는 값은 이렇습니다.

설명
songName화면에 보이는 곡 제목
levelAuthorName맵을 만든 사람 (업로더)
keyBeatSaver의 맵 번호
hash맵 파일의 SHA-1 해시 40자리
levelIdcustom_level_ + 해시

해시가 핵심입니다. 게임은 곡 이름이 아니라 해시로 곡을 찾기 때문에, 해시가 틀리면 플레이리스트에 곡이 보이지 않습니다.

편집하기

  1. 편집기.bplist 파일을 끌어다 놓습니다
  2. 제목과 작성자를 고칩니다
  3. 곡 목록을 정리합니다
  4. 수정된 파일 저장으로 내려받아 원래 위치에 덮어씁니다

플레이리스트 파일은 보통 Beat Saber 설치 폴더의 Playlists 폴더에 있습니다.

곡 추가하는 두 가지 방법

폴더로 추가 — 권장

커스텀 곡 폴더를 통째로 고르면 각 곡의 info.dat을 읽어 제목과 난이도 정보를 가져오고, 해시를 직접 계산해서 채웁니다.

해시는 info.dat과 각 난이도 파일을 순서대로 이어 붙여 SHA-1을 구하는 방식으로, Beat Saber가 쓰는 것과 같은 규칙입니다. 손으로 적을 필요 없이 정확한 값이 들어갑니다.

폴더 안에 info.dat이 없으면 곡 폴더가 아니라고 알려 줍니다. 커스텀 곡 폴더 하나가 아니라 그 상위 폴더를 골랐을 때 자주 생기는 상황입니다.

수동 추가

BeatSaver에서 값을 직접 옮겨 적는 방식입니다. 곡 파일이 손에 없을 때 씁니다.

순서 바꾸기와 정리

커버 이미지

플레이리스트 목록에서 눈에 띄게 하려면 커버가 중요합니다.

파일 선택 — 가지고 있는 이미지를 씁니다.

이미지 검색 — 검색어를 넣으면 앨범 아트를 찾아 줍니다. K-POP 곡 모음처럼 주제가 뚜렷한 플레이리스트라면 아티스트 이름으로 찾는 게 빠릅니다.

커버 텍스트 — 이미지 위에 글자를 합성합니다. 비슷한 앨범 아트로 여러 플레이리스트를 만들 때 구분하기 좋습니다.

커버 이미지 검색은 외부 서비스(Apple iTunes Search API)를 통해 이루어집니다. 검색어만 전달되며 플레이리스트 파일이나 곡 정보는 전송되지 않습니다.

JSON 직접 보기

JSON 보기를 누르면 파일의 실제 내용을 볼 수 있습니다. 다른 도구가 만든 플레이리스트가 이상하게 동작할 때, 어떤 필드가 빠졌는지 확인하는 용도로 씁니다.

자주 겪는 문제

플레이리스트는 보이는데 곡이 하나도 없다 해시가 틀렸거나, 그 곡이 실제로 설치돼 있지 않은 경우입니다. 폴더로 추가하는 방식으로 다시 만들면 해시 문제는 사라집니다.

일부 곡만 안 보인다 그 곡들만 해시가 다릅니다. 같은 곡이라도 맵이 업데이트되면 해시가 바뀌므로, 곡을 새로 받았다면 플레이리스트도 다시 만들어야 합니다.

저장한 파일을 게임이 인식하지 않는다 Playlists 폴더에 넣었는지, 확장자가 .bplist인지 확인하세요. 브라우저가 .json으로 바꿔 저장했을 수 있습니다.

정리

← 가이드 목록으로