오금유세가(House of Legacy) Framework v1.1 (BepInEx용)

https://store.steampowered.com/app/2503770/House_of_Legacy/

House of Legacy on Steam

오금유세가 - 짬라이거 프레임워크 구조 요약본

📌 구조 요약본 (JJamliger Framework)

1. 리소스 로드 & 캐싱

1. 외부 PNG 스캔
   • 경로: Data/AllLooks/...
     • 신규 남자 추가 : Data/AllLooks/Member_B/male/shen/...에 인덱스(숫자).png를 넣으면 적용됨.
     • 신규 여자 추가 : Data/AllLooks/Member_B/female/shen/...에 인덱스(숫자).png를 넣으면 적용됨.
     • 기존 교체 : UABEA 또는 AssetStudio 등에서 각 파츠의 Texture2D를 찾아 그 이름으로 교체 png를 만들고 Data/AllLooks/에 넣으면 적용됨.
2. 고정 매핑
   • 최초 로드 시 성별 확정 → 같은 index는 무조건 같은 성별에 고정.
   • 값은 IndexSexMap.json에서 로드:

     "50": "male",

   • JSON 키 = 인덱스, 값 = 성별("male", "female")
   • Member_B ↔ Member_S 자동 연결 (큰 그림 ↔ 작은 그림 한 세트)

---

2. 리소스 로드 패치

1. 인덱스 기반 캐시 확인
2. 컨텍스트에 맞는 Sprite 또는 Prefab 생성
3. Prefab 생성 시 이름은 CustomShen_{index}

---

3. Prefab & 오프셋 적용

• Prefab 생성 후:
• Scale = new Vector3(scaleX, scaleY, 1f); Position = new Vector3(posX, posY, 0f);
• 값은 ShenOffsets.json에서 로드:
• "50": { "scale": [4,6], "pos": [-30,-150], "hide": true }
• JSON 키 = 인덱스, 값 = scale/pos/hide
• 못 찾으면 경고 로그 출력

---

4. 숨김 처리

• CustomShen Prefab이 성공적으로 주입되면 실행:
  1. .../IconShow/0/
  2. parent의 모든 children 순회
  3. child 밑의 Tex GameObject → UnityEngine.UI.Image 확인
  4. image.sprite.name / image.overrideSprite.name 비교
  5. Tou, QF, HF, PX 매칭되면 숨김

---

5. 최종 로그 패턴

• 로드 단계
• [Tool] loaded shen idx=50 ctx=Member_B_male ... [Tool] Init complete. context caches: ...
• 매핑 단계
• [IndexSexStore] Saved index=50 sex=male
• Prefab 생성
• [LoadHook] Injected CustomShen prefab for index 50 (sex=male, memberSize=Member_B)
• 오프셋 적용
• [Offset] Applied Member_B/male/50 scale(4,6) pos(1000,590)
• 숨김 처리
• [Hide] Hid sibling part 'MemB11Tou3' in 2(Clone)

---

✅ 요약

1. 캐싱 → 컨텍스트별로 분리 (덮어쓰기 방지).
2. 성별 매핑 → index마다 최초 성별 고정, B/S 자동 매칭.
3. Prefab 생성 → 신규 추가 시 CustomShen 생성.
4. 오프셋 적용 → JSON에서 scale/pos 불러와 강제 적용.
5. 숨김 처리 → IconShow/0 밑에서 CustomShen 외 파츠 비활성화.

---

이제 여기서 ShenOffsets.json만 계속 관리하면,
새로운 인물 추가 / 크기 위치 수정 / 숨김 여부 제어까지 전부 외부 파일만 수정해서 제어 가능하게 구조화되었습니다 🎯

---

기존 이미지 파츠별로 제작하여 이미지 교체

신규 이미지 추가, 신규는 기존과 상이하게 파츠별이 아닌 옷(몸)[외형 2번 인덱스]으로 추가

설치 방법 - .../steamapps/common/吾今有世家/BepInEx/plugins에 압축파일을 풀어줍니다.

1.1 변경 사항

 - 이미지 교체 시 오작동 수정

JJamliger Framework v1.1.zip

2.35MB