[📜일지] (초스압)조금 재미있는 무기 클래스 구조 프로토타입 만들어보기

[Jaygan(jaygan)]

ㅎㅇ

지난번에 올렸던 글에서 댓글로 아이템과 무기 클래스 로직 구현은 분리되어 있는 게 낫다고 조언들을 해줘서

솔직히 말하면 처음엔 속으로 '아뉜데 내생각이 옳은거 가튼뒈' 했지만 

그래도 프로그램을 만들다 보면 중간쯤 가서 내 설계가 알고보니 잘못되었다는 걸 알게된 경우가 많더라구욥

그래서 빈 콘솔 프로젝트(엔진도 없는)에다가 텍스트 게임 만들듯이 한번 구현해보며 설계를 고쳐보자는 생각을 했음

결론부터 내고 시작하자면 처음에 설계했던 방법은 너무 과설계였다는 걸 알게 되었고 좀 더 간단하게 구조를 수정했음

1. 게임과 유사한 환경을 모의하기 위한 가상의 액터 클래스 

이건 설계에 포함되는 게 아니라 대충 넘어가겠워요

하는 일:

아이템들을 들고있음

사용자 입력을 받아서 이벤트를 발동하는 컨트롤러 역할도 수행함

액터의 이벤트 처리부에는 별다른 기능이 없고, 단지 키 입력에 따라 "현재 선택된 무기"의 이벤트 함수를 호출할 뿐임

2. 어빌리티 컴포넌트

어빌리티 컴포넌트는 이전 글에서 설명한 것과 같이 무기의 각종 능력치를 설정하거나, 

커스텀한 이펙트나 사운드를 지정하거나 하기 위해서 아이템 DB에 노출시키는 부분임.

아이템 DB와 / 실제 무기의 로직이 담긴 코드를 분리하고, 똑같은 로직을 가진 무기를 다양하게 만들 수 있도록 하기 위한 건데

언리얼에서 지원하는 "소프트 클래스 경로" 타입으로 DB에서 선택한 클래스를 런타임에 읽어서 스폰할 수 있게 되어있는 것 같아서

아래처럼 "소프트 클래스 경로" + "string:string 맵"을 필드에 넣으면 내가 원하는 구조를 구현할 수 있음.

(진짜로 되는지는 아직 확인 안해보긴 함.. 생각난 김에 내일은 이거 해봐야 할듯)

(테스트를 위해서 이 부분만 따로 만들어 본 것, "AKMTEST" 클래스를 기반으로 하는 두 개의 아이템을 만든 예시)

다시 프로토타입 코드로 돌아와서

모든 무기의 베이스가 되는 클래스인 WeaponBase를 만들고

무기가 가져야 할 기본적인 요소들이랑 더불어서, 액터로부터 이벤트가 발생했을 때 호출되는 OnFire, OnReload 따위 함수들의 원형을 선언해둠

그리고 어빌리티 컴포넌트가 이 WeaponBase 클래스에 붙도록 구현함

간단히 말해서 공격력, 장탄수, 반동과 같은 속성 하나하나가 위에 보이는 딕셔너리에 Key(속성명)-Value(값 클래스) 형태로 들어 있는 것

어빌리티 클래스 자체는 복잡할 것 없이 int, float, string같은 값 하나만 갖고 있도록 하고

AbilityComponentBase에서 "문자열을 받아서 값을 초기화시키는 가상 함수"를 상속받아 구현함.

그리고 WeaponBase로부터 상속받은 실제 무기를 구현할 때는 이런식으로 어빌리티를 생성함

위 예시에서는 Init 함수에서 어빌리티를 초기화하고, 성능을 위해서 내부에 캐싱하도록 구현했는데,

초기화를 어느 단계나 어느 클래스에서 주도해서 시킬지는 아직 확정하지 못했음. 

무기 클래스에서 위처럼 생성을 위한 코드를 명시하지 않으면서, 테이블에서 Stat을 읽어오는 단계에서 자동으로 초기화 시키는 방법도 있고

후술할 Behaviour 클래스 내부에서 WeaponBase를 호출해서 생성시킬 수도 있음.

이건 처음에 좀 다르게 만들었다가 오늘 고친 거라서 비효율적이거나 한 부분이 남아있는데 실제로 프로젝트에 넣을 땐 좀 더 다듬어서 넣을 듯

3. 비헤이비어 컴포넌트

처음 설계할 때는 비헤이비어 말고도 비헤이비어의 동작 여부를 결정하는 ExecuteCondition 컴포넌트도 고려했었지만

실제로 구현하면서 다시 생각해 보니 굳이 쓸데없이 복잡하기만 하고 별 의미가 없다는 결론에 이르렀음

왜냐면 어차피 양사 엔진에 기본적으로 구현되어 있는 컴포넌트들도 내부적인 조건에 따라서 알아서 동작하는 게 일반적이고

무기 능력치야 외부에 노출시켜야 되니깐 분리하는 게 깔끔할 수 있지만

무슨 "총알이 충분한지?" 같은 조건함수를 여기저기서 써 봐야 얼마나 쓰겠다고 그걸 따로 구현하려 했나 싶음

그래서 결론은 Condition을 없애고, "탄약" 컴포넌트가 있다면 그놈이 탄약이랑 관련된 기능들을 다 맡아서 하고 

그 기능들을 이용해서 무기 클래스에서 실행여부를 결정하는 방식으로 구현했음 

아무튼 여기서는

 

비헤이비어 컴포넌트 원형을 만들고 (무기 클래스에 붙은 채로 이런저런 동작이 가능하게 레퍼런스를 받음)

이렇게 "Ammo"와 관련된 조건 함수나 재장전 같은 기능 함수들을 만들었음

마지막으로 비헤이비어를 활용해서 무기 클래스의 "사격"과 "장전" 동작을 구현한 예시임

중요한 부분은 다 쓴 것 같다

위 영상이 이번에 만든 코드의 동작결과임

별로 대단한 것도 없지만 혹시나 도움이 될까? 해서 깃허브에다 일단 올려뒀으니 볼사람은 보셈

https://github.com/Jaygan-s/ComponentBasedItem

소모성/발동형 아이템을 구현하는 부분은 여기서 안 다뤘지만 

어차피 이 방식이랑 크게 다르진 않을 것 같아서 (그래도 무기 로직이랑은 분리하는게 맞는듯함)

다음엔 실제 게임에 한번 적용해보려고 함

이것저것 일정이 좀 있어서 좀 걸릴듯한데 암튼 결과물 나오면 들고와 볼게유~

[태보미(taebomi)]