결론

AI 에이전트에게 「공격 이펙트」라고만 지시하면,

ParticleSystem과 좌표 기반 판정을 조합한 구현이 되기 쉬워, 외형과 충돌 판정이 괴리된다.

대책으로서:

• Sprite / Animator / Particle 종류를 지정
• Collider2D와 Trigger 사용을 명시
• 판정 방법을 고정
• 「외형 위치와 판정 위치를 일치시킨다」를 사양화

할 필요가 있다.

문제

모내기 게임에서,

적을 쫓아내는 공격 처리가 「외형」과 「내부 판정」이 일치하지 않았다.

구체적으로는:

• 외형상으로는 적과 접촉하지 않음
• 하지만 적을 쫓아내는 처리가 성립함
• 플레이어 시점에서는 공격 성립 이유가 불명확함

게다가,

「공격 이펙트」라는 지시에 대해 AI 에이전트가:

• Sprite 애니메이션이 아니라
• ParticleSystem 기반

의 구현을 채택하고 있었다.

결과적으로:

• Collider2D가 존재하지 않음
• Trigger 판정 구조가 존재하지 않음
• 판정이 좌표 비교로만 구현됨

상태가 되어 있었다.

원인

원인은 사양의 모호함에 있다.

AI 에이전트는 「이펙트」라는 단어에 대해:

• ParticleSystem
• VFX
• 외형 전용 연출

을 우선적으로 채택하기 쉽다.

그 결과,

판정을 다음과 같은 간략한 구조로 대체하는 경향이 있다.

if (distance < range)
{
  enemy.Flee();
  ...
}

즉,

• 외형 연출
• gameplay 판정

을 분리하여 구현하고 있었다.

해결 방법

공격 사양을 「연출」뿐만 아니라,

「판정 구조」까지 포함하여 상세히 정의했다.

실시 내용

• 공격 이펙트를 Sprite 기반 Prefab화
• Instantiate로 생성
• Collider2D를 필수화
• Trigger 접촉 판정을 채택
• 이펙트 이동과 판정을 동일 오브젝트로 통합
• 좌표만으로 적 상태를 변경하는 구현을 금지

수정 후 구조

AttackEffectPrefab
├ SpriteRenderer
├ Collider2D (Trigger)
...

결과적으로:

• 외형과 공격 성립 위치가 일치
• Hierarchy 상에서 판정 구조를 확인 가능
• 디버그 용이성이 향상

되었다.

빠지기 쉬운 함정 (ハマりポイント)

• 「이펙트」는 ParticleSystem으로 해석되기 쉽다
• Particle는 표준으로 Collider를 가지지 않는다
• AI는 gameplay 판정을 좌표 계산으로 간략화하기 쉽다
• 「충돌 판정 있음」을 쓰지 않으면 Trigger 구조가 생성되지 않는다

보충

AI 에이전트는 일반적인 게임 구현 패턴으로서:

Visual Effect
↓
Separate Gameplay Logic
...

을 채택하기 쉽다.

이는:

• 연출과 판정의 분리
• 퍼포먼스 최적화
• VFX 중심 설계

에서는 합리적이지만,

소규모 2D 게임에서는:

• 시각적 일관성
• 디버그 용이성
• 플레이어의 납득감

을 해치는 경우가 있다.

재발 방지 템플릿

이펙트 사양 템플릿

• 이펙트 방식을 지정 (Sprite / Animator / Particle)
• 충돌 판정 유무를 명시
• Collider2D 사용 유무를 명시
• Trigger 사용 유무를 명시
• 판정 방법을 지정 (접촉 / 좌표 / Raycast)
• 외형 위치와 판정 위치를 일치시킬 것
• Hierarchy 상에서 확인 가능한 구조를 요구

대상 환경

• Windows 11
• Unity 6.3 LTS
• Visual Studio Code 1.109.5
• OpenAI Codex v0.0129
• model: gpt-5.5 xhigh / gpt-5.4-mini medium