스타듀밸리 모드 오류는 대부분 SMAPI(스마피)가 설치되지 않았거나 Steam 실행 옵션이 연결되지 않아 발생해요. SMAPI를 올바르게 설치하고 Steam 실행 옵션에 경로를 연결하면 대부분 해결돼요.
스타듀밸리 모드 오류의 주요 원인
스타듀밸리 모드가 작동하지 않거나 오류가 발생하는 원인은 크게 세 가지예요.
첫 번째는 SMAPI가 설치되지 않은 경우예요. 스타듀밸리 모드는 거의 모두 SMAPI를 기반으로 실행돼요. SMAPI 없이 모드 파일만 게임 폴더에 넣어도 게임이 모드를 아예 인식하지 못해요. 모드를 사용하려면 SMAPI 설치가 가장 먼저예요.
두 번째는 Steam 실행 옵션이 연결되지 않은 경우예요. SMAPI를 설치했더라도 Steam에서 게임을 실행할 때 SMAPI를 거쳐서 실행되도록 실행 옵션을 설정해야 해요. 이 설정이 없으면 게임은 모드 없이 바닐라 상태로만 실행돼요.
세 번째는 모드 파일을 잘못된 경로에 넣은 경우예요. 모드 파일은 반드시 SMAPI가 지정한 Mods 폴더 안에 넣어야 인식돼요. 파일 하나가 아닌 모드 폴더째로 넣어야 정상 작동해요.
SMAPI 다운로드 방법
SMAPI는 공식 사이트(smapi.io)에서 다운로드할 수 있어요. 네이버에 스마피 다운로드라고 검색하면 공식 사이트가 바로 나와요.
공식 사이트에서 다운로드 버튼을 클릭하면 세 가지 선택지가 나와요. 그중 CurseForge를 통한 다운로드를 추천해요. 스타듀밸리 모드도 CurseForge에서 다운로드할 수 있기 때문에, 미리 가입해두면 이후 모드 관리가 편해져요.
- CurseForge에서 회원가입 또는 로그인
- FILES(파일) 탭 클릭
- 메인 파일에서 Manual download 클릭 (오른쪽 버튼)
- Slow download 클릭 후 5초 대기하면 다운로드 시작
- 다운로드된 압축 파일을 더블클릭해서 압축 해제
맥북 설치 시 보안 오류 해결 방법
맥북에서 SMAPI를 설치할 때는 macOS 보안 정책 때문에 오류가 발생하는 경우가 많아요. 압축 해제 후 install on macOS 파일을 실행하면 “개발자를 확인할 수 없어서 열 수 없습니다”라는 오류 메시지가 뜨는 게 일반적이에요.
이 오류는 아래 방법으로 쉽게 해결할 수 있어요.
- 오류창에서 확인을 눌러서 닫기
- 상단 메뉴에서 시스템 설정 열기
- 개인정보 보호 및 보안 클릭
- 맨 아래로 스크롤하면 그래도 열기 버튼 등장
- 그래도 열기 클릭
이후 다시 install on macOS를 실행하면 터미널 화면이 열리면서 설치가 시작돼요. 터미널에서는 세 가지를 묻는데, 아래처럼 선택하면 돼요.
- 화면 색상 선택 → 1번 입력 후 엔터 (어두운 텍스트, 밝은 배경)
- 경로 설정 → 1번 입력 후 엔터 (기본 경로)
- 설치/제거 선택 → 1번 입력 후 엔터 (설치)
설치가 완료되면 터미널에 경로가 표시돼요. 이 경로 문자열을 그대로 복사해두세요. Steam 설정에 바로 써야 해요.
Steam 실행 옵션 연결하기
SMAPI 설치 후 가장 중요한 단계예요. Steam에서 게임을 실행할 때 SMAPI를 통해 실행되도록 설정해야 모드가 인식돼요.
- Steam을 열고 라이브러리에서 스타듀밸리 찾기
- 게임 이름 우클릭 → 속성 클릭
- 일반 탭에서 실행 옵션 입력란 찾기
- 아까 터미널에서 복사한 경로를 그대로 붙여넣기
- 창을 닫고 스타듀밸리 실행
게임을 실행했을 때 게임 아이콘이 닭 모양으로 바뀌고 터미널 화면이 함께 열리면 SMAPI가 정상 작동하는 거예요. 이 상태에서 게임 화면도 함께 나타나면 설정이 완료된 거예요. 앞으로 스타듀밸리를 실행할 때마다 이 터미널 화면이 함께 뜨는 게 정상이에요.
모드 파일 경로와 오류 확인 방법
SMAPI 설치와 Steam 연결이 끝났다면 모드 파일을 올바른 위치에 넣어야 해요.
맥북 모드 파일 경로:
Steam → 스타듀밸리 우클릭 → 로컬 파일 열기 → contents → macOS → Mods
모드는 각각 폴더 형태로 Mods 폴더 안에 넣어요. 모드 파일 하나만 넣는 게 아니라, 해당 모드의 폴더 전체를 Mods 폴더 안에 복사해야 정상 인식돼요.
모드 오류 확인 방법:
SMAPI를 통해 실행하면 터미널 화면에서 오류를 바로 확인할 수 있어요. 빨간 줄로 오류 메시지가 출력되고, 어떤 모드에서 오류가 났는지 모드 이름과 함께 표시돼요. 오류가 발생한 모드를 Mods 폴더에서 제거하거나, 해당 모드의 최신 버전으로 업데이트하면 대부분 해결돼요.
자주 묻는 질문
SMAPI 없이 모드 파일만 넣으면 게임이 모드를 전혀 인식하지 못해요. 스타듀밸리 모드는 반드시 SMAPI를 통해 로드되기 때문에, 먼저 SMAPI를 설치하고 Steam 실행 옵션을 연결해야 모드가 정상 작동해요.
macOS 보안 정책 때문에 발생하는 오류예요. 시스템 설정에서 개인정보 보호 및 보안으로 이동한 뒤 맨 아래로 스크롤하면 그래도 열기 버튼이 나타나요. 이 버튼을 클릭하면 정상적으로 설치를 진행할 수 있어요.
맥북에서는 SMAPI를 통해 게임을 실행하면 터미널 화면이 함께 뜨는 게 정상이에요. 게임 아이콘이 닭 모양으로 바뀌고 터미널이 실행되면 SMAPI가 올바르게 작동하고 있다는 신호예요.
SMAPI를 통해 실행하면 터미널 화면에서 오류 내용을 바로 확인할 수 있어요. 빨간 줄로 오류 메시지와 함께 어떤 모드에서 문제가 났는지 표시돼요. 해당 모드를 제거하거나 최신 버전으로 업데이트하면 대부분 해결돼요.