Neovim Unreal Engine: P4 지원, 매크로 위자드, 그리고 컨텍스트 인식 문서! 🚀(2025/12/04)

Source: Dev.to

UnrealDev.nvim

마음의 평화를 위한 Health Checks

:checkhealth UnrealDev 를 추가하여 Unreal Engine 개발 환경이 올바르게 설정되었는지 확인할 수 있습니다.
nvim-treesitter 파서가 플러그인 매니저와 자동으로 업데이트되지 않을 때 동기화가 깨질 수 있습니다. 이 명령을 실행하면 즉시 문제를 진단할 수 있습니다.

---

UNX.nvim (Explorer)

드디어… Perforce (P4) 지원!

• 상태 아이콘 – 탐색기에서 P4 상태(추가, 편집 등)를 시각화합니다.
• 자동 체크아웃 – 읽기 전용 파일을 수정하려고 하면, 체크아웃 여부를 묻는 대화상자가 표시되어 “파일이 읽기 전용입니다” 오류를 없애줍니다.

---

UCM.nvim (Code Actions)

Include와 매크로를 빠르게

:UCM copy_include[!]

• :UCM copy_include – 현재 파일의 include 경로를 복사합니다.
• :UCM copy_include! – 클래스 이름을 퍼지 검색으로 선택하고 해당 include 경로를 복사합니다.

# Example
:UCM copy_include

자동 해결: MyActor.cpp 에서 실행하면 #include "Actor/MyActor.h" 가 생성되어 클립보드에 복사됩니다.

매크로 마법사 (:UCM specifiers[!])

UPROPERTY, UFUNCTION, UCLASS 매크로를 손으로 쓰는 것은 번거롭습니다. 이 마법사가 대신해 줍니다.

일반 모드 (:UCM specifiers)

1. 매크로 종류를 선택합니다(예: UPROPERTY).
2. 지정자를 다중 선택합니다(예: EditAnywhere, BlueprintReadWrite).
3. 커서 위치에 전체 매크로 UPROPERTY(EditAnywhere, …) 를 삽입하고 클립보드에도 복사합니다.
4. 스마트 커서 – 지정자에 따옴표가 포함되어 있으면(Category=""), 커서가 따옴표 사이를 오가며 쉽게 편집할 수 있게 합니다.

추가 모드 (:UCM specifiers!)

• 기존 매크로를 편집할 때 최적입니다.
• 래퍼를 생략하고 지정자만(예: EditAnywhere) 커서 위치에 삽입합니다.

---

UEP.nvim (Project Provider)

더 똑똑한 탐색 및 문서

파일 및 셰이더 개선

• Config/Shaders 가시성 – UEP tree 가 Config 또는 Shaders 디렉터리를 표시하지 않던 문제를 해결했습니다.
• 가상 경로 – .ush / .usf 파일에서 가상 include 경로를 지원합니다; open_files 로 바로 이동할 수 있습니다.
• :UEP shaders[!] [Scope] – 셰이더 파일을 빠르게 검색하고 열 수 있습니다.

C# Config 탐색

• :UEP build_cs[!]

  • ! 없이 – 현재 모듈의 Build.cs 를 엽니다.
  • !와 함께 – 프로젝트 내 모든 Build.cs 파일을 목록으로 보여줍니다.

• :UEP target_cs[!]

  • ! 없이 – 프로젝트의 Target.cs 파일들을 목록으로 보여줍니다.
  • !와 함께 – 엔진 타깃까지 포함해 검색합니다.

컨텍스트‑인식 문서 (:UEP web_doc[!])

브라우저에서 공식 Unreal Engine 문서를 열며, 프로젝트의 UE 버전을 자동으로 감지합니다.

• ! 없이 – 커서 아래 단어를 기준으로 문서를 검색합니다.
• !와 함께 – 프로젝트 내 클래스를 선택해 해당 문서를 엽니다.

참고 (실험적): 플러그인이 직접 URL을 추정하지 못하면 사이트 검색으로 대체합니다.

---

결론

이번 주 업데이트는 “품질 향상”에 초점을 맞췄습니다—무거운 IDE에서 느꼈던 작은 불편함들을 해소했습니다. 이제 Rider를 여는 횟수가 점점 줄어들고, Neovim이 마침내 그 수준에 도달하고 있습니다!

기능 요청이나 아이디어가 있으면 댓글이나 이슈에 알려 주세요. 플러그인이 유용했다면 UnrealDev.nvim 에 ⭐ 하나만 눌러 주셔도 큰 힘이 됩니다!

행복한 해킹 되세요! 💻✨