MUDNET

# 십웅기 문파 체계 정본 문서 제1권 ## 정본 구조 · 문파 세계관 · 입문 · 회원 장부 · 서열 성장 > 기준 통파일: `sipwoonggi-runtime-full-synergy-network-r49-munpa-departure-transfer-expulsion-return-skill-seal-20260708.tar.gz`기준 SHA-256: `ae8987da25659e55a672bcef2ef38db9dc9c5a022fbe0483d8355d46fd240857`문서 기준 시점: R49성격: 현재 구현의 정본 설명서 + 개발 유지보수 지침 *** ## 0\. 이 권의 범위 이 문서는 십웅기의 문파 체계를 “어떤 파일이 진짜인가”라는 질문에서 시작해, 플레이어가 문파를 발견하고 입문하며, 문파원 장부에 이름을 올리고, 공헌과 수행을 쌓아 서열이 자라는 과정까지 설명한다. 다루는 범위는 다음과 같다. 1. 정규 문파와 봉인 유산의 구분 2. 문파 방 계열의 정본성 3. 중앙 관리자들의 책임 분리 4. 여섯 정규 문파의 성격과 전승 이미지 5. 문파 개방 조건 6. 정문 기반 입문 의례 7. 회원 장부의 단일성 8. 플레이어 소속 동기화 9. 1\~10단계 서열과 실제 직책명 10. 성장 장부, 공헌, 수행, 승급 11. 공동체 상태와 자치 준비 조건 12. 플레이어 명령어 13. 데이터 파일과 운영상 불변조건 14. 변경 시 지켜야 할 금지선 자치·선거·예산·파문은 제3권에서, 기술·수련·전투 균형은 제2권에서 다룬다. *** # 1\. 문파 체계의 가장 중요한 정본 선언 R49 시점의 문파 체계는 **여섯 정규 문파 + 하나의 봉인 유산**으로 나뉜다. ## 1.1 활성 정규 문파 6개 ```text 무당파 화산파 명교 일월신교 개방 곤륜파 ``` 이 여섯 곳만 다음 권리를 가진다. * 신규 플레이어 입문 * 활성 문파원 장부 보유 * 공헌·수행·승급 * 사람 지도자 선거 * 공동목표·예산 * 자동 장로단 * 문파 기술 전승 * 탈퇴·전향·파문·복귀 생애주기 * 활성 권한의 정본 정본 판정 파일: ```text lib-runtime/관리자/문파/문파기반.c ``` 핵심 함수: ```text getActiveMunpa() isActiveMunpa(name) canHoldActiveMembership(name) ``` ## 1.2 봉인 유산 1개 ```text 신선궁 ``` 신선궁은 삭제된 문파가 아니다. **장소와 자료를 보존하는 봉인 유산**이다. 현재 원칙: * 신규 입문 불가 * 활성 문파원 장부 불가 * 새 자치 지도자 불가 * 대행 지도자 불가 * 새 성장 체계 제외 * 새 전승 체계 제외 * 옛 저장자료를 활성 권한으로 부활시키지 않음 * 장소와 서사 흔적은 보존 * 플레이어의 과거 소속 흔적은 `유산문파` 표지로 남길 수 있음 이 원칙은 “옛 세계의 기억은 남기되, 새 체계의 왕좌를 쥐게 하지 않는다”는 R47의 핵심이다. *** # 2\. 문파 방 계열의 정본성 문파 관련 방은 폴더 이름만 보고 모두 같은 위상을 가져서는 안 된다. R47부터 중앙 분류가 존재한다. ## 2.1 네 계열 | 경로 | 분류 | 의미 | | --- | --- | --- | | `/방/문파/` | 정본 | 정규 문파의 산문·시설·수련방 본체 | | `/방/문파경제/` | 기능부속 | 실제 경제·생산 시설, 정본에 붙는 부속 권역 | | `/방/문파new/` | 유산호환 | 옛 연결 호환을 위해 보존, 새 정본으로 확장 금지 | | `/방/신문파/` | 유산격리 | 신규 입문·권한 근거로 사용하지 않는 격리 계열 | 중앙 함수: ```text classifyRoomPath(path) isMunpaAreaPath(path) isCanonicalRoomPath(path) isAuxiliaryRoomPath(path) isLegacyRoomPath(path) ``` ## 2.2 개발 규칙 새 문파 기능을 붙일 때 기본 원칙은 다음과 같다. * 새 정문, 수련방, 핵심 시설: `/방/문파/` * 실제 경제 기능의 부속 시설: `/방/문파경제/` * 기존 호환 때문에 남은 방: `/방/문파new/` 유지 가능 * 유산 자료: `/방/신문파/`에 새 권한을 붙이지 않음 ### 금지 다음은 하면 안 된다. * `/방/문파new/`를 새 정본으로 간주 * `/방/신문파/`에서 입문·지도자·문파원 권한 판정 * `문파경제`를 단순 중복 폴더라 보고 일괄 삭제 * 신선궁 방이 존재한다는 이유만으로 활성 문파로 복원 *** # 3\. 중앙 관리자 책임 지도 문파 체계는 한 파일에 몰아넣지 않는다. R49의 강점은 책임이 나뉘어 있다는 점이다. | 관리자 | 역할 | | --- | --- | | `문파기반.c` | 활성/봉인 문파, 정문, 개방조건, 방 계열 정본 | | `문파자료.c` | 문파 소개, 성격, 전승 설명, 정문 명칭 | | `입문관리.c` | 정문 의례, 문답, 상징시험, 첫 가입 | | `문파원관리.c` | 활성 회원 장부, 서열 값, 플레이어 소속 동기화 | | `문파성장.c` | 공헌, 수행, 가입시각, 활동, 승급, 공동체 상태 | | `문파기술.c` | 전승 등급, 파일 실체, 수련 조건, 사용 자격 | | `문파자치.c` | 선거, 지도자, 임기, 대행, 불신임 | | `문파운영.c` | 공지, 공동목표, 공동예산, 장로단, 권한감사 | | `문파이력.c` | 탈퇴, 전향, 파문, 복귀, 기술 봉인 생애주기 | | `문파경제.c` | 문파경제 부속 권역과 일부 생산 이동 기능 | ## 3.1 핵심 설계 철학 각 관리자는 서로의 자료를 침범하지 않는다. 예: * 입문 관리자가 공헌을 임의 생성하지 않음 * 성장 관리자가 지도자를 임명하지 않음 * 지도자가 회원 장부를 소유하지 않음 * 문파 이력 관리자가 기술 수치를 삭제하지 않음 * 기술 관리자가 새 수련방을 강제 생성하지 않음 이 분리가 문파 체계를 오래 살게 한다. *** # 4\. 여섯 정규 문파의 정체성 문파 소개의 정본은: ```text lib-runtime/관리자/문파/문파자료.c ``` 이다. ## 4.1 무당파 **한줄** > 솔바람과 물의 흐름처럼 힘을 흘려 보내며 깊은 검리를 좇는 도맥. **결** ```text 균형 · 변화 · 검리 ``` **주요 전승** ```text 구궁신행검법 대라검법 태극제천검 태극혜검 ``` **추천 성향** * 서두르기보다 흐름을 읽는 플레이어 * 한 수의 뜻과 전환을 즐기는 무인 * 방어와 변화의 리듬을 선호하는 플레이어 **정문** ```text /방/문파/무당파/정문 ``` **권역** ```text 무당산 도맥 ``` *** ## 4.2 화산파 **한줄** > 자하의 기운을 품고 매서운 연환검세로 길을 여는 검문의 도맥. **결** ```text 기세 · 연환 · 검공 ``` **주요 전승** ```text 자하신공 탈명연환삼선검 매화검진 ``` **추천 성향** * 날카로운 검세 * 이어지는 공세 * 뚜렷한 검문 색채 * 연속 공격의 손맛 **정문** ```text /방/문파/화산파/정문 ``` *** ## 4.3 명교 **한줄** > 빛과 불의 깃발 아래 건곤의 뒤집힘과 변화를 탐구하는 교문. **결** ```text 건곤 · 전환 · 광명 ``` **주요 전승** ```text 건곤이위신공 낙성구유마검 월광비천검 오행열화진 ``` **추천 성향** * 정면 법칙만 따르지 않는 플레이 * 전환과 변칙 * 공격 구조의 뒤집힘 * 광명과 화염의 상징성 **정문** ```text /방/문파/명교/정문 ``` 입문 명령은 다른 문파와 달리 옛 어휘를 보존한다. ```text 입교신청 ``` *** ## 4.4 일월신교 **한줄** > 해와 달의 두 빛을 품고 빠르고 과감한 검세를 벼리는 교문. **결** ```text 속도 · 결단 · 비검 ``` **주요 전승** ```text 규화보전 천풍광세검 마영검진 ``` **주의** `잠혈월향검결`은 이름과 계보 흔적은 있으나 실제 기술 파일이 없는 **단절 전승**이다. 자세한 내용은 제2권. **정문** ```text /방/문파/일월신교/정문 ``` *** ## 4.5 개방 **한줄** > 천하의 길과 사람 사이를 잇고 장법과 타구의 실전을 전하는 방문. **결** ```text 강호 · 장법 · 실전 ``` **주요 전승** ```text 타구절초 황룡십팔장 회선장법진 ``` **추천 성향** * 격식보다 실전 * 사람과 길의 연결 * 호방한 장법 * 강호 공동체 **정문** ```text /방/문파/개방/정문 ``` *** ## 4.6 곤륜파 **한줄** > 서쪽 설산의 찬 기운 속에서 운룡의 변화와 잠룡의 도약을 닦는 도맥. **결** ```text 운룡 · 설산 · 변화 ``` **주요 전승** ```text 운룡검결 잠룡승천무 천산비설 곤륜오행진 ``` **정문** ```text /방/문파/곤륜파/정문 ``` *** # 5\. 문파 개방 조건 중앙 정본: ```text MUNPA_CORE_D->getRequiredHwaseoMission() ``` 현재 값: ```text 화서마을 본편 14 ``` 즉 플레이어가 문파 입문 의례를 시작하려면: ```text who->getMission("화서마을") >= 14 ``` 가 필요하다. ## 5.1 중요한 철학 문파는 캐릭터 생성 직후 즉시 고르는 직업 선택창이 아니다. 플레이어는 먼저 세계를 조금 살아 본 뒤 문파를 만난다. 이 구조의 뜻: * 초보 조작을 먼저 익힘 * 세계관을 먼저 경험 * 문파 선택이 캐릭터 정체성의 두 번째 탄생이 됨 * 처음부터 지나친 정보량을 주지 않음 *** # 6\. 정문 기반 입문 의례 입문 정본: ```text lib-runtime/관리자/문파/입문관리.c ``` 사람 장문인·교주·방주가 없어도 기본 입문은 계속된다. ## 6.1 공통 흐름 ```text 1. 해당 문파 정문 도착 2. 입문신청 또는 입교신청 3. 입문계속 4. 입문 문답 5. 입문응답 1|2|3 6. 문파별 상징 시험 명령 7. 회원 장부 1단계 등록 8. 성장 장부 생성 9. 플레이어 소속 동기화 10. R49 복귀자라면 이력에 따른 흔적 복원 ``` ## 6.2 진행 상태 저장 플레이어 저장 대상 mission 변수를 쓴다. ```text 문파입문대상 문파입문단계 ``` 단계: | 단계 | 의미 | | --- | --- | | 1 | 첫 문을 열고 `입문계속` 대기 | | 2 | `입문응답` 대기 | | 3 | 상징 시험 대기 | 확인: ```text 입문상태 ``` 취소: ```text 입문취소 ``` 다른 문파 의례를 진행 중이라면 먼저 취소해야 한다. *** # 7\. 문파별 입문 의례 상세 ## 7.1 무당파 **접인자** ```text 접인도인 ``` **문답** > 힘이 밀려올 때 그 힘을 어떻게 다루겠는가? 선택지는 정답 시험이 아니다. 어느 마음으로 산문에 서는지 기록하는 절차다. **상징 시험** ```text 물결살피기 ``` **시험 이미지** > 돌수반의 잔물결이 바람과 발걸음에 따라 달라진다. 서두르지 말고 흐름을 읽어라. **완료 상징** ```text 작은 태극 목패 ``` *** ## 7.2 화산파 **접인자** ```text 수문검사 ``` **문답** > 검을 뽑은 뒤 가장 먼저 잊지 말아야 할 것은 무엇인가? **상징 시험** ```text 매화밟기 ``` **시험 이미지** > 붉은 바위 사이에 떨어진 매화 꽃잎 세 장을 밟지 않고 지나 검흔 앞에 선다. **완료 상징** ```text 매화 문양 목패 ``` *** ## 7.3 명교 **접인자** ```text 인도사자 ``` **문답** > 빛이 가장 필요한 때는 언제라고 생각하는가? **상징 시험** ```text 등불지키기 ``` **시험 이미지** > 바람 드는 돌계단 위 작은 등불 하나를 두 손으로 감싸되 불꽃을 억지로 누르지 않는다. **완료 상징** ```text 빛과 불의 매듭패 ``` *** ## 7.4 일월신교 **접인자** ```text 흑목호법 ``` **문답** > 두려움이 일어날 때 무엇을 먼저 끊어야 하는가? **상징 시험** ```text 철문서기 ``` **시험 이미지** > 세 겹 철문 앞에 홀로 서서 문이 울리는 동안 한 걸음도 물러서지 않는다. **완료 상징** ```text 검은 나무패 + 붉은 끈 ``` *** ## 7.5 개방 **접인자** ```text 전공장로 ``` **문답** > 강호의 소문 하나를 들었을 때 가장 먼저 해야 할 일은 무엇인가? **상징 시험** ```text 풍문잇기 ``` **시험 이미지** > 처마 밑 세 쪽지의 서로 다른 소문을 읽고 겹치는 사실 한 줄만 골라 잇는다. **완료 상징** ```text 낡았지만 단단한 매듭패 ``` *** ## 7.6 곤륜파 **접인자** ```text 접인도사 ``` **문답** > 높은 곳에 오를수록 무엇을 더 조심해야 하는가? **상징 시험** ```text 설계단오르기 ``` **시험 이미지** > 눈 덮인 푸른 돌계단을 호흡 세 번마다 한 계단씩 올라 구름문 앞에 멈춘다. **완료 상징** ```text 푸른 돌조각 문패 ``` *** # 8\. 입문 중 검증되는 조건 `입문관리.c`의 `validateFree()`는 다음을 검사한다. 1. 대상이 활성 정규 문파인가 2. 실제 그 문파 정문에 있는가 3. 화서마을 본편 14 이상인가 4. 이미 다른 정규 문파 소속인가 5. R49 탈퇴·전향·파문 숙려 제한이 남아 있는가 ## 8.1 중복 소속 금지 활성 문파원 장부는 한 사람에게 한 문파만 허용한다. 중앙 판정: ```text MUNPA_D->checkTotalMunpaList(name) ``` 이미 소속이 있으면 다른 문파 입문은 막힌다. *** # 9\. 회원 장부의 정본 정본 관리자: ```text lib-runtime/관리자/문파/문파원관리.c ``` 핵심 책임: * 문파별 회원 mapping * 문파별 서열 정수 * 중복 가입 차단 * 가입/탈퇴 * 플레이어 `munpa`, `jobLevel` 동기화 ## 9.1 회원 추가 ```text addMunpaList(munpa, name, jobLevel) ``` 중요 조건: * 활성 문파만 허용 * `jobLevel >= 1` * 다른 정규 문파에 이미 있으면 거부 ## 9.2 회원 제거 ```text removeMunpaList(munpa, name) ``` R49에서는 문파 이력 관리자가 이 함수를 통해 이탈을 처리한다. ## 9.3 단일 소속 조회 ```text checkTotalMunpaList(name) ``` 이 값이 현재 활성 소속의 정본이다. *** # 10\. 플레이어 소속 동기화 핵심 함수: ```text syncPlayerMunpa(ob) ``` 현재 회원 장부를 읽어 플레이어 객체에 반영한다. 활성 소속이 있으면: ```text ob->setMunpa(found) ob->setJobLevel(getJobLevel(found, level)) ``` 활성 소속이 없으면: ```text ob->setMunpa(0) ob->setJobLevel(0) ``` 단, 옛 소속이 신선궁 같은 봉인 유산이라면: ```text 유산문파 = 신선궁 ``` 표지를 저장할 수 있다. ## 10.1 중요한 원칙 플레이어 객체의 `getMunpa()` 문자열을 영원한 진실로 믿지 않는다. **활성 회원 장부가 정본**이며 플레이어 객체는 동기화 대상이다. *** # 11\. 1\~10단계 서열 체계 입문 완료 시 첫 서열: ```text 1단계 ``` 서열은 단순 숫자지만 플레이어에게는 문파별 직책명으로 보인다. ## 11.1 무당파 | 단계 | 직책 | | ---: | --- | | 1 | 수련생 | | 2 | 문하생 | | 3 | 시원백대제자 | | 4 | 혼원황대제자 | | 5 | 무원청대제자 | | 6 | 극원적대제자 | | 7 | 진원흑대제자 | | 8 | 도사 | | 9 | 도백 | | 10 | 도선 | ## 11.2 화산파 | 단계 | 직책 | | ---: | --- | | 1 | 수련제자 | | 2 | 문하제자 | | 3 | 청운제자 | | 4 | 왕자동인제자 | | 5 | 노군동인제자 | | 6 | 서현동인제자 | | 7 | 태극동인제자 | | 8 | 사대동천인 | | 9 | 연화도인 | | 10 | 상궁인 | ## 11.3 명교 | 단계 | 직책 | | ---: | --- | | 1 | 신입신도 | | 2 | 평신도 | | 3 | 분파포교원 | | 4 | 총교포교원 | | 5 | 분파포교장 | | 6 | 총교포교장 | | 7 | 오행기기수 | | 8 | 오산인 | | 9 | 사대호교호법왕 | | 10 | 광명좌우사자 | ## 11.4 일월신교 | 단계 | 직책 | | ---: | --- | | 1 | 신입교도 | | 2 | 외교도 | | 3 | 내교도 | | 4 | 교사 | | 5 | 기주 | | 6 | 당주 | | 7 | 향주 | | 8 | 장로 | | 9 | 호법 | | 10 | 수석호법 | ## 11.5 개방 | 단계 | 직책 | | ---: | --- | | 1 | 신입제자 | | 2 | 일결제자 | | 3 | 이결제자 | | 4 | 삼결제자 | | 5 | 사결제자 | | 6 | 오결제자 | | 7 | 육결제자 | | 8 | 칠결장로 | | 9 | 팔결장로 | | 10 | 구결장로 | ## 11.6 곤륜파 | 단계 | 직책 | | ---: | --- | | 1 | 수련생 | | 2 | 문하생 | | 3 | 외문제자 | | 4 | 정식제자 | | 5 | 내문제자 | | 6 | 전수제자 | | 7 | 호법 | | 8 | 장로 | | 9 | 수석장로 | | 10 | 태상도인 | *** # 12\. 성장 장부 정본: ```text lib-runtime/관리자/문파/문파성장.c ``` 문파별 데이터 경로: ```text /방/문파/<문파>/data/성장장부 ``` ## 12.1 한 문파원의 성장 기록 한 줄의 본질: ```text 이름 공헌 수행횟수 가입시각 마지막활동 마지막수행 ``` 논리 구조: ```text 공헌 수행 가입시각 마지막활동 마지막수행 ``` ## 12.2 입문 순간 정식 입문이 끝나면: ```text registerNewMember(who, munpa) ``` 가 호출된다. 초기값 개념: ```text 공헌 0 수행 0 가입시각 현재 마지막활동 현재 마지막수행 0 ``` R49 복귀자라면 그 뒤 `onMemberJoined()`가 이력 유형에 맞게 일부 흔적을 다시 심는다. *** # 13\. 활동 각인 함수: ```text touchMember(who) ``` 문파 명령을 사용할 때 활동 흔적을 갱신할 수 있다. 디스크 쓰기 폭증을 막기 위해: ```text 10분 이상 차이 ``` 가 날 때만 마지막활동을 갱신한다. 이 마지막활동은 다음에 쓰인다. * 최근 30일 활동 문파원 판정 * 투표권 * 후보 자격 * 지도자 장기 미접속 * 자동 장로단 * 공동체 상태 *** # 14\. 문파 수행 명령: ```text 문파 수행 ``` 조건: * 활성 정규 문파 소속 * 자기 문파 정문 * 최근 수행 뒤 4시간 경과 쿨타임: ```text 14400초 = 4시간 ``` 보상: ```text 공헌 +10 수행 +1 ``` 동시에 진행 중 공동목표가 있으면: ```text 공동목표 진행 +10 ``` 으로 이어질 수 있다. ## 14.1 문파별 수행 서사 ### 무당파 * 돌수반 물 갈기 * 수련 뜰 발자국 고르기 * 접인도인과 새 문하 호흡 살피기 * 계곡 물길 낙엽 걷기 ### 화산파 * 매화 뜰 가지 거두기 * 검흔 돌바닥 씻기 * 수련목인 균열 점검 * 산길 붉은 표식 세우기 ### 명교 * 광명정 등잔 점검 * 꺼진 불씨 잇기 * 순례자 물과 식량 나누기 * 오행 깃발 매듭 고치기 ### 일월신교 * 철문 빗장 점검 * 벼랑길 밧줄 정비 * 야간 순찰표 정리 * 비검 표적 회수 ### 개방 * 소문 대조 * 사실과 허풍 가르기 * 굶주린 나그네 구휼 * 매듭패와 연락표 정리 ### 곤륜파 * 설산 계단 쓸기 * 난간 밧줄 묶기 * 풍향표와 길표식 점검 * 찬 샘 얼음 깨기 이 수행은 “클릭 보상”이 아니라 문파의 하루를 잇는 작은 노동이라는 의미를 가진다. *** # 15\. 성장 단계 이름 서열 정수를 넓은 성장 단계로 묶는다. | 서열 | 성장 단계 | | --- | ----- | | 1 | 수련문하 | | 2 | 기초문하 | | 3\~4 | 정식문하 | | 5\~6 | 핵심문하 | | 7\~10 | 책임문하 | 이 분류는 플레이어 이해와 자치 기반 설명에 쓰인다. *** # 16\. 자동 승급 조건 승급 명령: ```text 문파 승급 ``` 지도자 승인 없이 조건을 충족하면 오른다. ## 16.1 승급표 현재 서열에서 다음 서열로 오를 때 요구량: | 현재→다음 | 공헌 | 수행 | 가입 경과 | | ----- | ---: | ---: | ----: | | 1→2 | 30 | 3 | 0일 | | 2→3 | 100 | 8 | 1일 | | 3→4 | 250 | 15 | 3일 | | 4→5 | 500 | 25 | 7일 | | 5→6 | 900 | 40 | 14일 | | 6→7 | 1500 | 60 | 21일 | | 7→8 | 2400 | 85 | 30일 | | 8→9 | 3600 | 115 | 45일 | | 9→10 | 5200 | 150 | 60일 | ## 16.2 설계 의미 승급은 세 축을 함께 본다. ```text 공헌 수행 시간 ``` 따라서: * 돈만 넣어 즉시 승급 금지 * 접속 일수만 길어도 승급 금지 * 수행만 반복해도 시간 문턱 존재 * 지도자 친분으로 직급 상승 금지 *** # 17\. 문파 공동체 상태 함수: ```text getMunpaState(munpa) ``` 최근 30일 활동과 정식문하 수, 총공헌으로 공동체 상태를 결정한다. ## 17.1 상태 ### 무주기 ```text 최근 30일 활동 <= 2 ``` 뜻: > 사람 지도자 없이 접인자와 제도가 도맥을 지키는 때 ### 개창기 ```text 최근 30일 활동 3~4 ``` 뜻: > 소수 문하가 서로의 이름을 익히며 공동체를 세우는 때 ### 자치준비 다음 모두 충족: ```text 최근 30일 활동 5명 이상 정식문하 이상 활동자 3명 이상 문파 총공헌 1000 이상 ``` ### 성장기 위 셋의 자치조건에는 아직 못 미치지만 무주·개창 단계를 넘어선 상태. *** # 18\. 사람 지도자 선출 기반 R43은 자격을 정의하고, R44가 실제 선거를 맡는다. 문파 공동체 선출 기반: ```text 최근 30일 활동 5명 이상 정식문하 이상 활동자 3명 이상 총공헌 1000 이상 ``` 개인 후보 기반: ```text 서열 4 이상 개인 공헌 500 이상 가입 14일 이상 최근 30일 활동 ``` 투표권은 제3권에서 상세히 설명한다. *** # 19\. 플레이어 명령어 — 제1권 범위 ## 19.1 탐색·비교 ```text 문파 문파 목록 문파 정보 <이름> 문파 추천 문파 비교 <이름1> <이름2> 문파 길 <이름> 문파 신청 <이름> 문파 신청현황 ``` ## 19.2 성장 ```text 문파 공헌 문파 성장 문파 수행 문파 승급 문파 상태 문파 지도자 ``` ## 19.3 도움 ```text 문파 도움 문파 도움말 ``` ## 19.4 입문 의례 계열 정문 방과 접인자 연동 명령: ```text 입문신청 입교신청 입문계속 입문응답 1 입문응답 2 입문응답 3 입문상태 입문취소 ``` 문파별 시험: ```text 물결살피기 매화밟기 등불지키기 철문서기 풍문잇기 설계단오르기 ``` *** # 20\. 주요 데이터 경로 ## 20.1 회원 ```text /방/문파/<문파>/data/문파원 ``` ## 20.2 직책명 ```text /방/문파/<문파>/data/직책설정 ``` ## 20.3 성장 ```text /방/문파/<문파>/data/성장장부 ``` ## 20.4 입문 관련 옛 장부 ```text /방/문파/<문파>/data/입문신청자 /방/문파/<문파>/data/입문불허자 ``` 새 기본 입문은 사람 승인 대기 방식에 예속되지 않는다. 옛 장부가 남아 있다고 해서 새 입문 흐름을 뒤집어서는 안 된다. *** # 21\. 문파 입문과 복귀의 연결 R49 때문에 입문은 더 이상 “첫 가입”만 의미하지 않는다. 입문 완료 직후: ```text MUNPA_GROWTH_D->registerNewMember(who, name) MUNPA_LIFE_D->onMemberJoined(who, name) ``` 순으로 이어진다. 의미: 1. 먼저 새 회원으로 등록 2. 새 성장 기록 생성 3. 과거 같은 문파 이력이 있으면 복귀 유형에 따라 공헌·수행 일부 복원 4. 가입시각은 새로 시작 자세한 복귀율은 제3권. *** # 22\. 운영상 핵심 불변조건 다음은 R49 문파 구조의 “깨뜨리면 안 되는 뼈”다. ## 22.1 활성 문파는 정확히 6개 새 문파를 추가하려면 다음을 모두 검토해야 한다. * `문파기반.c` * `문파자료.c` * `입문관리.c` * `문파성장.c` * `문파자치.c` * `문파운영.c` * `문파기술.c` * `문파이력.c` * 회원 장부 * 직책설정 * 정문 * 수련방 * 기술 계보 한 파일에 이름 하나 넣는 것으로 끝나지 않는다. ## 22.2 신선궁은 봉인 활성 목록에 조용히 추가하면 안 된다. ## 22.3 회원 장부가 정본 플레이어 객체의 문자열만 바꾸면 안 된다. ## 22.4 기본 입문은 사람 지도자 승인 대상이 아님 지도자가 없는 문파도 살아 있어야 한다. ## 22.5 자동 승급은 지도자 권한 밖 친분과 독재를 방지한다. ## 22.6 새 수련방 강제 생성 금지 실제 수련 경로는 제2권의 중앙 전승 장부를 따른다. *** # 23\. 알려진 별도 결함 문파 패치 회귀와 분리 유지 중인 기존 결함: ```text 백운은총 → savedata ``` 이 문제는 R46\~R49 문파 체계의 성공/실패 판정에 섞지 않는다. 관련 기록: ```text R46-별도결함-백운은총-savedata-기록.md ``` *** # 24\. 개발자 변경 지침 ## 24.1 문파 소개 변경 수정 우선: ```text 관리자/문파/문파자료.c ``` 방마다 소개 문자열을 중복 복제하지 않는다. ## 24.2 정문 변경 수정 우선: ```text 관리자/문파/문파기반.c ``` 그리고 실제 방 경로와 길찾기 연결을 검증한다. ## 24.3 입문 조건 변경 수정 우선: ```text 문파기반.c 입문관리.c ``` R49의 `문파이력.c -> canJoin()` 제한을 우회하면 안 된다. ## 24.4 승급값 변경 수정 우선: ```text 문파성장.c -> getPromotionRequirement() ``` 기술 절정 조건의 `최소서열 7 / 공헌 2400`과 연동되는지 제2권 기준으로 함께 본다. ## 24.5 직책명 변경 수정 우선: ```text /방/문파/<문파>/data/직책설정 ``` 10단계 수와 실제 서열 체계 정합성을 유지한다. *** # 25\. 전체 흐름 요약 ```text 화서마을 본편 14 ↓ 문파 탐색·비교 ↓ 해당 문파 정문 ↓ 입문신청 / 입교신청 ↓ 입문계속 ↓ 문답 ↓ 상징 시험 ↓ 회원 장부 1단계 등록 ↓ 플레이어 소속 동기화 ↓ 성장장부 생성 ↓ 문파 수행 ↓ 공헌 + 수행 + 시간 ↓ 자동 승급 ↓ 책임문하 ↓ 절정 전승·자치 후보 기반으로 이어짐 ``` 문파는 직업 선택창이 아니라 하나의 두 번째 생애다. 정문은 문턱이고, 장부는 이름이며, 수행은 시간을 쌓는 작은 돌이다. *** ## 부록 A. 핵심 파일 빠른 목록 ```text lib-runtime/관리자/문파/문파기반.c lib-runtime/관리자/문파/문파자료.c lib-runtime/관리자/문파/입문관리.c lib-runtime/관리자/문파/문파원관리.c lib-runtime/관리자/문파/문파성장.c lib-runtime/명령어/플레이어/문파.c ``` ## 부록 B. 다음 권 * 제2권: 전승 기술·수련·실전 균형 * 제3권: 자치·운영·예산·이탈 생애주기