문제 해결¶
크래시, 성능 저하, 기계가 멈추는 상황별 원인과 조치를 정리한다. 크래시 관련 수정 이력은 업데이트 참고.
로그 파일 위치¶
크래시 로그는 v0.5.3부터 main.log에 기록된다. 버그 신고 시 이 파일을 첨부한다.
Windows C:\Users\<사용자>\AppData\Roaming\sandustry\logs\main.log
macOS /Users/<사용자>/Library/Logs/sandustry/main.log
Linux /home/<사용자>/.config/sandustry/logs/main.log
크래시¶
| 원인 | 증상 | 조치 |
|---|---|---|
| Steam 오버레이 | Shift+Tab, 스크린샷, 친구 목록을 열 때 크래시 |
Steam 실행 옵션에 --sandustry-no-overlay-gpu-flags 추가. 오버레이는 꺼지지만 도전 과제는 정상 작동 |
| 튜토리얼 영상 디코더 고갈 | 튜토리얼 영상을 여러 번 보면 GPU 크래시, OBS 녹화 중 문제 | v0.5.3에서 디코더 해제, v0.5.5에서 영상을 애니메이션 이미지로 교체. 구버전이면 영상은 세션당 한 번만 보거나 건너뛴다 |
| 모드 | 부팅 직후 크래시 | 모든 모드를 제거하고 Steam 파일 무결성 검사 후 다시 시작 |
| 구버전 | 원인 불명 크래시 | v0.5.5+ 이상으로 업데이트. 사용하지 않는 창작마당·Fluxloader 모드는 비활성화 |
실행 옵션은 Steam 라이브러리 → 게임 우클릭 → 속성 → 일반 → 실행 옵션에 입력한다.
Steam 파일 무결성 검사: 라이브러리 → 게임 우클릭 → 속성 → 설치된 파일 → 게임 파일 무결성 확인.
성능 저하¶
| 원인 | 조치 |
|---|---|
| 증기Steam 비 구름이 계속 생성됨 | 증기를 상시 배출하지 말고 펄스 방식으로 배출한다 |
| 매우 큰 컨베이어 벨트Conveyor Belt 네트워크 | 구간을 나누고 불필요한 벨트를 줄인다. 공장 최적화 참고 |
| 조명Light 건물 과다 | 필요한 곳만 남긴다 |
| 최소 사양에서 대형 공장 | 권장 사양(RAM 8 GB, GTX 960 / RX 570급) 이상 권장 |
v0.5.5+의 성능 목표는 활성 픽셀 10만 개에서 60 FPS, RAM 약 1 GB다.
게임플레이 문제¶
| 증상 | 원인 | 조치 |
|---|---|---|
| 셰이커Shaker가 멈춤 | 위에 쌓인 잔여물Residue, 마른 모래Sand 투입, 이물질 유입 | 위쪽 잔여물을 치우고, 입력이 젖은 모래Wet Sand인지 확인한다. 안에 낀 이물질은 영구히 갇힐 수 있다 |
| 셰이커 입력이 비어 있음 | 벨트 굶주림, 믹서Mixer의 물Water 문제 | 상류 벨트와 물 공급을 확인한다 |
| 필터Filter가 분류하지 않음 | 재료 선택 오류, Allow/Block 모드 반전, 흐름 방향, 목적지 포화 | 재료와 모드를 확인한다. v0.5.4부터 오버레이 라벨 클릭으로 모드 전환 가능. 넘침 경로가 없는 필터는 반드시 막힌다 |
| 금Gold이 집계되지 않음 | 수집기Collector 밖에 떨어짐, 수집기가 가득 참, 토대Foundation 없이 떠 있음 | 셰이커 아래 공간과 수집기 위치를 확인한다. 금은 수집기 타일 안에 있을 때만 연구Research 자금으로 인정된다 |
| 물이 사라짐 | 젖은 모래 생산에 소비됨, 증기로 증발 후 미회수 | 공급을 분리하고 증기 배출구를 모래 벨트에서 멀리 둔다. 물 관리 참고 |
| 용암Lava 운송 실패 | 펌프Pump·파이프Pipe·액체 배출구Liquid Vent·저장소 중 한 곳의 문제 | 각각 따로 점검한다. 용암과 물 경로는 절대 섞지 않는다. 접촉하면 증기 폭발로 둘 다 사라진다 |
| 동적 프레스Kinetic Press가 반응 없음 | 탄 잔여물Burnt Residue이 아닌 생 잔여물·모래·물 투입, 낙하 높이 부족 | 입력을 탄 잔여물로 한정하고 25블록 이상 낙하를 확보한다. 잔여물 처리 참고 |
| 발사기Launcher 앞에서 벨트 정체 | 발사기 처리량 부족 | 발사기 단계를 추가하거나 받는 통을 넓힌다 |
| 젖은 모래 잔여물이 쌓임 | 처리 속도 초과 | 진공 수집기Vacuum로 치운다 |
| 호수가 얼어 금 생산 중단 | 빙하Ice 생성 | 화염방사기Flamethrower로 녹이는 통로를 만든다 |
| 건물이 배치되지 않음 | 타일에 재료가 남아 있음 | 컨베이어·건물은 어떤 재료라도 있는 타일에는 놓을 수 없다. 먼저 치운다 |
| 플레이어가 끼임 | 1픽셀 잔해 | 잔해를 제거하거나 공중 부양Hover로 빠져나온다 |
기계 문제는 입력 → 기계 상태 → 출력 경로 → 저장 용량 순서로 점검하면 대부분 원인이 잡힌다. 기계별 상세는 기계·건물 참고.
진행 막힘¶
- 티어 5 소프트락: 이상 현상 조사 후 진행이 막히는 문제는 v0.5.4부터 세이브를 불러올 때 자동 복구된다.
- 티어 5 진입 조건: 목표 패널에 표시되는 플로리놀Florinol 생산량 달성과 이상 현상 조사(구체Orb 유물Artifact 회수)다. v0.5.3부터 목표 UI가 막힌 이유를 표시한다. 연구 트리 참고.
- 퍼즐 초기화: 퍼즐 리셋 버튼은 v0.5.4에서 복원되었고 삭제할 수 없다. 퍼즐 문을 닫고 다시 열면 빨간 블록이 복원된다.
플랫폼별¶
- macOS: 우클릭 진공 수집기 분사가 멈추지 않는 버그는 v0.5.5에서 우회 처리되었다.
- Steam Deck: 네이티브 Linux 빌드는 있으나 호환성은 검증되지 않았다.
- Microsoft Store / Game Pass: 로컬 모드와 네이티브 패치가 동작하지 않는다.
모드 관련¶
| 증상 | 원인 | 조치 |
|---|---|---|
| 부팅 시 크래시 | 모드 충돌 또는 패치 후 호환 깨짐 | 모드를 전부 빼고 파일 무결성 검사. 이후 하나씩 다시 넣는다 |
| 모드 메뉴가 비어 있음 | 설치 경로 오류 | 게임 폴더의 Mods 폴더 위치를 확인한다 |
| 커스텀 지도가 뜨지 않음 | Custom Map Loader 버전 불일치 (오류 없이 조용히 실패) | 로더를 현재 게임 버전에 맞게 갱신한다 |
모드 설치와 안전 수칙은 모드·멀티플레이 참고.
출처¶
- sandustry.wiki — https://sandustry.wiki/guides/crashes-performance/, https://sandustry.wiki/updates/hotfix-053/, https://sandustry.wiki/updates/update-054/, https://sandustry.wiki/updates/update-055/, https://sandustry.wiki/guides/starter-factory/, https://sandustry.wiki/guides/factory-optimization/, https://sandustry.wiki/mods/custom-maps/
- sandustry.org — https://sandustry.org/guide/sandustry-troubleshooting/, https://sandustry.org/automation/sandustry-conveyor-setup/
- Steam 상점 — https://store.steampowered.com/app/2764460/Sandustry/
용어 표기 안내
이 위키의 한글 용어는 게임 데이터(Steam 빌드 로케일)에서 추출한 인게임 표기를 따릅니다. 게임 안에 대응 문자열이 없는 팬 위키 고유 명칭(생물군계 이름, 일부 연구 노드 등)은 용어집에 ✅ 수동 확정으로 표시했습니다. 영문 원어는 용어 옆에 작은 글씨로 함께 적습니다.