[스타듀벨리] 모드 설치를 위한 SMAPI 설치

스타듀벨리 모드 설치 가이드 

 

🎮 스타듀 밸리 모드 설치 가이드: SMAPI 완벽 정리

스타듀 밸리에서 대확장 모드(SVE), 릿지사이드, 편의성 모드(UI Info Suite 등)를 적용하려면 모드 구동기인 SMAPI(Stardew Modding API) 설치가 필수입니다. 공식 GitHub를 통해 안전하고 쉽게 설치하는 방법을 단계별로 안내해 드립니다.

📦 Step 1. GitHub에서 SMAPI 다운로드하기

1. 공식 SMAPI GitHub 저장소 릴리즈 페이지에 접속합니다.
👉 SMAPI GitHub Releases 바로가기

2. 최신 버전(Latest)의 Assets 항목에서 SMAPI-x.x.x-installer.zip 파일을 다운로드합니다.

3. 다운로드한 zip 파일의 압축을 풀어줍니다.

 

⚙️ Step 2. SMAPI 인스톨러 실행 & 설치

1. 압축을 푼 폴더로 들어가 본인의 OS에 맞는 설치 파일을 실행합니다.

• Windows: install on Windows.bat 더블 클릭
• Mac: install on macOS.command 실행
• Linux: install on Linux.sh 실행

2. 검은색 콘솔 창(커맨드 창)이 뜨면 설치 옵션을 선택합니다.

What do you want to do?
[1] Install SMAPI
[2] Uninstall SMAPI

> 숫자 1 을 입력하고 Enter를 누릅니다.

3. 초록색 글씨로 "SMAPI is installed!" 메시지가 나오면 설치 완료입니다.

 

🔗 Step 3. 스팀(Steam) 연동 및 시작 옵션 설정

⚠️ 중요: 스팀 도전과제 및 플레이 타임 연동
스팀에서 바로 '플레이' 버튼을 눌러 모드를 실행하고 스팀 도전과제/오버레이를 정상 작동시키려면 시작 옵션 설정이 필요합니다.

1. 설치 콘솔 창 마지막에 안내되는 경로 텍스트 전체(따옴표와 %command% 포함)를 복사합니다.

"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%

*(설치 경로에 따라 드라이브 명이나 폴더 경로가 다를 수 있습니다.)*

2. 스팀(Steam) 라이브러리에서 [Stardew Valley] 우클릭 ➔ [속성(Properties)] 클릭
3. [일반] 탭 하단의 [실행 옵션(Launch Options)] 입력창에 복사한 문구를 그대로 붙여넣기합니다.

📁 Step 4. 원하는 모드 넣는 방법

1. 스타듀 밸리가 설치된 폴더로 이동합니다. (SMAPI 설치 후 자동으로 Mods 폴더가 생성됩니다.)

기본 경로: C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods

2. 넥서스 모드(Nexus Mods) 등에서 다운로드한 모드 압축 파일의 압축을 풀어 Mods 폴더 안에 폴더째로 넣어주면 적용 끝입니다!

💡 SMAPI 사용 시 주의사항

• 게임 실행 시 검은색 SMAPI 콘솔 창이 먼저 뜨고 게임이 켜집니다. 콘솔 창을 끄면 게임도 함께 종료되므로 닫지 마세요.
• 콘솔 창에 빨간색 텍스트가 뜬다면 모드 간 충돌이나 버전 불일치 오류이므로 해당 모드를 확인/업데이트해야 합니다.
• 스타듀 밸리 본편 게임이 대규모 업데이트를 진행하면 SMAPI도 최신 버전으로 재설치(덮어쓰기)해야 작동합니다.