Neovim Unreal Engine: P4 Support, Macro Wizards, and Context-Aware Docs! 🚀(2025/12/04)

Source: Dev.to

UnrealDev.nvim

Health Checks for Peace of Mind

Added :checkhealth UnrealDev to verify that your Unreal Engine development environment is set up correctly.
Since nvim-treesitter parsers don’t always auto‑update with plugin managers, things can get out of sync. Run this command to troubleshoot instantly.

---

UNX.nvim (Explorer)

Finally… Perforce (P4) Support!

• Status Icons – Visualize P4 states (Add, Edit, etc.) directly in the explorer.
• Auto‑Checkout – When you try to modify a read‑only file, a dialog asks if you want to check it out, eliminating “File is read‑only” errors.

---

UCM.nvim (Code Actions)

Speeding up Includes & Macros

:UCM copy_include[!]

• :UCM copy_include – Copies the include path for the current file.
• :UCM copy_include! – Opens a fuzzy‑search prompt for a class name and copies its include path.

# Example
:UCM copy_include

Auto‑Resolution: Running this on MyActor.cpp generates #include "Actor/MyActor.h" and copies it to the clipboard.

Macro Wizard (:UCM specifiers[!])

Writing UPROPERTY, UFUNCTION, or UCLASS macros by hand is tedious. This wizard handles it for you.

Normal Mode (:UCM specifiers)

1. Select the macro type (e.g., UPROPERTY).
2. Multi‑select specifiers (e.g., EditAnywhere, BlueprintReadWrite).
3. Inserts the full macro UPROPERTY(EditAnywhere, ...) at the cursor and copies it to the clipboard.
4. Smart Cursor – If a specifier contains quotes (e.g., Category=""), the cursor jumps between the quotes for easy editing.

Append Mode (:UCM specifiers!)

• Perfect for editing existing macros.
• Skips the wrapper and inserts only the specifiers (e.g., EditAnywhere) at the cursor position.

---

UEP.nvim (Project Provider)

Smarter Navigation & Docs

File & Shader Enhancements

• Config/Shaders Visibility – Fixed an issue where UEP tree didn’t show Config or Shaders directories.
• Virtual Paths – Added support for virtual include paths in .ush / .usf files; open_files can now jump straight to them.
• :UEP shaders[!] [Scope] – Quickly search and open shader files.

C# Config Navigation

• :UEP build_cs[!]

  • Without ! – Opens Build.cs for the current module.
  • With ! – Lists all Build.cs files in the project for selection.

• :UEP target_cs[!]

  • Without ! – Lists project Target.cs files.
  • With ! – Includes Engine targets in the search.

Context‑Aware Docs (:UEP web_doc[!])

Opens the official Unreal Engine documentation in your browser, automatically detecting your project’s UE version.

• Without ! – Searches the docs for the word under the cursor.
• With ! – Lets you select a class from your project to open its documentation.

Note (Experimental): If the plugin can’t guess the direct URL, it falls back to a site search.

---

Conclusion

This week’s updates focus on “Quality of Life” improvements—fixing the small frictions that made me miss a heavyweight IDE. I’m finding myself opening Rider less and less; Neovim is finally getting that good!

If you have feature requests or ideas, let me know in the comments or issues. And if you find these plugins useful, a ⭐ on UnrealDev.nvim would make my day!

Happy hacking! 💻✨