설치 가이드

발라트로 모드 설치 방법

Q: 메인 메뉴에 Mods 버튼이 나타나지 않아요

Steamodded가 로드되지 않은 거예요. Lovely가 게임 폴더에 설치되어 있는지, Steamodded 폴더가 Mods 폴더 바로 안에 있는지 확인하세요.

대부분의 발라트로 모드는 두 가지 도구로 불러와요. Lovely는 게임이 시작될 때마다 게임을 패치하는 인젝터예요. Steamodded(smods라고도 해요)는 Lovely 위에서 돌아가는 모드 로더로, 모드에 공용 툴킷과 게임 내 Mods 메뉴를 제공해요. 둘 다 필요한 모드도, Lovely만 필요한 모드도 있어요.

이 가이드에서는 두 도구를 설치하고, 시스템별 Mods 폴더 위치를 알려 드리고, 가장 자주 겪는 문제를 다뤄요.

aong.dev 모드별 필요 조건
모드	Lovely	Steamodded
Edition Decks	예	예, 26.829.0 이상
Better Background	예, 0.9 이상	선택
Chromite 개발 중	예, 0.9 이상	선택

1 Lovely 설치하기

Lovely의 GitHub 릴리스에서 최신 버전을 내려받으세요. 게임 폴더를 열려면 Steam에서 발라트로를 우클릭하고 관리 › 로컬 파일 보기를 고르세요.

Windows: lovely-x86_64-pc-windows-msvc.zip을 내려받고 winmm.dll을 게임 폴더에 복사하세요. 예전 버전의 Lovely를 썼다면 게임 폴더에서 version.dll을 지우세요. 평소처럼 Steam에서 발라트로를 실행하면 돼요.
Steam Deck & Linux (Proton): Windows와 같은 winmm.dll을 쓰고, Steam에서 발라트로 실행 옵션을 WINEDLLOVERRIDES="winmm=n,b" %command%로 설정하세요.
macOS: 내 Mac에 맞는 빌드(M 시리즈는 aarch64, Intel은 x86_64)를 내려받아 liblovely.dylib와 run_lovely_macos.sh를 게임 폴더에 복사하세요. 게임은 Steam이 아니라 이 스크립트로 실행해야 해요.

시스템별 최신 정보는 Lovely의 설치 안내를 확인하세요.

2 Steamodded 설치하기

원하는 모드가 모두 Steamodded를 선택 사항으로 표시한다면 이 단계는 건너뛰세요. 그렇지 않다면 GitHub 릴리스에서 최신 Steamodded를 내려받아 압축을 풀고, 그 폴더를 Mods 폴더로 옮기세요(다음 단계). 공식 안내는 Steamodded 문서에 있어요.

제대로 동작하면 메인 메뉴에 설치된 모드를 모두 보여 주는 Mods 버튼이 생겨요.

3 Mods 폴더 찾기

Mods 폴더는 게임 폴더가 아니라 발라트로 세이브 폴더 안에 있어요. 없다면 Mods라는 이름의 폴더를 만들거나, Lovely를 설치한 상태로 게임을 한 번 실행하면 자동으로 만들어져요.

Windows: %AppData%\Balatro\Mods (파일 탐색기 주소창에 붙여 넣으세요)
macOS: ~/Library/Application Support/Balatro/Mods (Finder에서 Shift-Command-.를 누르면 숨김 폴더가 보여요)
Steam Deck & Linux: ~/.steam/steam/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods
Flatpak Steam: ~/.var/app/com.valvesoftware.Steam/.steam/steam/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods

4 모드 추가하기

모드 zip 파일을 내려받으세요. aong.dev에서는 각 모드 페이지의 초록색 다운로드 버튼이에요.
압축을 푸세요. EditionDecks-main 같은 폴더 하나가 나와요.
그 폴더를 Mods 폴더로 옮기세요. 모드마다 자기 폴더가 따로 있어야 해요.
발라트로를 실행하세요. Steamodded를 쓰는 모드는 메인 메뉴의 Mods에 나타나요.

GitHub에서 내려받은 폴더 이름 끝의 -main은 그대로 두거나 지워도 괜찮아요.

모드 호환성

aong.dev 모드는 하나의 Mods 폴더를 함께 쓰도록 만들어졌어요. 저희가 확인한 조합과 각각의 동작 방식이에요.

Chromite + Handy: Chromite의 속도, 애니메이션 스킵, 키 설정은 Handy에 양보해요. Force 스위치를 켜면 그래도 Chromite 쪽을 써요.
Chromite + Saturn: 속도와 애니메이션 스킵도 같은 방식으로 양보해요.
Chromite + JokerDisplay: 조커 오버레이는 계속 JokerDisplay가 맡아요. Chromite는 이를 보이거나 숨기는 키를 더해요.
Chromite + Multiplayer: 진행 속도를 바꾸는 Chromite 기능은 로비 안에서 꺼져요.
Better Background + Chromite: Chromite에 같은 배경 기능이 들어 있어서 Better Background는 스스로 꺼져요.

문제 해결

메인 메뉴에 Mods 버튼이 나타나지 않아요

Steamodded가 로드되지 않은 거예요. Lovely가 게임 폴더에 설치되어 있는지(Windows에서는 설치되어 있으면 게임 옆에 콘솔 창이 열려요), Steamodded 폴더가 Mods 폴더 바로 안에 있는지 확인하세요.

모드를 폴더에 넣었는데 게임이 인식하지 않아요

Mods/BetterBackground/BetterBackground/처럼 폴더 안에 폴더가 또 있는지 확인하세요. 압축을 풀 때 한 단계가 더 생기기도 해요. 안쪽 폴더를 위로 옮겨서 모드 파일이 Mods 바로 한 단계 아래에 오게 하세요.

모드를 추가하니 게임이 튕겨요

크래시 화면에서 모드 이름을 확인하고, 그 모드 페이지에서 필요한 Lovely나 Steamodded 버전을 확인하세요. 두 모드가 충돌한다면 하나씩 Mods 폴더 밖으로 옮기고 다시 시작해서 원인을 찾아보세요.

Lovely와 Steamodded는 뭐가 다른가요?

Lovely는 게임이 로드될 때 게임 코드를 바꿔요. Steamodded는 Lovely가 불러오는 모드로, 다른 모드를 불러오고 공용 도구와 설정 메뉴를 제공해요. Steamodded에는 항상 Lovely가 필요해요.

모드는 어떻게 제거하나요?

그 모드의 폴더를 Mods 폴더 밖으로 옮기세요. 모든 모드를 끄려면 게임 폴더에서 Lovely 파일을 지우세요.