MUDNET

# 십웅기 가문 선택·가문이적·독문무기 재계승 명세 > 기준 버전: **R34** > > 기준 통파일: `sipwoonggi-runtime-full-synergy-network-r34-family-choice-lineage-transfer-20260708.tar.gz` > > 목적: 신규 가입 시 랜덤 가문 배정을 제거하고, 플레이어가 가문을 직접 선택할 수 있게 하며, 게임 중 가문이적 시 독문무기·유품·백화궁 독문기술을 안전하게 재계승하도록 한다. *** ## 1\. 개요 기존 십웅기에서는 가입 시 10개 출신세력 가운데 하나가 `random(10)`으로 결정되었다. 이 값은 단순한 배경 설정이 아니라 다음과 연결되어 있었다. * 탄생 배경 * 초기 능력치 성향 * 유품 임무 * 독문무기 계열 * 백화궁 완료 후 가문 독문기술 * 일부 NPC 대사와 장편 서사 따라서 R34부터는 가문을 장기 계승 선택으로 취급한다. 핵심 원칙은 다음과 같다. 1. 신규 가입 시 가문을 직접 선택한다. 2. 게임 중에도 가문이적은 가능하다. 3. 독문무기 획득 후 가문이적은 단순 숫자 변경이 아니다. 4. 독문무기·유품·백화궁 가문기술을 함께 재계승한다. 5. 기존 능력치는 가문이적 시 재추첨하지 않는다. 6. 실패 시 기존 가문·무기·유품·금전을 보존한다. 7. 옛 가문 기술을 수집하는 악용을 차단한다. *** ## 2\. 지원 가문 10개 | 번호 | 가문 | 성향 | 기본 독문 계열 | | ---: | --- | --- | -------- | | 1 | 철방 | 힘 중심 | 창 | | 2 | 무영루 | 민첩 중심 | 편 | | 3 | 성유림 | 지혜 중심 | 필 | | 4 | 취죽림 | 힘·지혜 | 봉 | | 5 | 혈막 | 민첩·지혜 | 비수 | | 6 | 사해마련 | 기골 중심 | 도 | | 7 | 남해청조각 | 내공 중심 | 검 | | 8 | 대력산장 | 기골·내공 | 부 | | 9 | 약왕문 | 내공·지혜 | 섭선 | | 10 | 대륙상가 | 지혜 중심 | 적/옥소 | *** ## 3\. 신규 가입 가문 선택 ### 3.1 기존 방식 ```c res = random(10); ``` 가입 시 자동으로 가문이 결정되었다. ### 3.2 R34 방식 가입 과정에서 직접 선택한다. 예시: ```text 【 출신 가문 선택 】 1. 철방 2. 무영루 3. 성유림 4. 취죽림 5. 혈막 6. 사해마련 7. 남해청조각 8. 대력산장 9. 약왕문 10. 대륙상가 ``` 번호와 이름 입력을 모두 지원한다. ```text 7 ``` 또는: ```text 남해청조각 ``` ### 3.3 중요 정책 가입 시 가문 선택은 초기 능력치 성향에 영향을 준다. 그러나 게임 중 가문이적은 **기존 능력치를 다시 뽑지 않는다.** 즉 다음 악용을 허용하지 않는다. ```text 철방으로 시작 → 힘 성향 획득 → 무영루 이적 → 민첩 성향 추가 획득 ``` 가문이적은 계승 관계 변경이지 능력치 재생성이 아니다. *** ## 4\. 플레이어 명령 ### 현재 가문 확인 ```text 가문 ``` 또는: ```text 가문정보 ``` 예상 출력: ```text 【 가문 계승 】 현재 가문 : 대력산장 계승 성향 : 기골·내공 · 부 계승 독문무기 : 철부 독문 수련 : 8 독문 임무 : 3 이적 횟수 : 0회 다음 비용 : 1000000냥 이적 대기 : 가능 ``` ### 가문이적 목록 ```text 가문이적 ``` 또는: ```text 가문변경 ``` ### 실제 이적 번호 방식: ```text 가문이적 7 ``` 이름 방식: ```text 가문이적 남해청조각 ``` 최종 확인: ```text 정말 이적하시겠습니까? [예/아니오] ``` *** ## 5\. 가문이적 공통 제한 ### 5.1 전투 중 금지 전투 중에는 가문이적을 허용하지 않는다. 이유: * 무장 객체 참조 * 공격력 계산 * 독문무기 객체 교체 * 전투 대상 상태 * 장비 귀속 등이 동시에 바뀔 수 있기 때문이다. ### 5.2 재이적 대기시간 성공한 가문이적 후: ```text 259200초 ``` 즉 **3일** 동안 다시 이적할 수 없다. `가문` 명령에서 남은 시간을 확인할 수 있다. 예: ```text 이적 대기 : 2일 11시간 ``` *** ## 6\. 가문이적 비용 정책 ### 6.1 독문무기 획득 전 조건: ```text 독문무기 임무 < 2 ``` 첫 이적: ```text 무료 ``` 이후: ```text 100,000 200,000 300,000 ... 최대 1,000,000 ``` ### 6.2 독문무기 획득 후 조건: ```text 독문무기 임무 >= 2 ``` 비용: ```text 1회차 1,000,000 2회차 2,000,000 3회차 3,000,000 ... 최대 10,000,000 ``` 목적: * 초보 선택 실수 구제 * 무제한 가문 순회 방지 * 가문기술 수집 악용 방지 * 경제적 의미 부여 *** ## 7\. 독문무기 임무와 가문이적 ### 7.1 독문무기 임무 시작 전 독문 계승을 받지 않은 상태에서는 비교적 자유롭게 변경할 수 있다. ### 7.2 독문무기 임무 진행 중 예: ```text 독문무기 = 1 ``` 상태에서 이적하면 기존 진행을 유지하지 않는다. 처리: ```text 기존 도적 처치 표식 정리 ↓ 독문무기 임무 0 ↓ 새 가문 기준으로 다시 시작 ``` 이유: 옛 가문으로 시작한 임무의 진행도를 새 가문 무기에 그대로 연결하면 서사와 보상이 꼬일 수 있기 때문이다. *** ## 8\. 독문무기 재계승 독문무기 상태가 2 이상이면 단순 삭제 후 1단계 무기를 지급하지 않는다. ### 핵심 원칙 > 현재 독문 수련 단계를 유지한 채 새 가문의 같은 단계 무기로 전환한다. 예: ```text 대력산장 독문 수련도 68 ↓ 남해청조각으로 이적 ↓ 남해청조각의 수련도 68 대응 독문검 ``` 수련도 68은 유지된다. ### 단계 계산 기존 독문무기 관리자의 실제 수련도 구간을 사용한다. 예: ```text 1~10 11~20 21~30 ... 91~100 ``` 별도 가짜 변환표를 만들지 않는다. *** ## 9\. 독문 수련도 100 초과 개인 완성형 무기 수련도 100을 넘는 독문무기는 플레이어 전용 경로를 사용한다. 예: ```text /물체/독문/플레이어/<개인무기> ``` R34 원칙: * 개인 완성형 이름 보존 * 플레이어 전용 경로 보존 * 가문이적 때문에 1단계 무기로 강등하지 않음 즉 100 초과 독문무기는 일반 가문 기성품보다 개인 완성형 계승물로 취급한다. *** ## 10\. 유품 임무와 가문이적 ### 10.1 유품 임무 진행 중 상태: ```text 유품 = 1~4 ``` 중 가문이적 시: ```text 유품 임무 0 ↓ 구출 지시 표식 정리 ↓ 새 가문으로 다시 시작 ``` ### 10.2 유품 임무 완료자 상태: ```text 유품 = 5 ``` 이면 새 가문의 유품 목걸이로 교체한다. 예: ```text 대력산장의목걸이 ↓ 남해청조각의목걸이 ``` 새 유품이 실제 인벤토리에 들어간 뒤 전환을 확정한다. *** ## 11\. 백화궁 완료자 처리 조건: ```text 백화궁 >= 100 ``` 이면 일반 유품이 아니라 승급 유품을 사용한다. 예: ```text 대력산장 승급 목걸이 ↓ 남해청조각 승급 목걸이 ``` 또한 가문 독문기술도 함께 전환한다. *** ## 12\. 백화궁 가문 독문기술 전환 | 가문 | 독문기술 | | --- | ---- | | 철방 | 뇌공혈풍격타 | | 무영루 | 신룡은비 | | 성유림 | 천멸흡룡기력 | | 취죽림 | 대자비범지장 | | 혈막 | 포풍환영지참 | | 사해마련 | 견룡무위지 | | 남해청조각 | 쾌풍연환진기 | | 대력산장 | 광풍대해폭우 | | 약왕문 | 무상천지대법 | | 대륙상가 | 금룡변회 | 예: ```text 대력산장 광풍대해폭우 수련도 47 ↓ 남해청조각 이적 ↓ 쾌풍연환진기 수련도 47 ``` 그리고 옛 기술: ```text 광풍대해폭우 ``` 는 제거한다. ### 악용 방지 다음 행동을 막기 위한 정책이다. ```text 철방 기술 습득 ↓ 무영루 이적 ↓ 무영루 기술 추가 습득 ↓ 또 이적 ↓ 모든 가문기술 수집 ``` R34에서는 새 가문 대응 기술로 **전환**하며, 옛 가문 기술을 계속 보유하지 않는다. *** ## 13\. 대력산장 특수 보조기술 대력산장은 백화궁 완료 시: ```text 대력흡마지 ``` 를 추가로 얻는 구조가 있다. ### 대력산장에서 다른 가문으로 이적 ```text 대력흡마지 제거 ``` ### 다른 가문에서 대력산장으로 이적 백화궁 완료자라면: ```text 대력흡마지 최소 1 보장 ``` *** ## 14\. 이적 트랜잭션 원칙 가문이적은 반드시 안전한 순서로 처리한다. ### 권장 순서 ```text 1. 새 가문 검증 2. 전투 여부 확인 3. 쿨다운 확인 4. 비용 확인 5. 새 독문무기 준비 6. 새 독문무기 인벤토리 이동 성공 확인 7. 새 유품 준비 8. 새 유품 인벤토리 이동 성공 확인 9. 비용 차감 10. History/가문 상태 변경 11. 옛 독문무기 회수 12. 옛 유품 회수 13. 가문기술 전환 14. 이적 기록 저장 15. 쿨다운 기록 ``` ### 금지되는 순서 ```text 옛 독문무기 삭제 ↓ 새 독문무기 생성 ↓ 공간 부족 ↓ 새 무기 지급 실패 ``` 이런 구조를 허용하지 않는다. *** ## 15\. 공간 부족 처리 새 독문무기나 새 유품을 받을 공간이 부족하면: ```text 가문 그대로 돈 그대로 옛 독문무기 그대로 옛 유품 그대로 ``` 를 유지한다. 즉 실패는 원상복구되어야 한다. *** ## 16\. 금전 처리 비용 차감 결과가 예상과 다르면: * 새로 준비한 임시 물품 제거 * 금전 원복 * 가문 변경 취소 * 기존 상태 유지 를 원칙으로 한다. *** ## 17\. 이적 기록 저장 R34에서 사용하는 주요 저장값: ```text 가문이적횟수 가문이적시각 가문이전가문 가문현재가문 ``` 활용 가능 분야: * 가문 계보 UI * 과거 가문 기록 * NPC 특수 대사 * 이적 횟수에 따른 비용 * 칭호 * 후속 퀘스트 * 가문 명예/불명예 시스템 *** ## 18\. 신규/변경 파일 ### 신규 ```text lib-runtime/구조/가문.c lib-runtime/명령어/플레이어/가문.c lib-runtime/도움말/가문.help ``` ### 변경 ```text lib-runtime/관리자/독문무기.c lib-runtime/관리자/로긴.c tools/smoke-preload-stage5.txt ``` *** ## 19\. 운영자 확인 항목 가문이적 관련 장애가 접수되면 다음을 확인한다. ### 기본 정보 ```text 현재 History 값 현재 가문명 가문이적횟수 가문이적시각 가문이전가문 가문현재가문 ``` ### 임무 상태 ```text 독문무기 유품 백화궁 ``` ### 기술 상태 ```text 현재 가문 독문기술 이전 가문 독문기술 잔존 여부 대력흡마지 ``` ### 물품 상태 ```text 현재 독문무기 객체 현재 독문 수련도 유품 목걸이 승급 유품 ``` *** ## 20\. 테스트 체크리스트 ### 신규 가입 * [ ] `random(10)` 자동 배정이 제거되었는가 * [ ] 번호 1\~10 입력이 가능한가 * [ ] 가문 이름 입력이 가능한가 * [ ] 잘못된 입력 시 재선택 가능한가 * [ ] 선택한 가문이 저장되는가 * [ ] 재접속 후 유지되는가 ### 독문무기 전 이적 * [ ] 첫 이적 무료인가 * [ ] 두 번째부터 비용이 증가하는가 * [ ] 능력치가 재추첨되지 않는가 * [ ] 3일 재이적 제한이 걸리는가 ### 독문무기 진행 중 * [ ] 상태 1에서 이적 시 임무가 안전 재시작되는가 * [ ] 도적 처치 표식이 정리되는가 ### 독문무기 완료 후 * [ ] 수련도가 유지되는가 * [ ] 새 가문의 같은 단계 무기가 지급되는가 * [ ] 옛 독문무기가 회수되는가 * [ ] 공간 부족 시 변경이 취소되는가 ### 유품 * [ ] 진행 중 1\~4 상태가 안전 재시작되는가 * [ ] 완료자 5 상태는 새 가문 목걸이로 교체되는가 * [ ] 백화궁 완료자는 승급 목걸이를 받는가 ### 백화궁 기술 * [ ] 새 가문 대응 기술로 전환되는가 * [ ] 수련도가 유지되는가 * [ ] 옛 가문 기술이 제거되는가 * [ ] 대력흡마지가 올바르게 추가/제거되는가 ### 저장·재접속 * [ ] 가문이적 후 저장되는가 * [ ] 재접속 후 현재 가문이 유지되는가 * [ ] 독문무기 상태가 유지되는가 * [ ] 유품 상태가 유지되는가 * [ ] 기술 전환 결과가 유지되는가 * [ ] 쿨다운이 유지되는가 *** ## 21\. 현재 검증 상태 R34 기준: * 핵심 불변조건: **25/25 PASS** * FluffOS 2.28.2 전체 smoke: **PASS** * 최종 tar.gz 재추출본 smoke: **PASS** 아직 완료하지 않은 수동 종단시험: 1. 완전 신규 계정 생성 2. 가입 화면에서 1\~10 가문 선택 3. 저장·재접속 4. 실제 운영 계정에서 비용 차감 5. 독문무기 보유 상태 가문이적 6. 새 독문무기 확인 7. 재접속 후 계승 상태 확인 *** ## 22\. 설계 철학 가문은 단순 성씨나 시작 보너스가 아니다. R34 이후의 가문은 다음을 함께 묶는 장기 계승 축이다. ```text 출신 ↓ 유품 ↓ 독문무기 ↓ 가문기술 ↓ 백화궁 승급 ↓ 이적 기록 ↓ 새 계승 ``` 따라서 가문이적은 초기화가 아니라: > **한 캐릭터가 지나온 계보를 보존하면서 새로운 계승으로 옮겨 가는 사건** 으로 취급한다. 향후에는 다음 확장이 가능하다. * 과거 가문 이력 UI * 가문별 칭호 * 가문 이적 NPC * 전가 의식 * 가문 명예 * 가문 공헌도 * 가문 전용 저택 * 과거 가문 NPC의 반응 변화 * 배신/용서/복권 서사 * 독문무기 계승석 * 가문 연대기 *** ## 23\. 관련 기준 통파일 ```text sipwoonggi-runtime-full-synergy-network-r34-family-choice-lineage-transfer-20260708.tar.gz ``` SHA-256: ```text ba24dc9906ff059f047a0b3d6fd5b362b05d5152899ae47d2f86b6343048d4f6 ```