software

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

발행: (2025년 12월 4일 오후 12:16 GMT+9)
6 min read
원문: Dev.to

Source: Dev.to

위에 제공된 링크에 있는 전체 텍스트를 알려주시면, 해당 내용을 한국어로 번역해 드리겠습니다. (코드 블록, URL, 마크다운 형식 및 기술 용어는 그대로 유지됩니다.)

UnrealDev.nvim

마음의 평화를 위한 건강 체크

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

checkhealth

UNX.nvim (Explorer)

드디어… Perforce (P4) 지원!

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

p4 checkout

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) 커서 위치에 삽입합니다.

specifiers_1

specifiers_2

UEP.nvim (프로젝트 제공자)

더 똑똑한 네비게이션 및 문서

파일 및 셰이더 개선

  • 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[!])

프로젝트의 UE 버전을 자동으로 감지하여 공식 언리얼 엔진 문서를 브라우저에서 엽니다.

  • ! 없이 – 커서 아래 단어에 대한 문서를 검색합니다.
  • !와 함께 – 프로젝트에서 클래스를 선택하여 해당 문서를 엽니다.

Note (Experimental): 플러그인이 직접 URL을 추측하지 못하면 사이트 검색으로 대체됩니다.

web_doc

결론

이번 주 업데이트는 “Quality of Life” 개선에 초점을 맞추었습니다—무거운 IDE가 그리워지게 만들던 작은 마찰들을 해결합니다. 이제 Rider를 여는 빈도가 점점 줄어들고 있습니다; Neovim이 드디어 그 수준에 도달하고 있습니다!

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

행복한 해킹 되세요! 💻✨

Back to Blog

관련 글

더 보기 »