TIL

Clean Code

코드는 “동작하는 것”에서 끝나는 것이 아니라, 읽기 쉽고 수정하기 쉬우며 실수하기 어려운 구조로 작성해야 한다.특히 Unreal Engine / C++ 프로젝트에서는 클래스, 컴포넌트, 데이터 구조, Subsystem, 상속 구조가 쉽게 커지기 때문에 코드 스멜을 초기에 발견하고 리팩터링하는 습관이 중요하다.기이한 이름함수, 변수, 클래스 이름은 역할과 의도가 드러나야 한다.void AttackEnemy(int DamageAmount); // DamageAmount로 Enemy를 Attack하는 함수float CurrentHealth; // 현재 체력int EnemyCount; // 적 수이름이 잘 떠오르지 않는다면 단순히 작명 문제가 아니라,책임 분리가 덜 되었거나 설계가 모호한 상태일 수..

공감 0 댓글 2026.06.09 공개

TIL

Unreal EQS(Environment Query System)

환경에 대한 데이터를 수집하고, 그 데이터에 대해 질문을 던져서 가장 적절한 결과를 찾는 시스템.이때 결과는 보통 위치이거나 Actor플레이어를 볼 수 있는 위치가 어디인가가장 가까운 엄폐물이 어디인가가장 위협적인 적은 누구인가회복 아이템 중 지금 가장 가까운 것은 무엇인가후보를 만든 뒤 그 후보를 평가해서 가장 높은 점수를 고르는 시스템기본 구조GeneratorContextTestGenerator가 후보를 만들고, Context가 기준점을 제공하고, Test가 그 후보를 필터링하거나 점수화한다.먼저 후보를 만든다.그 후보를 어떤 기준점과 비교한다.비교 결과로 걸러내거나 점수를 준다.가장 좋은 결과를 반환한다.GeneratorGenerator는 EQS의 시작점.테스트하고 가중치를 줄 대상인 Item을 만..

공감 0 댓글 2026.06.08 공개

TIL

Unreal Engine AI Controller

Unreal Engine에서 Pawn은 직접 판단하지 않고, 보통 Controller에게 조종된다.APawn └─ ACharacterAController ├─ APlayerController └─ AAIController구분역할Pawn / Character실제 월드에 존재하는 몸체PlayerController플레이어 입력을 받아 Pawn 조종AIControllerAI 로직으로 Pawn 조종플레이어가 조종하는 캐릭터는 PlayerController가 붙고,적 몬스터나 NPC처럼 스스로 움직이는 캐릭터는 AIController가 붙는다.AI ControllerAI를 Character에서 AI Controller를 사용할 때 문제점// Bad Examplevoid AWEnemyCharacter::Tick(fl..

공감 0 댓글 2026.06.05 공개

TIL

ProjectFT 시작, 초기 설정

팀 프로젝트를 시작하기 전에 초기 설정 세부 사항 기록코드 컨벤션파스칼 표기법 사용bool 값은 b 접두사 사용예: bJump중괄호는 개행해서 사용Struct와 EnumStruct, Enum은 각 폴더에서 생성하나의 헤더에는 하나의 Struct, Enum만 작성Struct는 생성 시 접미사로 Struct를 붙이기Enum은 생성 시 접미사로 Enum을 붙이기생성하는 모든 클래스는 FT 접두사 사용예: FTPlayerControllerUSTRUCT(BlueprintType)struct FTDamageInfoStruct{ GENERATED_BODY()};UENUM(BlueprintType)enum class EWeaponTypeEnum : uint8{ Sword, Bow};파일 디렉토리디렉토리..

공감 0 댓글 2026.06.04 공개

TIL

Unreal Component

가장 바깥 구조Unreal에서 Actor는 혼자서 모든 기능을 들고 있는 객체가 아니다.실제 게임 로직은 Actor가 소유한 Component로 나뉘고, Actor는 그 Component를 조립해서 하나의 게임 오브젝트처럼 쓰는 경우가 많다.UObject └─ UActorComponent └─ USceneComponent └─ UPrimitiveComponentUActorComponent는 재사용 가능한 기능 단위다.USceneComponent는 transform을 가진다.UPrimitiveComponent는 렌더링이나 충돌에 직접 연결되는 geometry 계층이다.UActorComponentUActorComponent는 가장 기본적인 컴포넌트다.공식 API 설명도 reu..

공감 0 댓글 2026.06.02 공개

TIL

TEXT RPG(DIABL5) 발표하며 회고...

콘솔기반에서 실시간 RPG를 만들며 다사다난했던 일주일을 회고한다.https://github.com/leeseungjae97/TEXT_RPG_5일주일간 정말 많은시간을 쏟았다.콘솔 게임에 뭐 그렇게 까지 하냐라고 할 수 있지만일단 재밌었고 짜둔 구조가 협업에 적합해 쌓이면 쌓는대로 컨텐츠가 만들어져서후반에는 재미로 개발하며 새로운 기능을 추가했다전쟁같은 흔적발표까지 마치고 나니, 일주일 동안 정말 많은 것을 쏟아부은 프로젝트였다는 생각이 든다.이번 프로젝트는 C++ 콘솔 환경에서 진행한 로그라이크 게임 프로젝트였고, 최종적으로는 타일 기반 이동, 보간 이동, Isometric View, 3D View, 몬스터 BFS 길찾기, 인벤토리/상점/상자 Cursor 시스템, 랭킹 저장 흐름까 포함한 형태로 완성했..

공감 0 댓글 2026.05.29 공개

TIL

C++ 프로그램에서 Cloudflare Worker로 R2에 GET, POST 하기

C++ 프로그램에서 Cloudflare Worker로 R2에 GET, POST 하기작업 배경처음에는 AWS SDK for C++를 사용해서 R2의 S3 호환 API에 접근하려고 했다. 이를 위해 vcpkg로 aws-sdk-cpp[s3]를 설치하고, r2Config.ini에 AccessKeyId, SecretAccessKey, BucketName, Endpoint 같은 정보를 저장한 뒤 C++ 코드에서 읽어오는 방식을 구성했다.하지만 이 방식은 public repository와 배포 환경에서 보안 문제가 있었다.게임 클라이언트에 R2 Access Key와 Secret Key가 포함되면, 실행 파일이나 설정 파일을 통해 키가 노출될 수 있고, 누군가가 R2 Bucket에 직접 접근할 가능성이 생긴다.그래서 ..

공감 0 댓글 2026.05.28 공개

TIL

타일 기반에서 실시간 이동 표현을 위한 이동 보간 처리

문제지금 프로젝트는 격자 기반 이동이라서, 실제 게임 로직은 타일 단위로 맞아야 한다.하지만 렌더는 부드럽게 보여주고 싶어서 PrevPosition -> CurrentPosition 보간을 사용했다.렌더는 이동 주기동안 보간하면서 부드럽게 이동중인데 로직은 격자 기반이동 이므로보간을 시작하기전 이미 이동할 위치로 이동한다.맵에서는 이미 다음 칸으로 들어가 있거나 반대로 아직 이전 칸에 남아 있으면충돌, 타겟 판정, 카메라 추적이 전부 어긋난다.이 둘을 맞추기 위해 PrevPosition, Position, NextPosition을 분리하고,중간 렌더 좌표와 실제 맵 반영 시점을 나눴다.그리고 PrevPosition과 NextPosition으로 구한 Ratio가 0.5를 넘어가면Position에 NextP..

공감 0 댓글 2026.05.27 공개