[WML] Wayward SDK, 모드 로더 0.8.0 , 모드팩 기본/통팩 1.3.3 , MCP 0.5.0 (1.5v적용+통합모드팩)
1.5번역 적용했음 2026-10-06 19:32 아래링크서 다운로드
새패치 적용했음 2026-10-07 17:35 아래링크서 다운로드
안드로이드 모바일 통팩 추가 2026-10-08 15:00 아래링크 추가.
통팩올렸음
새업데이트 있음 +++이번엔 이미지 미포함+++
앞으로 모든 업데이트는 wayward-wml 서브에서 진행됨 이제 여기는업데이트없음
핫픽스는 wayward-wml 서브 가면 있음
핫픽스는 wayward-wml 서브 가면 있음
핫픽스는 wayward-wml 서브 가면 있음
##### 패치내역 #####
패치 26-10-07
▶ 모드팩 1.0.1
[WAYWORKS]
- 부업, 잠잘 때 시간 보내기 누르면 1분씩만 가던 거 (errand_continue 오류) 고침
-> 10-04부터 게임이 시간 넘기기를 전부 wait 하나로 합쳐놨는데 옛날 방식 그대로 보내고 있었음
- 1·2·3 = 1·5·15분 기다리기, Enter = 끝날 때까지. 작업대 실험도 Enter로 끝까지 감
- 부업 중에 1분 키 누르면 "주점 밖에 있습니다" 뜨면서 시간 안 가던 거 고침
- 선택지 하나짜리 이벤트는 Enter·1·2·3 으로 바로 넘어감
- Esc 누르면 백과사전부터 닫힘
- 영어판에서 단축키랑 Esc 안 먹던 거 고침. 일시정지 메뉴 버튼도 영어판에선 영어로 나옴
- 위쪽 버튼(☰ WW ↶ ♡ ?) 서로 겹치던 거 고침
- 버튼 툴팁에 내가 바꾼 단축키 제대로 나옴
- 통계·치트가 하루 마감이랑 자동저장 순서 꼬이던 거 9-30처럼 맞춤
[손님 조종]
- 패널 열어두면 단축키가 전부 안 먹던 거 고침 (기본으로 켜진 모드라 이거 겪은 사람 꽤 있었을 듯)
[H Status]
- 침실 난입 끝나고 밤이 이상하게 넘어가던 거 고침
- 러브호텔 다녀와서 잠자기 이어지는 거 고침
- 실시간 그림 생성 쓸 때 메이드 그림 따라가던 거 고침
-> 그림 없을 때 화면에서 제일 큰 그림을 빌려 쓰는데 그게 메이드관 패널 초상화였음. 이제 게임 그림만 씀
- ※ 비밀 탭 그림이랑 실시간 생성 쓰려면 에로스테 글에서 images-situation-*.js, prompts-situation-*.js 받아서
게임 html 옆에 둬야 함 (엘레나·마라·피파·히나만 됨. 미야비는 원래 지원 안 함)
[메이드관]
- 자는 동안 질투·위로 이벤트 돌아가던 거 고침
- 잠들거나 외출하면 열려있던 주인 시간 바로 닫힘
[노예관]
- 새 게임 시작하면 설정창이랑 하루 넘어갈 때 오류 뜨던 거 고침 (원본 애드온에 있던 버그였음)
[창관·노예관]
- 쉬는 날 일당 기록 초기화 안 되던 거 고침
[치트 장부]
- 경계(허용·제한) 건드리면 10-04에서 "남편이 그은 선"으로 먹히던 거 고침
- "모든 허용 신호" 치트 다시 제대로 먹음
- "경계 초기화" 누르면 0으로 밀지 않고 게임 처음 상태로 돌아감
[나머지]
- 애드온 호환층 : 손님 주변 이벤트 원망 수치가 조건 상관없이 붙던 거 고침
- 임신·출산 : 부업·잠자기 중 기다리기가 1분씩 끊기고 외출 끝나도 계속 흐르던 거 고침
- 배달 부업 : 10-04에서 "배달 중 · N분 남음" 안 뜨던 거 고침 (좁은 화면에서도 뜸), 조사 (으)로 고침
- 아내 수치 디버그 : 가슴 통증·적응도 항목 추가
- 이미지 생성 도구 : 침실 손님 그림 침대 위 / 아닌 거 따로 셈
- 캐릭터 외형 프롬프트 : 장면 그림에 프로필 설명문 섞여 들어가던 거 고침
▶ WML (게임 + 모드 로더 0.4.0)
- 모드 전용 의미 이름 추가 (모드 만드는 사람용)
-> 공용 심볼표에 없는 게임 함수·목록·표 이름을 모드 안에 직접 넣으면 됨
-> WML한테 등록 요청하고 다음 배포 기다릴 필요 없음. WML 따로 같이 배포할 필요도 없음
-> 게임 업데이트되면 로더가 새 버전에서 같은 걸 알아서 찾아 씀
-> 못 찾으면 엉뚱한 데 붙어서 조용히 깨지는 대신 그 모드만 안 켜고 이유 알려줌
- 기다리기 버튼 툴팁 "1분 기다리기1" -> "1분 기다리기 (1)" 로 고침
- 개발용 도구 추가 : mod-symbols.mjs (모드 전용 이름 넣기·확인·새 버전 맞추기), port-regen.mjs (옮긴 모드 다시 만들기)
- 설명서(SDK·MCP 한/영)에 모드 전용 이름 쓰는 법 추가, README에 에로스테 파일 안내 추가
▶ MCP 0.3.0
- symbol_add 에 mod 넣으면 그 모드 전용 이름이 됨
-> 영어판·한글판 둘 다에서 딱 하나만 찾는지 확인하고 mod.js 에 써줌
-> 여러 개 한번에(items), 다른 이름(aliases), 없어도 되는 이름(optional) 다 됨
- 새 도구 3개
-> symbols_check : 내 모드 전용 이름이 지금 게임에서 제대로 잡히는지 확인
-> symbols_port : 게임 업데이트 후 새 이름 찾아서 mod.js 에 기록
-> symbols_request : 공용 심볼표에 넣어달라는 요청서 만들어줌
- mod_check 가 모드 전용 이름 알아봄. 압축 이름 그대로 쓰는 데 있으면 symbol_add { mod } 쓰라고 알려줌
AI한테 "이 함수 모드 전용 이름으로 넣어줘" 하면 끝임
터지는 거 있으면 계속 댓글 ㄱㄱ
패치 26-10-07 PM05:34
【WML 업데이트】 모드팩 1.1.0 · 모드 로더 0.5.0 · MCP 0.4.0
허가받은 모드들(Wayward MOD v3.44, Mod v2.30, 디버깅툴 v1.2, EasyGen, 히나 통합팩) 기능을 하나씩 쪼개서 WML 모드로 옮겼음
모드가 31개 → 65개 됨. 새로 들어온 건 전부 기본 꺼짐이라 모드 관리자에서 골라 켜면 됨
받을 거 : wayward-wml-ko-2026-10-04.zip / wml-mods-1.1.0.zip (모드 만들 사람은 wml-mcp-0.4.0.zip 도)
모드팩 1.0.x 깔아둔 사람은 1.1.0 zip 게임 화면에 다시 끌어다 놓으면 덮어써짐
▶ 이번에 고친 버그
- H Status 그림이 없을 때 메이드·창관 패널 그림을 빌려 쓰던 거 고침 (이제 게임 그림만 씀)
-> 참고: 이미지 생성 도구는 기본이 "오프라인 전용"이라 그림 서버를 안 부름 (서버 없는 사람이 대부분이라)
그림 서버로 실시간 생성 쓰는 사람은 이미지 생성 도구 창에서 "오프라인 전용" 끄면 됨
- 오른쪽 위 웨이트리스·메이드관·⚙치트 버튼이 게임 버튼(? ♡ ↶)에 겹치던 거 고침 (창 겹침 보정 1.1.0이 한 줄로 정렬함)
- 모드 창(WML 창) 열어두면 WAYWORKS 단축키가 전부 안 먹던 거 고침
- 노예관 새 게임 오류, 손님 조종 패널 단축키 막힘은 지난번에 고친 그대로
▶ 새 모드 (전부 기본 꺼짐)
[화면·편의]
- 테마 : 색 테마 10종 (🎨)
- 음악 플레이어 : 내 음악 폴더를 영업 준비/영업 중/마감/침실/외출마다 다른 곡으로 (♪)
- 세이브 압축 : 저장 칸 압축 + 저장 공간 꽉 차면 오래된 복원본부터 정리
- 이야기·행동 표시 : 지금 하는 행동 표시, 이야기 줄 행동 배지, 이야기 순서 위/아래, 아내 툴팁
- 단축키 (MOD판) : 키 바꾸기 (WAYWORKS랑 같은 일이라 둘 중 하나만)
- 만남·경제 통계 (MOD판) : 📊
[게임 규칙]
- 엔딩 설정 : 부자 엔딩 + NTR·수금원·마녀사냥 배드 엔딩 하나씩 켜고 끄기
- 밸런스 조절 : 손님 방문·동시 손님·팁·악명 감소 같은 숫자를 다음 날부터
- 상인 연합 길드 상점 : 24시간 상점, 가방, 기력 음료·최면제 같은 아이템, 즉시 배달/직접 장보기 (🏪)
- 도전 의상 조건 완화 / 자동 체위 전환 끄기 / 상황에 맞는 옷 선택지
- 완료 후 선택지·여운 : 끝난 뒤 이어하기·정리, 관계 여운
- 아내 자율행동 : 아내가 먼저 다가오는 이벤트 + 자율행동 빈도 조절
- 사용자 손님 (MOD판) : 내가 만든 손님 50명까지 (게임 에디터랑 같은 일)
[일꾼]
- 종업원 할머니 (웨이트리스랑 같은 일) / 청소 고블린 / 사냥꾼 아저씨
[치트·디버그]
- 치트 에디터 (MOD판) : 퀵 치트, 능력치·성향·관계·마법·선술집 편집 (🛠)
- 디버깅툴 v1.2 그대로 들어옴 : 손님 조종 1.7, 판정 디버그 1.1, 아내 수치 디버그 1.3 (새 판으로 교체)
+ 수용도 검사기, 카드 게임 디버거 새로 추가
-> "디버깅 툴 연결(debug-bridge)"은 손님 조종이 필요로 해서 켜져 있음. 끄지 마셈
-> 구경꾼 상한 바꾸기만 게임 상수라 WML에선 4명 고정
[그림]
- 그림 프롬프트 정리 : 태그 정리 규칙 15개 (규칙마다 켜고 끄기)
- 장면·의상 태그 개편 (Mod v2.30판)
- 장면 프롬프트 덮어쓰기 : 장면별 프롬프트를 내가 쓴 글로 통째로
- 그림 설정 확장 : 장면별 그림 수 늘리기, 모델·생성 설정 즐겨찾기
- 손님 외형 / 그룹 장면 / 취기·생리 표현 / 정사 후 모습 / 아내 외형 (Mod v2.30판)
- 안에 사정 마무리 장면 (새 장면 3개) / 목욕 시중 장면 (새 장면 1개)
- EasyGen 연결 : EasyGen 서버 쓰는 사람용 (설정창·실제 프롬프트·NAI 남은 양)
※ 그림 이름 바꾸는 기능(새 그림 필요)은 모드 설정에서 따로 켜야 함. 기본은 쓰던 이미지팩 그대로
[새 판으로 바뀐 기존 모드]
- 임신·출산 : 정자량이 많을수록 임신 확률 올라감 (10-06판)
- 창관 + 임신 연동 : 새 확률식
- 새 아내 히나 : 아내 고르는 화면에 히나 초상화 나옴
▶ WML (모드 로더 0.5.0)
- 같은 일 하는 모드 경고 : 모드에 "역할"을 적어두면, 같은 역할 모드 둘을 켰을 때 모드 관리자가 하나만 켜라고 알려줌
(막지는 않음. 취향대로 고르라고 만든 거라)
- 압축 세이브 : 로더가 압축된 세이브를 항상 풀어서 읽음. 세이브 압축 모드 꺼도 세이브 그대로 불러옴
- zip 안에 공용 심볼표 사본 들어있으면 공용표를 덮어쓰지 않고 그 모드 전용 이름으로만 넣음
-> 다른 제작자가 공용표 고쳐서 만든 모드도 zip 그대로 돌아가고, 다른 모드랑 안 섞임
- 공용 심볼표 46개 → 166개 (나쁜 손님 모드가 쓰던 97개 포함. 이제 나쁜 손님 zip 그대로 넣어도 돌아감)
- 옮긴 모드 26개 다시 만드는 명령을 port/regen.json 에 정리 (tools/port-regen.mjs, --check로 손으로 고친 데 없는지 확인)
▶ MCP 0.4.0
- mod_check 가 같은 역할 모드 알려줌 / mod_list 에 역할 표시
- 포팅 도구(wrap-addon, port-inline)에 --role 추가
패치 26-10-08 1차 최종 (이거이후 좀 쉬고옴ㅠ)
▶ 버튼 한 줄로 모으기 (왼쪽 아래 WML 줄)
- 구석구석 흩어져 있던 모드 버튼을 WML 버튼 줄 한곳에 모았음
-> 이미지 생성 도구, 손님 조종, ⚙ 치트, 창 ▾(WAYWORKS), 메이드관·노예관·웨이트리스 같은 오른쪽 위 버튼까지
- 줄 왼쪽 손잡이를 끌면 원하는 자리로 옮겨짐. 자리는 기억함
- 왼쪽 끝 ‹ 를 누르면 옆으로 밀려서 작은 "WML ›" 만 남음. 그거 누르면 다시 펴짐 (모드를 끄는 게 아님)
- api.ui.addButton, api.ui.adopt(요소, { proxy }) 로 태우기. 지침,MCP 설명서에도 적어 뒀음
▶ 실시간 그림 생성 ("이미지 없음" 고침)
- 이미지 생성 도구의 "게임 중 이미지 생성"이 기본 "자동"으로 바뀜
-> 그림 서버가 연결돼 있고 그릴 수 있으면(ComfyUI든 NovelAI든, 같은 PC든 다른 PC든) 없는 그림 바로 만듦
-> 아니면 지금처럼 오프라인 이미지팩만 씀
(전에는 "오프라인 전용"이 기본으로 켜져 있어서 미리 생성은 되는데 실시간 생성이 안 됐음)
- 서버를 게임보다 늦게 켜거나 연결이 끊겼다 다시 붙어도 새로고침 없이 알아서 다시 찾음
- 도구 창에 상태 나옴 : 그림 서버 연결됨 / 서버는 있는데 그림 엔진이 응답 없음 / 그림 서버 없음
- 끔(오프라인 이미지팩만) · 켬(항상 요청)으로 고정도 됨
- 새 아내 미야비가 게임 켤 때 그림 서버가 없어도 생성 요청 보내던 거 고침
▶ 한글판 이야기 줄 사람별 색
- 손님마다 붙는 색 점 · 글색이 한글판에서 안 붙던 거 고침
- 원인 : 게임이 손님 이름을 영어 단어 기준으로 찾아서, 한글 손님 이름이나 한글로 옮긴 단골 이름(알드릭 등)을 못 찾았음
9-30 한글판엔 이걸 처리하는 코드가 있었는데 WML엔 빠져 있었음
▶ 모드팩 1.3.1 새로 넣은 거 (기본 켜짐)
- 터치 행동 버튼 (touch-bar)
-> 폰에서 단축키 대신 화면 버튼으로 기다리기(1·5·15분) · 손님 올 때까지 · 청소 · 주방 · 일하기 · 부업 · 낮잠
-> 게임 단축키랑 같은 규칙. 지금 못 하는 건 흐리게 나옴. 단축키 바꿔 둔 사람도 버튼 뜻은 그대로
-> 폰에서만 보임 (PC는 설정 ⚙에서 켜기). 버튼 고르기 · 위치(아래/오른쪽) · 크기 설정 있음
- 남편 방침 대화 시간 초과 고침 (guidance-timeout) — 게임 원래 버그
-> 아내가 손님 일로 물을 때("그 사람한테 잘 대처했어" 같은 선택지) 30분 안에 대답 안 하면 그 뒤로 이런 대화가 다시 안 나왔음
-> 30분 지나면 "네가 알아서 해" 고른 것처럼 처리해서 다음 질문이 다시 나옴
-> 코네에 올라온 버그픽스 애드온이랑 같은 처리를 WML 모드로 새로 짠 거임 (그 애드온의 다른 기능은 안 들어 있음)
▶ 화면 빼내기 (여러 모니터) — 새 모드, 기본 켜짐
- 이야기 로그 · 아내 상태(초상화) · 행동 버튼을 각각 따로 창으로 뺄 수 있음. 왼쪽 아래 WML 줄의 📜 👤 ⚡ 버튼
(세 개를 각각 다른 모니터에 두면 듀얼·트리플·쿼드 배치가 됨)
- WAYWORKS가 켜져 있으면 WAYWORKS 창으로 열림 → 도킹·분할·탭, 그리고 ↗ 로 다른 모니터에 분리까지 그대로 됨
(창 체계를 두 개 만들지 않으려고 WAYWORKS 틀에 얹었음. WAYWORKS가 꺼져 있으면 이 모드가 새 창을 띄움)
- 빼낸 창은 게임을 그대로 비추는 창임. 게임이 그린 칸을 옮기면 다음에 다시 그릴 때 깨져서, 같은 내용을 복사해 보여 주고
거기서 누른 것은 원래 자리를 눌러 줌 → 필터(전체·금화 등)나 📷 같은 버튼도 그대로 동작
- 뺀 동안 본 화면에서는 그 칸을 숨겨서 자리를 넓게 씀 (설정에서 끌 수 있음)
- 폰에서는 쓸모가 없어서 'PC 전용' 표시
- 아내 상태 창은 H Status가 끼워 넣은 「상태」 탭까지 그대로 나오고, 거기서 눌러도 게임에 그대로 전해짐
(다른 모드가 그 칸을 감싸고 있으면 표를 붙일 자리가 없어서, 자리를 차지하지 않는 껍데기를 하나 씌워 찾아냄)
- 행동 버튼 창에서 누른 행동도 그대로 실행됨 (시간도 흐름)
▶ 제작자들이 WML용으로 내준 모드 (받아서 같이 넣음, 수정·배포 허락받음)
- 창관 운영 3.5.0 · H Status 1.6.3 · 웨이트리스 1.0.1 : 제작자가 새로 낸 판으로 교체
-> 창관은 이야기 로그·수입 통계·행위별 최소 요금·종업원별 기록 추가 (우리 판 1.0.0 → 3.5.0)
-> H Status 1.6.3 은 캐릭터 애드온 생성기 v10으로 만든 새 아내도 알아봄
-> 표기 이름은 제작자 것을 그대로 씀 (배달 모드는 "배달의 민족", 에디터는 "게임 에디터(HL)")
-> 임신·출산, 창관+임신, 배달, 에디터, 새 아내 히나는 코드가 같거나 우리 게 최신이라 그대로 둠
- 새로 들어온 모드 3개 (기본 꺼짐)
-> WW 이미지 프롬프트 향상 2.65.0 : 의상·노출·장면 태그 등 그림 프롬프트를 통째로 바꿈
※ 프롬프트 관리자와 같이 못 켬 (같은 게임 함수를 통째로 바꿈). 켜면 모드 관리자가 알려 주고 양쪽 다 안 켜짐
※ 모드팩 1.1.0에서 떼어 낸 Mod v2.30 모드들과도 같은 일 → 그쪽도 끄고 쓰기
-> 위 모드의 세이브 압축 애드온 : 우리 '세이브 압축'과 같은 일·같은 형식이라 하나만 켜기 (둘 다 켜면 관리자가 알려 줌)
-> 이미지 공방 8.6 : 의상·장면별 그림 생성 줄 세우기와 검수. 모드 관리자 ⚙ 설정에서 엶 (그림 서버 필요)
- 손본 것 : 같이 못 켜는 조합·같은 일 하는 모드를 모드 관리자가 알려 주도록 표시를 넣고,
게임 함수를 가리키던 압축 이름을 WML 공용 의미 이름으로 바꿈 (이미지 공방은 게임이 올라가도 따라감)
▶ 프롬프트 관리자 0.2.2 (0.1.0 → 최신판)
- 예전 판에서 저장해 둔 규칙 그대로 불러옴 (데이터 호환 제보 반영). 설정 JSON 내보내기·가져오기도 그대로
- 새 "프롬프트 구성요소 기준" : 작업·기분·장소·장면·의상·취기·노출 같은 구성요소를 하나씩 골라 바꿈
-> 기존 "조합된 태그 묶음 기준"이랑 둘 중 하나를 골라 씀. 기준을 바꿔도 반대쪽 규칙은 안 지움
-> 품질·부정 태그, 인원·그룹·노출·정사 후 정황처럼 게임이 상황에 따라 붙이는 묶음도 바꿀 수 있음
- 캐릭터 외형(imageBase)을 기본·장면으로 나눠 저장. 장면 그림에서 게임이 3개로 줄이던 걸 안 줄이고 다 넣음
- 침대 장면 34종 편집, Dimensions(크기) 설정, 현재 이미지 참고 패널, 드래그 선택으로 구성요소 찾기
- 설정 가져오기에 병합/교체 선택
- 포팅 방식 : 원작 설치기는 게임 html을 54군데 고침. WML은 게임 파일을 안 고치고, 그 패치로 바뀌는 게임
함수 8개만 따로 만들어 끼움. 그래서 같은 함수를 쓰는 다른 모드(그림 관련 모드들)도 같이 켜짐
-> 모드 매니저용 매니페스트(bridge.manifest.json)가 딸린 애드온은 이제 이 방식으로 옮길 수 있음
▶ 모드팩 1.3.1 바뀐 거
- 세이브 압축 기본 켜짐 (저장 공간 부족 경고 줄어듦). 나중에 꺼도 압축된 세이브는 그대로 불러옴
- 이미지 생성 도구 1.1.0 · EasyGen 1.2.0 · 새 아내 미야비 1.0.1 · 프롬프트 관리자 0.2.2
- 노예관 1.3.0 · 창관 운영 3.5.1 : 「창 분리」(이야기·가게·그녀·행동 칸 떼어 내기) 기본 꺼짐으로 바뀜
-> 노예관을 켜면 네 칸이 저절로 떨어져 나오고, 다른 모드 창과 앞뒤 순서가 엉킨다는 제보 고침
-> 없앤 게 아니라 설정 > 화면 > 창 분리 에서 다시 켤 수 있음. 켜고 끌 때 게임 화면도 바로 제자리로 돌아감
-> 켠 상태의 z 값도 고침 : 게임 화면 위·WML 버튼 줄과 창 아래 자리로 (예전엔 100이라 다른 모드 창에 다 깔렸음)
-> 네 칸을 다른 모니터로 보내고 싶으면 새로 들어간 「화면 빼내기」 모드를 쓰면 됨
- 창 겹침 보정 1.4.0 : 제작자 쪽 옛 판 창관·노예관을 직접 넣어 쓰는 경우를 위해, 그 창 분리 테두리를
게임 화면 위로 올려 주는 보정을 넣음 (설정에서 끌 수 있음. 여기 들어 있는 판은 이미 고쳐져 있어서 아무 일도 안 함)
▶ WML (모드 로더 0.7.0)
- 캐릭터 애드온 생성기로 만든 아내 파일(Newwife_이름.js 같은 거)을 그대로 넣으면 됨
-> 게임 화면에 끌어다 놓거나 모드 관리자 [파일 고르기]. "새 아내: 이름" 모드로 감싸서 넣어 줌. 폰도 같음
- 모드 관리자에 검색칸 생김. 방금 넣은 모드는 노란 줄로 표시
- 모드 버튼을 한 줄에 모으는 장치(위 참고) : api.ui.addButton 손잡이, api.ui.adopt
- 모드 만드는 사람용 : api.actions.list / api.actions.observe (다른 모드 행동 찾아서 단축키 만들기 같은 거),
actions.register 세 번째 인자 { label }, 그림 서버 의미 이름 4개(imageBackendProbe 등),
api.provide / api.use (부모 모드가 자식 모드에 기능 내주기), api.secret (API 키 같은 값, 옮기기·백업 파일엔 안 들어감)
▶ LLM 모드 (기본 꺼짐, 완전 선택)
- 게임 원문은 그대로 두고, 그때 기분·감정·성격에 맞는 짧은 대사를 LLM이 뒤에 덧붙임
- OpenAI 형식 주소를 직접 넣어야 함 (내 컴퓨터의 llama.cpp·LM Studio·Ollama 등, 또는 클라우드 키)
-> 주소가 없으면 아무것도 안 함. 자체 LLM 돌리는 사람만 쓰는 모드라 기본 꺼짐임
- llm-night-talk : 영업 마치고 침실 들어가면 아내가 그날 일로 한두 마디. 자식 모드 만드는 예제이기도 함
- 모드 만드는 사람용 설명 : wml\docs\LLM.md
※ 아직 가짜 서버로만 시험했음. 실제 모델로 돌려 보고 이상하면 댓글 ㄱㄱ
▶ 그 밖에
- zip 여러 개를 한 번에 넣으면 하나만 설치되던 것 고침 (각 zip 안 mod.js 가 루트에 있을 때 경로가 겹쳤음)
- 폴더에 이미 있는 모드의 새 zip 을 넣으면 조용히 무시되던 것 고침 → "폴더 것(1.6.1)을 쓰고 있어요, 넣으신 1.6.3 으로
바꾸려면 폴더를 덮어쓰세요" 라고 알려 줌
- 모드 액션 API : api.actions.observe 에 payload(=action) 추가
- 모드목록_자동갱신.cmd · 모바일로_묶기.cmd가 PowerShell 코드를 iex로 돌리던 방식이라 백신이 잡을 수 있었음
-> .ps1 파일 따로 두고 실행하는 방식으로 바꿈 (동작은 같음)
- 모바일로_묶기에서 그림 묶음 다 만들고도 "실패했어요: tar ()" 뜨고 옛 묶음 안 지워지던 거 고침
- README에 추가 : Mod v2.65(WML판)랑 같이 쓸 때 끌 모드 목록 / 그림 속 아내 외형(태그) 바꾸는 법(html 말고 프롬프트 관리자) /
생성기 아내 파일 넣는 법
나쁜손님 모드 포함했어요 가루삼겹, MOD 3.44 등 다 추가했음
손놈 모드는 사이즈가 커서 따로 배포할 예정.
이밖에 한게 많은데 그냥 열어보면…알듯..ㅠㅠ 나도 너무많이 정리해서 정신이업다!
패치 26-10-12 2차 최종 (요양갈게…)
각 모드들 호환안되는거 잡았고 추가 API 넣었음.
저장에 관한 문제라던가 모드호환성에 집중했음.
자세한건 다운받아서 readme 참고.. 여기쓰기 참길다..
##### 패치내역칸 #####
지금 뜨거운감자에서 따뜻한 감자가 된 wayward에 큰 결함이 있따면
나 이것도 적용하고싶고 저것도 하고싶은데 얘넨 호환이안되우..ㅜㅜ 하는게 좀 있고
모드 여러 개 섞다가 화면 까맣게 되거나, 업데이트 한 번 뜨면 쓰던 모드 전부 터지는 거..
너무 중구난방한 모드제작 방식 & 배포방식 때문에
이걸 하나로 합쳐서 관리하기 용이하고 개발하기 편하게하자! 라는 취지로 SDK 와 MCP를 만들게 되었음.
이름은 WML(Wayward Mod Loader)임
*SDK 랑 MCP가 뭐임??
- 모드 “만드는” 사람용 설명서랑 도구 -> SDK
- “AI가 직접 모드를 만들고 시험까지 해주는 연결 도구” -> MCP
모드 안 만들고 그냥 플레이만 할 사람은 【1】【2】만 보면 됨
【0. 한 줄 요약】
- 원본 게임 파일은 손 안 대고, 모드는 옆에 끼워 넣는 방식임
- 모드는 폴더 하나에 파일 하나씩임. 폴더 넣으면 생기고 지우면 사라짐. 켜고 끄는 건 게임 안에서 체크 하나로 함
- 게임 업데이트가 나오면 라벨만 다시 맞추고 끝임. 모드를 하나하나 다시 손볼 필요가 거의 없음
【1. 지금까지 뭐가 문제였지;;】
어려운 얘기 빼고 비유로 하면 이럼
- 게임 html 하나를 집이라고 치면, 지금까지 모드는 집 벽을 직접 뜯어고치는 방식이었음
- 모드 A가 거실 벽을 고쳤는데 모드 B도 같은 벽을 고치려 들면?
-> 둘 중 하나가 망가지거나 집이 무너짐 (= 화면 까매짐)
- 게임 업데이트가 오면 집을 새로 지어버림. 그럼 벽 위치가 다 바뀜
-> 예전 위치 기준으로 짠 모드는 전부 엉뚱한 데를 뜯음 (= "ae is not defined" 같은 오류)
-> 이게 업데이트 때마다 모드가 단체로 터지는 이유임
WML은 벽을 허물고 다시짓는 힘든일을 방지해.
- 집(원본 게임)은 그대로 두고, 방마다 문 옆에 "알림 벨"만 달아둠
- 모드는 벨이 울리면 들어와서 자기 일만 하고 나감 (어흐 나만의 메이드쨩)
- 같은 방에 모드 여러 개가 와도 순서대로 하나씩 들어감
- 집을 새로 지어도 "거실은 여기, 부엌은 여기" 하는 이름표만 다시 붙이면 됨
이건 도구가 함수 모양을 보고 거의 자동으로 찾아줌
【2. 플레이하는 사람 입장에서 좋은 점】
1) 압축 풀기
2) 쓰던 이미지팩(wayward-elena-1.zip 이런 거) 같은 폴더에 풀기
3) Wayward_WML_ko.html 더블클릭
4) 설치할 모드 zip파일을 게임화면에 드래그 앤 드롭. (와정말쉽다!)
설치하면 일케됨
▶ 2-2. 모드는 게임 안에서 체크로 켜고 끔
- 왼쪽 아래 "WML" 버튼 누르면 모드 관리자 창이 뜸
- 체크하면 켜지고, 끌어서 순서 바꾸고, ⚙ 누르면 그 모드 설정 창 열림
- 바꾸고 "새로고침해서 적용" 누르면 끝임
- 설정은 브라우저에 저장되니까 껐다 켜도 잘 저장됨
▶ 2-3. 모드 넣고 빼기
모드는 웹스토리지에 저장하는 방법과 내 파일에서 관리하는 두가지 방식이있음.
첫번째는 직접 파일 관리식임 (구형이지만 편안함을 느끼는 사람들을 위해)
이건 이전 Addons 이나 설치기 등 이미겪어본 사람들이 많을텐데, 모드를 폴더에 넣고 특정 cmd 파일을 실행하는구조임.
그럼 html에서 인식해서 “모드를 설치했구나!” 하고 인식하는거지.
(자세한건 받아서 wml/mods 폴더 가보면 있음!)
두번째는 자동 설치 *위 사진처럼 (웹스토리지에 저장하여 쉽고빠르게 드래그 앤 드롭으로 모드설치 관리하기)
처음사용자는 이게 제일 편할거임 그냥 화면한가운데에 받아둔 mod.zip을 넣으면 모드가 적용되니까. 이거저거 따질것도없음
▶ 2-4. 필요한 모드가 꺼져 있으면 알려줌
- 예를 들어 "창관 + 임신 연동"은 창관 모드가 있어야 돌아감
- 창관을 꺼두고 연동만 켜면, 실행 안 하고 "필요한 모드가 꺼져 있거나 없어요: 창관 운영"이라고 빨갛게 알려줌
- 모드의 종속을 만들 수 있으니 모드의 모드의 모드의 모드가 가능해진것이지!
- 먼저 로드돼야 하는 모드가 있으면 순서도 알아서 맞춰줌
▶ 2-5. 같이 켜면 터지는 모드는 방지함
- 노예관 <-> 창관 운영, 손님 편집 <-> 게임 에디터 같은 조합은 같은 데를 건드려서 같이 켜면 꼬임(구버전기준)
- 둘 다 켜면 하나는 실행 안 하고 "같이 켤 수 없는 모드"라고 알려줌 (현재는 구버전을 포팅한거라 그렇고 추후 잘 맞춰 개발하면 문제는없을듯함)
그래도 지금 같은 코드를 같은 방식으로 불러오는것을 방지해두었음.
*추가기능 웹 스토리지 확인가능 (저장 찐빠나거나 할때 체크하기좋음)
▶ 2-6. 모드팩에 들어 있는 모드 (31개)
기존 9-30 한글판용 모드 대부분을 먼저 WML로 옮겨뒀는데, 모드가 워낙많다보니 내가 댓글 달아서 허가받았는데, 까먹고안받은게 있을수도..
문제시 모드팩은 배포 중단함
(괄호) 안은 기본으로 꺼진 거임
- 장면,행동관련 : 같이 한다, 기절한 아내 그대로 두기
- 가게 일,일꾼 : 배달 부업, 웨이트리스, 메이드관, 창관 운영(+임신 연동), (노예관)
- 아내,몸 : 임신·출산, 새 아내 히나/미야비, 의상 추가, H Status(+임신 연동)
- 도구,치트 : 게임 에디터, (손님 편집), 치트 장부, 손님 조종, WAYWORKS, (판정 디버그), (아내 수치 디버그)
- 그림 생성 : 이미지 생성 도구, 그림에 임신·몸 상태 반영, 프롬프트 관리자(+태그 자동완성), (캐릭터 외형 프롬프트), (그림 요청 고치기)
- 모드 내용은 원작 모드 그대로임. 원작 모드 만든 분들 작품이고 나는 옮기기만 했음 (압도적 감사 ㅜㅜ)
(클릭)여기부턴 개발자용!(내가 개발을 하나도몰라도 AI를 결제했다면 모드는 쉽게만들수있으니 읽어볼 것)
【3. SDK는 뭐고 왜 만들었냐】
SDK = 모드 만드는 사람용 "설명서 + 도구 상자"임
게임 폴더 안 wml\docs\SDK.md에 들어 있음
왜 만들었냐면
- 게임 코드는 압축돼 있어서 함수 이름이 _ , r8 , RDe 이런 식임
게다가 업데이트 때마다 이 이름이 전부 바뀜
-> 이게 모드가 업데이트마다 터지는 큰 이유라고 생각함.
- 그래서 "wife(아내)", "log(이야기 창)", "imagePrompt(그림 프롬프트)" 같은 사람이 읽을 수 있는 이름을 따로 붙여둠
모드는 이 이름만 쓰면 됨
-> 게임이 업데이트돼도 도구가 같은 함수를 찾아서 이름을 옮겨줌. 모드는 안 고쳐도 됨
- 여러 모드가 같은 함수에 끼어들 때 누가 먼저 하는지 규칙을 정해둠
-> 서로 결과를 덮어쓰거나 꼬이는 일이 줄어듦
- 설치기(cmd/ps1)를 따로 만들 필요가 없음
-> 모드 폴더를 zip으로 배포하면 끝임. 받는 사람은 폴더 넣고 끌어다 놓기 한 번
모드 하나가 대충 이렇게 생김
WML.define({
id: 'my-first',
name: '내 첫 모드',
setup(api) {
api.ui.addButton({ label: '★', onClick: () => api.log('헤에에 놀라워!') });
},
});
- 이게 기본모드제작법. 왼쪽 아래에 ★ 버튼 생기고 누르면 이야기 창에 한 줄 뜸
- 설명서에 예제 5개 있음 (팁 항아리, 아침 알림, 그림 프롬프트에 태그 넣기, 게임 버튼 옆에 버튼 더하기 등)
- 예제는 실제로 게임에 켜서 돌아가는 거 확인한 것만 넣었음
【4. MCP는 뭐냐】
요즘 Claude, ChatGPT(Codex) 같은 AI한테 다시키잔아(나도그렇고)
MCP는 AI 한테 해설지 주고 어어 그거대로 만들어 하는거라고 보는게 편함 (자세한건 검색해봐 나도몰류ㅜ..)
- MCP는 정해진 규격이라 Claude, Codex, Cursor, VS Code, Gemini 등 어디에 꽂아도 똑같이 됨
이걸 연결하고 AI한테 그냥 말로 하면 끗.
"손님 올 때마다 1골드씩 모아두는 팁 항아리 모드 만들어줘. 버튼 누르면 비우게. 시험까지 해줘"
그러면 AI가 알아서 이 순서로 함
1) 게임 코드에서 손님이 들어오는 함수를 찾음
2) 모드 파일을 만들고 작성함
3) 오류 날 데 없는지 검사함 (없는 이름 쓴 거, 다른 모드랑 겹치는 거까지)
4) 화면 없는 브라우저로 게임을 몰래 켜서 모드를 켜고 며칠 자동으로 플레이해봄
5) 오류 0인 거 확인하고 "쥬인님 다됐어요...♡"라고 알려줌
- AI가 게임을 돌려보고 확인함
- 시험할 때는 그림 생성 요청이랑 인터넷 연결을 다 막음. 평소 세이브도 안 건드림 (로컬환경에서 분리된 스토리지와 캐시에서 동작함)
- 화면 사진도 찍어서 보여줌
【5. 그래서 이거 쓰면 뭐가 좋냐】
▶ 플레이만 하는 사람
- 모드 여러 개 섞어도 덜 터짐(추측임ㅋㅋ)
- 켜고 끄기, 순서 바꾸기를 게임 안에서 클릭으로 함
- 모드 빼는 건 폴더 지우기 한 번. 쓸데없는 찌꺼기는 [삭제] 버튼으로 정리
- 필요한 모드나 충돌하는 모드는 알아서 알려줌
- 업데이트가 와도 금방 따라감
- 파일 가벼움 (3.6MB)
▶ 모드 만드는 사람
- 다른코드 신경안쓰고 내맘대로 만들어도됨.
- 업데이트 대응 개빠름
- 옛 9-30용 모드 옮기는 도구도 들어 있음
▶ 코딩 1도 모르는 사람
- MCP 연결해두면 AI한테 말로 모드를 시킬 수 있음
- 만들고, 검사하고, 실제로 돌려보는 것까지 AI가 다 함
- 나는 "이런 거 있으면 좋겠다"만 말하면 됨 (물론 AI결제는하셔야...!!)
【MCP 연결 방법 (모드 만들 사람만)】
1) Node.js 설치 (nodejs.org 에서 LTS 받으면 됨)
2) MCP 배포판(wml-mcp) 압축 풀기
3) 그 폴더에서 cmd 열고 npm install 한 번
(폴더 주소창에 cmd 치고 엔터하면 그 폴더에서 열림)
4) 아래 명령 치면 내 컴퓨터 경로가 다 들어간 연결 설정이 나옴. 쓰는 AI 앱 거 복붙하면 끝임
node config.mjs --wml "게임 폴더 경로"
- Claude Code는 명령어 한 줄, Codex는 설정 파일에 몇 줄 붙이면 됨
- 자세한 건 배포판 안 README.md에 다 써놨음
- 잘 붙었는지는 node selftest.mjs --wml "게임 폴더 경로" 돌려서 "모두 통과" 뜨면 됨
***사실 이것도 걍 mcp 받고 AI한테 “해줘” 하면 해주긴함 ㅋㅋ 토큰아까우면 직접설치 ㄱㄱ
【6. 젤다 & 구성】
- 한글판 (게임 + 모드 로더, 모드는 비어 있음) : wayward-wml-ko-2026-10-08-V0.7.0.zip
- 영문원본 (게임 + 모드 로더, 모드는 비어 있음) : wayward-wml-en-2026-10-08-V0.7.0.zip
- 모드팩 (모드 31개, 한글판이랑 같이 받기) : wml-mods-1.3.1.zip
- MCP 배포판 (모드 만들 사람만) : wml-mcp-0.4.1.zip
클릭)과거 젤다
젤다 기간한달 : aHR0cHM6Ly9raW8uYWMvYy9jMzR3c3pJaXdpTFNYV3AyMFRla2Vi
1.5v 번역 적용 ㅈㄷ기간한달 :aHR0cHM6Ly9raW8uYWMvYy9kb1dhMnZDT0ZJR0VIMlBIQmVla2Vi
패치내역참고»26-10-07
1.5 적용 및 자체 버전 업 1.0.2 : aHR0cHM6Ly9raW8uYWMvYy9jX1h6ZHpqazVCUXFMMVg3bERlQWVi
패치내역참고»26-10-07 PM 05:30
ㅈㄷ ㄱㄹ aHR0cHM6Ly9raW8uYWMvYy9iZ1BjUS1ZMzJlSWJuMW9tSWRmQWVi
최신업데이트 wml 10-08 업데이트 내역 상단 참고
wml 기본팩
ㅈㄷ ㄱㄹ ㅎㄷ aHR0cHM6Ly9raW8uYWMvYy9hY2ZlbWtSMk9RUXRYNXVmYUlnUWVi
모바일버전 배포 apk 파일이고 .tar를 모바일에 넣어서 불러오는 형태. + 이미지포함
모바일 통팩
ㅈㄷ ㄱㄹ ㅎㄷ aHR0cHM6Ly9raW8uYWMvYy9jMWo4LTBlYkdVUDZqWXg5Q2Rna2Vi
이미지 포함 올인원 통팩
이미지포함 pc 통팩
ㅈㄷ ㄱㄹ ㅎㄷ aHR0cHM6Ly9raW8uYWMvYy9jTWV6dGVCeFlPTC1mX0U0R0NnUWVi
최신업데이트 wml 10-12 업데이트 내역 상단 참고
wml 기본팩 및 모바일 mcp mod통팩 포함 이미지 X
ㅈㄷ ㄱㄹ ㅎㄷ aHR0cHM6Ly9raW8uYWMvYy9jUS0yU1ZyMEp4TUIxWmQ4bEZsa2Vi
이미지 포함된걸 받고싶다면 이미지포함된 과거 젤다를 받아서 최신에 씌우셈.. 다시올리기 빡세잉..
【8. 알아둘 점】
- 아직 베타에요우… 이상하면 WML 버튼에서 그 모드 끄고 새로고침 해보셈
- 창관,노예관 창 테두리가 게임 팝업 가리던 건 고쳐둠
- 웨이트리스랑 메이드관 같이 켜면 메이드 홀 서빙은 자동으로 꺼짐
- 영어가 섞여 나오면 왼쪽 아래 🔤 버튼 누르셈. 화면에 나온 영어가 모여 있음(이것도 모드팩에있음 모드팩안넣으면안뜸)
복사해서 댓글로 주면 다음 업뎃에 반영함(번역개념을 바꿔서 따로진행햇서.. 간혹안된게있우ㅜ)
- 그림 자동 생성(ComfyUI)은 원래 쓰던 방식 그대로 됨
- 옮긴 모드들은 원작 모드 그대로라, 모드 자체 버그는 원작이랑 같을 수 있음
궁금한 거나 터지는 거 댓글로 남겨주면 볼개..
아직 초안이라 문제있는 부분이 분명 있을거고 인기가 식어도 유지보수는 할테니 가능하면 하나의 프레임워크로
안터지는 모드생활을 해보도록하자..! 내가잘할게...!!
【요약】
▶ 세 줄 요약
1) 모드 로더만들었음
2) 모드 만드는 사람용 키트만듬 AI한테 말로 "이런 모드 만들어줘" 하면 만들고 시험까지 해주는 도구(MCP) 만들었음
3) 이제 쉽게 모드 받고 설치하고 버그나면 삭제하고 세이브데이터 덜터지고 뭐..그렇다..? (내 검증에선 그랫음 암튼그랫음)
세줄요약이지만 한줄만더..! :
원래 본인 모드만들던것도 mcp연결해서 “해줘” 라고 하면 딸각으로 포팅되니 모드만들고 계시는분들은 가능하면 사용해주시면 감사하겟읍니다.. wayward 공식디코에서도 이런거 만들었다고 콕콕 찔러보는중임
안되는거있으면 실시간 피드백 감사 최대한빨리수정함.
참조된 모드 및 번역 원게임글 목록 (추가중):
▶ 번역
1.5v 한글번역 (바닐라) — 손님 말투, 문장 교정
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvZDFsTmVrSmhuS0xJSDhfVk9zYUFlYj9wPTI=
[AI번역] Wayward v2026-09-30 v1.4 — 한글 번역 원본
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYVVBa2FyVzM4Q09kOVpkUGRhOTZhYg==
[개조판] Wayward MOD v3.41 — 처음 번역표를 뽑은 파일
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvZG5jdWtnWDFQMVJQMV9IdGFHWGthYg==
▶ 옮긴 모드
Mod 개조 Addon 통합본 — 배달, 웨이트리스, 임신·출산, 창관, 창관+임신 연동, 게임 에디터, 이미지 스튜디오, 새 아내 히나
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYlZ3R2RjbjJTdVJqdlpmd2xtNFFhYg==
Modstation 포함 버전 — 애드온 호환층
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYkx5d1Y2azhYclRTRDRQV1JhXzZhYg==
노예관·메이드관 애드온 통합 — 노예관, 메이드관, 손님 편집, 새 아내 미야비
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYkRyajd3Q0l0VUlrajVfemhOYmtlYg==
캐릭터 추가 애드온 — 새 아내 미야비의 캐릭터 추가 방식
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvY3pMZXRaclA3QVVGcjZPTVRiX2thYg==
에로스테-이벤트 추가 모드 1.6.1 — H Status, H Status+임신 연동, 캐릭터 외형 프롬프트
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYzNGbEtLT0tvRElicjROSFhwOTZhYg==
WAYWORKS v4.2 — WAYWORKS (창·단축키·통계·업적·치트)
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYURVUkMtUVlqalR2cjhBanNPX1FhYg==
커스텀 의상 애드온 — 의상 추가
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvY2ppekRseDU3Zk5idi1QUGRCOEFhYg==
의상 애드온 v1.1 업데이트 — 옮긴 건 v1.1
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYjZXLWFCaEtiUFZkUDlsMTZnYVFlYg==
디버깅 모드 — 판정 디버그, 손님 조종, 아내 수치 디버그
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvY1lyLS0xRFVTbVU5RDlWdzR0YlFlYg==
인게임 프롬프트 매니저 — 프롬프트 관리자, 프롬프트 태그 자동완성
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvY0NadUxCN1hTVExRdjFYcjJXXzZhYg==
프롬프트 후킹 애드온 v1.1 — 그림 요청 고치기
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvYXVPc0Jhb3FwMFIwcjNMbUtFODZhYg==
치트 테이블 (9/30 한글판 기반) — 치트 장부
aHR0cHM6Ly9rb25lLmdnL3Mvc29taXNvZnQvY1UtXzlFNkRaRkowNTNUYXl1YWtlYg==
s/somisoft
• 163,117 subscribers- 1. 게시물 규정 양식
업로드 시 링크 암호화 & 필수 정보를 기입할 것
- 2. 질문
국룰, 암호화 링크 등 기본사항 질문 금지, 탭 미준수시 차단 및 삭제
- 3. 요청
요청 기준 및 양식 미준수 & 댓글로만 자료 복구 요청 시 차단
- 4. 미성년자 / 근첩 / 페미 / 다중계정
조금이라도 의심되면 선 차단, 후 해명
- 5. 좆목 / 네임드화
닉언, 네임드화 등 친목질 금지
- 6. 분탕 및 어그로 / 혐짤 / 낚시 / 뇌절
해당 카테고리의 차단 기간 및 가중처벌은 처리자 재량으로 판단
- 7. 홍보 / 판촉 / 거래
허용되지 않은 모든 형태의 홍보, 거래, 교환, 조건부 공유 시 차단
- 8. 쌀먹 / 바이러스
조건부 공유 & 수익성 링크 & 고의적인 바이러스 유포 시 갱신차단
- 9. 자료 분류 / AI
미검수 시 표기 필수, 생성형 AI를 사용한 자료의 제목에 AI 미기입 시 차단
- 10. 실사 / 토들러
업로드시 갱신 차단
- 11. 기타 세부 규정은 서브 공지사항 참고