kone
wayward-
wayward-

Wayward + WML 입문 총정리 (설치 -> 모드 -> 그림 -> 꿀팁)

공지
90,176 views · 79 points

Wayward 그래서 이게 뭔데!

(정보,안내,다운로드,WML)

서브가 따로 파진 뒤로 글이 또 ㅈㄴ 쌓여서 뉴비들이 길을 잃는거같음.

"모드가 200개가 넘는다는데 대체 뭐부터 받으라는거임?" 하는 사람들 많아보여서 다시 정리함.

10월 초에 썼던 입문글은 그때 기준(통짜 html + 설치기 cmd + 모드매니저 3파전)이라 지금이랑 많이 다름.

지금은 WML이 기본 모드 로더임 그래서 처음부터 새로 씀.

※ 규정 먼저 한번 읽어봐 (실사, 토들러 금지 등 제발 숙지해줘어) : aHR0cHM6Ly9rb25lLmdnL3Mvd2F5d2FyZC13bWwvYnBPdC1zN2kwQ1Q4djNreDAzbFFlYg==

※ 다운 링크는 원글 작성자들이 관리하니까 모드는 원글 가서 받는게 맞음

!! 씹스압 주의 !! 다 귀찮으면 맨 아래 【요약】만 보셈


【0. 이게 뭔 겜임?】

  • 빚 1000골드 지고 그녀랑 중세 선술집 운영하는 텍스트 기반 NTR/NTS 샌드박스임

  • 제작자는 Sintention, 무료고 아직 개발중인데 업데이트가 꽤 자주일어남.

  • 그림은 AI 일러가 상황마다 바뀌고 나머지는 전부 텍스트임

  • 설치 같은거 없음. html 파일 하나라 더블클릭하면 브라우저에서 돌아감

  • 뭘 허용하고 뭘 막을지 플레이어가 정하는 구조라 순애도 가능함 (대신 돈벌기 빡셈)

최신 테스트버전(10-18-pre2)부터 꽤 바뀜

  • 시작할때 관계를 고름. 아내 / 연인 / 의붓여동생 / 친구 / 고용인 중 하나고 관계마다 말투랑 반응이 다름

  • 캐릭터 만들기가 생김. 이름, 나이, 출신, 외모, 성향을 직접 정하고 그림도 직접 뽑아서 zip으로 공유 가능

  • 뒷방이 개인실로 바뀌고 손님 여럿이 한 방 쓰는 "일행"이 생김

  • 사냥이 외출 방식으로 바뀜 (작은 사냥감 안전 / 큰 사냥감 부상위험)

  • 능력치에 "조심성" 추가

  • 문장 3500개 추가


【1. 지금 버전 상황 (이것부터 보셈)】

지금 두 갈래로 갈라져있어서 이거 모르면 ㅈㄴ 헷갈림.

게임

WML

상태

정식

2026-10-04

0.9.1

모드 다 돌아감. 뉴비는 무조건 이거

테스트

2026-10-18-pre2

0.9.2

신기능 많은데 다른 제작자 모드 대부분 아직 안됨

  • pre2는 제작자가 아직 테스트중인 버전이라 변수/함수를 계속 비틀어댐

  • 그래서 모더들이 지금 맞춰놔도 다음 배포때 또 터짐. 정식 나올때까지는 존버가 답임

  • 그림이랑 모드 다 되는 환경을 원하면 10-04 + WML 0.9.1 로 시작하셈

  • 신버전 구경만 하고싶으면 임시판 따로 있음 (아래 2번 표 참고)


【2. WML이 뭔데?】

모드 로더임. 게임 html은 그대로 두고 옆에 wml 폴더가 붙어서 모드를 얹어주는 구조.

예전엔 이랬음

  • 통짜 html형 : 모드 들어간 html 통째로 받기 -> 다른 모드랑 못 섞음

  • 설치기형 : cmd에 html 드래그 -> 모드 늘어나면 관리하기 복잡함.

  • 모드매니저 : 배포자마다 달라서 서로 호환 안됨

지금은 그냥 WML 하나 쓰면 됨.

  • 모드 켜고 끄기, 순서, 설정 전부 게임 안에서 함. cmd 돌릴 일 없음(가끔있음ㅋㅋ)

  • 모드는 폴더 하나 = 모드 하나. 지우고싶으면 폴더 지우면 끝

  • 게임 업뎃이 와도 로더가 함수 이름표를 갈아끼워주는 구조라 모드가 대부분 그대로 삶

  • 프리셋 기능 있어서 "조합" 통째로 저장하고 남한테 공유 가능


【3. 파일이 여러갠데 뭘 받음?】

이게 제일 많이 묻는거같아서 표로 정리함.

파일

뭐임

누가 받음

wayward-wml-ko-V0.9.x.zip

한글판 게임 + 로더 (모드 비어있음)

처음 받는 사람

wayward-wml-en-V0.9.x.zip

영문판 게임 + 기본팩

영어로 할 사람

wml-0.9.x.zip

로더만 (wml 폴더)

게임 있는데 로더만 최신으로

wml-mods-basic-x.x.zip

기본팩 모드 43개

한글판이랑 같이 받기

wml-mods-full-x.x.zip

통팩 모드 217개

다 때려넣고 싶은 사람

wml-mcp-x.x.zip

MCP 서버

모드 만들 사람만

wml-player-x.x.apk

안드로이드 앱

폰으로 할 사람

.tar

모바일용 묶음

폰 유저

ㅈㄷ (10-17 기준 정식, 뉴비는 이거) : aHR0cHM6Ly9raW8uYWMvYy9iVkdVNmNycGROR0JmV2xQc2ZzQWVi

ㅈㄷ (모드 따로 받기, 10-17 최신 모음집) : aHR0cHM6Ly9raW8uYWMvYy9hUWV2TVRnazBBT1dQOXgzRXdzQWVi

원글 : aHR0cHM6Ly9rb25lLmdnL3Mvd2F5d2FyZC13bWwvY2I0RGhvdERYcFY0OTNJTDJsc0FlYg==

ㅈㄷ (10-18-pre2 임시판, 모더, 구경꾼용) : aHR0cHM6Ly9raW8uYWMvYy9hYXhfcnNSb1FwUVQ1XzBQY1J1UWVi

원글 : aHR0cHM6Ly9rb25lLmdnL3Mvd2F5d2FyZC13bWwvY1BpMzVZWVdtcElMdjcydXdydVFlYg==

▶ 공식 영어 원본 받고싶으면

  • 공식 : aHR0cHM6Ly9zaW50ZW50aW9uLmNvbS8=

  • itch : aHR0cHM6Ly9zaW50ZW50aW9uLml0Y2guaW8vd2F5d2FyZA==

  • 돈 내라고 뜨는건 후원 요청임. 0원 넣거나 무료로 받기 누르면 됨

  • 근데 한글판이 영어 원본을 그대로 품고 만든거라 그냥 한글판 쓰는게 편함


【4. 설치 (3분컷)】

  1. wayward-wml-ko-V0.9.x.zip 받아서 아무데나 압축 풀기

  2. wml-mods-basic-x.x.zip 풀어서 안에 있는 wml 폴더를 게임 폴더에 덮어쓰기

  3. 이미지팩 있으면 같은 폴더에 풀기 (5번 참고)

  4. Wayward_WML_ko.html 더블클릭

끝임. 왼쪽 아래 WML 버튼 누르면 모드 관리자 뜸.

게임 폴더/

├ Wayward_WML_ko.html <- 이거 더블클릭

├ wml/ <- 로더 + 모드 (지우면 안됨)

│ └ mods/ <- 모드 폴더 하나 = 모드 하나

├ images/ <- 이미지팩 그림

├ images-elena-1.js <- 이미지팩 목록

└ wayward-imagegen/ <- 그림 직접 뽑을때 쓰는 도구

!! 중요 !!

  • html이랑 wml 폴더랑 이미지가 같은 폴더에 있어야 함. 옮길땐 폴더째로

  • 압축 풀때 경로 깊어지는거 주의. wml 폴더가 html이랑 같은 높이에 있어야함

  • 이미 모드 넣어둔 상태에서 덮어썼으면 wml\mods\모드목록_자동갱신.cmd 한번 더블클릭하셈 (목록에 다시 들어감)


【5. 기본팩 / 통팩 / 이미지팩 — 이거 제일 헷갈려함】

▶ 5-1. 기본팩 vs 통팩

기본팩

통팩

모드 수

43개

217개

내용

WML이 만든 유틸 위주

현존하는 모드 전부

용량

0.6MB

323MB

프리셋

없음

6개 들어있음

  • 기본팩 : 창 배치, 단축키, 통계, 세이브 압축, 이야기 글 색 같은 편의 기능 위주임. 바닐라 맛 유지하면서 불편한것만 없애고 싶으면 이거

  • 통팩 : 다른 제작자분들 모드까지 전부 때려넣은거. 다같이 켜놓고 테스트한 구성 그대로라 충돌 걱정 덜함

통팩이 323MB인 이유는? 이미지 아님.사운드임 사운드 모드 하나가 270MB라서 그럼. 근데 요즘 MB 따위가 용량이진 않잖아~ 사운드 모드 없으면 허전하니 나는 개추함 ㅋㅋ

▶ 5-2. "이미지 포함 통팩"이 뭔 소리임?

예전 통팩에는 이미지팩이 같이 들어있었음. 근데 지금 배포되는 기본팩/통팩에는 이미지가 안 들어있음.

용량이 감당이 안돼서 뺐고, 요즘은 다들 직접 뽑는 분위기로 가는 중임.

그래서 지금 받으면 이렇게 됨

  • 게임은 멀쩡히 돌아감

  • 근데 초상화 자리에 "이미지 없음" 이라고 뜸

  • 이건 고장난게 아니라 그림을 아직 안 넣은 상태인거임

그림 나오게 하는 길은 두가지임. 아래 6번 보셈.

▶ 5-3. 모드 하나만 추가하고 싶을때

통팩 통째로 받기 싫고 땡기는것만 넣고싶으면

  1. 모드 폴더를 wml\mods 안에 넣음

  2. wml\mods\모드목록_자동갱신.cmd 더블클릭

  3. 게임 새로고침

또는 그냥 모드 폴더나 zip을 게임 화면에 끌어다 놓으면 됨. 이게 제일 빠름.

지우는것도 똑같음. wml\mods에서 폴더 지우면 끝.


【6. 그림 나오게 하는 법】

▶ 6-1. 이미지팩 받아서 쓰기 (쉬움)

서브 이미지팩 탭에 아내별로 올라와있음. 요즘 꾸준히 올라오는중임.

  • images-OOO.js 파일 -> html 옆에 둠

  • images 폴더 -> 게임 폴더 안에 둠 (팩 여러개면 images 폴더끼리 합치면 됨)

  • 엘레나 1, 2 이런건 분할압축 아니고 추가 이미지임. 다 받고 다 풀고 덮어쓰면 완전체

  • 안 쓰는 아내 팩은 안 받아도 됨 (용량 아끼려면)

▶ 6-2. 직접 생성하기 (ComfyUI)

한글판 패키지 안에 wayward-imagegen 폴더가 이미 들어있음. 그거 쓰면 됨.

대충 흐름

ComfyUI 설치 -> 커스텀 노드 설치 -> 체크포인트/로라 넣기

-> bun 설치 -> wayward-imagegen 실행

-> 게임 설정 > 이미지 생성 > "자동 찾기" -> "연결됨" 초록불

  • 권장 사양은 VRAM 8GB 이상임. 3050ti 노트북도 장당 10~12초로 돌아간다는 글 봤음

  • 서브에 뉴비용 세팅팩이랑 따라하기 글들 꾸준히 올라옴. 연구&팁 탭 뒤져보셈

자주 막히는거

  • 직접 뽑은 그림이 안 보임 -> 기본 이미지팩을 빼야함. 안 빼면 기본 그림이 먼저 나옴

  • 그림이 흐릿함 -> 대부분 CFG/로라 문제임. 기본 세팅이 고속(라이트닝) 로라라 CFG 1 기준임

  • 연결이 안됨 -> wayward-imagegen 폴더에서 bun src/cli.ts doctor 돌리고 결과를 AI나 댓글에 물어보셈

  • "Module not found src/cli.ts" -> 경로 문제임. wayward-imagegen 폴더에서 터미널 열고 다시 실행

▶ 6-3. 컴 사양이 딸리면

NovelAI로 뽑는 방법도 있음 (Opus 결제 필요). 관련 모드랑 글 서브에 있음.


【7. 모드 설정하는 법 (게임 안에서)】

왼쪽 아래 WML 버튼 -> 모드 관리자

  • 왼쪽 = 지금 쓰는 모드 / 오른쪽 = 안 쓰는 모드. 옮겨서 켜고 끔

  • 모드 오른쪽 톱니바퀴가 그 모드 설정임. 모드마다 설정이 꽤 많으니 한번씩 열어보셈

  • 제작자별 / 태그별 묶어보기 됨. 태그는 유틸 / 콘텐츠 / H 장면 / 그림 / 프롬프트 / 기반(호환층) / 태그 없음

  • 프리셋 : 모드 조합 통째로 저장. 통팩에 예시 6개 들어있음 (기본 편의, 손님, 손놈, 새 아내, H-Scene, 순애)

  • 옮기기, 백업 : 세이브 + 모드 설정 + 브라우저에 설치한 모드를 파일 하나로 내보내기. 다른 PC나 폰으로 옮길때 씀

※ 순서 중요함. 기반(호환층) 계열이 위로 가야 그걸 쓰는 모드들이 제대로 붙음. 기본적으로 알아서 정렬되긴 함

※ 모드가 많으면 로딩이 길어지는데, 지금은 멀티스레딩으로 읽어서 많이 빨라짐


【8. 폰으로 하기】

PC에서 세팅 다 해놓고 그대로 폰으로 옮기는 방식임.

  1. PC 게임 폴더에서 모바일로_묶기.cmd 더블클릭 -> "모바일용" 폴더에 .tar 두개 생김

  2. 두 파일 폰에 복사

  3. 폰에 wml-player-x.x.apk 설치 ("출처를 알 수 없는 앱" 허용 필요)

  4. 앱에서 [게임 묶음 고르기] -> [그림 묶음 추가] 한번씩

  • 앱에 게임이 들어있는게 아님. 내 PC에서 만든 묶음을 읽는 구조임

  • WML 업데이트는 새 .tar 다시 불러오면 됨

  • 그림 묶음은 압축 안 풀고 그 파일에서 바로 읽음. 파일 지우거나 옮기면 다시 골라야함


【9. 모드 만들어보고 싶으면】

요즘 AI한테 시켜서 모드 뽑는 사람 꽤 많음.

  • wml-mcp-x.x.zip 받아서 압축 풀기

  • npm install

  • node config.mjs --wml "게임 폴더" 출력을 쓰는 AI 앱 설정에 붙여넣기

이러면 AI가 게임 코드 구조랑 WML 문법을 알아서 읽고 모드를 짜줌. 모드 검사도 해줌.

게임 버전이 올라가도 로더가 함수 이름표를 다시 맞춰주는 구조라, 의미 이름만 써서 만들면 손 안대도 대부분 살아남음.


【10. 알아두면 좋은 것】

▶ 보안

  • 이 겜은 html 파일임. Setup.exe 같은게 들어있으면 일단 의심부터 하셈

  • 서브에 렌파이 게임으로 위장한 인포스틸러 공지 있음. 한번 읽어보는거 추천

  • .cmd 파일은 메모장으로 열면 내용 다 보임. 찜찜하면 열어보고 실행하셈

  • 인터넷에서 받은 .cmd 처음 돌릴때 윈도우 "PC 보호" 창 뜨는건 정상임 -> 추가 정보 -> 실행

  • bun 설치 명령어는 bun 공식 홈페이지에 나온 그대로만 쓸것

▶ 세이브

  • 세이브는 게임 폴더가 아니라 브라우저 안에 저장됨

  • 쿠키 날리면 세이브도 같이 날아감. 실제 피해자 있음 (애도 엉엉..)

  • 브라우저 바꾸면 세이브 안 따라옴

  • 게임 안 설정 -> 내보내기로 수시로 백업하셈

  • "저장 공간이 가득 찼습니다" 뜨면 -> 끄기 전에 무조건 JSON 내보내기부터 -> 안 쓰는 슬롯 지우기

  • 기본팩에 세이브 압축 모드 들어있음. 이거 켜두면 훨씬 덜 참

  • 저장용량 제한 자체를 늘려주는 확장 런처도 서브에 올라와있음 (윈도우 전용)

▶ 버그처럼 보이는데 정상인것

  • 손님 초상화 안 뜸 -> 손님 이름이 랜덤 생성이라 초상화 없는 손님 있음. 정상임

  • "이미지 없음" -> 이미지팩을 안 넣었거나 생성 서버가 꺼져있는거임 (6번 참고)

  • 소리 없음 -> 원래 없음. 사운드 모드나 음악 플레이어 모드 깔면 됨

  • 새 아내 모드 넣었는데 그림이 없음 -> 이미지팩 작업중인 경우가 많음. 원글 확인하셈

▶ 플레이 꿀팁

  • 치트는 첫 회차엔 봉인 추천함. 텍스트겜에서 서사 사라지면 재미 반토막남

  • 첫날 50골드로 재고 욕심내지 말것. 명성 낮을땐 사봐야 다 못 팜

  • 손님 오자마자 이것저것 권하면 주문을 못해서 수입이 안 생김

  • 1분 경과 5번이랑 5분 경과 1번은 결과가 다름. 시간 보내는 방식에 따라 이벤트가 달라짐

  • 빚 안 갚으면 수금원이 옴. 강제성 높은 이벤트 트리거임

  • 부업은 "지금 바로 돌아가기"로 시간 안 쓰고 스킵 가능함 (체력은 씀)

  • "그녀에게 원하는 것 말하기"가 핵심임. 현장에서 직접 끼어들어 말리면 더 확실하게 각인됨

  • 특정 손님이랑 한번 넘은 선은 그 손님한텐 계속 열려있음. 원망은 대화로 내릴 수 있지만 선은 못 되돌림

  • 술이 만악의 근원임. 취할수록 선이 무너짐

  • 순애도 됨 (다른 남자 보지 말라고 각인). 대신 돈벌기 빡셈


【요약】

  1. wayward-wml-ko-V0.9.1.zip + wml-mods-basic 받아서 압축 풀고 wml 폴더 덮어쓰기

  2. Wayward_WML_ko.html 더블클릭

  3. 그림 나오게 하려면 이미지팩 받기 또는 ComfyUI로 직접 뽑기 (기본팩/통팩에 이미지 안 들어있음)

  4. 왼쪽 아래 WML 버튼 -> 모드 관리자에서 켜고 끄고 설정

  5. 모드 더 땡기면 통팩, 또는 원글 가서 하나씩

  6. 신버전(10-18-pre2)은 아직 존버. 정식 나오면 제대로 맞춰서 올림

  7. 세이브 백업 생활화, exe 조심


모드 만들어주시는 분들 덕분에 매일 다른 겜이 되는중임.

지금만 해도 모드가 200여개 인데, 앞으로 더 늘어날 것으로 추정.

힘내라 웨붕이모더들! 더 짜내라 으럇으럇

79
41 comments
선생님 질문할게있는데 순정은 메뉴 작동이 잘되는데 wml이거는 모드를 다 날려도 메뉴만 키려고 하면 게임이 멈추거든요. 다른 변형겜인 종교모드?겜 같은건 잘 작동되는데 이거 어떻게 해야하나요? 인터넷 쿠키날려도 wml거에 모드만 넣으면 겜이 멈추는데
업데이트 한것도 그럼 ? 그럼 브라우저를 바꿔봐야할듯 indexedDB 라는게있는데 거기서부터 문제가생긴거같음. 이걸 초기화하는방법은 F12 눌러서 Application 탭 가서 indexedDB를 우클릭 해서 Clear 하면됨.
개추요
[deleted] (edited )

Deleted comment.

전에 한번 공지로 뉴비 가이드 올라달라했는데 마참내 올려주셨군요! 이제 뉴비/핑프들 무지성으로 질문들어오는거 덜 해질듯
[deleted] (edited )

Deleted comment.

주딱 일 잘한다 개추
정리 감사합니다! wml 모드도 잘 쓰고 있습니다! 질문이 있는데요 '이 순간에 해당하는 이미지 없음'의 경우가 본문에서 말씀하신 부분 같은데, 이미지팩을 받으면 해당 텍스트에 해당하는 이미지가 자동으로 설정되는 걸까요? 이미지 없음 경우가 많아서 모드 다 빼고 나쁜 손님 모드만 쓰고 있는데도 이미지가 없는 경우가 있어서요!
이미지팩은 기본 바닐라 게임만 지원되는거고 모드는 대부분은 이미지생성용이야. 이미지생성이없으면 지원안될확률이높음. 다만 모드 제작자가 이미지팩을 제공했다면 뜨겠지
정리 진짜 깔끔하네 개추
개추를 참을 수 없는
ㅈㄷ (10-17 기준 정식, 뉴비는 이거) 요거 사용 중인데, 라이자가 목욕탕 관련 씬만 이미지가 하나도 출력되지 않네요. 분명 bath 관련해서 폴더 안에 이미지는 분명히 있는데, 왜 목욕탕 관련 이미지만 출력이 안될까요.
라이자가 뭐임 ?캐릭터 이름임 ? 그럼 난모름.. 기본적으로 있는건 엘레나 피파 마라 임
이게 뭐지 하고 검색하고 있었는데 너무 감사해요!
NovelAI로 이미지 뽑는법 검색해도 안보이네..
헉 사실 novelai는 크게 세팅할게없어서 .. 사람들이 댓글에만 적어둔게많을거임 ㅠ
요약한것도 많아서 못읽겠으면 개추
그래서 요약도 적어놨잖음 그마저 못밁으면 문맹아니면 외국인이지뭐
pc에서 모바일 모드 적용 다 했고 이미지팩도 html파일 있는 곳에 images랑 js파일들, h status 폴더 안에 images랑 js파일들까지 전부 옮겼는데 마지막 모바일로 묶기 cmd가 먹통이네요ㅜ 뭐가 문제인걸까요
게임폴더 안에 images/ images-elena-1.js 이거 두개 파일이없는데 어떻게해요?
아하! 최신버전에는 없음! 본편 페이지를 가거나 아니면 내가 소미때 올린팩을 찾아보는게좋음 지금은 wml 만 공유하고 있는데, 곧 본편 업데이트 되면 통으로 나올것임 ㅠ
(edited )
이제 이미지 생성기 눌러서 키던거 추가안해주는거같은데 날림 설명이 있으면 초보자 운다요
담버전 나오면 완전 싹다 넣어서 풀팩해줄게 버텨..ㅠ
감사합니다 엄청 헤맸는데, 정독 몇 번면서 겨우겨우 받아가요!
pre2 ko 버전 해봤는데.. 이상한점은 못본거 같은데 오늘보니 링크 다 터져있네
원래 곧 정식나올까바 pre2는 일주일만 했었는디.. 흠.. 다시올릴까 ㅠ
뉴비 지금 한글판 게임 + 로더 여기에 통팩 넣었는데 이미지는 없는게 맞지? images폴더 따로 만들고 이미지팩 찾아서 받아넣으면됨?
아마 모드를 쓰고있다면 대부분 이미지가 없는것처럼 보일것임. 바닐라 이미지는 있지만 모드는 대부분 생성을 권장하니까
All
Title
Body