마을 확장판 v0.8.30 기반 모드 (WML)
마을 확장판
town-expansion
선술집 밖으로 나가 마을에 진입할 수 있습니다.
다른 모드의 제작과 호환성을 위해 공통 API를 제공하는 기반 모드입니다.
※ 요구사항
Wayward-v2026-10-04_ko-v1.5
WML v0.8.0
외출 장소 이미지 보정 exterior-image-location 모드 비활성화 → 해당 모드 기능을 탑재하였습니다.
※ 시스템 - 마을 레이아웃
선술집 공간 외에 마을 레이아웃이 추가되었습니다.
선술집에서 아래 버튼을 통해 마을로 이동 가능합니다
마을 둘러보기 탭, 혹은 레이아웃 내 시설 칸을 클릭하여 마을 내부를 이동할 수 있습니다.
해당 각 장소가 연결 되어있을 때, 해당 장소로 이동 가능합니다.
※ 마을 확장판 시스템 - 변경사항
아내가 선술집에서 외출하면 마을 레이아웃의 해당 시설에 아내가 위치합니다.
일부 커맨드가 각 장소에 맞는 위치에 표시됩니다.
지금 여기서 그녀에게 박기 커맨드가 사라집니다. (대신 속한 공간 자체에서 공개, 비공개 여부를 판정합니다)
위 커맨드는 모드 설정 내 선술집에서 비활성화할 수 있습니다. (기본적으로 활성화 해뒀습니다. 번거로울까봐)
숲을 제외한 기본 바닐라 레이아웃들에서 성관계시 공개 H 판정을 부여합니다.
※ 마을 확장판 시스템 - 시설 건설, 업그레이드
시설 건설과 업그레이드에 금화와 노동력이 필요합니다.
노동력은 플레이어가 부업 행동을 할 때마다 1 오릅니다.
시설의 요구 사항이 0/0 일 경우 해당 시설이 즉시 활성화 됩니다.
시설을 커스텀하여 직접 넣을 수 있습니다. 해당 경로에 양식에 맞게 시설을 작성할경우, 마을 레이아웃에 해당 시설이 추가됩니다.
시설 업그레이드와 시설 내 커맨드 버튼을 생성할 수 있습니다.
* 모드로 커스텀한 시설 등록하기
아래에 작성된 지시문을 실행하면 대상 모드에 facilities 폴더가 생성되고 시설 js 파일이 생성됩니다.
그 후 게임을 새로고침하면 마을 확장팩이 자동으로 인식하고 불러옵니다.
* 모드 제작없이 독립 시설만 등록하기
town-expansion/facilities 경로에 해당 시설 js 파일을 추가하고 폴더 내 시설-목차갱신.cmd를 실행해주세요
※ 모드 연계
모더 여러분에게
자유롭게 호환 패치 하셔도 됩니다.
AI로 시설을 추가하고 호환시키기 원하시는 분들은 아래와 같이 요청하세요.
===============================================
현재 개발 중인 이 모드를 마을 확장판과 호환되도록 수정해줘.
마을 확장판의 AI_FACILITY_GUIDE.md를 먼저 읽고, 연결된 문서까지 확인해 현재 규격과 공개 API를 따라줘.
기존 모드의 기능과 저장 데이터를 보존하고, 마을 확장판 원본은 수정하지 마. 모든 시설은 우리 모드의 facilities 폴더에 시설별 JS 파일로 분리하고, 우리 모드에서 불러와 등록해.
기존 구현에서 시설 정보를 찾아 활용하고, 결정이 필요한 내용만 질문해줘. 구현 후 안내서의 검증 항목에 따라 검사하고, 변경한 파일과 검증 결과를 보고해줘.
====================================================
마을 확장판 모드의 기반 논리는 다음과 같습니다.
마을 레이아웃 생성
마을에서 나가기
아내가 자율 행동으로 이동하던 지역을 레이아웃에 도입
바닐라 장소 관련 명령을 마을 레이아웃에도 가능 하도록 함
시설 추가 혹은, 시설 변경
시설 간 이동
시설에 대한 정보 제공
※ 지원 API
API 영역 | 대표 API | 제공하는 기능 |
|---|---|---|
시설 등록·조회 |
| 시설 생성과 이름·설명·배경 프롬프트·연결·단계별 정보 제공 |
시설 공개·사용 가능 여부 |
| 시설 사용 가능 여부와 지도 공개 상태 관리 |
플레이어 이동 |
| 기존 시간·출입 조건·사건 처리를 따르는 이동과 차단 사유 조회 |
이동 확장 |
| 다른 모드가 이동 조건과 소요 시간에 개입 |
이동 알림 |
| 도착·위치 변경을 다른 모드에 알림 |
인물 공통 경로 조회 |
| NPC별 통행 가능 경로와 이동 시간 조회. 실제 NPC 이동은 인물 모드가 수행 |
내부 레이아웃 |
| 시설 안의 여러 방과 현재 표시할 공간 묶음 제공 |
레이아웃 이동 조건·복구 |
| 공간 사이 출입 조건·대체 위치·레이아웃 변경 알림 |
NPC 주택 |
| 고유 주택과 내부 공간 등록·조회. 공동 주택도 연결 가능 |
집 방문 커맨드 |
| 알려진 집에서 부르기·몰래 들어가기·집 들어가기 제공. 관계·침입 판정은 인물 모드에 위임 |
마을 밖 경계 |
| 마을과 외부 지역을 잇는 경계 등록·통행 조회. 기본 경계는 숲에 연결 |
숨겨진 공간 진입 |
| 커맨드로만 들어가는 공간의 진입 버튼·조건·실행 연결 |
건설·업그레이드 |
| 비용 지불·노동력·공사 진행·완공 단계·업그레이드 조건 관리 |
장소 내 시설 칸 |
| 장소 안에 작은 설비·설치물 칸과 행동 버튼 추가. 기존 공사 체계 사용 |
영업시간 |
| 영업 여부·입장 제한 조회와 거주자·관리자 등의 예외 연결. 미지정은 24시간 |
시설 태그 |
| 공통 태그 목록·시설별 태그·NPC 태그 선호와의 일치 결과 제공 |
공간 공개성 |
|
|
시설 직업 정보 |
| 직업 목록 확장과 시설별 직업 연결·검색. NPC 고용·배정은 하지 않음 |
시설별 NPC 방문·커맨드 자료 |
| 방문 선호 조건·체류 시간·NPC 전용 행동·자동 수행·반복 제한 자료 등록. 판단과 실행은 인물 모드 담당 |
현재 위치의 인물 표시 |
| 타 모드 NPC를 위치 레이아웃에 표시하고 표시 조건 연결 |
플레이어 행동 중계 |
| 사용자 정의 행동을 마을의 바닐라 dispatch 경로에 연결하여 실행 취소 지원 |
외부 아내 상호작용 조건 |
| 아내·플레이어·대상 손님의 위치에 따른 차단 사유 조회 |
설정·상태 조회 |
| 마을 공개 상태와 이미지·선술집 외출 버튼·디버그 설정 연결 |
API 영역 | 대표 API | 제공하는 기능 |
|---|---|---|
시설 기본 소란도 |
| 시설 기본 소란도 조회. 미지정은 25, 명시한 0은 보존 |
소란도 지정 정보 |
| 소란도 값·명시 여부·출처 조회. 다른 모드의 가산 보정에 활용 |
기존 주민 커맨드 |
| 기존 주민용 시설 행동 조회. 이전 소비 모드와의 호환 유지 |
공통 인물 연결 |
| 인물 소유 모드가 현재 인물 정보·위치·실제 근무 배정을 제공하도록 연결 |
공통 방문자 커맨드 |
| 일반 주민과 NPC가 같은 방문자용 행동 정의를 사용하도록 지원. 정의가 없으면 ‘둘러보는 중’ 제공 |
시설 직무 등록 |
| 시설의 직무와 업무 커맨드 등록. 실제 고용·인물 배정은 소유 엔진에서 처리 |
시설 직무 조회 |
| 시설에 등록된 직무 정보와 해당 업무 커맨드 ID 조회 |
근무자 커맨드 조회 |
| 해당 시설에 실제 배정되어 현재 근무 중인 인물의 업무 커맨드 조회 |
공통 행동 정의 확장 |
|
|
※ 패치로그
v0.8.30 26.10.26 08:07
특정 공사의 노동력 투입을 일시정지하는 API 추가
기존 공사를 보존하면서 우선 공사를 착공할 수 있는 기능 추가
일반 건설의 동시 공사 제한은 유지
v0.8.29 26.10.26 02:18
마을 확장판 0.8.21 → 0.8.29 통합 패치로그
컨텐츠·기능 추가
시설에서 기다리기 추가
마을 시설·커스텀 시설·주택 내부에서 1분·5분·15분 대기 가능.
사건이나 플레이어 참여 장면이 발생하면 대기 중단.
디버그 즉시 완공 추가
마을 설정에서 미건설 시설과 진행 중인 공사를 무료로 완공.
진행 중인 증축은 해당 단계까지만 완료하며 실행 취소 지원.
시설 칸의 효과 표시 추가
설치된 시설 칸을 누르면 설명과 현재 적용 중인 효과 표시.
행동 버튼이 없는 시설도 설명·효과가 있으면 펼쳐보기 가능.
연결 경로 자동 귀환 추가
선술집으로 돌아갈 때 연결된 시설을 차례로 경유.
구간별 이동 시간 적용, 사건 발생 시 중단·재개 지원.
다른 모드를 위한 공통 API 확장
시설별 행동 카테고리 등록.
마을회의 등 외부 모드가 시설 건설·증축을 관리하는 건설 담당 API.
시설 기능을 식별하는
roles자료와 현재 단계 역할 조회.등록된 마을 밖 경계 목록 조회.
일반 수정·UI 개선
옷가게는 시장, 치유소는 주택가를 통해 이동하도록 연결 변경.
현재 위치는 주황색, 이동 가능한 연결 시설은 청록색 테두리로 구분.
연결됐지만 출입할 수 없는 시설은 흐린 테두리로 표시하고 제한 사유 안내.
‘이동 가능’ 글씨를 제거하고 색상으로만 표시하도록 정리.
미건설 시설은 지도에 ‘미건설’만 표시하도록 간소화.
건설 조건·필요 금화·노동력·설명은 마우스를 올리거나 클릭한 상세 정보에서 표시.
이동·쇼핑·대화 중 대기 버튼이 중복 표시되지 않도록 처리.
자동 귀환의 남은 경로와 이동 시간을 저장·불러오기 및 실행 취소로 복원.
귀환 도중 경로가 막히거나 다른 모드가 위치를 변경하면 안내 후 자동 귀환 중단.
원격 아내 이벤트로 이동이 멈춰 행동할 수 없게 되는 상황 재검증.
시설 제작 안내서·템플릿·API 문서와 WOW 모더용 연계 자료 갱신.
※ WOW 관련 변경은 연계를 위한 기반 지원입니다. WOW의 이동 중 사건 인계 문제는 별도 확인 사항이며, 완전 호환 패치에는 포함되지 않습니다.
v0.8.20 26.10.22 23:01
0.8.20
시설 기본 소란도(
baseBustle)와 조회 API 추가.일반 주민용 시설 커맨드 조회 지원.
해당 커맨드가 없으면 효과 없는 ‘둘러보는 중’을 기본 제공.
선술집에서 시작한 전단 붙이기·행인에게 인사하기에 선술집 귀환 / 교차로 잔류 선택 추가. 기본값은 선술집이며, 활동 중에도 변경 가능.
교차로에서 시작한 홍보는 기존처럼 교차로에 잔류.
옷가게 방문 시 플레이어와 아내의 위치가 갈라지는 문제 수정.
옷가게에 직접 들어갔을 때 바닐라 쇼핑을 시작할 수 있도록 버튼 복구.
일반 주민과 NPC가 함께 사용할 공통 방문자 커맨드 API 추가. 기존 인물 전용 행동은 자동 확대하지 않음.
시설 직무 정의와 실제 근무 자격을 구분하는 업무 API 추가.
소란도 미지정 기본값 25, 명시한 0은 보존. 지정 여부 조회 API 추가.
바닐라 시설별 소란도 배정은 주민 출현 모드로 이관하고, 다른 모드의 보정은 가산 방식으로 정리.
시설 제작 안내서 갱신 및 쇼핑·건설·귀환·실행 취소·주민 연계 회귀 검사 완료.
v0.8.18 26.10.19 20:33
별도 공개 성관계 버튼 제거: ‘지금 여기서 그녀에게 박기’를 모든 장소에서 숨깁니다.
일반 커맨드에 공개 판정 적용:
public시설에서는 일반 성관계 커맨드도 바닐라의 공개 성관계 판정(sex_public)을 사용합니다.사적 공간은 일반 판정 유지:
private시설과 선술집 내부 방은 기존 일반 판정을 사용합니다. 선술집 홀은 영업 중·마지막 주문 시간에만 공개 판정입니다.타 NPC용 공통 API 추가:
publicIntimacyCategory()를 제공해 NPC 시뮬레이터도 같은 기준에 연결할 수 있습니다.밀회의 장소에 있던 관련 버튼 제한을 마을 쪽으로 옮겼습니다.
v0.8.17 26.10.18 18:18
버전 | 주요 변경 |
|---|---|
0.8.5 | 시설 폴더 찾아보기·권한 요청·자동 읽기 제거. 시설 모드가 직접 등록하는 방식으로 정리. 추가 시설에서 스킨십 후 검은 화면이 발생하던 오류 수정. |
0.8.6~0.8.7 | 숨겨진 공간 진입 커맨드와 디버그 표시 지원. NPC 주택·내부 공간·마을 외부 경계 연결 기반 정비. |
0.8.8 | 시설 영업시간·공통 태그·태그 선호 연결 API 추가. 영업시간 미지정은 24시간, 거주자·관리자 예외 지원. |
0.8.9 | 기본 시설과 주택 내부에 태그 부여. 기본 주택에 화장실 추가, 개별 주택 설정 보존. |
0.8.10 | 숲에 기본 마을 밖 경계 연결. 다른 모드가 외부 지역을 연결할 API 제공. |
0.8.11 | 다른 모드가 건설·노동력·업그레이드를 처리할 공사 API 추가. 반복 계산 최적화. |
0.8.12 | 공통 직업 144종과 시설별 직업 정보 등록·조회 지원. |
0.8.13 | 장소 내부에 설비·설치물 등 작은 시설 칸을 추가하는 API 도입. 기존 건설 체계와 연결. |
0.8.14 | 다른 모드 NPC의 위치 태그 표시 조건을 연결하는 API 추가. |
0.8.15 | 아내의 자율 이벤트 때문에 플레이어 이동이 멈추던 문제 수정. 실제 플레이어 개입 여부에 따라 구분. |
0.8.16 | NPC별 이동 경로·통행 조건·소요 시간 조회 API 추가. 선술집 내부와 주택 경로 지원. |
0.8.17 | 알려진 집의 방문 메뉴에 인물 부르기·몰래 들어가기·집 들어가기 추가. 판정은 인물 모드에 위임. |
v0.8.4 26.10.15 22:18
시설 자동 로드 : 대상 모드에 facilities 폴더가 존재하고 시설js파일이 저장된 상태라면 마을 확장판 모드가 자동으로 해당 시설을 로드합니다.
모드 독립 시설 자동 읽기: 설정에서
facilities폴더를 연결하면, 게임 시작·새로고침 시 파일 추가·수정·삭제를 반영합니다. 미지원 환경에서는 기존 목차 갱신 방식을 사용합니다. 독립 시설을 추가할 경우에만 해당되며 facilities 폴더 양쪽에 동일한 시설이 존재할 경우 오류가 발생할 수 있습니다.가족·지인 방문 위치 수정: 교차로 대신 주택가로 이동합니다. 기존 진행 중 방문도 위치를 보정합니다.
추가 시설의 검은 화면 수정: 스킨십 이후 장면을 표시할 때 필요한 공간 정보를 마을이 자동 등록합니다. 새로 추가하는 시설에도 적용됩니다.
시설 제작 안내서 정리: 시설별 파일 구성,
order의 의미와 지정 규칙, 독립 모드 연결 방법을 명확히 했습니다.
링크 : aHR0cHM6Ly9raW8uYWMvYy9jS0VRejVMa3pxUjh6MkRUSHFEQWVi
비번 : 국룰
기간 : 1달
Deleted comment.
Deleted comment.
s/wayward-wml
• 3,512 subscribers- 1. 게시물 규정 양식
업로드 시 링크 암호화
- 2. 미성년자 / 근첩 / 페미
조금이라도 의심되면 선 차단, 후 해명
- 3. 분탕 및 어그로 / 혐짤 / 낚시 / 뇌절
차단
- 4. 링크 기준
트퍼잇 키오만 허용 나머진 전부 차단
- 5. 호출 및 신문고
처리가 완료되거나 끝난경우엔 삭제 조치함.
- 6. 질삭
질문해두고 내용의 변경, 삭제 등 7일정지.