bluemsi/2nd

Files

T

Antigravity Agent 9a135bd19d docs(10_Wiki): Topic_Business/General/Graphic/Programming을 Topics/ 하위로 이동

최상위 10_Wiki/Topic_*였던 4개 카테고리 폴더를 10_Wiki/Topics/Topic_* 로 재배치.
콘텐츠 변경 없음(순수 폴더 이동) — Topics/ 하위 나머지 폴더는 이미 지난 커밋에서
전부 정리된 상태(잔존 항목은 에이전트 운영 상태 및 사용자가 보존을 요청한
업데이트0615/무제 3.canvas 뿐).

2026-07-05 00:44:01 +09:00

1.4 KiB

Raw Blame History

Engine Stability and Optimization (2026-04-21)

Skybound 엔진의 성능 저하 및 런타임 크래시 이슈에 대한 해결 및 방지 가이드입니다.

1. Issue: Effect Overload (이펙트 폭주)

증상: 대폭발 시 수백 개의 파편(Shard) 객체가 화면에 잔존하여 프레임 드랍 발생.
해결책:
- Hard Cap: 파편 최대 생성 개수를 500개로 제한.
- Resource Recycling: 파편의 수명 감소 속도를 6배 상향(0.1 -> 0.6)하여 자원 회수율 증대.

2. Issue: Rendering and API Type Mismatch

증상: undefined 배열 순회 시 발생하는 런타임 에러.
해결책:
- Optional Chaining: GameRenderer.ts 내 모든 엔티티 순회 로직에 ?. 및 || [] 적용.
- Interface Sync: WorldModel에 items, expGems 등 누락된 필드를 정식 등록하여 정적 분석 강화.

3. Lesson Learned (조직적 교훈)

Silo Warning: 엔진 고도화 중 인터페이스 명세서를 동시에 업데이트하지 않을 경우, '느슨한 계약 관리'로 인해 대규모 런타임 에러가 발생할 수 있음.
Defensive Programming: 외부 주입 데이터가 언제든 undefined일 수 있음을 가정하고 순회 로직을 작성해야 함.

Status: Resolved Context: Infrastructure / Performance Tuning

🔗 Knowledge Connections

Optimization