[WAYWORKS — 창 배치·단축키·통계·업적·치트 통합 프레임워크] [v4.2] (Wayward 2026-09-30 v1.4)
Wayward v2026-09-30 v1.4 버전:
https://kone.gg/s/somisoft/aUAkarW38COd9ZdPda96ab
인스톨러, 통합 설치 완료 되어있는 html (한달 2026-11-02 15:37) (10-03 16:05 이전에 받으신 분은 새로 받아 주세요) :
aHR0cHM6Ly9raW8uYWMvYy9jSm9SV3g1cnlMVHdiWnZ3d3Vha2Vi
ㅂㅂㄱㄹ
일반 사용자는 통합 설치 되어있는 .html파일 하나만 받으셔도 됩니다.
게임을 하다가 “오늘은 어디서 돈을 벌었지?”, “빚은 얼마나 줄었지?”, “이 손님과 무슨 일이 있었더라?” 싶어서 시작한 모드입니다.
실시간 수치 편집, 플레이 통계, 경영 업적에 자유로운 창 배치와 단축키 설정까지 한 패키지로 묶었습니다.
필요한 기능만 골라 설치할 수 있습니다.
기능이 많아 설명이 너무 길어져 간단하게만 적겠습니다. 직접 플레이 해보시며 찾아가는게 좋습니다.
1.치트, 2.통계, 3.업적, 4.윈도우 프레임워크, 5. 단축키 프레임워크 순으로 설명하겠습니다.
지원 대상: Wayward 2026-09-30 한국어판 v1.4 (1.3 기반이라 1.3에도 적용 될겁니다.)
설치 환경: Windows PC
순정 게임에 설치하는 모드입니다. 별도의 Wayward MOD v2.x 기반 모드를 먼저 설치할 필요는 없습니다.
모딩을 하실 때 제 프레임 워크를 쓰시려면 설명 후의 개발자 노트와 각 기능의 프레임워크 적용 지시를 ai에 넣어 주시면 됩니다.
=====================================================
업데이트 이력 : v4.2
카테고리화
단축키 버튼이 불필요하게 나누어졌는데, 다음 업데이트 쯤 단축키 설정으로 몰아 따로 뺄 예정입니다.
주인공 관련
주인공 숙련도
배우자 관련
배우자 추가 능력치, 가중치
특성 탭 추가
의상 언락
당신의 뜻에 대한 인식: 행동
당신의 뜻에 대한 인식: 손님
당신의 뜻에 대한 인식: 부부
가게 관련
약초 재료 재고
물약 재고. 다음 업데이트 물약 생성기 만들 예정입니다.
가게 업그레이드
시스템
추가 배율
통계
손님 분석 < > 손님 장부의 밀접한 연계
윈도우 워크프레임
작업 공간에서 창을 열면 작업공간에 창이 생깁니다.
=====================================================
이슈 : 윈도우 프레임워크가 정상적으로 작동 되지 않거나, 복사 붙혀넣기 등이 안먹힐 경우 엣지/크롬 등 브라우저를 작업관리자에서 완전히 종료후 다시 켜주세요.
=====================================================
1. 실시간 치트 — WW Cheat
플레이어와 배우자의 상태, 능력치, 관계 수치, 골드와 물자 등을 한 창에서 확인하고 조절할 수 있습니다.
숫자 입력과 지원 항목의 슬라이더 조절
실시간 수치 갱신
선택한 값의 세션 고정
항목별 접기·펼치기
치트와 치트 단축키를 각각 켜고 끄기
게임 행동과 치트 변경을 실행 역순으로 되돌리기
슬라이더를 한 번 움직인 것은 한 건의 변경으로 묶습니다. 값 고정이 자동으로 재적용되는 것은 취소 기록을 계속 쌓지 않습니다.
기본 치트 단축키는 다음과 같습니다. 뒤에 설명할 단축키 프레임워크로 변결하실 수 있습니다.
키 | 기능 |
|---|---|
4 | 플레이어 기력 100 / 피로도 0 / 마나 최대 |
5 | 배우자 기력 100 |
6 | 배우자 기분 100 |
7 | 배우자 흥분도·매혹 100 |
8 | 식량·맥주·와인 각각 +100 |
9 | 골드 +100 |
Backspace | 마지막 게임 행동·치트 변경 되돌리기 |
입력칸에서 Backspace를 누르면 텍스트만 지워집니다.
2. 통계와 장부 — WW Observer
통계 화면은 아래 8개 탭으로 구성되어 있습니다.
개요: 오늘 수입, 보유 골드, 빚, 응대한 손님 등 핵심 현황
수입 분석: 팁·접객·유료 제안·심부름·기타 수입의 구성과 추이
손님 분석: 응대·놓침 등 게임에 기록된 손님 관련 지표
부부 관계: 관계 변화와 대화·스킨십 등 함께한 행동 기록
장사 기록: 기록된 날짜별 운영 현황
업적: 경영 업적의 조건, 진행도, 달성 여부
손님 장부: 손님별 프로필, 배경 태그, 관계와 만남 기록
은밀한 기록: 플레이어·손님과의 만남 및 행동 기록 분석
빠르게 확인하는 간단 보기와 정보를 더 깊게 살펴보는 상세 분석을 제공합니다.
기간별 통계는 3일 / 7일 / 30일 / 전체로 전환할 수 있습니다. 수입뿐 아니라 골드·빚·순자산의 변화도 볼 수 있고, 그래프에는 수치와 기간 정보가 함께 표시됩니다.
과거 날짜는 확정된 기록으로, 현재 날짜는 진행 중인 실시간 값으로 구분합니다. 은밀한 기록은 핑크 계열로 표시해 일반 경영 통계와 구분했습니다.
단, 설치 이전에 사라진 기록을 추측해서 만들어내지는 않습니다. ‘전체’는 확인 가능한 기록의 전체 기간을 뜻합니다.
3. 경영 업적 20개
재정 성장, 매출, 접객, 수입 구성, 꾸준한 경영을 주제로 한 공개 업적 20개가 들어 있습니다.
예를 들면:
순자산이 0g 이상이 되는 적자 탈출
하루 총수입 200g을 기록하는 대박 난 하루
누적 접객 손님 100명을 달성하는 단골집
확정된 3일 연속으로 하루 수입 100g 이상을 기록하는 안정된 장사
업적을 달성하면 통계 창을 닫아두어도 화면 왼쪽 위에 알림이 나타납니다. 여러 업적을 동시에 달성해도 알림은 겹치지 않고 순서대로 표시됩니다.
정확한 달성 조건은 동봉된 WW_Observer_Achievements.txt에서 확인할 수 있습니다. 치트와 업적을 함께 사용할 수 있으며, 경쟁·인증용 업적 시스템은 아닙니다.
AI에게 업적명과 조건을 주고 업적을 추가해 달라고 부탁하시면 됩니다. 사실 이거에 대해서는 커뮤니티화를 할까 싶기도 합니다. 예를 들면 ‘WAYWORKS 업적 게시물’에 댓글로 업적명과 조건을 달고 ‘나는 이런거 만들었다!’하고 공유하는 것이죠.
4. 창을 원하는 위치에 배치
좌측에 도킹한 모습
하나는 도킹, 하나는 플로트 창으로 띄운 모습
ㄴ자, ㄱ자로 도킹한 모습
각 창이 아닌 탭으로 합친 모습 (상단 통계, 치트가 탭으로 합쳐진 것 확인해주세요)
세컨 윈도우로 띄운 모습 (더 많은 윈도우도 가능합니다)
세컨 윈도우 에서도 도킹, 탭이 가능 합니다.
탭 옆의 마름모를 누르면
화면 좌측에 숨습니다.
클릭하면
임시 창으로 나옵니다. 언리얼 에디터에서의 핀 고정 안되어있는 창, 컨트롤+스페이스를 누르면 임시 콘텐츠 브라우저가 열리는 것을 참고하였습니다.
치트나 통계 창을 게임 화면 위에 띄우거나 가장자리에 붙여 사용할 수 있습니다. 손쉽게 드래그를 해서 옮길 수 있으며,
위의 통계와 ww치트가 있는 탭 위치가 아닌, 아래 WW치트 만 써져있는 부분을 클릭해 드래그 해주세요.
드래그 중에는 화면 중앙 옵션이 뜹니다.
원하는 위치로 가져가져도 되고
가운데 띄워진 메뉴로 가져가셔도 됩니다.
창 이동과 크기 조절
위·아래·왼쪽·오른쪽 도킹
탭 묶기와 분할 배치
자동 숨김
별도 브라우저 창으로 분리하고 본창으로 돌아오기
레이아웃 저장과 복구
다른 모니터에 통계 창을 띄워두고 플레이하는 식으로도 사용할 수 있습니다. 외부 창이 열리지 않으면 브라우저의 팝업 차단 설정을 확인해 주세요.
분리 대상은 모드 창입니다. 게임 본화면 자체를 외부 창으로 옮기는 기능은 아닙니다.
게임 본 화면은 바로 뺄 수 없게 복잡하게 되어있더라구요. wayward.game.surface라는 특수 Surface로 float:false, popout:false이고, 코드에도 “원본 게임 이동/복제는 제공하지 않는다”고 명시돼어 있습니다.
추후 찬찬히 생각해보겠습니다.
모더님들도 쓸 수 있게 프레임워크화 시켜놓았습니다.
5. 원본 게임 단축키도 설정 가능
원본의 1·2·3, Enter, W/C/F/T/S/N/A, Esc도 단축키 설정에 포함했습니다.
원본 게임 단축키와 추가 모드 단축키는 가로줄로 구분되어 있으며, 변경·초기화·해제가 가능합니다. 키를 바꾸면 게임 버튼의 단축키 안내도 갱신됩니다.
부업이나 낮잠 중에 같은 키가 다른 행동을 하는 원본의 조건은 유지합니다. 하위 메뉴 취소나 창 닫기용 Esc, 입력창에서 사용하는 키는 별도로 유지됩니다.
추후 단축키를 넣으실 모더분들도 단축키를 추가할 수 있게 프레임워크화 시켜놓았습니다.
설치 방법
설치 전에는 게임 내 저장 내보내기로 세이브도 백업해 주세요.
ZIP의 모든 파일을 게임 HTML과 같은 폴더에 풉니다.
WW_Install.cmd를 실행하고 1 설치·업데이트를 선택합니다.설치할 기능을 선택합니다. 필요한 공용 기능은 자동으로 함께 설치됩니다.
게임을 열거나 이미 열려 있는 탭을 새로고침합니다.
원하는 HTML을 WW_Install.cmd 위로 끌어다 놓아 직접 지정할 수도 있습니다. 관리자 권한은 필요하지 않습니다.
설치할 때 코드를 HTML에 내장하므로, 플레이할 때 설치기나 별도 모드 스크립트를 실행할 필요는 없습니다. 기존 게임의 이미지 팩과 images 폴더는 원래 위치에 유지해 주세요.
백업·제거·주의사항
설치·제거 직전 HTML 백업이 생성됩니다.
WW_Remove.cmd는 선택한 모드의 설치 블록을 제거합니다.WW_Restore.cmd는 HTML 전체를 백업 시점으로 되돌립니다. 백업 이후의 다른 HTML 수정도 함께 되돌아갑니다.HTML 백업은 세이브 백업과 다릅니다.
치트 변경의 되돌리기 기록은 실행 중인 세션용입니다. 새 게임·불러오기·새로고침 이후에는 지난 세션의 치트 이력을 복구하지 않습니다.
지원 대상과 다른 게임 버전이나 변형본은 설치가 중단될 수 있습니다. 다른 모드와의 모든 조합 호환을 보장하지는 않습니다.
모바일은 이번 PC 배포판의 검증 범위에 포함되지 않습니다.
기존 치트·통계·업적, 저장 불러오기, 설치·제거 등을 포함한 자동 검사 13개를 통과했습니다. 다만 실제 다중 모니터와 화면 배율, 브라우저별 외부 창 동작은 사용 환경에 따라 추가 확인이 필요합니다.
문제가 생기면 게임 버전, 브라우저, 설치한 기능, 재현 순서와 오류 내용을 함께 알려주시면 확인에 도움이 됩니다.
이 밑으로는 안 읽으셔도 됩니다.
=========================================================================================
WAYWORKS 개발자 노트 — 모듈 구조와 확장 원칙
WAYWORKS 개발자 노트 — 모듈 구조와 확장 원칙
이 노트는 Wayward 2026-09-30 한국어판 v1.4에 대응한 WAYWORKS RC3.1 패키지를 기준으로 작성했습니다.
WAYWORKS는 치트·통계·업적을 제공하면서, 다른 기능에서도 재사용할 수 있도록 창 관리와 입력 처리, 상태 변경, 기록과 판정을 분리한 구조입니다.
게임별 연결 부분은 별도 Adapter/Bridge에 두고, 공용 기능이 게임 내부 구현에 직접 의존하는 범위를 줄였습니다.
1. 모듈별 책임
모듈 | 역할 |
|---|---|
WWWindow | 창 이동·크기·도킹·탭·분할·외부 창·레이아웃 |
WWKeybind | 키 설정·충돌 검사·입력 문맥·명령 실행 연결 |
WWAction | 상태 변경 기록과 시간순 Undo |
WWGameRuntime | 원본 Game Store와 공용 연결 |
WWCheat | 수치 편집·회복·물자 추가·세션 고정 |
WWStatistics | 통계 수집·일별 확정·관계 커맨드·장기 기록 |
WWAchievement | 업적 정의·평가·저장·해금 이벤트 |
WWObserver | 통계·장부·업적을 보여주는 화면 |
설치 의존성은 다음과 같습니다.
Cheat → Action + Keybind
Action → Runtime
Statistics → Runtime
Achievement → Statistics
Observer → Statistics + Window통계 기록장치는 창이 없어도 동작합니다. 업적은 통계를 소비하지만, 통계 기록장치는 업적 엔진에 의존하지 않습니다.
따라서 치트 없이 통계와 업적을 사용하거나, 업적 없이 통계 화면만 사용하는 구성이 가능합니다.
2. Window / Keybind Public API v1
이번 업데이트에서도 Window와 Keybind 코어는 이전 RC2의 파일을 그대로 유지했습니다.
원본 게임 단축키 추가는 공용 입력 코어를 수정하는 대신 게임 전용 등록·연결 모듈로 처리했습니다.
확장 기능은 다음 원칙을 권장합니다.
창 내부 구조를 직접 수정하지 않고 공개 패널 등록 API를 사용합니다.
키 입력은 기능별 전역 이벤트 리스너를 추가하기보다 WWKeybind에 Action을 등록합니다.
패널과 명령에는 충돌하지 않는 ID 및 소유자 정보를 지정합니다.
외부 창으로 이동할 수 있으므로 전역
document보다 제공된 host/context의 문서를 사용합니다.이벤트·타이머·문서 연결은 패널 해제와 종료 시 정리합니다.
Public API v1만으로 처리할 수 없는 부분은 별도 Adapter로 격리합니다.
창 프레임워크는 기능의 내용을 결정하지 않습니다. 통계 화면은 창의 배치 방식을 관리하지 않습니다.
3. 원본 게임 단축키 연결
원본 명령 12종은 owner wayward.game, ID wayward.native.*로 등록했습니다.
게임 전용 연결 파일은 다음 두 개입니다.
WW_Game_Keybind_Actions.jsWW_Game_Keybind_Bridge.js
행동 가능 여부는 원본 선택 함수를 재사용하고, 실제 실행은 원본 Store의 dispatch로 전달합니다. 부업·낮잠의 문맥별 처리도 유지합니다.
기존 하드코딩 키 핸들러에는 제거 가능한 소유 guard를 넣어, 키를 재지정한 뒤 이전 키가 함께 실행되는 경로를 막았습니다. 하위 메뉴의 Esc 취소는 유지합니다.
설정 화면에서는 원본과 모드 명령을 구분하지만, 충돌 검사는 같은 입력 체계에서 처리합니다. 원본 명령은 게임 본창에서만 실행하며, 외부 모드 창의 입력이나 창 닫기 동작과 섞지 않습니다.
4. 상태 변경과 Undo
WWAction은 원본 게임의 Store와 undoStack을 제거하거나 복제하지 않습니다. 게임 행동과 되돌릴 수 있는 치트 변경을 하나의 실행 순서로 연결합니다.
게임 행동과 치트 변경을 역순으로 되돌립니다.
슬라이더의 연속 조작은 하나의 gesture로 묶습니다.
Freeze의 자동 재적용은 변경 기록을 생성하지 않습니다.
현재 값이 예상한 변경 결과와 다르면 안전을 위해 Undo를 거부할 수 있습니다.
치트 변경 이력은 세션용이며 최대 1,000건입니다.
불러오기·새 게임·새로고침 이후의 과거 치트 이력을 추측 복원하지 않습니다.
추가 기능에서 게임 상태를 편집한다면 직접 값을 덮어쓰기보다 WWAction의 변경 경로를 사용하는 편이 공용 Undo와 일관됩니다.
5. 통계와 업적의 저장 원칙
화면은 확정된 과거 기록 + 현재 상태의 Live Snapshot을 합쳐 표시합니다. 현재 날짜를 확정 History에 계속 덮어쓰는 방식으로 처리하지 않습니다.
하루 종료 시에는 다음 순서로 처리합니다.
통계 확정 → 업적 평가 → 원본 하루 자동 저장기존 업적 저장 위치는 유지합니다.
state.modData.wwObserver.achievements알 수 없는 미래 버전의 저장 구조를 임의로 덮어쓰지 않으며, 기존 저장 이행에서도 증명되지 않은 과거 기록을 생성하지 않습니다.
원본에 남아 있는 최근 기록은 초기 자료로 활용할 수 있지만, 이미 사라진 행동이나 과거 달성은 복원 대상으로 간주하지 않습니다.
장기 만남 기록은 누적 요약과 상세 기록을 구분합니다. 상세 기록은 최대 5,000건으로 제한하며, 기록된 누적 요약은 상세 기록이 잘려도 유지하도록 설계했습니다. 따라서 ‘전체 기간’과 ‘모든 원시 기록의 무제한 보관’은 같은 의미가 아닙니다.
6. 업적 확장
업적은 현재 상태, 확정된 하루 기록, 누적·연속·복합 조건을 평가할 수 있습니다. 현재 공개 경영 업적은 20개이며, hidden 정의 지원도 포함되어 있습니다.
화면은 해금 이벤트를 받아 알림을 표시합니다. 동시에 여러 업적이 달성되면 해금은 기록하되 Toast는 순차적으로 표시합니다.
확장 시에는 다음을 지켜 주세요.
업적 ID를 안정적으로 유지합니다.
기록으로 증명할 수 없는 과거 조건을 추측하지 않습니다.
업적 정의와 사람이 읽는 조건 안내를 함께 갱신합니다.
통계 기록장치에 업적 판정을 다시 넣지 않습니다.
저장·불러오기·Undo·새 게임을 함께 검증합니다.
이번 업적 세트는 경쟁 검증용이 아니며, 치트 사용에 따른 별도 무효화 규칙은 적용하지 않습니다.
7. 설치와 제거의 안전장치
설치기는 원본 게임 모듈의 해시와 연결 지점, 알려진 설치 표시의 상태를 확인합니다. 검증되지 않은 게임 코드에는 기본적으로 설치를 중단합니다.
각 모듈은 소유 표시로 구분된 블록을 사용합니다.
선택한 모듈만 설치·교체·제거
필요한 의존성 자동 설치
소비자가 남아 있는 공용 모듈의 단독 제거 방지
같은 코드 재설치 시 무변경
설치·제거 직전 HTML 백업
선택 업데이트에서도 실행 순서 유지
RC3에서 RC3.1로 이동할 때는 Keybind만 업데이트할 수 있으며, 다른 모듈을 그대로 보존하는 경로도 검사했습니다.
이 구조는 모든 타 모드와의 조합 호환을 보장하는 장치는 아닙니다. 새 게임 버전에서 Store·함수·연결 지점이 바뀌면 게임별 Bridge를 다시 검토해야 합니다.
8. 검증 범위와 배포 자료
자동 검사 13개가 통과했습니다.
원본 키 재지정·해제·초기화, 기존 키 중복 실행 방지, 입력 보호, Undo, 저장 이행, 통계·업적 분리, 창 이동과 외부 창 왕복, 실제 ZIP 설치·제거 등을 검사했습니다.
창 위치의 일부 검사는 시뮬레이션 또는 헤드리스 환경에서 수행했습니다. 실제 OS 창 닫기, 다중 모니터와 DPI, 브라우저별 팝업 제약까지 모든 환경에서 검증 완료했다는 의미는 아닙니다.
설치 ZIP에는 다음 문서를 포함합니다.
README_SHORT.md: 설치·사용 안내DOMAIN_API.md: 책임 분리와 주요 APIPHYSICAL_QA.txt: 실제 환경 확인 항목WW_Observer_Achievements.txt: 업적 달성 조건
개발용 소스와 자동 검사 자료는 별도로 보관하고 있습니다.
향후 기능 추가에서도 창 관리 / 입력 / 상태 변경 / 기록 / 판정 / 표시의 경계를 유지하는 것을 기본 원칙으로 삼습니다.
======================
WORK CARD — WAYWORKS 창 프레임워크 적용
WORK CARD — WAYWORKS 창 프레임워크 적용
적용 지시
내가 설명한 기능의 창을 WAYWORKS의 WWWindow Public API v1에 맞춰 구현하라.
이 카드는 기능 설명의 앞이나 뒤에 붙여 사용할 수 있다. 기능의 내용은 내 설명을 따르고, 창의 생성·배치·이동·종료는 아래 규칙을 따른다.
참조 기준: WAYWORKS RC3.1 / WWWindow API v1.
1. 공용 창에 패널로 등록
WWWindow.registerPanel(spec)으로 내 모드의 패널을 등록한다.작성자·모드별 고유 ID를 사용한다. 예:
author.mymod.panel.ww.*,wayward.*등 기존 기능의 ID를 재사용하지 않는다.owner.modId,owner.name,owner.version으로 소유자를 표시한다.일반 메뉴에 표시할 창은
menu.section: 'main'을 사용한다.등록은 DOM 준비 및 WWWindow 로드 이후에 한 번만 수행한다.
API가 없거나 지원 버전이 아니면 의존성이 필요하다고 안내하고 안전하게 종료한다.
등록만으로 자동으로 창을 열 필요는 없다. 사용자의 메뉴 선택이나 명시한 동작으로 연다.
2. 창 관리와 내용 구현을 분리
내 모드는 패널 내부의 내용만 구현한다.
창의 이동·크기 조절·도킹·탭·분할·자동 숨김·외부 창 분리·복귀·레이아웃 저장은 프레임워크에 맡긴다.
별도의 창 관리자, 드래그 시스템, z-index 관리, 외부 창용 프레임워크 복사본을 만들지 않는다.
기능 제한이 필요한 경우에는 capabilities로 선언한다. 공개된 선택 기능을 직접 호출할 때는 해당 메서드와 hasFeature()를 확인한다. 배치 관련 내부 구조나 debug()의 반환 필드에 의존하지 않는다.
3. 외부 창과 생명주기
mount(host, context)안에서 내용을 만든다.DOM 생성은
host.ownerDocument를 사용한다.문서가 바뀔 수 있으므로 이후 갱신에서도 현재
host.ownerDocument또는context.document를 사용한다.등록한 이벤트·구독·타이머는 cleanup 함수 또는
context.signal로 정리한다.mount의 반환값은 cleanup 함수다. 임의의 dispose 객체로 대체하지 않는다.onVisibilityChange(visible, context)에서 화면용 갱신을 시작·중지할 수 있다.onWorkspaceChange(change, context)에서 문서가 바뀌는 연결을 갱신한다.닫기는 숨김일 수 있다. 닫을 때마다 mount가 폐기·재실행된다고 가정하지 않는다.
계속 수집해야 하는 게임 기록은 UI mount 밖의 별도 기록장치에 둔다.
단축키도 사용하는 패널은 단축키 카드에 따라 현재 문서의 WWKeybind 연결을 관리한다.
주의: context.getState()는 창 상태다. 게임 상태로 착각하지 않는다.
4. 스타일과 저장
CSS는 내 모드의 고유 클래스 아래로 한정한다.
다음 테마 변수를 활용한다.
--ww-bg
--ww-surface
--ww-text
--ww-muted
--ww-accent
--ww-border프레임워크 전체나 다른 모드의 스타일을 덮어쓰지 않는다.
검색어·선택 항목 등 UI 상태 저장이 필요하면 serializeUIState(context)와 restoreUIState(value, context)를 사용한다. 저장값은 JSON으로 표현 가능한 작은 데이터로 만들고, 게임 세이브 데이터와 구분한다. 패널 UI 저장은 64KB 이하로 유지한다.
5. 최소 등록 예제
아래는 실제 API 형식의 예제다. 이름·내용·크기는 내 기능에 맞게 변경한다.
(function () {
const PANEL_ID = 'author.mymod.panel';
function init() {
const api = window.WWWindow;
if (api?.apiVersion !== 1) {
console.warn('[내 모드] WWWindow API v1이 필요합니다.');
return;
}
if (api.listPanels().some(p => p.id === PANEL_ID)) return;
api.registerPanel({
id: PANEL_ID,
title: '내 모드 창',
owner: {
modId: 'author.mymod',
name: '내 모드',
version: '0.1.0'
},
menu: { section: 'main', order: 100 },
defaultSize: { width: 520, height: 480 },
minSize: { width: 280, height: 220 },
css: `
.author-mymod-panel {
padding: 12px;
color: var(--ww-text);
background: var(--ww-bg);
overflow-wrap: anywhere;
}
`,
mount(host, context) {
const content = host.ownerDocument.createElement('div');
content.className = 'author-mymod-panel';
content.textContent = '여기에 내 기능을 구현합니다.';
host.append(content);
return () => content.remove();
}
});
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init, { once: true });
} else {
init();
}
})();열기와 제거는 각각 다음 공개 API를 사용한다.
WWWindow.open('author.mymod.panel');
WWWindow.unregisterPanel('author.mymod.panel');6. 납품·검증 조건
메인 창에서 열기·닫기·다시 열기
외부 창으로 이동 후 표시·입력·복귀
지원하는 도킹·탭·크기 조절
반복 실행해도 패널·구독·타이머가 중복되지 않음
기존 Cheat·Observer·다른 패널을 변경하지 않음
내 애드온의 설치·로드 방법과 의존성을 함께 제공한다. JS 파일을 폴더에 넣는 것만으로 자동 등록된다고 가정하지 않는다.
공용 프레임워크나 기존 설치기를 임의로 수정하지 않는다. 현재 API로 불가능한 요구는 필요한 변경과 이유를 먼저 보고한다.
==============================
WORK CARD — WAYWORKS 단축키 프레임워크 적용
WORK CARD — WAYWORKS 단축키 프레임워크 적용
적용 지시
내가 설명한 기능의 단축키를 WAYWORKS의 WWKeybind Public API v1에 맞춰 구현하라.
키 입력은 공용 설정과 충돌 검사에 통합하고, 실제 기능 실행은 내 모드의 명령 함수에 연결한다.
참조 기준: WAYWORKS RC3.1 / WWKeybind API v1.
1. 명령으로 등록
WWKeybind.registerAction(spec)을 사용한다.명령 ID는 고유한 점 구분 형식으로 정한다. 예:
author.mymod.open.owner.id,owner.name,owner.version을 지정한다.사용자에게 보이는
title은 기능을 설명하는 이름으로 작성한다.같은 기능의 버튼과 단축키는 같은 실행 함수를 사용한다.
공용 키 설정을 우회하는 별도 전역 keydown 리스너를 만들지 않는다.
등록한 명령은 기존 단축키 설정의 추가 모드 영역에 소유자별로 표시된다.
2. 기본 키와 충돌
사용자가 기본 키를 지정하지 않았다면 defaultBinding: null로 등록한다. 임의로 기존 키를 빼앗지 않는다.
키는 문자 대신 KeyboardEvent의 code 형식으로 지정한다.
{ code: 'KeyJ' }
{ code: 'KeyJ', ctrl: true }
{ code: 'Digit1' }
{ code: 'Numpad1' }기존 바인딩을 강제로 덮어쓰지 않는다.
getConflicts(id)로 기본 키 충돌도 확인한다. 등록 자체가 모든 충돌을 거부한다고 가정하지 않는다.충돌이 있으면 사용자에게 알리고 다른 키 선택을 제공한다.
setBinding()결과의ok와conflicts를 확인한다.승인 없이
{ replace: true }를 사용하지 않는다.when조건이 다르다는 이유로 같은 문맥의 중복 키를 허용하지 않는다.업데이트할 때 명령 ID와 사용자가 저장한 키를 유지한다.
브라우저·운영체제가 선점하는 키는 별도로 고려한다.
3. 입력 문맥과 실행 조건
일반 기능은 다음을 기본으로 한다.
contexts: ['NORMAL']입력창과 모달에서도 실행해야 하는 특별한 요구가 있을 때만 TEXT_INPUT 또는 BLOCKING_MODAL을 추가한다.
게임 시작 여부·대상 존재 여부·사용 가능 조건은
when(context)에서 확인한다.when은 실행 가능하면 명확하게true를 반환한다.실행하지 못한 경우
execute(context)는false를 반환한다.입력창의 타이핑·Backspace·Enter, 한글 조합 입력, 키 재지정 과정의 입력을 방해하지 않는다.
Esc 창 닫기·메뉴 취소와 기존 원본 단축키 처리를 별도로 덮어쓰지 않는다.
모든 명령이 외부 창에서도 실행되어야 한다고 가정하지 않는다. 내 기능의 실행 범위를 명시한다.
비동기 기능은 공용 라우터가 Promise를 기다려 준다고 가정하지 말고, 별도 작업 함수에서 취소·실패 처리를 관리한다.
4. 게임 상태 변경은 별도 계층으로 연결
키 등록은 입력 처리만 담당한다.
수치 편집 등 게임 상태를 변경하는 기능은 WWAction의 공개 변경 경로에 연결해 공용 Undo와 함께 동작하도록 한다. 원본 게임 행동은 검증된 게임 연결을 통해 실행한다.
키 핸들러에서 세이브나 Store 값을 직접 덮어쓰거나, 별도 Undo 기록을 만들지 않는다. 필요한 의존성이 없다면 해당 기능을 안전하게 비활성화하고 안내한다.
WWKeybind.execute() 같은 존재하지 않는 API를 만들거나 호출하지 않는다.
5. 외부 문서와 정리
외부 창에서도 내 키를 사용할 경우에는 해당 문서를 연결한다.
const release = WWKeybind.attachDocument(currentDocument);
// 연결이 더 이상 필요하지 않을 때
release();창 패널과 함께 사용하는 경우:
mount에서 현재 문서를 연결한다.
onWorkspaceChange에서 문서가 바뀌면 이전 연결을 해제하고 새 문서를 연결한다.cleanup에서 마지막 연결을 해제한다.
같은 문서에 연결이 중복해서 쌓이지 않도록 관리한다.
내 모드의 제거 시에는 내 명령만 unregisterAction(id)로 해제한다. 공용 WWKeybind.dispose()를 호출해 다른 모드까지 종료하지 않는다.
6. 창 열기 명령 예제
창 카드의 패널이 먼저 등록된 경우에 사용할 수 있는 예제다.
(function () {
const PANEL_ID = 'author.mymod.panel';
const ACTION_ID = 'author.mymod.open';
function init() {
const keys = window.WWKeybind;
const windows = window.WWWindow;
if (keys?.apiVersion !== 1 || windows?.apiVersion !== 1) {
console.warn('[내 모드] WWKeybind와 WWWindow API v1이 필요합니다.');
return;
}
if (keys.listActions().some(a => a.id === ACTION_ID)) return;
keys.registerAction({
id: ACTION_ID,
title: '내 모드 창 열기',
owner: {
id: 'author.mymod',
name: '내 모드',
version: '0.1.0'
},
defaultBinding: null,
contexts: ['NORMAL'],
when: () => windows.listPanels().some(p => p.id === PANEL_ID),
execute: () => {
windows.open(PANEL_ID);
return true;
}
});
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', init, { once: true });
} else {
init();
}
})();7. 납품·검증 조건
기존 단축키 설정에 내 소유자·명령이 표시됨
재지정·초기화·해제·새로고침 후 설정 유지
재지정 뒤 이전 키가 함께 실행되지 않음
기존 원본·치트 키와의 충돌 검사
입력창·모달·한글 입력 보호
지원한다고 명시한 메인·외부 창에서 실행
반복 연결·제거 후 리스너가 남지 않음
내 명령 ID, 기본 키, 실행 범위, 의존성, 설치·로드 방법을 함께 제공한다.
공용 키 코어나 다른 모드의 설정은 수정하지 않는다. 현재 API로 불가능한 요구는 필요한 변경과 이유를 먼저 보고한다.
====================================
WORK CARD — WAYWORKS 업적 프레임워크 적용
WORK CARD — WAYWORKS 업적 프레임워크 적용
적용 지시
내가 설명한 업적을 WAYWORKS의 WWAchievement 공개 API에 정의로 등록하라.
별도 업적 엔진이나 해금 저장소를 복제하지 않고, 기존 평가·저장·Undo·알림 연결을 사용한다.
참조 기준: WAYWORKS RC3.1 / WWAchievement API v1.
1. 의존성과 등록
필수 의존성:
Achievement → Statistics → Runtime기존 업적 목록 화면과 Toast까지 사용하려면 Observer 화면 모듈도 필요하다. WWAchievement 엔진만 있다고 화면 알림까지 자동으로 존재하는 것은 아니다.
WWAchievement.register(definition)으로 등록한다.게임 로딩 시 한 번 등록하며 중복 ID는 등록하지 않는다.
엔진이 나중에 로드될 수 있다면 현재 존재 여부와
WWAchievementReady이벤트를 함께 처리한다.이미 존재하는 공개 경영 업적 20개를 수정·삭제하지 않는다.
2. ID와 정의 형식
업적 ID는 창·단축키 ID와 다르다.
허용 형식:
영문 소문자로 시작
영문 소문자 / 숫자 / 밑줄만 사용예:
author_mymod_net_2000점·하이픈을 넣지 않는다. 작성자와 모드의 접두사를 포함해 충돌을 방지하고, 배포 이후에는 같은 업적의 ID를 유지한다.
정의의 필수 항목:
{
id,
name,
category,
condition,
evaluate
}hidden은 선택 항목이며 기본값은 false다. 정의에 작성하지 않은 owner 전용 API 등이 존재한다고 가정하지 않는다.
3. 평가 함수의 실제 계약
평가 함수는 다음 문맥을 받는다.
evaluate({ snapshot, days, unlocked })snapshot: 현재 게임의 정규화된 통계 상태days: 기록으로 확인 가능한 확정 일별 기록unlocked: 기존 해금 기록
반환 형식:
{
progress,
target,
achieved,
achievedDay,
detail
}progress: 현재 진행 수치. 확인할 수 없으면null.target: 목표 수치.achieved: 조건 충족 여부.achievedDay: 조건이 충족된 게임 날짜. 미충족이면null.detail: 사용자에게 보여줄 진행 설명.
achievedDay까지 올바르게 반환한다. achieved: true만 반환하고 날짜를 빠뜨리지 않는다.
평가는 읽기 전용으로 구현한다. snapshot·days·세이브를 수정하거나 평가 중 게임 행동을 실행하지 않는다. 없는 값·잘못된 값·빈 기록을 처리하고 예외를 던지지 않도록 한다.
4. 조건에 사용할 기록의 기준
현재 상태 업적은 확인 가능한 현재 snapshot으로 평가한다.
하루 수입 업적은 확정된 하루 기록으로 평가한다.
누적 업적은 실제로 보유한 기록이나 명시된 누적 자료로 계산한다.
연속 업적은 날짜의 연속성까지 확인한다.
현재 진행 중인 날짜를 완료된 하루로 취급하지 않는다.
없는 기록을 0으로 바꾸어 달성을 추측하지 않는다.
설치 이전의 사라진 기록을 임의 생성하지 않는다.
내 조건에 필요한 데이터가 현재 snapshot에 없으면, 먼저 기록장치 확장이 필요한 이유와 설계를 보고한다. 각 업적이 원본 데이터를 따로 파싱하거나 기록 리스너를 중복 설치하는 구조를 만들지 않는다.
5. 저장·화면·알림
해금 저장과 상태 갱신은 WWAchievement 런타임에 맡긴다. 다른 업적의 저장값을 덮어쓰거나 localStorage에 별도 해금 목록을 만들지 않는다.
화면이 필요한 경우에는 공개 API를 사용한다.
WWAchievement.getStatuses();
const unsubscribe = WWAchievement.subscribe(event => {
// event.type, event.value를 사용한다.
});기존 Observer 화면을 사용한다면 자체 Toast를 추가해 같은 해금을 두 번 알리지 않는다.
Save / Load / Undo / 새 게임의 기존 처리 흐름을 유지한다. 업적 정의 등록은 매 실행에 필요하며 세이브가 평가 함수를 보관하는 것은 아니다.
현재 공개 API에는 개별 업적 unregister()가 없다. 존재하지 않는 API를 호출하거나 정의 제거를 위해 공용 dispose()를 호출하지 않는다. 제거는 내 등록 코드를 제거하고 새로고침하는 방식으로 설계하며 기존 저장값을 임의 삭제하지 않는다.
6. 현재 순자산 업적 예제
현재 snapshot에 실제로 제공되는 gold·debt를 사용하는 예제다. 내가 설명한 업적에 맞게 조건과 목표를 변경한다.
(function () {
const ID = 'author_mymod_net_2000';
function register() {
const api = window.WWAchievement;
if (api?.apiVersion !== 1) return;
if (api.list().some(def => def.id === ID)) return;
api.register({
id: ID,
name: '내 모드의 첫 목표',
category: '내 모드 업적',
condition: '현재 순자산이 2,000g 이상이 된다.',
hidden: false,
evaluate({ snapshot }) {
const known =
Number.isFinite(snapshot?.gold) &&
Number.isFinite(snapshot?.debt);
const value = known ? snapshot.gold - snapshot.debt : null;
const target = 2000;
const achieved =
known &&
Number.isInteger(snapshot.day) &&
value >= target;
return {
progress: value,
target,
achieved,
achievedDay: achieved ? snapshot.day : null,
detail: known
? `순자산 ${value}g / ${target}g`
: '현재 재정 기록을 확인할 수 없습니다.'
};
}
});
}
window.addEventListener('WWAchievementReady', register);
register();
})();위 예제는 현재 상태 업적이다. 하루 종료·누적·연속 업적으로 바꿀 때는 days 또는 실제 누적 자료에 맞춰 다시 설계한다.
7. 납품·검증 조건
내 모드의 업적 조건 TXT도 함께 제공한다.
업적 이름: 달성 조건정의와 TXT의 업적 목록·조건이 일치하도록 검증한다.
다음 항목을 확인한다.
목표 직전 / 정확한 목표 / 목표 초과
게임 시작 전 / 데이터 없음 / 기존 세이브 첫 실행
현재 상태 조건과 하루 확정 조건의 구분
누적·연속 조건에 필요한 기록의 충족 여부
중복 등록·중복 해금·중복 알림 없음
Save / Load / Undo / 새 게임
기존 경영 업적과 Cheat·Statistics가 정상 유지됨
Observer를 사용하는 경우 목록·진행도·알림 표시
내 정의의 로드 순서와 의존성을 함께 제공한다. 공용 업적·통계 엔진을 임의로 수정하지 않으며, 현재 데이터나 API로 불가능한 요구는 필요한 변경과 이유를 먼저 보고한다.
=====================================
s/somisoft
• 163,117 subscribers- 1. 게시물 규정 양식
업로드 시 링크 암호화 & 필수 정보를 기입할 것
- 2. 질문
국룰, 암호화 링크 등 기본사항 질문 금지, 탭 미준수시 차단 및 삭제
- 3. 요청
요청 기준 및 양식 미준수 & 댓글로만 자료 복구 요청 시 차단
- 4. 미성년자 / 근첩 / 페미 / 다중계정
조금이라도 의심되면 선 차단, 후 해명
- 5. 좆목 / 네임드화
닉언, 네임드화 등 친목질 금지
- 6. 분탕 및 어그로 / 혐짤 / 낚시 / 뇌절
해당 카테고리의 차단 기간 및 가중처벌은 처리자 재량으로 판단
- 7. 홍보 / 판촉 / 거래
허용되지 않은 모든 형태의 홍보, 거래, 교환, 조건부 공유 시 차단
- 8. 쌀먹 / 바이러스
조건부 공유 & 수익성 링크 & 고의적인 바이러스 유포 시 갱신차단
- 9. 자료 분류 / AI
미검수 시 표기 필수, 생성형 AI를 사용한 자료의 제목에 AI 미기입 시 차단
- 10. 실사 / 토들러
업로드시 갱신 차단
- 11. 기타 세부 규정은 서브 공지사항 참고