kone
wayward-
wayward-

마을 확장판 v0.8.30 기반 모드 (WML)

모드
14,411 views · 14 points

마을 확장판

town-expansion

선술집 밖으로 나가 마을에 진입할 수 있습니다.

다른 모드의 제작과 호환성을 위해 공통 API를 제공하는 기반 모드입니다.

※ 요구사항

Wayward-v2026-10-04_ko-v1.5

WML v0.8.0

외출 장소 이미지 보정 exterior-image-location 모드 비활성화 → 해당 모드 기능을 탑재하였습니다.

※ 시스템 - 마을 레이아웃

선술집 공간 외에 마을 레이아웃이 추가되었습니다.

1

선술집에서 아래 버튼을 통해 마을로 이동 가능합니다

1

1

마을 둘러보기 탭, 혹은 레이아웃 내 시설 칸을 클릭하여 마을 내부를 이동할 수 있습니다.

1

해당 각 장소가 연결 되어있을 때, 해당 장소로 이동 가능합니다.

※ 마을 확장판 시스템 - 변경사항

  • 아내가 선술집에서 외출하면 마을 레이아웃의 해당 시설에 아내가 위치합니다.

  • 일부 커맨드가 각 장소에 맞는 위치에 표시됩니다.

  • 지금 여기서 그녀에게 박기 커맨드가 사라집니다. (대신 속한 공간 자체에서 공개, 비공개 여부를 판정합니다)

1

위 커맨드는 모드 설정 내 선술집에서 비활성화할 수 있습니다. (기본적으로 활성화 해뒀습니다. 번거로울까봐)

  • 숲을 제외한 기본 바닐라 레이아웃들에서 성관계시 공개 H 판정을 부여합니다.

※ 마을 확장판 시스템 - 시설 건설, 업그레이드

1

시설 건설과 업그레이드에 금화와 노동력이 필요합니다.

노동력은 플레이어가 부업 행동을 할 때마다 1 오릅니다.

시설의 요구 사항이 0/0 일 경우 해당 시설이 즉시 활성화 됩니다.

시설을 커스텀하여 직접 넣을 수 있습니다. 해당 경로에 양식에 맞게 시설을 작성할경우, 마을 레이아웃에 해당 시설이 추가됩니다.

시설 업그레이드와 시설 내 커맨드 버튼을 생성할 수 있습니다.

* 모드로 커스텀한 시설 등록하기

아래에 작성된 지시문을 실행하면 대상 모드에 facilities 폴더가 생성되고 시설 js 파일이 생성됩니다.

그 후 게임을 새로고침하면 마을 확장팩이 자동으로 인식하고 불러옵니다.

* 모드 제작없이 독립 시설만 등록하기

town-expansion/facilities 경로에 해당 시설 js 파일을 추가하고 폴더 내 시설-목차갱신.cmd를 실행해주세요

※ 모드 연계

모더 여러분에게

자유롭게 호환 패치 하셔도 됩니다.

AI로 시설을 추가하고 호환시키기 원하시는 분들은 아래와 같이 요청하세요.

===============================================

현재 개발 중인 이 모드를 마을 확장판과 호환되도록 수정해줘.

마을 확장판의 AI_FACILITY_GUIDE.md를 먼저 읽고, 연결된 문서까지 확인해 현재 규격과 공개 API를 따라줘.

기존 모드의 기능과 저장 데이터를 보존하고, 마을 확장판 원본은 수정하지 마. 모든 시설은 우리 모드의 facilities 폴더에 시설별 JS 파일로 분리하고, 우리 모드에서 불러와 등록해.

기존 구현에서 시설 정보를 찾아 활용하고, 결정이 필요한 내용만 질문해줘. 구현 후 안내서의 검증 항목에 따라 검사하고, 변경한 파일과 검증 결과를 보고해줘.

====================================================

마을 확장판 모드의 기반 논리는 다음과 같습니다.

마을 레이아웃 생성

마을에서 나가기

아내가 자율 행동으로 이동하던 지역을 레이아웃에 도입

바닐라 장소 관련 명령을 마을 레이아웃에도 가능 하도록 함

시설 추가 혹은, 시설 변경

시설 간 이동

시설에 대한 정보 제공

※ 지원 API

API 영역

대표 API

제공하는 기능

시설 등록·조회

registerArea, getArea, listAreas

시설 생성과 이름·설명·배경 프롬프트·연결·단계별 정보 제공

시설 공개·사용 가능 여부

isAreaAvailable, isAreaVisible, setAreaVisibility

시설 사용 가능 여부와 지도 공개 상태 관리

플레이어 이동

move, reason

기존 시간·출입 조건·사건 처리를 따르는 이동과 차단 사유 조회

이동 확장

registerMovementInterceptor, registerTravelTimeModifier

다른 모드가 이동 조건과 소요 시간에 개입

이동 알림

registerArrivalObserver, registerNavigationObserver

도착·위치 변경을 다른 모드에 알림

인물 공통 경로 조회

getActorRoute, getActorMovementReason, getActorMovementMinutes, isActorAreaAvailable

NPC별 통행 가능 경로와 이동 시간 조회. 실제 NPC 이동은 인물 모드가 수행

내부 레이아웃

registerLayout, getLayout, getAreaLayout, getCurrentLayout, listLayoutAreas

시설 안의 여러 방과 현재 표시할 공간 묶음 제공

레이아웃 이동 조건·복구

getMovementReason, getLayoutFallback, subscribeLayouts

공간 사이 출입 조건·대체 위치·레이아웃 변경 알림

NPC 주택

registerResidence, getResidence

고유 주택과 내부 공간 등록·조회. 공동 주택도 연결 가능

집 방문 커맨드

registerResidenceVisitHandler, openResidenceVisit, listResidenceVisitCommands, residenceVisitReason, isResidenceEntrance

알려진 집에서 부르기·몰래 들어가기·집 들어가기 제공. 관계·침입 판정은 인물 모드에 위임

마을 밖 경계

registerWorldBoundary, getWorldBoundary, queryBoundaryRoute

마을과 외부 지역을 잇는 경계 등록·통행 조회. 기본 경계는 숲에 연결

숨겨진 공간 진입

registerHiddenEntrance, listHiddenEntrances, hiddenEntranceReason, enterHiddenArea

커맨드로만 들어가는 공간의 진입 버튼·조건·실행 연결

건설·업그레이드

construction, requestBuild, confirmBuild, startProject, addLabor, setConstructionStage, constructionReason, upgradeReason

비용 지불·노동력·공사 진행·완공 단계·업그레이드 조건 관리

장소 내 시설 칸

registerAreaSlot, listAreaSlots, getAreaSlot

장소 안에 작은 설비·설치물 칸과 행동 버튼 추가. 기존 공사 체계 사용

영업시간

getFacilityOpeningStatus, isFacilityOpen, facilityEntryReason, registerOpeningHoursException

영업 여부·입장 제한 조회와 거주자·관리자 등의 예외 연결. 미지정은 24시간

시설 태그

listFacilityTags, getFacilityTags, matchFacilityTags

공통 태그 목록·시설별 태그·NPC 태그 선호와의 일치 결과 제공

공간 공개성

getFacilityPrivacy

public·private 등 공간 자료 조회. 실제 목격자·동의 판정과는 별개

시설 직업 정보

listOccupationCategories, listOccupations, getOccupation, registerOccupationCategory, registerOccupation, getFacilityOccupations, findFacilitiesForOccupation

직업 목록 확장과 시설별 직업 연결·검색. NPC 고용·배정은 하지 않음

시설별 NPC 방문·커맨드 자료

registerNpcFacilityData, getNpcFacilityData, subscribeNpcFacilityData

방문 선호 조건·체류 시간·NPC 전용 행동·자동 수행·반복 제한 자료 등록. 판단과 실행은 인물 모드 담당

현재 위치의 인물 표시

registerOccupantResolver, registerOccupantVisibilityResolver

타 모드 NPC를 위치 레이아웃에 표시하고 표시 조건 연결

플레이어 행동 중계

registerActionHandler

사용자 정의 행동을 마을의 바닐라 dispatch 경로에 연결하여 실행 취소 지원

외부 아내 상호작용 조건

wifeInteractionReason

아내·플레이어·대상 손님의 위치에 따른 차단 사유 조회

설정·상태 조회

read, placeImagesEnabled, setPlaceImagesEnabled, tavernOutingsEnabled, setTavernOutingsEnabled, debugHiddenFacilities, setDebugHiddenFacilities

마을 공개 상태와 이미지·선술집 외출 버튼·디버그 설정 연결

API 영역

대표 API

제공하는 기능

시설 기본 소란도

getFacilityBaseBustle

시설 기본 소란도 조회. 미지정은 25, 명시한 0은 보존

소란도 지정 정보

getFacilityBaseBustleInfo

소란도 값·명시 여부·출처 조회. 다른 모드의 가산 보정에 활용

기존 주민 커맨드

getResidentFacilityCommands

기존 주민용 시설 행동 조회. 이전 소비 모드와의 호환 유지

공통 인물 연결

registerFacilityActorProvider

인물 소유 모드가 현재 인물 정보·위치·실제 근무 배정을 제공하도록 연결

공통 방문자 커맨드

getFacilityVisitorCommands

일반 주민과 NPC가 같은 방문자용 행동 정의를 사용하도록 지원. 정의가 없으면 ‘둘러보는 중’ 제공

시설 직무 등록

registerFacilityJob

시설의 직무와 업무 커맨드 등록. 실제 고용·인물 배정은 소유 엔진에서 처리

시설 직무 조회

getFacilityJobDefinitions

시설에 등록된 직무 정보와 해당 업무 커맨드 ID 조회

근무자 커맨드 조회

getFacilityWorkCommands

해당 시설에 실제 배정되어 현재 근무 중인 인물의 업무 커맨드 조회

공통 행동 정의 확장

registerNpcFacilityData

actorContract·facilityRole로 공통 방문자/근무자 행동을 명시. 기존 인물 전용 행동의 대상은 자동 확대하지 않음

※ 패치로그

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

알려진 집의 방문 메뉴에 인물 부르기·몰래 들어가기·집 들어가기 추가. 판정은 인물 모드에 위임. 인적드묾 태그와 선술집 홀 외 내부 공간의 private 정보 제공.

v0.8.4 26.10.15 22:18
  • 시설 자동 로드 : 대상 모드에 facilities 폴더가 존재하고 시설js파일이 저장된 상태라면 마을 확장판 모드가 자동으로 해당 시설을 로드합니다.

  • 모드 독립 시설 자동 읽기: 설정에서 facilities 폴더를 연결하면, 게임 시작·새로고침 시 파일 추가·수정·삭제를 반영합니다. 미지원 환경에서는 기존 목차 갱신 방식을 사용합니다. 독립 시설을 추가할 경우에만 해당되며 facilities 폴더 양쪽에 동일한 시설이 존재할 경우 오류가 발생할 수 있습니다.

  • 가족·지인 방문 위치 수정: 교차로 대신 주택가로 이동합니다. 기존 진행 중 방문도 위치를 보정합니다.

  • 추가 시설의 검은 화면 수정: 스킨십 이후 장면을 표시할 때 필요한 공간 정보를 마을이 자동 등록합니다. 새로 추가하는 시설에도 적용됩니다.

  • 시설 제작 안내서 정리: 시설별 파일 구성, order의 의미와 지정 규칙, 독립 모드 연결 방법을 명확히 했습니다.

링크 : aHR0cHM6Ly9raW8uYWMvYy9jS0VRejVMa3pxUjh6MkRUSHFEQWVi

비번 : 국룰

기간 : 1달

14
27 comments
동행 기능은 개발중이니 기다려주세요!
오 감사합니다 적어주신거 넣으면 호환가능한걸까여
새로고침하세요!
시설간 이동 너무 부럽습니다. 전 그냥 포기하고 랜덤인카운트로 집어넣어버렸는데
선술집 시설 기반으로 새 레이아웃 만들어 달라고 하니 해줬음
오케이 개발중인 bittersweet에 이것도 필수 모드로 포함해야겠다
잠시 ai 지시문 테스트하는데 바로 문제생김 지시문 교체중
갱신함
아이디어 건의 1. 손님이 선술집 오기전에 왔다갔다 하는걸 구현가능? 2. 만약가능하면 만난적있는 손님이면 일정거리내에서는 이름이보이고 멀어지거나 모르는손님이면 ? 로 표시가능한가? 3. 1,2가 가능한상태에서 피파도 이동 중 밀회장소에서 붙잡히거나 스스로 권유하는게 가능한가???
[deleted] (edited )

Deleted comment.

호환성 준비했으니 직접 만들어보기 ㄱㄱ
생각해봤는데 그렇게 하면 손님마다 고유 I'd 넣어야하고 손님 태그가 표시될텐데, 그렇게되면 마을 레이아웃이 난장판이 되서 난 시도안할듯
선생님, 맘껏 보여주기 모드랑 호환시켜도 되나요?
ㄱㅊㄱㅊ 마을 모드에서 충돌난다면 아마 시설의 공개h 판정 쪽 일거 같은데, 거기 체크 해보시면 될듯. getFacilityPrivacy public·private 등 공간 자료 조회. 실제 목격자·동의 판정과는 별개
[deleted] (edited )

Deleted comment.

선생님 제가 우리들의 마을 모드 + 마을 확장판 + wow를 동시에 결합중인데, 옷가게만 가면 "교차로"로 가지고, 거기서 옷을 골라야해서 이미지가 안뜨는 버그가 있습니다 ㅜㅜ 교차로에서 옷가게로 이동해도, 옷 구매가 안되네요. 저만 이런걸까요? 통합팩 만드는 중인데, 이런 "버그류"만 조금 수정해서 배포해도 될까요?
??? 진짜네. 왜 교차로로 가지. 즉시 패치 함. 동행으로 옷가게갔어서 몰랐음;;
아 사용량없지. 50분 뒤에 리필하니 해당 문제 픽스해서 업로드하겠음
업뎃함!
All
Title
Body