# How to compile a plugin project with XCode

**URL:** <https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275>\
**Category:** C++\
**Tags:** unreal-engine, Engine-Source-Code, GitHub, Engine-Source-GitHub\
**Created:** [April 25, 2014, 11:47pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275 "2014-04-25T23:47:54Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![rotwang](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@rotwang](https://forums.unrealengine.com/u/rotwang)\
**Post date:** [April 25, 2014, 11:47pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/1 "2014-04-25T23:47:54Z")

</div>

Following the description to copy an existing engine plugin:

- I copied the BlankPlugin and renamed all strings and filenames from BlankPlugin to MyPlugin.
- Then deleted binaries and intermediate files.
- Copied the MyPlugin folder containing Sources and Resources and the MyPlugin.uplugin file into the XCode project under UE4-Engine-Plugins.

In order to compile the plugin, I would need a target, but none of the stock plugins has one. So Im struggling here, wondering how to compile it.  
Anybody knows the hidden magic? Thank You. 🙂

---

<div class="post-metadata">

**Author:** ![rotwang](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@rotwang](https://forums.unrealengine.com/u/rotwang)\
**Post date:** [April 27, 2014, 8:56am UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/2 "2014-04-27T08:56:55Z")

</div>

Is there nobody here, who had success compiling an engine plugin on OSX?  
Thank you for considering helping me. 🙂

---

<div class="post-metadata">

**Author:** ![enlight\_2014](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@enlight\_2014](https://forums.unrealengine.com/u/enlight_2014)\
**Post date:** [April 27, 2014, 12:10pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/3 "2014-04-27T12:10:55Z")

</div>

Where exactly did you put the plugin source? And did you run the GenerateProjectFiles.command to regenerate the UE4 XCode project after doing so?

---

<div class="post-metadata">

**Author:** ![rotwang](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@rotwang](https://forums.unrealengine.com/u/rotwang)\
**Post date:** [April 27, 2014, 9:12pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/4 "2014-04-27T21:12:01Z")

</div>

> [@enlight\_2014;23906](#):
>
> Where exactly did you put the plugin source? And did you run the GenerateProjectFiles.command to regenerate the UE4 XCode project after doing so?

Thank you for helping.  
I copied my new renamed plugin MyPlugin to the same level as the BlankPlugin under  
…/UnrealEngine/Engine/Plugins/Developer/

Then I dragged this MyPlugin folder into the XCode project under UE4-Engine-\>Plugins-\>Developer,  
also at the same level as the BlankPlugin.

I leave XCode and run the GenerateProjectFiles.command, but cant see any changes made to the XCode project (still 27 targets).  
Building the UE4Editor target doesn’t build the plugin, no intermediate files or binaries ( expecting a dylib) are created.

What did you to make your engine plugin compile?

---

<div class="post-metadata">

**Author:** ![enlight\_2014](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@enlight\_2014](https://forums.unrealengine.com/u/enlight_2014)\
**Post date:** [April 28, 2014, 7:18am UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/5 "2014-04-28T07:18:44Z")

</div>

> [@rotwang;24084](#):
>
> Then I dragged this MyPlugin folder into the XCode project under UE4-Engine-\>Plugins-\>Developer,  
> also at the same level as the BlankPlugin.

You shouldn’t need to do this, GenerateProjectFiles.command should do this for you.

> [@rotwang;24084](#):
>
> I leave XCode and run the GenerateProjectFiles.command, but cant see any changes made to the XCode project (still 27 targets).  
> Building the UE4Editor target doesn’t build the plugin, no intermediate files or binaries ( expecting a dylib) are created.

I’m using Visual Studio myself, but assuming that the generated UE4 XCode project has a similar layout plugins will not have a separate target, they’ll be built as part of the UE4Editor target.

> [@rotwang;24084](#):
>
> What did you to make your engine plugin compile?

I haven’t actually tried compiling my plugin as part of the UE4 project, what I’ve done is create a new “Basic C++” project from the Editor and then put my plugin into the Plugins directory of that project. That way I can easily build my plugin using the source version or the launcher version of the engine, and avoid accidental rebuilds of the entire engine. More details here: [GitHub - enlight/ue4-hg-plugin: Basic Mercurial source control plugin for Unreal Engine 4](https://github.com/enlight/ue4-hg-plugin#building-from-scratch)

---

<div class="post-metadata">

**Author:** ![rotwang](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@rotwang](https://forums.unrealengine.com/u/rotwang)\
**Post date:** [May 1, 2014, 9:21am UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/6 "2014-05-01T09:21:37Z")

</div>

Thank you, I will start with a new “Basic C++” project to integrate my source, like you did.  
Hoping, that in the next weeks, someone will solve that plugin problem.

So, if any developer on OSX reads this: Please show me the steps to get an engine plugin target build.

---

<div class="post-metadata">

**Author:** ![synthure](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@synthure](https://forums.unrealengine.com/u/synthure)\
**Post date:** [February 22, 2015, 12:02am UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/7 "2015-02-22T00:02:43Z")

</div>

Did you ever get your plugin to build using xcode? i’m currently trying to go through the process, however i am having difficulty finding the resources to do so.

---

<div class="post-metadata">

**Author:** ![anonymous\_user\_44923cad](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous\_user\_44923cad](https://forums.unrealengine.com/u/anonymous_user_44923cad)\
**Post date:** [October 31, 2016, 5:50pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/8 "2016-10-31T17:50:47Z")

</div>

Since I had problems this week and this thread keeps showing up for this question, I’ll try to answer:

Here’s how I got it working with UE 4.13.2:

1. Download the code for UE from Github
2. Run GenerateProjectFiles.command
3. Open the generated XCode project file (I used Xcode 8.1).  
3a. Make sure the Command Line Tools are installed.
4. Build the UnrealEngine project.  
4a. This takes a couple of hours on a recent MBP, so kick it off and go do something else
5. Open Unreal Editor and create a new Basic C++ project.  
5a. Close UnrealEd
6. Run GenerateProjectFiles.sh against the new project’s base directory.  
6a. This will create an xcode project structure for the entire project
7. Create the Plugins folder in the base project folder.
8. Copy BlankPlugin from the Unreal Engine folder (for me, /Users/Shared/UnrealEngine/4.13/Engine/Plugins/Developer/BlankPlugin to the project’s Plugins folder
9. Rename folders, files, and classes to the new plugin’s name.  
9a. Don’t forget to modify the .uplugin file as well!
10. Open the project in Xcode and run the Build task. Your plugin should build.

It’s very likely that at this point you could just create that same project, however, and then click Settings-\>Plugin-\>New Plugin. Which is…well, it’s a bit frustrating, isn’t it?

---

<div class="post-metadata">

**Author:** ![anonymous\_user\_311cebd5](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous\_user\_311cebd5](https://forums.unrealengine.com/u/anonymous_user_311cebd5)\
**Post date:** [November 12, 2016, 8:10am UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/9 "2016-11-12T08:10:31Z")

</div>

Really - this seems very painful. Trying to work out how to build a mac plugin here too - documentation is lacking. Thanks for the post Michael, i will try your method.

---

<div class="post-metadata">

**Author:** ![Hnomer](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@Hnomer](https://forums.unrealengine.com/u/Hnomer)\
**Post date:** [January 25, 2018, 5:21pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/10 "2018-01-25T17:21:39Z")

</div>

For everyone who needs to compile plugins on a Mac you need:

1. Mac with UE installed.
2. Blank C++ project.
3. Create a folder named “plugins” inside your project.
4. Inside “plugins” folder create your actual plugin folder with Source and uplugin files.
5. Delete Intermediate and Build folder from your plugin.
6. Inside your .uplugin file add “OSX” to the whitelist.
7. Generate XCode files by right clicking your uproject file.
8. Double click the uproject file to open UE4.
9. Compile.

After that you should have Binaries folder inside your plugin.

If after all that UE4 can see the plugin enabled, but can’t use any of its functions, try adding your plugin as a module to game.build.cs inside your project source folder.

Hope it would be helpful!

---

<div class="post-metadata">

**Author:** ![anonymous\_user\_38e5aa46](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@anonymous\_user\_38e5aa46](https://forums.unrealengine.com/u/anonymous_user_38e5aa46)\
**Post date:** [July 26, 2018, 10:55pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/11 "2018-07-26T22:55:46Z")

</div>

Sorry to necro this, but does anyone have an idea why for “7.Generate XCode files by right clicking your uproject file” I dont have an option to generate xcode files when i right click? Thanks for the help.

---

<div class="post-metadata">

**Author:** ![Brian\_Westley](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@Brian\_Westley](https://forums.unrealengine.com/u/Brian_Westley)\
**Post date:** [October 17, 2018, 11:21pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/12 "2018-10-17T23:21:32Z")

</div>

> [@anonymous\_user\_38e5aa46](#):
>
> Sorry to necro this, but does anyone have an idea why for “7.Generate XCode files by right clicking your uproject file” I dont have an option to generate xcode files when i right click? Thanks for the help.

It should be way at the bottom in the submenu for Services. Yeah, I missed it too.

---

<div class="post-metadata">

**Author:** ![ksimpson1986](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@ksimpson1986](https://forums.unrealengine.com/u/ksimpson1986)\
**Post date:** [February 12, 2020, 6:13pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/13 "2020-02-12T18:13:05Z")

</div>

> [@Hnomer](#):
>
> For everyone who needs to compile plugins on a Mac you need:
> 
> 1. Mac with UE installed.
> 2. Blank C++ project.
> 3. Create a folder named “plugins” inside your project.
> 4. Inside “plugins” folder create your actual plugin folder with Source and uplugin files.
> 5. Delete Intermediate and Build folder from your plugin.
> 6. Inside your .uplugin file add “OSX” to the whitelist.
> 7. Generate XCode files by right clicking your uproject file.
> 8. Double click the uproject file to open UE4.
> 9. Compile.
> 
> After that you should have Binaries folder inside your plugin.
> 
> If after all that UE4 can see the plugin enabled, but can’t use any of its functions, try adding your plugin as a module to game.build.cs inside your project source folder.
> 
> Hope it would be helpful!

Mannnnn here we are in 2020 and this post saved me! i’ve been pounding my head against the wall trying to figure this issue out for days! Thank you so much!!

---

<div class="post-metadata">

**Author:** ![gigapede](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@gigapede](https://forums.unrealengine.com/u/gigapede)\
**Post date:** [October 14, 2020, 8:28pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/14 "2020-10-14T20:28:29Z")

</div>

This post is rising from the dead, just in time for Halloween!

My library shows that I own the plugin:

 ![autosettings_destroyme.jpg](https://d3kjluh73b9h9o.cloudfront.net/original/3X/2/f/2ff3a14d9c872c9e736a222356da987bc6d844b3.jpeg)

…I created that image for a Discord forum where someone said they had success, but it turned out they had a windows machine install the plugin across a repo.

I would like to know if it’s possible to do this from macOS without involving windows, since I have many more plugins now and for going ahead to the future.

So:

Step 4: How do I put the Source and .uplugin files in a folder if I can’t find those original files?

Also:  
Step 6. Where is the definitive .uplugin file? What’s the format for adding OSX to the list?

Thank you from a derelict starship!

---

<div class="post-metadata">

**Author:** ![Chiodo](https://d3kjluh73b9h9o.cloudfront.net/original/4X/2/8/5/28502927f1d97ba1051b3b47ccfe17233bf41ef0.png) [@Chiodo](https://forums.unrealengine.com/u/Chiodo)\
**Post date:** [July 11, 2024, 3:29pm UTC](https://forums.unrealengine.com/t/how-to-compile-a-plugin-project-with-xcode/3275/15 "2024-07-11T15:29:45Z")

</div>

> [@Hnomer](#):
>
> Inside your .uplugin file add “OSX” to the whitelist.

Raise, my abomination! 2024 and this is still a problem.  
How do you apply this?

" 6. Inside your .uplugin file add “OSX” to the whitelist."

I look into the docs and there is not a whitelist or similar. There is something for plugins but “OSX” is definitely a platform!  
Whelp!
