MUDNET

# 십웅기 호북성 신규 생성·확장 매뉴얼 ## 1. 문서 목적 이 문서는 십웅기에서 새 권역을 만들거나 기존 권역을 대규모로 확장할 때, 호북성 개발에서 사용한 설계 원칙과 작업 순서를 재사용하기 위한 기준서다. 호북성은 단순히 방을 많이 늘린 지역이 아니라 다음 요소를 하나의 흐름으로 묶은 대형 권역이다. - 관도와 여행 동선 - 외성·내성·수운지구 - 무당파 거점과 가입 동선 - 현악진과 무당산 오름길 - 운몽택 위험 지역 - 수몰된 현천궁 비경 - 지역 상점·특산품·장비·몹·임무 - 시간·날씨·생태·드랍·경제 - 관리자 관리 기능 - 방 이미지 대표 장면과 실제 방 연결 앞으로 사천성·산서성·하남성·호남성 같은 대형 지역을 만들 때도 이 문서의 뼈대를 따라가면 된다. --- # 2. 호북성 개발의 기본 목표 ## 2.1 지역 정체성 호북성의 핵심 인상은 다음 다섯 가지다. 1. **물의 땅** - 강, 수로, 제방, 나루, 습지, 운몽택 2. **무당산의 도가적 기운** - 현악진, 순례길, 산문, 잔도, 태화궁 3. **상업과 수운** - 곡물창고, 어물시장, 여객선, 화물부두 4. **중원의 관문** - 여러 관도가 갈라지는 교통 중심 5. **밝은 도시와 어두운 습지의 대비** - 내성의 질서와 운몽택·현천궁의 신비 지역마다 하나의 상징만 반복하지 말고, 도시·산·물·늪·비경이 서로 다른 결을 지니도록 한다. ## 2.2 권장 진입 시점 호북성은 장백성·화서마을의 초반 임무를 마친 플레이어가 진입하는 중급 권역으로 설계한다. 권장 전투 체감: - 호북관도 초입: 무공 35~45 - 호북성 외성·내성: 무공 40~55 - 현악진·무당산 하단: 무공 45~60 - 무당산 중상단: 무공 55~70 - 운몽택: 무공 60~75 - 수몰 현천궁: 무공 70 이상 또는 관련 임무 완료자 수치만으로 막기보다 다음을 함께 사용한다. - 선행 임무 - 지역 방문 기록 - 문파 가입 여부 - 특정 물건 - 임무 단계 - NPC 대화 - 비경 입장 조건 --- # 3. 전체 권역 구성 호북성 개발은 총 8개 큰 구역, 250개 방 규모로 구성했다. | 구역 | 방 수 | 핵심 기능 | |---|---:|---| | 호북관도 | 40 | 여행, 역참, 상단, 순례 동선 | | 호북성 외성 | 30 | 물류, 노동, 성문, 말시장 | | 호북성 내성 | 44 | 관아, 객잔, 상점, 제작, 생활 | | 장강 수운지구 | 32 | 여객선, 화물, 어업, 선박 수리 | | 현악진 | 24 | 무당산 입구 마을, 순례, 약초 | | 무당산 오름길 | 36 | 무당파 접근, 수행, 가입 동선 | | 운몽택 | 32 | 습지 전투, 채집, 생태, 위험 지역 | | 수몰된 현천궁 | 12 | 고대 비경, 봉인, 보스, 신물 서사 | | **합계** | **250** | | 새 대형 권역도 180~300방 사이를 권장한다. - 소도시형: 80~140방 - 중형 성도형: 140~220방 - 대형 복합 권역: 220~320방 - 320방 이상은 하위 지역을 별도 권역으로 분리한다. --- # 4. 개발 단계와 스테이지 구성 호북성은 한 번에 만들지 않고 기능별 스테이지로 분리했다. ## R102 — 호북성 총괄 기획 - 전체 지역 구조 - 진입 시점 - 권장 무공 - 도시 성격 - 무당파 거점 설정 - 지역 경제·특산품·위험도 - 후속 스테이지 순서 확정 ## R103 — 호북관도 40방 - 장백성·화서마을 이후 이동 동선 - 제방길, 역참, 상단 야영지 - 순례객과 짐꾼 - 방 설명과 여행 감각 - 방마다 주변 풍경과 이동 방향이 자연스럽게 읽히도록 구성 ## R104 — 호북성 외성 30방 - 동문·서문·남문·북문 - 곡물창고 - 말시장 - 어물마당 - 짐꾼 주막 - 성벽 아래 창고 - 외성 노동자와 상단의 생활권 ## R105 — 호북성 내성 44방 - 중앙광장 - 종루거리 - 물시계누각 - 관아 - 포도청 - 객잔 - 차관 - 약재시장 - 검방 - 장신구 골목 - 비단거리 - 도관 및 생활시설 ## R106 — 장강 수운지구 32방 - 큰나루 - 여객선 - 화물부두 - 새벽 어시장 - 선박 수리소 - 버드나무 나루 - 갈대 포구 - 밀수 선착장 ## R107 — 현악진 24방 - 무당산 입구 마을 - 순례자 거리 - 약초시장 - 검집공방 - 산문 접인소 - 오름길 초입 ## R108 — 무당산 오름길 36방 - 산문 고도 - 구곡계 - 해검석 - 백학바위 - 자소령 - 운무잔도 - 칠성교 - 송풍대 - 태화궁 외도 - 무당파 정문 앞 ## R109 — 무당파 가입 연동 - 무당파 가입 조건 - 문파 미가입자 이동 - 장문인 부재 시 가입 대체 절차 - NPC 접인 - 가입 임무 - 문파 공백 상태에서의 자동 승인 또는 임시 대리인 처리 ## R110 — 운몽택 32방 - 백로습지 - 갈대미로 - 독수초 군락 - 검은물 웅덩이 - 침수 제단 - 철갑악어 둥지 - 물안개부인의 뜰 ## R111 — 특산품·재료 - 약초 - 연근 - 갈대섬유 - 수운철 - 운몽 진흙 - 물고기·어물 - 특수 독초 - 무당산 향재 ## R112 — 지역 장비 - 무기 - 방어구 - 장신구 - 도가 의식구 - 수운 노동 장비 - 습지 탐사 장비 ## R113 — 일반 임무 18종 - 배달 - 채집 - 처치 - 구조 - 호위 - 조사 - 상점 연계 - 도시 생활형 - 수운형 - 습지형 ## R114 — 무당 첫 수련 서사 - 입문 - 예절 - 해검 - 기본 호흡 - 태극·도인 서사 - 사부와의 첫 대면 - 초급 문파 기술 ## R115 — 수몰된 현천궁 12방 - 잠긴 석문 - 물거울 회랑 - 현수의 심장 - 북극 봉인실 - 봉인 장치 - 현무 상징 - 수몰 신전 보스 ## R116 — 시간·날씨·생태 - 비 - 안개 - 강풍 - 수위 변화 - 낮·밤 묘사 - 몹 출현 변화 - 채집물 변화 ## R117 — 이동·길찾기 - 관도 연결 - 역참 안내 - 축지법 연동 - 항로 연동 - 무당파 위치 안내 - 명령어 기반 이동 - NPC 안내 대사 ## R118 — 전투·드랍·경제 균형 - 몹 난도 - 경험치 - 엽전 - 재료 - 희귀 장비 - 상점 매입가 - 반복 사냥 방지 - 지역별 전리품 차등 ## R119 — 방 문체 통일 - 방 제목 - 방 배경 묘사 - 방향 단서 - 중복 표현 제거 - 시대·지역 어휘 통일 - 현대식 표현 제거 ## R120 — 관리자 기능 - 지역 상태 점검 - 몹 재생성 - 방 이동 - 임무 상태 확인 - 지역 폐쇄·개방 - 이미지 교체 관리 - 오류 방 확인 ## R121 — 대표 이미지 장면 기획 - 250방을 68개 대표 장면으로 통합 - 대표 ID 부여 - 중복방 공유표 - 회차별 이미지 목록 - 권장 파일명 ## R122 — 최종 통합 - 방 - NPC - 상점 - 임무 - 전투 - 이동 - 도움말 - 관리자 기능 - 최종 점검 ## R123 — 방 이미지 연결 - PNG 정리 - WebP 변환 - 대표 장면 파일명 - 250방 이미지 연결 - 적용 스크립트 - 검증 스크립트 - 기존 JSON 백업 --- # 5. 방 설계 원칙 ## 5.1 방은 지도 칸이 아니라 장면이다 좋은 방은 다음 네 가지가 한 번에 읽혀야 한다. 1. 지금 어디인가 2. 무엇이 보이는가 3. 무엇을 할 수 있는가 4. 다음에 어디로 갈 수 있는가 나쁜 예: > 길이 있다. 동쪽으로 갈 수 있다. 좋은 예: > 제방 위로 다져진 관도가 강물과 나란히 굽어간다. 동쪽에는 검은 기와를 얹은 역참이 낮게 보이고, 서쪽으로는 갈대밭 사이 물길이 햇빛을 잘게 부순다. ## 5.2 방 설명 구성 권장 순서: 1. 공간의 뼈대 2. 빛·바람·냄새·소리 3. 사람·물건·생태 4. 주변 지역과의 관계 5. 행동 가능성 또는 이동 암시 권장 길이: - 일반 방: 2~4문장 - 핵심 방: 4~7문장 - 비경 핵심실: 5~9문장 - 반복 방은 문장 수보다 차이를 만드는 세부 묘사가 중요 ## 5.3 방향 단서 방향 단서는 “동쪽으로 가라”는 기계적 문장이 아니다. 자연스러운 단서 예: - 북쪽 성벽 너머로 종루 지붕이 보인다. - 강바람은 남쪽 나루 쪽에서 불어온다. - 서쪽 골목에는 약초 냄새가 짙어진다. - 위쪽 산길에서 종소리가 낮게 내려온다. 단, 모든 방에 방향 단서를 억지로 넣지 않는다. 공간의 풍경이 자연스럽게 다음 장소를 가리키도록 한다. ## 5.4 중복 방 처리 같은 구조가 반복되어도 다음 중 하나 이상을 달리한다. - 시간 - 날씨 - 주변 소리 - 바닥 재질 - 물길 - 식생 - NPC - 물건 - 지역 사건 - 먼 배경 중복 묘사가 완전히 같은 방은 대표 이미지 하나를 공유할 수 있다. --- # 6. NPC 설계 원칙 ## 6.1 NPC 분류 - 생활 NPC - 상인 - 안내자 - 문파 관계자 - 임무 NPC - 전투 NPC - 보스 - 비전투 유력자 - 이동·항로 NPC 레벨이 있다고 해서 적으로 취급하지 않는다. ## 6.2 호북성 주요 NPC 유형 - 성문병 - 역참지기 - 상단 호위 - 곡물상 - 어물상 - 약재상 - 검방 장인 - 장신구 세공사 - 선박 수리공 - 뱃사공 - 순례객 - 무당 도인 - 산문 접인 도사 - 약초꾼 - 습지 사냥꾼 - 밀수꾼 - 현천궁 수호자 ## 6.3 NPC 대사 대사는 한 번에 모든 정보를 말하지 않는다. 권장 구조: - 인사 - 지역 이야기 - 현재 문제 - 선택지 또는 명령 - 임무 단계에 따른 변화 예: > “강물은 늘 같은 얼굴을 하고 흐르지 않소. 비가 사흘만 이어져도 갈대포구의 길은 물 밑으로 숨지.” 이 한 문장으로 지역 날씨, 길 변화, 습지 위험을 함께 암시할 수 있다. --- # 7. 상점·경제 설계 ## 7.1 상점은 지역의 얼굴이다 호북성 상점은 단순한 잡화상이 아니라 지역 생산과 생활을 보여 줘야 한다. 권장 상점: - 곡물상 - 어물상 - 약재상 - 차관 - 객잔 - 검방 - 장신구점 - 비단점 - 선박 수리점 - 마구점 - 순례용품점 - 습지 탐사점 ## 7.2 상품 등급 - 생활품 - 초급 장비 - 지역 특산품 - 임무 재료 - 제작 재료 - 희귀 드랍 - 문파 전용 - 비경 전용 ## 7.3 지역 특산품 예시 - 운몽 연근 - 백로 깃 - 갈대섬유 - 수운철 - 운몽 진흙 - 무당 송진 - 자소 향재 - 장강 은어 - 검은물 이끼 - 현천 옥편 --- # 8. 몹·전투 설계 ## 8.1 지역별 몹 성격 ### 관도 - 산적 - 들개 - 늑대 - 도적 정찰꾼 - 떠돌이 무사 ### 외성 - 창고 도둑 - 말도둑 - 불량 짐꾼 - 밀수꾼 ### 수운지구 - 수적 - 부두 깡패 - 밀수선원 - 강도 ### 무당산 - 야생 원숭이 - 산양 - 독사 - 수련 방해자 - 문파 시험 상대 ### 운몽택 - 늪악어 - 독충 - 독사 - 습지 도적 - 철갑악어 - 물안개 정령 ### 현천궁 - 수몰 수호자 - 청동 인형 - 별빛 잔영 - 현무 수호수 - 봉인 보스 ## 8.2 전투 난도 각 지역은 평균 무공 하나만 맞추지 말고 다음 층위를 둔다. - 일반 몹 - 강한 일반 몹 - 희귀 출현 몹 - 지역 정예 - 임무 보스 - 비경 보스 ## 8.3 드랍 드랍은 지역 생태와 연결한다. 예: - 악어 → 가죽, 이빨, 철갑 비늘 - 갈대 요괴 → 갈대섬유, 습지 정수 - 수적 → 엽전, 밀수품, 수운지도 - 무당산 도적 → 산약초, 훔친 향낭 - 현천궁 수호자 → 현천 옥편, 봉인 파편 --- # 9. 임무 설계 ## 9.1 일반 임무 비율 권장 18개 기준: - 대화형 3 - 배달형 3 - 채집형 3 - 처치형 3 - 조사형 2 - 호위형 2 - 연속형 1 - 비경 진입형 1 ## 9.2 임무는 지역을 걸어 보게 해야 한다 좋은 임무는 플레이어가 다음을 자연스럽게 경험하게 한다. - 관도 - 성문 - 시장 - 객잔 - 수운 - 현악진 - 무당산 - 운몽택 - 비경 임무 이동이 곧 지역 안내가 되도록 설계한다. ## 9.3 문파 임무 무당파는 다음 흐름을 권장한다. 1. 현악진 도착 2. 산문 접인소 방문 3. 기본 예절 확인 4. 해검석에서 무기 내려놓기 5. 무당산 오름길 통과 6. 정문 시험 7. 사부 또는 대리 접인 NPC 대화 8. 가입 9. 초급 수련 10. 첫 문파 임무 장문인이 없는 문파도 가입이 막히지 않도록 한다. - 대리 장로 - 자동 접인 - 임시 문파 관리자 - 조건 충족 시 가입 - 나중에 장문인 체계와 연결 --- # 10. 이미지 제작 기준 ## 10.1 기본 화풍 - 16:9 가로형 - 밝고 세련된 동양 판타지 애니메풍 - 맑은 색감 - 공간감 - 환경 중심 - 작은 화면에서도 장소가 읽히는 구도 - 글자 없음 - UI 없음 - 워터마크 없음 - 프레임 없음 ## 10.2 대표 이미지 방식 호북성 250방은 대표 장면 68장으로 묶었다. 같은 장면을 공유해도 되는 기준: - 방 제목과 묘사가 동일하거나 매우 유사 - 구조와 기능이 동일 - 시각적으로 구별할 필요가 없음 - 같은 권역의 반복 통로 별도 이미지가 필요한 기준: - 임무 종착점 - 보스방 - 핵심 NPC 방 - 도시 대표 장소 - 이동 거점 - 비경 핵심실 - 분위기와 기능이 뚜렷하게 다른 방 ## 10.3 파일명 규칙 호북성 대표 ID: - `HB-KD-xx` : 호북관도 - `HB-OS-xx` : 외성 - `HB-NS-xx` : 내성 - `HB-SW-xx` : 수운지구 - `HB-HY-xx` : 현악진 - `HB-MD-xx` : 무당산 - `HB-YM-xx` : 운몽택 - `HB-XR-xx` : 수몰 현천궁 예: ```text HB-KD-01.png HB-KD-01.webp ``` ## 10.4 WebP 변환 기준 - 긴 변 최대 1280px - 품질 74 - 원본 PNG 별도 보존 - 파일명은 대표 ID와 동일 - 색공간 변환 후 이미지 손상 검사 - 투명 배경 불필요 ## 10.5 서버 경로 ```text /home/master/mud/public/room-images/rooms/호북성/_대표장면/ ``` 연결 장부: ```text /home/master/mud/public/room-images/data/room-images.json ``` --- # 11. 이미지 연결 패키지 구성 권장 압축 구조: ```text images/ webp/ metadata/ 대표장면.csv 전체방_이미지연결표.csv 중복이미지_공유표.csv manifest/ region-room-images-final.json scripts/ apply-region-room-images.py verify-region-room-images.py README.md ``` 원본 PNG 압축: ```text images/ png/ metadata/ README.md ``` ## 11.1 적용 스크립트 필수 기능 - `--dry-run` - WebP 누락 검사 - manifest 검사 - 방 개수 검사 - 기존 `room-images.json` 백업 - 기존 다른 지역 연결 유지 - 해당 지역만 덮어쓰기 - 임시 파일 작성 후 원자적 교체 - 적용 결과 출력 - 설치 경로 환경변수 지원 권장 환경변수: ```text MUD_ROOT PUBLIC_ROOT ROOM_IMAGE_DIR ROOM_IMAGE_FILE ``` ## 11.2 스크립트 언어 운영 안정성을 위해 Python3을 권장한다. 이유: - 리눅스 기본 설치 가능성이 높음 - JSON 처리 안정적 - 한글 경로 처리 용이 - Node 모듈 형식 오류 회피 - 별도 의존성 없이 실행 가능 --- # 12. 관리자 기능 대형 지역은 관리자 명령과 화면이 반드시 필요하다. 권장 기능: - 지역 방 수 - 현재 접속자 - 몹 수 - 하트비트 수 - 지역별 스폰 상태 - 보스 재생성 - 임무 상태 초기화 - 방 이미지 연결 확인 - 이미지 미연결 방 목록 - 잘못된 출구 - 고립 방 - NPC 누락 - 드랍표 확인 - 상점 재고 확인 - 지역 폐쇄 - 지역 공지 --- # 13. 검증 체크리스트 ## 방 - [ ] 실제 `LIB_ROOM` 방만 포함 - [ ] 임시·백업 방 제외 - [ ] 모든 출구가 존재 - [ ] 고립 방 없음 - [ ] 일방통행은 의도된 것인지 확인 - [ ] 특수 명령 이동 확인 - [ ] 축지법·항로·포권·안녕 등 비출구 이동 확인 ## 묘사 - [ ] 방 제목과 설명 일치 - [ ] 현대어·개발자 문구 없음 - [ ] 같은 문장 과다 반복 없음 - [ ] 주변 풍경이 읽힘 - [ ] 지역 특성이 드러남 ## NPC - [ ] 공격 대상과 대화 NPC 구분 - [ ] 임무 NPC 사망 방지 - [ ] 대화 단계 확인 - [ ] 상점 NPC 재고 확인 - [ ] 스폰 중복 확인 ## 전투 - [ ] 무공 구간 적합 - [ ] 일반·정예·보스 구분 - [ ] 경험치와 엽전 과다 여부 - [ ] 희귀 드랍 확률 - [ ] 자동전투 악용 가능성 - [ ] 완전토벌 연동 ## 임무 - [ ] 시작 가능 - [ ] 진행 반영 - [ ] 완료 가능 - [ ] 보상 지급 - [ ] 실패·재개 가능 - [ ] 도움말과 실제 명령 일치 ## 이미지 - [ ] 대표 ID 중복 없음 - [ ] 파일명 일치 - [ ] WebP 누락 없음 - [ ] 전체 방 연결 수 일치 - [ ] 기존 지역 연결 보존 - [ ] 백업 생성 - [ ] 모바일에서 장소가 읽힘 --- # 14. 새 지역을 만들 때의 권장 작업 순서 1. 지역 정체성 한 문장 확정 2. 진입 시점과 무공 구간 결정 3. 대권역 5~8개로 나누기 4. 방 수 배분 5. 이동 구조 설계 6. 방 이름 목록 작성 7. 방 설명 작성 8. NPC·상점 배치 9. 몹·드랍 설계 10. 일반 임무 제작 11. 핵심 서사 제작 12. 비경 제작 13. 시간·날씨·생태 14. 길찾기·축지법·항로 15. 관리자 기능 16. 문체 통일 17. 대표 이미지 장면 묶기 18. 이미지 생성 19. WebP 변환·연결 20. 최종 플레이 점검 --- # 15. 호북성 개발에서 지켜야 할 핵심 원칙 1. **방 수보다 지역의 결이 먼저다.** 2. **도시·산·물·습지·비경은 서로 다른 호흡을 가져야 한다.** 3. **방 설명은 방향표가 아니라 풍경 속에서 길을 드러내야 한다.** 4. **상점과 아이템은 지역의 생업과 연결해야 한다.** 5. **몹과 드랍은 지역 생태에서 나와야 한다.** 6. **문파 가입은 운영자나 장문인 부재 때문에 막히면 안 된다.** 7. **큰 권역은 기능별 스테이지로 나누어 개발한다.** 8. **대표 이미지는 실제 방 묘사를 기준으로 묶는다.** 9. **원본 PNG와 게임용 WebP를 분리 보존한다.** 10. **적용 스크립트는 기존 자료를 백업하고 다른 지역 연결을 보존해야 한다.** 11. **모든 신규 기능은 도움말·관리자 기능·검증 절차까지 함께 만든다.** 12. **완성된 지역은 하나의 장소가 아니라 하나의 살아 있는 세계처럼 느껴져야 한다.** --- # 16. 권장 산출물 목록 대형 지역 개발이 끝나면 최소한 다음 자료를 남긴다. ```text 지역_총괄기획.md 지역_방목록.csv 지역_방연결표.csv 지역_NPC목록.csv 지역_상점목록.csv 지역_아이템목록.csv 지역_몹목록.csv 지역_임무목록.csv 지역_드랍표.csv 지역_대표장면.csv 지역_중복이미지공유표.csv 지역_이미지_manifest.json apply-region-room-images.py verify-region-room-images.py README.md 원본_PNG.zip 게임용_WebP_적용패키지.zip ``` --- ## 맺음말 호북성은 물길과 산길, 장터와 도관, 밝은 성도와 침수된 신전이 서로 이어지는 권역이다. 새 지역도 방을 늘어놓는 방식으로 만들지 않는다. 길이 사람을 이끌고, 물산이 시장을 만들고, 시장이 이야기를 낳고, 이야기가 다시 산과 비경으로 이어져야 한다. 그때 방 하나하나는 단순한 좌표가 아니라, 플레이어가 지나온 세월의 한 장면이 된다.