MUDNET

# 십웅기 정령 시스템 상세 내역 > **기준 판본:** Stage59 — 멀티 보스 기여도·공정 보상 통합본**기준 파일:** `sipwoonggi-runtime-stage59-multiboss-fair-reward-utf8-nfc.tar.gz`**설치 기준 경로:** `/srv/sipwoonggi/runtime`**주 저장 키:** `정령데이터`**개방 자격 키:** `사원소정령석`**문서 성격:** 현재 구현 명세·플레이 안내·운영 기준·개발 확장 지침을 함께 담은 통합 기준서 *** ## 1\. 체계의 뜻과 자리 십웅기의 정령은 장비처럼 끼웠다 벗는 수치 묶음도, 주인공의 행동을 대신하는 단순 소환수도 아니다. 불·물·바람·땅이라는 네 갈래 원소가 저마다 성격과 몸 상태, 기억과 친밀도, 성장과 서약을 지닌 채 주인공과 동행하는 **독립 협공자**다. 현재 전투 편성의 기본형은 다음과 같다. ```text 주인공 1명 + 출전 동행자 1명 + 소환 정령 1체 ``` 전투박자에서 세 존재의 기본 흐름은 다음과 같다. ```text 주인공 기본 공격 → 동행자 보조행동 → 정령 보조행동 ``` 정령과 동행자는 주인공의 기본 공격 횟수를 빼앗지 않는다. 동행자와 정령도 서로의 행동칸을 나누지 않는다. 따라서 정령을 소환했다고 주인공의 공격이 줄어들지 않으며, 문객이 행동했다고 정령이 쉬는 구조도 아니다. ### 핵심 설계 원칙 1. **네 정령을 모두 보유한다.**무공 30에 노야에게서 사원소 정령석을 받으면 물·불·바람·땅 네 정령이 한꺼번에 열린다. 2. **동시에 활동하는 정령은 하나다.**네 정령의 성장 기록은 각각 보존되지만 실제 동행·전투 정령은 한 체뿐이다. 3. **전투 중 교대가 전술의 중심이다.**보스 전조와 전장 상황에 맞추어 정령을 바꾼다. 교대해도 각 정령의 체력·내력·이동력·컨디션·고유 재사용 시간은 그대로 남는다. 4. **역할이 뚜렷하다.**운디네는 회복, 살라만드라는 화상과 공격, 실프는 회피, 그놈은 피해 대리를 맡는다. 5. **성장은 전투만으로 끝나지 않는다.**대화·격려·선물·수련·원소석 축복·인연 임무·사원소 합동 임무가 함께 성장축을 이룬다. 6. **정령은 기억한다.**위험, 치유, 방어, 승리, 선물, 대화, 맹약 기술, 보스 전조 대응을 최근 기억으로 남긴다. 7. **통합 보스에서는 역할 공헌을 인정한다.**Stage59부터 공격 피해뿐 아니라 회복·방어·회피·봉인·전조 대응도 공동 보스 공적으로 계산한다. *** ## 2\. 전체 개방과 성장 흐름 | 단계 | 조건 | 열리는 내용 | | --- | ---: | ------ | | 네 원소의 부름 | 무공 30 도달 | 오두막으로 돌아가라는 1회 안내 | | 사원소 정령석 | 무공 30 이상 + 분지 오두막의 노야와 같은 방 | 네 정령 영구 소환 자격 | | 기본 동행 | 정령석 보유 | 소환·해제·도감·상태·대화·탐색·전투 보조 | | 교감 | 친밀도 10 | 첫 인연 단계, 정령별 첫 인연 임무 시작 가능 | | 서약 | 정령 레벨 10 + 친밀도 50 | 원소 서약, 고유 기술과 1단계 진화 | | 맹약 기술 | 첫 인연 임무 완료 + 친밀도 70 | 전투 중 수동 맹약 기술 사용 | | 2단계 진화 | 서약 + 레벨 20 + 친밀도 70 | 둘째 진화 기술과 능력 상승 | | 일심 | 친밀도 90 | 맹약 기술 강화형 발동 | | 3단계 진화 | 서약 + 레벨 30 + 친밀도 90 | 최종 진화 형상과 기술 | | 사원소 합동 임무 | 네 정령 첫 인연 임무 모두 완료 | 네 관문을 잇는 합동 탐험 | | 사원소의 인장 | 합동 임무 완료 + 무명 공명수호자 처치 | 네 정령 모두 경험치 +50, 전투 재교대 대기 2턴→1턴 | | 공동 보스 성장 | 통합 보스에 여러 플레이어 참여 | 45:55 공적 보상과 정령별 60:40 성장 분배 | ### 무공 30 안내와 실제 해금의 구분 무공 30에 닿으면 플레이어 heartbeat의 `spiritAmbientTick()`이 한 번만 「네 원소의 부름」 안내를 보여 준다. 이 시점에는 아직 소환 자격이 없다. 실제 해금은 분지 오두막의 노야가 `missionCheck()`에서 다음 조건을 확인할 때 일어난다. ```text 플레이어 무공 >= 30 그리고 사원소정령석 저장값이 없음 ``` 조건을 만족하면 노야가 `사원소정령석 = 1`을 기록하고, 네 정령을 모두 부를 수 있게 한다. ### 옛 저장자료 호환 Stage18 이전부터 이미 `정령데이터` 안에 정령 성장 기록이 있는 인물은 그 기록을 잃지 않도록 `hasFourElementStone()`이 사원소 정령석을 받은 것으로 이어받는다. 따라서 예전 정령 육성 기록이 있는 캐릭터는 새 개방 사건 때문에 소환권을 잃지 않는다. *** ## 3\. 네 정령의 원형 ### 3.1 기초 능력치 | 내부 식별자 | 이름 | 원소 | 초깃단계 | 성격 | 기본 HP | 기본 MP | 기본 이동력 | 공격 | 방어 | 속도 | 기본 기술명 | | ------ | --- | --- | ---- | --- | ----: | ----: | -----: | ---: | ---: | ---: | ------ | | `undine` | 운디네 | 물 | 어린 물결 | 차분함 | 80 | 120 | 70 | 8 | 6 | 7 | 물결치유, 수막보호 | | `salamander` | 살라만드라 | 불 | 어린 불씨 | 거침 | 120 | 70 | 70 | 14 | 5 | 7 | 불꽃물기, 작열숨결 | | `sylph` | 실프 | 바람 | 작은 바람 | 가벼움 | 60 | 80 | 120 | 9 | 4 | 14 | 칼바람, 흐린발걸음 | | `gnome` | 그놈 | 땅 | 작은 흙덩이 | 충직함 | 150 | 50 | 50 | 10 | 12 | 4 | 돌주먹, 대지방패 | > 기초 기술명은 도감과 상태에 표시되는 정령의 본래 재능이다. 현재 실제 전투에서는 별도의 기술 선택창보다 각 정령의 자동 역할 로직으로 발현한다. `정령 기술 사용`은 첫 인연 임무 뒤 열리는 **맹약 기술**을 뜻한다. ### 3.2 역할 요약 | 정령 | 핵심 역할 | 주 자원 | 자동 방어·회복 | 공격 특성 | | --- | ----- | ---- | -------- | ----- | | 운디네 | 치유·수막 | 내력 | 위험 체력 자동 회복 | 물방울 보조타 | | 살라만드라 | 공격·화상 | 내력 | 직접 방어 없음 | 불씨·지속 화상 | | 실프 | 회피·피해 흘리기 | 이동력 | 확률 회피·감쇄 | 속도 기반 칼바람 | | 그놈 | 피해 대리·방패 | 체력·이동력 | 정령 몸으로 피해 일부 부담 | 안정적인 대지 타격 | ### 3.3 원소별 성장 방향 정령이 레벨을 올릴 때 원소마다 다른 능력이 크게 자란다. #### 운디네 ```text 최대 HP += 7 + 방어 / 3 최대 MP += 12 + 새 레벨 / 4 최대 이동력 += 4 방어 += 1 레벨이 3의 배수면 속도 += 1 ``` #### 살라만드라 ```text 최대 HP += 9 최대 MP += 8 + 공격 / 3 최대 이동력 += 5 공격 += 2 레벨이 4의 배수면 속도 += 1 ``` #### 실프 ```text 최대 HP += 5 최대 MP += 6 + 속도 / 4 최대 이동력 += 12 + 속도 / 2 속도 += 2 레벨이 4의 배수면 방어 += 1 ``` #### 그놈 ```text 최대 HP += 14 + 방어 / 2 최대 MP += 3 최대 이동력 += 4 + 속도 / 4 방어 += 2 레벨이 4의 배수면 공격 += 1 ``` 레벨 상승 때 체력·내력·이동력은 모두 최대치로 회복된다. *** ## 4\. 명령 체계 권장 어순은 **체계 + 기능 + 대상**이다. ```text 정령 정보 물 정령 외형 실프 정령 임무 시작 땅 정령 전투로그 간결 ``` 기존 붙여쓰기 명령과 여러 별칭도 호환한다. ### 4.1 소환과 기본 관리 | 명령 | 기능 | | --- | --- | | `소환 물` / `소환 운디네` | 운디네 소환 또는 전투 중 교대 | | `소환 불` / `소환 살라만드라` | 살라만드라 소환 또는 교대 | | `소환 바람` / `소환 실프` | 실프 소환 또는 교대 | | `소환 땅` / `소환 그놈` | 그놈 소환 또는 교대 | | `정령 해제` | 비전투 중 현재 정령을 정령계로 돌려보냄 | | `정령 목록` / `정령 도감` | 네 정령의 성장·인연·형상·소환 상태 | | `정령 정보 물` | 지정 정령의 상세 능력과 다음 성장 문턱 | | `정령 상태` | 현재 동행 정령의 전체 상태 | | `정령 전투` | 자원·역할·재사용·화상·교대 대기 | ### 4.2 관계와 기억 | 명령 | 기능 | | --- | --- | | `정령 대화 [말]` | 현재 정령과 대화 | | `정령에게 말 <내용>` | 대화 별칭 | | `정령 격려` | 친밀도·감정·컨디션 상승 | | `정령 주기 <물건>` | 소지 물건 하나를 실제 소모하여 선물 | | `정령 친밀도` / `정령 감정` | 관계, 말투, 감정, 몸 상태, 선물 기호 | | `정령 기억` | 현재 정령의 가장 최근 사건 회상 | | `정령 기억첩 [원소]` | 시험·인연 임무·맹약·합동 임무의 연대기 | | `정령 외형 [원소/전체]` | 인연과 진화에 따른 형상 묘사 | ### 4.3 성장과 제단 | 명령 | 기능 | | --- | --- | | `정령 휴식` / `정령 회복` | 현재 정령의 HP·MP·이동력·컨디션 회복 | | `정령 수련` | 경험·친밀도·원소석 조각 획득 | | `정령 원소석` / `정령석` | 조각 보유량 확인 | | `정령 제단` | 현재 정령의 제단 축복 조건 확인 | | `정령 축복` | 원소 조각 7개와 순백 조각 1개를 바쳐 능력 강화 | | `정령 서약` | 레벨 10·친밀도 50에서 원소 서약 | | `정령 진화` / `정령 각성` | 조건을 갖춘 다음 진화 한 단계 진행 | | `정령 기술` | 맹약 기술의 씨앗·친밀도·재사용 상태 확인 | | `정령 기술 사용` | 전투 중 현재 정령의 맹약 기술 발동 | ### 4.4 탐험과 임무 | 명령 | 기능 | | --- | --- | | `정령 말` | 대기 대사를 즉시 한 번 들음 | | `정령 기척` | 현재 방의 원소·성소·불길한 분위기 감응 | | `정령 탐색` | 출구·틈·물길·균열·위험 단서 탐색 | | `정령 명령 [행동] [대상]` | 방·물체의 정령 상호작용 실행 | | `정령 임무` | 네 정령의 첫 인연 임무 상태 | | `정령 임무 시작 물` | 지정 정령의 첫 장 시작 | | `사원소 임무` | 합동 임무 진행 상태 | | `사원소 임무 시작` | 네 첫 장 완료 뒤 합동 임무 시작 | | `사원소 인장` | 영구 교대 단축 효과 확인 | ### 4.5 전투 문구 설정 | 명령 | 표시 방식 | | --- | ----- | | `정령 전투로그 상세` | 일반 공격과 주요 발동 모두 표시 | | `정령 전투로그 보통` | 주요 발동은 모두, 일반 공격은 4박자 간격 표시 | | `정령 전투로그 간결` | 회복·방어·회피·화상 같은 주요 발동만 표시 | | `정령 전투로그 끄기` | 정령 전투 문구 숨김 | 전투 계산은 문구 표시와 무관하게 그대로 실행된다. *** ## 5\. 소환·해제·교대 규칙 ### 5.1 소환 * 사원소 정령석을 보유해야 한다. * 한 번에 한 정령만 `active`가 된다. * 이미 같은 정령이 활동 중이면 다시 소환하지 않는다. * 비전투 소환은 전투박자와 남은 화상을 초기화한다. * 소환 장면은 정령의 인연·서약·진화 형상에 따라 달라진다. ### 5.2 전투 중 교대 전투 중 다른 정령을 소환하면 기존 정령은 물러나고 새 정령이 즉시 활동 정령이 된다. 기본 재교대 대기는 다음과 같다. ```text 기본: 2턴 사원소의 인장 보유: 1턴 ``` 교대할 때 유지되는 것: * 정령별 현재 HP·MP·이동력 * 컨디션과 감정 * 운디네·실프·살라만드라 고유 재사용 대기 * 공통 맹약 기술 재사용 대기 * 살라만드라가 원래 대상에게 남긴 화상 * 보스전 정령 기여 명부 교대로 초기화되지 않는다는 점이 중요하다. 자원이 마른 정령을 내보냈다가 바로 다시 불러도 회복되지 않는다. ### 5.3 화상의 대상 귀속 살라만드라 화상은 몬스터 이름이 아니라 clone의 `file_name()`을 대상 열쇠로 삼는다. * 같은 이름의 다른 몬스터로 대상을 바꾸면 화상이 옮겨붙지 않는다. * 원래 대상이 사라지거나 clone 식별자가 달라지면 남은 화상을 걷는다. * 전투가 완전히 끝나면 heartbeat에서 전투박자와 화상 상태를 정리한다. ### 5.4 해제 * 비전투에서만 가능하다. * 전투 중에는 해제할 수 없으며 다른 정령을 소환해 교대해야 한다. *** ## 6\. 경험치와 단계 성장 ### 6.1 다음 레벨 요구 경험치 정령 레벨을 `L`이라고 할 때 다음 단계 요구치는 다음과 같다. ```text 다음 경험치 = 200 + L² × 80 ``` 예시: | 현재 레벨 | 다음 단계 요구 경험치 | | ----: | -----------: | | 1 | 280 | | 5 | 2,200 | | 10 | 8,200 | | 20 | 32,200 | | 30 | 72,200 | 현재 코드에는 정령 레벨의 명시적 강제 상한이 없다. 단계 이름과 주요 진화 문턱은 30까지 마련되어 있으나, 경험치 누적과 레벨 증가는 그 이후에도 계산된다. ### 6.2 일반 단계 이름 | 레벨 | 운디네 | 살라만드라 | 실프 | 그놈 | | ---: | --- | ----- | --- | --- | | 1\~9 | 어린 물결 | 어린 불씨 | 작은 바람 | 작은 흙덩이 | | 10\~19 | 흐르는 샘 | 타오르는 불꽃 | 빠른 바람 | 단단한 돌 | | 20\~29 | 깊은 물결 | 붉은 화신 | 푸른 폭풍 | 산의 수호자 | | 30 이상 | 원소의 왕권 | 원소의 왕권 | 원소의 왕권 | 원소의 왕권 | 서약과 진화를 마친 경우 일반 단계 이름보다 서약·진화 형상 이름이 우선 표시된다. ### 6.3 경험치 획득 경로 * 정령 독립 보조공격 성공 * 자동 치유·방어·회피 발동 * 맹약 기술 사용 * 보스 전조 올바른 대응 * 적 처치 보상 * 정령 수련 * 탐험 상호작용 보상 * 정령별 첫 인연 임무 * 사원소 합동 임무와 인장 보상 일반 몬스터 처치에서는 플레이어에게 계산된 처치 수련치의 약 3분의 1이 정령 성장치로 전달된다. 통합 보스에서는 Stage59 공적 정산으로 확정된 플레이어 보상의 3분의 1이 정령 성장 분배기로 들어간다. ### 6.4 전투 도중 소량 성장 정령이 실제로 공격·방어·회복에 성공하면 보조행동 자체에서도 소량 경험치를 얻는다. 따라서 처치 막타를 얻지 못하더라도 전투에 계속 참여한 정령은 조금씩 성장한다. ### 6.5 원소석 조각의 전투 획득 `gainSpiritExpForId()`가 호출될 때 다음 확률로 조각이 깨어난다. ```text 해당 원소 조각 확률 = 8% + 진화 단계 × 2% 추가 순백 조각 확률 = 8% + 서약 여부 × 4% ``` 순백 조각 판정은 해당 원소 조각이 먼저 생긴 경우에만 이어진다. *** ## 7\. 독립 협공과 전투박자 ### 7.1 보조타 주기 정령 보조공격은 정령 전투박자 기준으로 **2턴마다 한 번** 실행된다. ```text 1박자: 상태·재사용·화상 처리, 일반 보조타 없음 2박자: 상태·화상 처리 + 정령 보조타 3박자: 상태·화상 처리, 일반 보조타 없음 4박자: 상태·화상 처리 + 정령 보조타 ``` 화상과 맹약 지속효과는 보조타가 쉬는 박자에도 처리될 수 있다. ### 7.2 전투 중 컨디션과 감정 * 4박자마다 현재 정령 컨디션 `-1` * 8박자마다 감정 변화 * 살라만드라가 컨디션 35 이상이면 감정 `+1` * 그 밖에는 감정 `-1` 전투가 길수록 정령의 몸 상태가 서서히 마르며, 이는 후반 보조 위력에도 반영된다. ### 7.3 성장 보조 위력 기본 보조타와 화상에는 다음 성장 보정률이 붙는다. ```text 보정률 = 레벨 / 5 + 친밀도 / 3 + 진화 단계 × 15 + 서약 시 15 + 컨디션 80 이상이면 10 - 컨디션 25 미만이면 10 ``` 최종 보정률은 `-10% ~ +120%` 사이로 제한한다. ```text 최종 위력 = 기본 위력 + 기본 위력 × 보정률 / 100 ``` 이 상한은 정령이 후반 보스전에서도 실제 전투원으로 설 수 있도록 Stage56에서 느슨하게 확장된 성장 울타리다. *** ## 8\. 운디네 — 물의 치유자 ### 8.1 자동 보조공격 조건: ```text 정령 보조타 박자 내력 6 이상 ``` 계산: ```text 기본 피해 = 3 + 레벨 + 공격 / 2 내력 소모 = 6 ``` 이 피해에 성장 보조 위력 보정이 붙는다. ### 8.2 위험 체력 자동 회복 피해를 받기 직전, 그 피해까지 적용했을 때 주인공 체력이 최대치의 35% 이하가 될 것으로 예상되면 발동을 시도한다. 조건: ```text 예상 잔여 체력 <= 최대 체력의 35% 운디네 내력 >= 14 운디네 회복 재사용 대기 = 0 ``` 회복량: ```text 10 + 레벨 × 2 + 친밀도 / 7 서약 시 + 6 + 진화 단계 × 4 최대 회복 상한 = 주인공 최대 HP의 35% ``` 소모와 재사용: ```text 내력 14 소모 회복 재사용 = max(4, 7 - 레벨 / 10)턴 ``` 실제 회복된 양만 통합 보스 역할 공헌의 `healing`으로 기록한다. ### 8.3 보스 전조 대응 물 대응이 요구되는 전조에 운디네가 활동 중이면: ```text 피해 50% 감소 주인공 체력 회복 = 8 + 레벨 × 2 + 친밀도 / 8 정령 경험치 +8 전조 대응 공적 +25 감소 피해는 guard, 실제 회복량은 healing 공적으로 기록 ``` ### 8.4 맹약 기술 — 청류의 숨결 개방: ```text 운디네 첫 인연 임무 완료 친밀도 70 이상 전투 중 공통 맹약 기술 대기 0 내력 20 이상 ``` 기본 회복: ```text 24 + 레벨 × 3 + 친밀도 / 3 상한: 주인공 최대 HP의 40% ``` 친밀도 90의 일심 단계에서는: ```text 회복량 150% 상한: 최대 HP의 55% 3턴 재생 부여 매턴 재생 = 4 + 레벨 / 2 + 친밀도 / 15 ``` *** ## 9\. 살라만드라 — 불의 공격자 ### 9.1 일반 불꽃 보조타 화상 기술을 쓸 수 없을 때 내력 5 이상이면 다음 공격을 한다. ```text 기본 피해 = 4 + 레벨 + 공격 / 2 + 홍련 맹약 강화값 내력 소모 = 5 ``` ### 9.2 불씨와 화상 조건: ```text 살라만드라 화상 대기 0 현재 남은 화상 없음 내력 12 이상 ``` 첫 타격: ```text 공격 + 레벨 + random(공격 + 5) + 맹약 강화값 서약 시 + 3 + 진화 단계 × 4 내력 12 소모 ``` 화상: ```text 기본 화상 피해 = 2 + 레벨 / 2 + 공격 / 4 기본 지속 횟수 = 2 + 레벨 / 12 최대 지속 횟수 = 5 ``` 서약·진화·일심 홍련 강화가 화상 피해와 지속 횟수를 더한다. 화상 피해에도 성장 보조 위력 보정이 붙는다. 재사용: ```text max(2, 4 - 레벨 / 15)턴 ``` ### 9.3 보스 전조 대응 불 대응 전조에서는 공격 자체를 끊고 보스에게 역공한다. ```text 역공 기본값 = 12 + 레벨 × 3 + 공격 성장 보조 위력 보정 적용 플레이어가 받을 전조 피해 = 0 전조 대응 공적 +25 정령 경험치 +8 ``` ### 9.4 맹약 기술 — 홍련의 맹세 소모: ```text 내력 18 ``` 기본: ```text 4턴 동안 정령 공격 강화 강화값 = 5 + 레벨 + 공격 / 2 ``` 일심: ```text 6턴 동안 강화 추가 강화 = 5 + 친밀도 / 10 화상 피해와 지속 횟수 증폭 ``` *** ## 10\. 실프 — 바람의 회피자 ### 10.1 자동 보조공격 조건: ```text 정령 보조타 박자 이동력 7 이상 ``` 계산: ```text 기본 피해 = 4 + 레벨 + random(속도 + 2) 이동력 소모 = 7 ``` ### 10.2 자동 회피와 피해 감소 피해를 받기 직전 다음 확률로 발동한다. ```text 발동 확률 = 16 + 속도 + 친밀도 / 6 서약 시 + 4 + 진화 단계 × 3 최대 55% ``` 발동 뒤 다시 두 갈래로 나뉜다. ```text 완전 회피 확률 = 20 + 레벨 / 3 (%) 그 밖에는 피해 감소 = 피해 / 3 + 속도 / 2 서약 시 감소량 + 2 + 진화 단계 × 2 ``` 소모와 재사용: ```text 이동력 5 소모 재사용 = max(2, 3 - 레벨 / 18)턴 ``` 실제로 피하거나 흘린 피해량만 통합 보스 `evasion` 공적으로 기록한다. ### 10.3 보스 전조 대응 바람 대응 전조에서는 공격선 밖으로 완전히 빠져나간다. ```text 전조 피해 = 0 전체 회피량을 evasion 공적으로 기록 전조 대응 공적 +25 정령 경험치 +8 ``` ### 10.4 맹약 기술 — 청풍보 소모: ```text 이동력 20 ``` 기본: ```text 다음 피해 1회를 완전 회피 ``` 일심: ```text 완전 회피 뒤 역풍 반격 반격 = 10 + 레벨 × 2 + 속도 ``` *** ## 11\. 그놈 — 땅의 수호자 ### 11.1 자동 보조공격 조건: ```text 정령 보조타 박자 이동력 6 이상 ``` 계산: ```text 기본 피해 = 4 + 레벨 + 공격 / 2 이동력 소모 = 6 ``` ### 11.2 자동 피해 대리 주인공이 피해를 받을 때 그놈이 살아 있고 이동력 4 이상이면 일부를 자기 체력으로 받는다. ```text 흡수량 = 피해 / 5 + 방어 / 3 + 레벨 / 3 + 친밀도 / 25 서약 시 + 2 + 진화 단계 × 3 최대 흡수 = 원래 피해의 60% 그놈 HP가 1 아래로 내려가지 않도록 제한 이동력 4 소모 ``` 실제 대신 받은 양은 통합 보스 `guard` 공적으로 기록한다. ### 11.3 보스 전조 대응 땅 대응 전조에서는 대지의 뿌리로 충격 대부분을 받친다. ```text 전조 피해 75% 감소 최소 1 피해는 남음 감소량을 guard 공적으로 기록 전조 대응 공적 +25 정령 경험치 +8 ``` ### 11.4 맹약 기술 — 반석수호 소모: ```text 이동력 18 ``` 보호막: ```text 35 + 레벨 × 4 + 방어 × 2 + 친밀도 / 2 ``` 일심: ```text 보호막 150% 보호막이 모두 깨질 때 반동 피해 반동 = 8 + 레벨 × 2 + 방어 ``` *** ## 12\. 재사용 대기와 전투 임시효과 ### 12.1 정령별 재사용 | 상태 키 | 용도 | 기본 계산 | | ---- | --- | ----- | | `undine_cd` | 위험 체력 자동 회복 | `max(4, 7 - 레벨/10)` | | `sylph_cd` | 자동 회피·피해 감소 | `max(2, 3 - 레벨/18)` | | `salamander_cd` | 새 화상 불씨 | `max(2, 4 - 레벨/15)` | | `spirit_swap_cd` | 전투 중 재교대 | 기본 2, 인장 보유 1 | | `bond_skill_cd` | 네 정령 공통 맹약 기술 | 12턴 | 각 전투박자마다 위 대기값이 1씩 줄어든다. ### 12.2 공통 맹약 대기 맹약 기술의 12턴 재사용은 정령별이 아니라 사원소 공통이다. 운디네의 청류의 숨결을 쓴 직후 살라만드라로 교대해도 홍련의 맹세를 즉시 쓸 수 없다. ### 12.3 임시효과 키 * 운디네 재생: `bond_water_regen_turns`, `bond_water_regen_power` * 살라만드라 강화: `bond_fire_turns`, `bond_fire_power`, `bond_fire_oneheart` * 실프 완전 회피·역풍: `bond_wind_dodge`, `bond_wind_counter`, `bond_wind_counter_power` * 그놈 보호막·반동: `bond_earth_shield`, `bond_earth_counter`, `bond_earth_counter_power` *** ## 13\. 친밀도와 인연 단계 ### 13.1 관계 문구 | 친밀도 | 관계 설명 | | ---: | ----- | | 0\~9 | 처음 만난 기척 | | 10\~24 | 조심스러운 호기심 | | 25\~49 | 낯익은 동행 | | 50\~69 | 마음을 여는 사이 | | 70\~89 | 깊이 믿는 동행 | | 90\~100 | 혼빛으로 이어진 벗 | ### 13.2 인연 단계 | 친밀도 | 인연 이름 | 주요 의미 | | ---: | ----- | ----- | | 0\~9 | 낯섦 | 첫 만남 | | 10\~34 | 교감 | 첫 인연 임무 시작 가능 | | 35\~69 | 신뢰 | 형상과 대화가 깊어짐 | | 70\~89 | 맹약 | 임무 씨앗이 있으면 맹약 기술 사용 가능 | | 90\~100 | 일심 | 맹약 기술 강화형 | > 관계 문구와 인연 이름의 경계가 일부 다르다. 예를 들어 친밀도 25는 관계 문구상 「낯익은 동행」이지만 인연 단계는 아직 「교감」이며, 「신뢰」는 35부터다. ### 13.3 친밀도 획득 #### 대화 * 내용이 있는 대화 * 마지막 친밀도 대화로부터 60초 이상 * 친밀도 100 미만 이면 친밀도 `+1`을 얻는다. `고마`, `좋아`, `친구`, `사랑`이 들어간 말은 감정을 조금 더 밝게 한다. #### 격려 * 비전투 * 마지막 격려로부터 60초 이상 ```text 친밀도 25 미만: +2 그 밖: +1 감정 +8 컨디션 +2 ``` #### 선물 선물은 실제 소지 물건 하나를 없애고 친밀도를 올린다. ```text 일반 선물: +1 선호 선물: +4 선호 선물이며 친밀도 70 이상: +3 ``` 현재 선물에는 별도 시간 제한이 없다. ### 13.4 정령별 선호 선물 낱말 | 정령 | 이름에 포함되면 선호하는 낱말 | | --- | ---------------- | | 운디네 | 물, 약초, 진주, 이슬 | | 살라만드라 | 숯, 화염, 매운, 붉은 | | 실프 | 깃털, 향초, 바람, 은방울 | | 그놈 | 광, 흙, 철, 보석 | 물건 이름의 일부 낱말을 검사하는 방식이므로 새 선물 아이템을 만들 때 이름에 해당 어근을 넣으면 선호 반응을 얻을 수 있다. *** ## 14\. 감정·컨디션·기억 ### 14.1 컨디션 컨디션 범위는 `0~100`이다. | 수치 | 표시 | | ---: | --- | | 90\~100 | 원소력이 충만함 | | 70\~89 | 고른 숨결 | | 45\~69 | 조금 지침 | | 20\~44 | 피로가 쌓임 | | 0\~19 | 깊이 지쳐 있음 | 비전투 시간이 흐르면 300초마다 컨디션이 1씩 회복한다. ### 14.2 감정 감정 범위는 `-100~100`이다. 정령별로 같은 수치도 서로 다른 이름을 쓴다. * 높은 긍정: 물빛 기쁨, 활활 타는 환희, 구름 위의 들뜸, 깊고 든든한 만족 * 낮은 긍정: 맑은 기분, 신이 난 불꽃, 장난기 어린 바람, 조용한 흡족함 * 낮은 부정: 흐린 물빛, 매캐한 심기, 풀이 죽은 바람, 무거운 심기 * 깊은 부정: 얼어붙은 슬픔, 꺼져 가는 분노, 비에 젖은 침묵, 금 간 마음 비전투 300초마다 감정은 0을 향해 1씩 가라앉는다. ### 14.3 감정과 전투 문구 * 컨디션 20 이하: 지쳤지만 물러서지 않는 문구 * 감정 45 이상: 기쁜 전투 문구 * 감정 -25 이하: 흐리거나 거친 전투 문구 수치 자체는 보조 위력의 컨디션 보정에 직접 쓰이고, 감정은 주로 말투와 장면을 바꾼다. ### 14.4 최근 기억 정령별로 최근 사건 최대 8개를 저장한다. 기록 종류 예시: * `danger` — 주인공 생명력 위기 * `guard` — 피해 방어·대리 * `heal` — 위험 상처 회복 * `burn` — 화상 * `victory` — 전투 승리 * `gift` — 받은 선물 * `talk` — 최근 대화 * `bond_skill` — 맹약 기술 사용 * `boss_answer` — 보스 전조 대응 대기 대사는 최근 30분 안의 기억을 55% 확률로 회상할 수 있다. *** ## 15\. 휴식·수련·원소석·제단 ### 15.1 정령 휴식 비전투에서 현재 정령만 회복한다. ```text HP 회복 = 6 + 레벨 + 방어 / 3 MP 회복 = 10 + 레벨 + 친밀도 / 8 이동력 회복 = 10 + 레벨 + 속도 / 2 ``` 30초 안에 다시 쉬면 회복량이 절반으로 줄고 친밀도는 오르지 않는다. 첫 휴식 또는 30초가 지난 휴식: ```text 친밀도 +1 컨디션 +22 감정 +4 ``` 연속 휴식: ```text 컨디션 +8 감정 +1 ``` 휴식 때 모든 전투 재사용 대기를 한 번씩 1턴 줄인다. ### 15.2 정령 수련 조건: * 비전투 * 정령 HP 10 이상, MP 8 이상, 이동력 8 이상 * 마지막 수련 뒤 600초 경과 소모: ```text HP = 4 + 레벨 / 6 MP = 6 + 레벨 / 5 이동력 = 6 + 레벨 / 5 컨디션 -12 감정 +3 ``` 보상 경험치: ```text 8 + 레벨 × 2 + 친밀도 / 8 서약 시 +6 진화 단계마다 +4 ``` 그 밖의 보상: ```text 친밀도 +1 30% 확률로 추가 +1 해당 원소 조각 기본 +1 20% + 진화단계×5% 확률로 해당 조각 추가 +1 12% + 서약여부×8% 확률로 순백 조각 +1 ``` ### 15.3 원소석 종류 | 원소 | 조각 이름 | | --- | ----- | | 물 | 청류석 조각 | | 불 | 홍련석 조각 | | 바람 | 창공석 조각 | | 땅 | 산맥석 조각 | | 공통 | 순백 원소석 조각 | ### 15.4 제단 축복 한 번의 축복 비용: ```text 현재 정령의 원소 조각 7개 순백 원소석 조각 1개 ``` 축복 가능 상한: ```text 5 + 현재 진화 단계 ``` 즉 서약 전 최대 5단계, 진화 3단계에서는 최대 8단계다. 원소별 축복 효과: | 정령 | 한 단계 효과 | | --- | ------- | | 운디네 | 최대 MP +12, 최대 HP +4 | | 살라만드라 | 최대 MP +6, 공격 +1 | | 실프 | 최대 이동력 +14, 속도 +1 | | 그놈 | 최대 HP +12, 방어 +1 | 축복 뒤 HP·MP·이동력과 컨디션이 최대치로 회복되고 감정이 `+12` 밝아진다. *** ## 16\. 서약과 진화 ### 16.1 서약 조건 ```text 비전투 현재 정령 레벨 10 이상 친밀도 50 이상 아직 서약하지 않음 ``` 서약하면: * `oath = 1` * `evolution = 1` * 원소별 서약 이름 기록 * 고유 기술 추가 * 최대 HP `+10 + 레벨` * 최대 MP `+8 + 레벨/2` * 최대 이동력 `+8 + 레벨/2` * 모든 자원 완전 회복 * 컨디션 100 * 감정 +25 ### 16.2 서약 이름과 고유 기술 | 정령 | 서약 | 서약 고유 기술명 | | --- | --- | --------- | | 운디네 | 청류의 서약 | 심연치유 | | 살라만드라 | 홍련의 서약 | 홍련낙인 | | 실프 | 창공의 서약 | 바람걸음 | | 그놈 | 산맥의 서약 | 암반수호 | 이 기술명은 정령의 성장 기술 목록에 더해지는 고유 표식이며, 첫 인연 임무로 얻는 수동 맹약 기술과는 별개의 이름이다. ### 16.3 진화 조건 | 진화 | 조건 | | ---: | --- | | 1단계 | 서약 시 자동, 레벨 10·친밀도 50 | | 2단계 | 레벨 20·친밀도 70 | | 3단계 | 레벨 30·친밀도 90 | `정령 진화` 한 번에 현재 단계의 다음 한 단계만 오른다. 이미 3단계 조건을 모두 갖추었더라도 1단계에서 3단계로 한 번에 뛰지 않으므로 명령을 단계별로 사용해야 한다. ### 16.4 진화 시 능력 상승 진화 단계 `R`: ```text 최대 HP += 12 + R×8 + 방어/2 최대 MP += 10 + R×7 최대 이동력 += 10 + R×7 + 속도/4 공격·방어·속도 각각 += R ``` 모든 자원이 회복되고 컨디션은 100이 된다. ### 16.5 진화 이름과 기술 | 정령 | 2단계 형상 / 기술 | 3단계 형상 / 기술 | | --- | ----------- | ----------- | | 운디네 | 깊어진 물결 / 깊은수막 | 심연의 운디네 / 푸른심연 | | 살라만드라 | 거센 불꽃 / 잿불확산 | 홍련의 살라만드라 / 불꽃왕관 | | 실프 | 푸른 돌풍 / 흐린그림자 | 폭풍의 실프 / 폭풍날개 | | 그놈 | 바위 수호자 / 돌뿌리결계 | 산맥의 그놈 / 대지왕권 | *** ## 17\. 정령별 첫 인연 임무 ### 17.1 공통 개방 조건 ```text 사원소 정령석 보유 해당 정령 기록 존재 해당 정령 친밀도 10 이상 — 인연 ‘교감’ 아직 그 임무를 시작하지 않음 ``` 공통 보상: ```text 친밀도 +5 정령 경험치 +35 quest_chapter = 1 정령별 맹약 기술 씨앗 획득 ``` 임무 경험치는 저장 기록에 누적되며, 이후 일반 성장 처리 때 요구치를 넘었다면 레벨 상승으로 정산된다. ### 17.2 네 첫 장 | 정령 | 임무 | 시작 장소 | 목표 장소 | 목표 명령 | 기술 씨앗 | | --- | --- | ----- | ----- | ----- | ----- | | 운디네 | 메마른 샘의 기억 | `/방/분지/오두막3` | `/방/분지/메마른샘` | `정령 명령 정화` | 청류의 숨결 | | 살라만드라 | 꺼진 불씨의 이름 | `/방/분지/오두막2` | `/방/분지/꺼진대장간` | `정령 명령 점화` | 홍련의 맹세 | | 실프 | 길 잃은 바람의 이름 | `/방/분지/분지5` | `/방/분지/메아리절벽` | `정령 명령 추적` | 청풍보 | | 그놈 | 돌에 잠든 맹세 | `/방/분지/오두막1` | `/방/분지/끊어진지맥` | `정령 명령 발굴` | 반석수호 | ### 17.3 맹약 기술의 실제 개방 기술 씨앗만 얻었다고 즉시 사용할 수 있는 것은 아니다. ```text 첫 인연 임무 완료 → 기술 씨앗 보유 친밀도 70 도달 → 전투 중 맹약 기술 사용 가능 친밀도 90 도달 → 같은 기술의 일심 강화형 ``` *** ## 18\. 탐험 상호작용 ### 18.1 정령 명령의 구조 ```text 정령 명령 정령 명령 <행동> 정령 명령 <행동> <대상> ``` 행동 예: * 조사 * 정화 * 점화 * 추적 * 발굴 방 또는 물체가 `정령 상호작용` 자료를 품고 있을 때만 특별 반응이 일어난다. ### 18.2 일회성 기록 상호작용 열쇠는 다음을 묶어 만든다. ```text 반응을 품은 방/물체 + 정령 식별자 + 상호작용 자료 ``` 일회성 반응은 플레이어별 저장 기록으로 남아 같은 보상을 되풀이하지 않는다. ### 18.3 상호작용 보상 방·물체가 지정한 값에 따라: * 정령 친밀도 * 정령 경험치 * 임무 callback * 길 개방이나 환경 변화 를 처리한다. ### 18.4 원소별 탐색 관점 | 정령 | 잘 감지하는 낱말과 흔적 | | --- | ------------- | | 운디네 | 물, 샘, 우물, 비, 습기, 회복, 독, 피, 오염 | | 살라만드라 | 불, 화로, 재, 열기, 위험, 함정, 어둠, 마기 | | 실프 | 틈, 비밀문, 높은 곳, 창, 바람, 여러 갈래 길 | | 그놈 | 균열, 돌, 동굴, 지하, 뿌리, 무너짐, 잠긴 문 | ### 18.5 자동 방 반응과 빈도 비전투 heartbeat에서 다음 세 기능을 하나의 `spiritAmbientTick()`이 호출한다. 1. 방 기척 반응 2. 탐색 힌트 3. 대기 속삭임 자동 반응에는 과도한 로그를 막는 시간 제한과 확률이 있다. #### 방 기척 * 같은 방 15분 안에 반복하지 않음 * 전체 반응 간격 최소 45초 * 자동 발화 확률 22% #### 탐색 힌트 * 같은 방 20분 안에 반복하지 않음 * 전체 간격 최소 180초 * 특별 단서 방 12% 확률 * 평범한 방 0.6% 확률 #### 대기 속삭임 * 기본 간격 180\~419초 * 플레이어가 60초 이상 대기 중이면 18% 확률 * 방금 명령·이동한 상태에서는 0.8% 확률 * 같은 정령의 최근 대사 8개를 피하여 반복을 줄임 수동 명령 `정령 말`, `정령 기척`, `정령 탐색`은 자동 확률을 건너뛰고 즉시 한 번 보여 준다. *** ## 19\. 사원소 합동 임무 ### 19.1 개방 조건 네 정령의 첫 인연 임무가 모두 3단계, 곧 완료 상태여야 한다. ```text 운디네 첫 장 완료 살라만드라 첫 장 완료 실프 첫 장 완료 그놈 첫 장 완료 ``` 그 뒤 `사원소 임무 시작`을 사용하면 오두막 아래 사원소 공명굴의 깊은 문턱이 열린다. ### 19.2 진행 순서 | 합동 단계 | 정령 | 관문 | | ----: | --- | --- | | 1 | 운디네 | 독기의 수문 정화 | | 2 | 살라만드라 | 얼어붙은 화로 깨우기 | | 3 | 실프 | 침묵의 회랑에서 바람길 찾기 | | 4 | 그놈 | 무너진 석교의 돌맥 잇기 | | 5 | 네 원소 | 사원소 봉인전으로 진입 | | 6 | 완료 | 심장전의 무명 공명수호자 개방 | ### 19.3 합동 임무 완료 보상 * 네 정령 모두 경험치 `+25` * `unison_mark = 1` * 합동 임무 기억 기록 * 사원소 심장전 진입 자격 ### 19.4 무명 공명수호자 이 보스는 평상시 검은 원소고리로 공격 피해의 85%를 흘려보낸다. ```text 핵이 닫힌 동안 실제 피해 = 원래 피해의 15% ``` 정령 대응 순서: ```text 운디네 → 살라만드라 → 실프 → 그놈 ``` 각 전조 때 한 명 이상이 알맞은 정령으로 응답하면: ```text 공명 균열 피해 = 75 + 대응 인원 × 20 사슬 단계 +1 ``` 네 고리가 모두 풀리면 심장핵이 8박자 동안 열리고 모든 공격이 온전히 들어간다. 시간이 지나면 핵은 다시 닫히고 물고리부터 반복한다. ### 19.5 사원소의 인장 무명 공명수호자를 쓰러뜨리면 전투에 참여한 플레이어 가운데 합동 임무를 끝낸 인물에게: * 네 정령 모두 경험치 `+50` * `사원소의인장 = 1` * 정령 전투 재교대 대기 `2턴 → 1턴` * 합동 보스 기억 기록 을 부여한다. 인장은 정령의 자원이나 재사용 시간을 초기화하지 않는다. 오직 재교대 사이의 기다림만 줄인다. *** ## 20\. 동행자와 정령의 일반 연계 현재 일반 전투 연계는 다음 네 짝이다. | 문객 + 정령 | 연계 이름 | 효과 | | ------- | ----- | --- | | 소령 + 운디네 | 청류회춘 | 소령 치료량 +20% | | 묵철 + 그놈 | 반석철벽 | 묵철 피해 분담률 +10%p, 철곤 공격 +10% | | 연화 + 살라만드라 | 홍련낙화 | 연화 검술·자동 공격 +20% | | 백려 + 실프 | 풍령공명 | 백려 술법 내력 소모 -20%, 위력 +10% | 확인 명령: ```text 동행 연계 ``` 연계 효과는 정령 쪽이 아니라 `/구조/동행자/연계.c`에서 현재 출전 문객과 활동 정령의 조합을 읽어 적용한다. *** ## 21\. 통합 보스 전조와 삼위 협공 사원소 수호상은 체력 70%·40%·10%에서 국면이 바뀌며 전조 간격과 위력이 거세진다. 전조는 정령의 원소 대응과 문객의 역할 대응을 따로 요구한다. | 보스 기술 | 요구 정령 | 요구 문객 역할·대표 문객 | | ----- | ----- | -------------- | | 태산압정 | 그놈 | 방어·피해 분담 — 묵철 | | 무형풍살 | 실프 | 회피·공격선 이탈 — 연화 | | 열무의 파도 | 운디네 | 치유·충격 완화 — 소령 | | 사원소 폭주 | 살라만드라 | 봉인·공격 맥 차단 — 백려 | 정령만 맞으면 원소 충격을 누르고, 문객만 맞으면 남은 공격의 성질에 대응한다. 둘이 모두 맞으면 주인공의 공격 기세까지 더해진 **삼위 협공**이 발동한다. > 일반 연계 짝과 보스 전조 짝은 목적이 다르다. 일반 연계에서는 연화+살라만드라, 백려+실프가 강하지만, 특정 보스 전조에서는 실프+연화, 살라만드라+백려처럼 역할 대응이 교차할 수 있다. ### 전조 안내와 실제 대응의 구분 `spiritBossWarning()`은 현재 전조에 어울리는 정령을 말로 알려 주는 안내 함수다. 실제 피해 감쇄·회피·역공은 전조가 실행될 때 `resolveSpiritBossStrike()`가 **그 순간 활동 중인 정령**을 검사하여 처리한다. *** ## 22\. Stage59 공동 보스 공적과 정령 보상 Stage59에는 서로 다른 두 층의 분배가 있다. 둘을 혼동하지 않아야 한다. ### 22.1 첫째 층 — 플레이어 공동 공적 `통합보스` 표식이 있는 보스는 clone별로 공적 장부를 연다. ```text 최종 플레이어 보상 = 공격 공헌 45% + 역할 공헌 55% ``` 역할 공헌: ```text 실제 치료량 + 실제 피해 분담·보호량 + 실제 회피·피해 흘리기 + 봉인량 × 110% + 전조 대응 점수 ``` 정령이 통합 보스에서 수행한 다음 행동은 주인의 역할 공적으로 남는다. * 운디네의 실제 회복량 → `healing` * 그놈의 실제 피해 대리·수막·보호막 → `guard` * 실프의 실제 회피·감쇄 → `evasion` * 올바른 원소 전조 대응 → `response +25` * 살라만드라 역공과 정령 보조공격 → 실제 보스 피해로 공격 공헌 협력 인원 `N`에 따른 보상 풀: ```text 수련치 풀 = 100% + (N-1)×18%, 최대 190% 명성 풀 = 100% + (N-1)×12%, 최대 160% ``` 아주 작은 공헌도도 정수 나눗셈 때문에 0점으로 사라지지 않도록 최소 1점을 보장하되, 가장 큰 몫에서 옮겨 전체 보상 풀은 늘리지 않는다. ### 22.2 둘째 층 — 한 플레이어 안의 정령 성장 분배 공동 공적 정산 뒤 플레이어가 받은 수련치의 약 3분의 1이 정령 성장치로 들어간다. 보스전에서는 그 정령 성장치를 다시 나눈다. ```text 처치 순간 활동 정령: 60% 그 전투의 기여 정령 명부: 나머지 40% 균등 분배 ``` 기여 명부에는 공격·화상·회복·회피·피해 대리·맹약 기술·전조 대응 등으로 `combat_contributors` 점수를 얻은 정령이 들어간다. 현재 40% 공동 몫은 기여 점수의 크기 비례가 아니라 **기여 정령 식별자 사이의 균등 분배**다. 활동 정령도 이미 기여 명부에 있다면 60%와 공동 몫 일부를 함께 받을 수 있다. ### 22.3 일반 보스 판정과 통합 보스 판정 정령 내부의 보스 공동 성장 판정은 다음을 인정한다. * `정령보스` * `보스` * `boss` * 또는 플레이어보다 레벨 15 이상 높고 최대 HP가 플레이어 최대 HP의 5배 이상인 옛 보스 추정 그러나 Stage59의 45:55 멀티플레이어 공적 장부는 반드시 `통합보스` 표식이 있어야 한다. *** ## 23\. 저장자료 구조 정령 저장자료에는 동행자처럼 명시적인 `version` 필드가 없다. 대신 `ensureSpiritData()`와 `normalizeSpiritRecord()`가 빠진 필드를 실행 중 보충하는 **느슨한 판올림 방식**을 쓴다. ### 23.1 최상위 자료 ```text 정령데이터 ├─ active 현재 활동 정령 ID ├─ spirits 네 정령의 개별 기록 ├─ combat_log_mode detail / normal / simple / off ├─ combat_turn 현재 정령 전투박자 ├─ spirit_swap_cd 재교대 대기 ├─ combat_contributors 보스전 기여 정령 명부 ├─ burn_turns 남은 화상 횟수 ├─ burn_damage 화상 1회 피해 ├─ burn_name 표시용 대상 이름 ├─ burn_target clone 식별자 ├─ stones 다섯 종류 원소석 조각 ├─ spirit_memory 정령별 최근 기억 최대 8개 ├─ quest_memory 인연·합동 임무 기억 ├─ training_until 다음 수련 가능 시각 ├─ last_talk_time 최근 친밀 대화 시각 ├─ last_encourage_time 최근 격려 시각 ├─ last_rest_time 최근 휴식 시각 ├─ last_idle_chatter_time 최근 속삭임 시각 ├─ last_room_reaction_* 방 기척 자동출력 제어 ├─ last_explore_hint_* 탐색 자동출력 제어 ├─ bond_* 맹약 기술 임시효과 ├─ unison_mark 합동 임무 표식 └─ unison_seal 인장 표식 ``` 정령별 상태 회복 시각은 `last_spirit_state_<정령ID>` 형식의 동적 키로 저장한다. 최근 중복 대사를 피하기 위한 자료도 `recent_spirit_lines_<정령ID>` 형식으로 생긴다. ### 23.2 정령 한 체의 기록 ```text id, name, element stage, level, exp hp, max_hp mp, max_mp move, max_move attack, defense, speed affinity mood, temper condition, emotion skills oath, oath_name, unique_skill evolution altar_blessing quest_chapter quest_skill_seed ``` ### 23.3 정규화 규칙 * 빠진 필드는 해당 정령의 기본 원형에서 채움 * 레벨 최소 1 * 최대 자원 최소 1 * 현재 자원은 `0~최대치`로 제한 * 친밀도 `0~100` * 컨디션 `0~100` * 감정 `-100~100` * 진화 `0~3` * 기술 목록이 깨졌으면 기본 기술 목록 복원 * 표시 단계는 현재 레벨·서약·진화에 맞추어 다시 계산 실제 디스크 기록은 플레이어 자동저장·종료 저장이 담당하고 정령 모듈은 `setSaveData()`로 현재 상태를 넘긴다. *** ## 24\. 전투 호출 고리 ### 24.1 공격 흐름 플레이어 전투 heartbeat의 핵심 순서: ```text /구조/플레이어/바디.c AutoHandAttack() → /명령어/플레이어/동행.c::combatAssist() → 대상이 살아 있으면 /명령어/플레이어/정령.c::combatAssist() → 주인공 연환·특수 공격 ``` 동행자가 먼저 적을 쓰러뜨리면 정령은 이미 죽은 대상을 다시 치지 않는다. ### 24.2 피격 흐름 주인공 `damageHp()` 처리에서: ```text 기존 대신 맞기 처리 → 동행자 beforePlayerDamaged() → 정령 beforePlayerDamaged() → 남은 피해를 주인공 HP에 적용 ``` 따라서 동행자 피해 분담이 먼저 적용되고, 그 뒤 남은 피해에 정령 방어·회복·회피가 작동한다. ### 24.3 비전투 heartbeat ```text /구조/player.c → /명령어/플레이어/정령.c::spiritAmbientTick() ``` 여기서 무공 30 안내, 전투 잔여 상태 정리, 방 기척, 탐색 힌트, 대기 속삭임을 처리한다. *** ## 25\. 모듈별 파일 지도 ### 25.1 정령 핵심 | 파일 | 책임 | | --- | --- | | `lib-runtime/명령어/플레이어/정령.c` | 명령 진입점, 소환·교대·성장·전투·휴식·수련·탐색 조정 | | `lib-runtime/구조/정령/자료.c` | 원형 정의, 이름 정규화, 기본 기록, 옛 저장 보정 | | `lib-runtime/구조/정령/교감.c` | 친밀도, 인연 단계, 대화, 격려, 선물, 최근 기억 | | `lib-runtime/구조/정령/기술.c` | 맹약 기술 조건·발동·상태 출력 | | `lib-runtime/구조/정령/표시.c` | 도감, 정보, 상태, 기억첩·외형 연결 | | `lib-runtime/구조/spirit_chronicle.c` | 인연·진화별 외형, 기억첩, 임무 연대기 | | `lib-runtime/구조/spirit_interaction.c` | 방·물체 원소 상호작용 탐색과 실행 | | `lib-runtime/구조/spirit_quest.c` | 네 정령 첫 인연 임무 | | `lib-runtime/구조/spirit_unison_quest.c` | 사원소 합동 임무와 인장 | | `lib-runtime/도움말/정령.help` | 플레이어 도움말 | ### 25.2 세계와 보스 | 파일 | 책임 | | --- | --- | | `lib-runtime/방/분지/mob/노야.c` | 무공 30 정령석 지급 | | `lib-runtime/방/분지/mob/사원소수호상.c` | 정령·문객 통합 교대형 보스 | | `lib-runtime/방/분지/사원소합동/mob/무명공명수호자.c` | 네 원소 순차 공명 보스, 인장 지급 | | `lib-runtime/구조/보스/통합전투.c` | 보스 국면·전조 공통 계산 | | `lib-runtime/구조/보스/기여도.c` | Stage59 보스별 공적 장부와 45:55 분배 | ### 25.3 동행자 연동 | 파일 | 책임 | | --- | --- | | `lib-runtime/구조/동행자/연계.c` | 네 문객·정령 조합 효과 | | `lib-runtime/구조/동행자/전투.c` | 문객 행동과 보스 역할 대응 | | `lib-runtime/구조/플레이어/바디.c` | 주인공→문객→정령 공격 순서와 피격 훅 | *** ## 26\. 새 정령 기능 확장 지침 현재 체계는 네 정령 고정형이다. 다섯째 정령을 추가하려면 단순히 `spiritDefs()`에 한 줄을 넣는 것으로 끝나지 않는다. ### 26.1 필수 수정 지점 1. `/구조/정령/자료.c` * 원형 자료 * 이름·한글·영문 별칭 정규화 * 기본 능력·기술 2. `/명령어/플레이어/정령.c` * 성장 공식 * 단계·서약·진화 이름 * 원소석 종류 * 보조공격 * 피격 대응 * 수련·축복 * 방 기척·탐색 문구 3. `/구조/정령/교감.c` * 말투 * 대화·격려·선물 반응 * 선호 선물 * 기억 회상 4. `/구조/정령/기술.c` * 맹약 기술 * 일심 강화 5. `/구조/spirit_chronicle.c` * 외형과 등장 장면 6. `/구조/spirit_quest.c` * 인연 임무와 기술 씨앗 7. 표시·도움말·명령 등록 * 도감 순서 * 상태 화면 * 도움말 * 명령어 등록부 8. 보스·동행자 연계 * 원소 전조 정규화 * 새 문객 짝 또는 독립 조합 ### 26.2 새 통합 보스 연결 새 보스에 공정 보상을 붙이려면: ```c setProp("통합보스", 1); ``` 을 지정하고, 실제 피해를 받을 때 `/구조/보스/기여도.c::recordDamage()`가 호출되도록 공통 몬스터 흐름을 사용해야 한다. 정령 전조는 다음 두 함수를 연결한다. ```c spiritBossWarning(player, boss, element, warning_text); resolveSpiritBossStrike(player, boss, required_element, damage, strike_name); ``` 역할 공적을 별도로 만들 때는: ```c recordRole(boss, player, "healing" | "guard" | "evasion" | "seal", amount); recordResponse(boss, player, amount); ``` 을 사용한다. ### 26.3 새 방·물체 원소 반응 방 또는 물체가 정령 상호작용 mapping을 제공하면 `spirit_interaction.c`가 자동으로 찾는다. 설계할 때 다음을 정해야 한다. * 반응 정령 ID * 허용 행동 목록 * 성공 문구 * 반복 문구 * 일회성 여부 * 친밀도·경험치 보상 * callback 함수 일회성 보상은 반드시 플레이어별 완료 열쇠로 막아야 한다. *** ## 27\. 운영·균형 점검표 ### 개방 * [ ] 무공 29에서는 오두막 노야가 정령석을 주지 않는가 * [ ] 무공 30 도달 시 귀환 안내가 한 번만 나오는가 * [ ] 노야와 같은 방에 들어가면 네 정령이 모두 열리는가 * [ ] 옛 정령 저장자료가 있는 캐릭터가 소환 자격을 잃지 않는가 ### 소환과 교대 * [ ] 한 번에 한 정령만 활동하는가 * [ ] 전투 중 해제가 막히는가 * [ ] 기본 재교대가 2턴인가 * [ ] 인장 보유자는 1턴인가 * [ ] 교대 뒤 자원·컨디션·고유 대기가 유지되는가 * [ ] 화상이 원래 clone에만 남는가 ### 전투 * [ ] 주인공 기본 공격 뒤 동행자와 정령이 각각 행동하는가 * [ ] 정령 보조타가 2박자마다 발동하는가 * [ ] 운디네는 실제 위험 체력에서만 회복하는가 * [ ] 살라만드라가 새 화상을 중복 덮어쓰지 않는가 * [ ] 실프 회피가 자원·재사용을 지키는가 * [ ] 그놈이 자기 HP 1을 남기고 피해를 대신 받는가 * [ ] 죽은 대상에게 정령 추가타가 들어가지 않는가 ### 성장과 관계 * [ ] 경험치 요구식과 레벨업 능력치가 원소별로 적용되는가 * [ ] 친밀도 경계 10·35·70·90에서 인연 장면이 나오는가 * [ ] 선물 물건이 실제 소모되는가 * [ ] 수련 600초 제한과 자원 소모가 적용되는가 * [ ] 제단 축복 비용과 단계 상한이 맞는가 * [ ] 서약·진화가 비전투에서만 가능한가 ### 임무와 맹약 * [ ] 친밀도 10 전에 첫 인연 임무가 막히는가 * [ ] 각 목표 방에서 올바른 정령 명령만 완료되는가 * [ ] 완료 뒤 기술 씨앗이 저장되는가 * [ ] 친밀도 70 전에 맹약 기술이 막히는가 * [ ] 친밀도 90에서 일심 강화가 적용되는가 * [ ] 공통 맹약 재사용 12턴이 교대 뒤에도 남는가 ### 사원소 합동 임무 * [ ] 네 첫 장을 모두 끝내기 전 깊은 문턱이 막히는가 * [ ] 물→불→바람→땅 순서로 단계가 진행되는가 * [ ] 핵이 닫힌 무명 수호자에게 피해 15%만 들어가는가 * [ ] 네 응답 뒤 핵이 열리고 다시 봉합되는가 * [ ] 인장과 네 정령 경험치가 참여자에게 지급되는가 ### Stage59 공적 * [ ] 보스 clone별 장부가 서로 섞이지 않는가 * [ ] 정령 공격 피해가 주인공 공격 공헌에 기록되는가 * [ ] 실제 회복·방어·회피량만 역할 공헌에 기록되는가 * [ ] 전조 대응 +25가 기록되는가 * [ ] 플레이어 보상 45:55와 정령 성장 60:40이 서로 다른 층으로 적용되는가 * [ ] 작은 공헌자의 최종 수련치가 0으로 사라지지 않는가 * [ ] 정산 뒤 공적 장부가 지워지는가 *** ## 28\. 현재 구현의 중요한 해석 1. **네 정령은 선택 영입형이 아니다.**정령석 하나로 네 정령이 모두 열린다. 선택은 영구 보유가 아니라 그때그때의 소환과 교대다. 2. **기초 기술명과 맹약 기술은 구분한다.**물결치유·수막보호 같은 기본 기술은 자동 역할의 이름이고, 청류의 숨결 같은 맹약 기술만 수동 발동 명령을 가진다. 3. **정령 HP 0은 영구 소실이 아니다.**해당 정령의 전투 행동이 멈추며, 비전투 휴식과 성장·축복으로 다시 회복할 수 있다. 4. **일반 연계와 보스 대응 조합은 다를 수 있다.**평소 피해 보정을 주는 최적 짝과 특정 전조를 막는 역할 짝은 같은 개념이 아니다. 5. **보스 보상에는 두 장부가 있다.**플레이어 사이의 45:55 공적 장부와, 한 플레이어가 키우는 정령 사이의 60:40 성장 장부는 별도다. 6. **임무 보상 경험치는 직접 누적된다.**임무 직후 경험치가 요구치를 넘어도 다음 정규 성장 처리에서 레벨 상승 장면이 나타날 수 있다. 7. **저장자료는 명시적 판본보다 정규화에 의존한다.**새 필드를 추가할 때는 반드시 기본값과 구형 기록 보정 코드를 함께 넣어야 한다. *** ## 29\. 플레이어 권장 진행 순서 ```text 1. 무공 30 달성 2. 분지 오두막의 노야에게 사원소 정령석 받기 3. 정령 도감으로 네 정령 확인 4. 하나를 소환해 전투·대화·격려·휴식 익히기 5. 네 정령을 번갈아 키우며 친밀도 10 달성 6. 각 정령 첫 인연 임무 완료 7. 레벨 10·친밀도 50에서 서약 8. 친밀도 70에서 맹약 기술 사용 9. 네 첫 장을 모두 끝내 사원소 합동 임무 시작 10. 무명 공명수호자를 넘어 사원소의 인장 획득 11. 레벨 20·30, 친밀도 70·90에서 진화와 일심 완성 12. 동행자·정령·주인공의 세 힘으로 통합 보스 대응 ``` ### 전투 상황별 빠른 교대 | 상황 | 권장 정령 | | --- | ----- | | 체력이 위험하고 회복이 필요함 | 운디네 | | 적의 빈틈에 지속 피해를 쌓고 싶음 | 살라만드라 | | 큰 공격을 피하거나 흘려야 함 | 실프 | | 강타를 버티고 피해를 나누어야 함 | 그놈 | *** ## 30\. 한눈에 보는 핵심 수치 | 항목 | 값 | | --- | ---: | | 개방 무공 | 30 | | 동시 활동 정령 | 1체 | | 기본 재교대 대기 | 2턴 | | 인장 보유 재교대 대기 | 1턴 | | 보조타 주기 | 2턴마다 | | 친밀도 범위 | 0\~100 | | 교감 / 신뢰 / 맹약 / 일심 | 10 / 35 / 70 / 90 | | 서약 조건 | 레벨 10, 친밀도 50 | | 2단계 진화 | 레벨 20, 친밀도 70 | | 3단계 진화 | 레벨 30, 친밀도 90 | | 맹약 기술 공통 대기 | 12턴 | | 정령 수련 대기 | 600초 | | 선호 선물 친밀도 | 기본 +4, 친밀도 70 이상 +3 | | 제단 축복 비용 | 원소 조각 7 + 순백 1 | | 제단 축복 상한 | 5 + 진화단계 | | 보스 플레이어 공적 | 공격 45% + 역할 55% | | 보스 정령 성장 | 활동 정령 60% + 기여 정령 40% | | 협력 수련치 풀 상한 | 190% | | 협력 명성 풀 상한 | 160% | *** ## 맺음말 정령 체계의 본뜻은 네 수치를 골라 붙이는 데 있지 않다. 물은 상처가 깊을 때 흐르고, 불은 틈이 열릴 때 타오르며, 바람은 맞설 수 없는 칼끝을 비껴 가고, 땅은 끝내 무너지지 않도록 몸을 받친다. 플레이어는 네 정령 가운데 하나를 버리고 하나를 택하는 사람이 아니다. 네 결을 모두 익히고, 지금 이 전장에 필요한 숨결을 불러내는 사람이다. 정령의 성장은 곧 숫자의 팽창이 아니라 **때를 읽는 눈, 관계를 쌓는 시간, 네 힘을 하나의 원으로 묶는 공명**의 성장이다.