모드·멀티플레이¶
샌더스트리Sandustry의 모드 구조, 모드 로더, 커뮤니티 협동 모드, 설계도 공유처를 정리한다. 공식 멀티플레이는 없다.
공식 입장¶
- 게임은 싱글플레이 전용이다. 스팀 상점도 "싱글플레이어"만 표기한다.
- 온라인 멀티플레이와 콘솔 이식은 앞서 해보기 기간 중 계획에 없다. Xbox Cloud Gaming도 지원하지 않는다.
- 협동 플레이는 전부 커뮤니티 모드로만 가능하며, 개발사 Lantto Games와 퍼블리셔 Hooded Horse가 보증하지 않는다.
- Steam 창작마당은 v0.5.5+부터 정식 지원한다.
게임 구조와 모드 API (sandkit)¶
게임은 Electron(Chromium + V8) 위에서 돌아간다. UI는 React, 모래 시뮬레이션은 Web Worker에서 실행된다. 따라서 모드는 JavaScript다.
| 항목 | 내용 |
|---|---|
| 모드 형태 | 폴더 하나. modinfo.json(매니페스트) + entry.js(메인 스레드 코드) |
| 선택 파일 | patches.json(게임 JS 문자열 패치), preview.png(창작마당 등록 시 필수) |
| 버전 필드 | manifestVersion = apiVersion = 1 |
| 전역 객체 | sandkit.api, sandkit.enums, sandkit.state, sandkit.engine, sandkit.react |
| 규칙 | 월드를 바꾸는 호출은 …WhenIdle 접미사를 쓴다. 초기화는 "game:ready" 이벤트 이후에 한다 |
| 진입 스크립트 | 비동기 함수 본문으로 컴파일된다 |
로컬 모드 경로:
Linux ~/.config/sandustry/mods/<모드이름>/
Steam 창작마당 구독 .../steamapps/workshop/content/2764460/<아이템ID>/
patches.json은 게임 번들 JS를 문자열 치환으로 고치는 방식이다. 번들은 패치마다 바뀌므로 이 방식의 모드는 업데이트 후 깨질 가능성이 높다.
네이티브 패치·로컬 모드는 Steam 전용
Microsoft Store(PC Game Pass) 빌드는 로컬 모드와 네이티브 패치를 실행하지 않는다.
출처 불일치: Lua / C# 스크립트 로더
sandustry.wiki는 v0.5.5+(2026-08-29)에 공식 "Sandustry Modding API"가 Lua와 C# 스크립트 로더를 제공한다고 적는다. 경로는 %AppData%\sandustry\scripts\lua\, %AppData%\sandustry\scripts\csharp\, 로그는 %AppData%\sandustry\logs\scripting.log, 설정 → 모드 → Script Loaders에서 켠다는 설명이다. 그러나 개발 문서 사이트 sandustry.dev는 JavaScript 기반 sandkit API만 문서화하며, .dll 모드나 Lua/C#에 대한 언급이 없다. 엔진이 Electron인 점을 고려하면 sandustry.dev 쪽이 신뢰도가 높다. Lua/C# 관련 내용은 미검증으로 취급한다.
모드 로더¶
Fluxloader¶
커뮤니티 표준 모드 로더이자 로드 순서 관리자다. 예전 이름은 "modloader"다. 로드 순서는 fluxloader.json에서 정한다.
설치 순서:
- 게임을 완전히 종료한다.
- 공식 Discord 고정 글 또는 GitHub에서 Fluxloader를 내려받는다.
- 게임 설치 폴더에 압축을 푼다.
Mods폴더가 없으면 만든다.- 모드 파일을
Mods폴더에 넣는다. - Steam으로 게임을 실행하고, 모드는 한 번에 하나씩만 켜서 확인한다.
mod loader.exe (데모 시절 도구)¶
데모 시기에 Discord를 통해 배포된 GitHub 도구다. 게임 폴더(...\steamapps\common\Sandustry demo 또는 \Sandustry)에 두고 한 번 실행하면 mods/ 폴더와 설정이 생긴다. 지도는 mods\Maps\에 넣고, 이 exe로 게임을 켜서 드롭다운에서 지도를 고른다. sandustry.org는 이 도구가 v0.5.6과 실험 "mods" 브랜치를 대상으로 한다고 적는다.
출처 불일치: 로더 이름
sandustry.wiki는 Fluxloader를, sandustry.org는 mod loader.exe를 주로 다룬다. 데모 시절 도구와 현재 로더가 섞여 설명되므로, 현재는 Fluxloader 기준으로 보는 것이 안전하다.
Custom Map Loader (커스텀 지도)¶
- 제작자 Electric131. Fluxloader가 필요하다.
.map파일을Maps폴더에 넣으면 게임 안 지도 선택기에 나타난다. sandustry.org는 경로를mods/Maps/로 적는다.- 패치가 나올 때마다 로더를 갱신해야 한다. 버전이 맞지 않으면 지도가 조용히 로드되지 않는다.
- 싱글플레이 전용이며, 커스텀 지도는 새 세이브로 시작해야 한다.
- 모드 지도도 기본 조작은 그대로다. 조작법은 조작법 참고.
SandTogether (협동 모드)¶
"Sandustry Together"로도 표기되는 첫 커뮤니티 협동 모드다. Steam 창작마당에 있고 Fluxloader가 필요하다.
| 항목 | 내용 |
|---|---|
| 공유 항목 | 금Gold 지갑, 연구Research 트리, 잔여물Residue 저장소, 플럭스 방출기Flux Emanator, 물Water |
| 접속 | 호스트/참가. IP 직접 입력 또는 모드 자체 매치메이커. v0.5.0부터 공개 방 로비, 플레이어 목록(이름·색·핑), 백그라운드 참가 |
| 요구 사항 | 모든 참가자가 v0.5.5+ 이상, 같은 모드 버전. corelib 3.1.0+, Steam "mods" 실험 브랜치. RAM 8 GB 권장 |
| 단축키 | F10 방 코드 표시, Shift+F11 커스텀 조정 서버 입력, Shift+F12 커스텀 서버로 참가 |
출처 불일치: 인원
sandustry.wiki는 "2인 이상(빌드마다 다름)", sandustry.org는 "최대 4인, 인터넷 또는 LAN"으로 적는다.
알려진 문제
총알 동기화 불일치, 경계 청크 동기화 오류, 크래시, 세이브 손상 위험이 보고되어 있다. 협동 세이브는 반드시 별도로 두고 백업한다.
New Game+¶
세이브 시작 시점부터 모든 콘텐츠를 해제해 주는 모드다. (sandustry.org)
설계도 공유¶
게임 안에 공식 설계도Blueprint 시스템이 있는지는 출처가 갈린다.
출처 불일치: 공식 설계도 기능
sandustry.wiki의 공장 설계도 문서와 sandustry.org는 EA에 공식 설계도 시스템이 없고 커뮤니티 레이아웃만 있다고 적는다. 반면 sandustry.wiki의 v0.5.5+ 업데이트 문서는 설계도 패널(B 키), .sandprint 내보내기, 마키 선택 저장 동기화 수정을 언급한다. 최신 빌드에서 직접 확인이 필요하다.
SandPrints¶
- 커뮤니티 웹 설계도 데이터베이스(sandprints.quest). Steam 창작마당과 별개다.
- 파일 형식
.sandprint. 게임에서B(기본 키)로 설계도 패널을 열고 Export로 내보낸다. - 분류: 재료, 공장 티어(Starter, Tier 2~5), 크기(Small 1,000타일 미만 / Medium 1,000~10,000 / Large 10,000 이상). 품질 표시는 Verified, Community Tested, Experimental, Outdated.
설계도 저장 경로:
Windows %AppData%\sandustry\blueprints\
macOS ~/Library/Application Support/sandustry/blueprints/
Linux ~/.config/sandustry/blueprints/
SandustryVault¶
커뮤니티 설계도 공유 사이트다.
Steam 창작마당 (v0.5.5+)¶
버전 태그, 의존성 추적, 검색 필터(태그·생물군계Biome 유형·공장 티어)를 지원한다.
모드 분류¶
| sandustry.wiki | sandustry.org |
|---|---|
| 편의성(QoL) | 편의성(QoL) |
| 게임플레이 확장 | 콘텐츠 해제 |
| 지도 팩 | 커스텀 지도 |
| 실험적 스크립트 | 토탈 컨버전, 샌드박스 도구 |
안전 수칙¶
- 모드를 넣기 전에 세이브를 백업한다.
- 모드는 한 번에 하나씩 넣고 게임을 켜서 확인한다.
- 모드 세이브는 바닐라 세이브와 분리한다.
- 패치 뒤에는 모드가 갱신될 때까지 깨질 수 있다고 전제한다.
- 서드파티 미러 사이트는 쓰지 않는다. 다운로드 우선순위는 Discord 모드 포럼 > GitHub > Steam 창작마당이다.
- 모드 관련 크래시는 문제 해결, 버전별 변경은 업데이트 참고.
출처¶
- sandustry.dev — https://sandustry.dev/wiki/getting-started
- sandustry.wiki — https://sandustry.wiki/mods/, https://sandustry.wiki/mods/fluxloader-install/, https://sandustry.wiki/mods/custom-maps/, https://sandustry.wiki/mods/sandtogether-coop/, https://sandustry.wiki/guides/modding-api-guide/, https://sandustry.wiki/guides/sandprints/, https://sandustry.wiki/guides/factory-blueprints/
- sandustry.org — https://sandustry.org/mods/sandustry-mods/, https://sandustry.org/mods/sandustry-modding-guide/, https://sandustry.org/guide/sandustry-multiplayer-coop/, https://sandustry.org/automation/sandustry-conveyor-setup/
- Steam 상점 — https://store.steampowered.com/app/2764460/Sandustry/
용어 표기 안내
이 위키의 한글 용어는 게임 데이터(Steam 빌드 로케일)에서 추출한 인게임 표기를 따릅니다. 게임 안에 대응 문자열이 없는 팬 위키 고유 명칭(생물군계 이름, 일부 연구 노드 등)은 용어집에 ✅ 수동 확정으로 표시했습니다. 영문 원어는 용어 옆에 작은 글씨로 함께 적습니다.