Project selection 190

From PopcornFX
Jump to navigation Jump to search
! IMPORTANT ! This is a PopcornFX v1 page. PopcornFX v2 documentation can be found here

See also : Editor interface overview.

This page is for version v1.9.0 and above
For the latest version of PopcornFX, see: Project selection
For previous versions of PopcornFX, see the following pages:


When you first start the PK-Fx editor, the following window will pop-up:

Popcorn-Fx project selection

This is the project selection window.

It gives you various useful informations:

  • 1 : Popcorn-SDK version
  • 2 : User data-folder path (this is where all the projects in the project list are stored, as well as all your user-specific data)

It is split in 3 main panels:

There are also various buttons to manipulate all this:

User infos

Popcorn-Fx Use infos

Data Folder Tells the Popcorn-Fx editor where to look for the projects settings.

It is by default set to a user-directory. You do not have to have your packs in this folder, this is for the user configuration stuff.

Misc User Infos For our internal use only, used to notify company-specific upgrades if you have a registered popcorn SDK license.

Otherwise, just useful for us to get some stats and keep you updated on new popcorn stuff.
Make sure you enter a valid email so you'll get the popcorn-fx newsletter. Don't worry, we only send mails for new versions, we won't spam you :)

Check For Updates if this is checked, the editor will check, on startup, if there is a more recent build uploaded on the popcorn servers.

If there is, it will pop a notification window asking you if you want to upgrade.
If you disable this automatic check, you can always check by hand by clicking the "Check Updates" button in the main project selection window.

Projects panel

PK-Fx Editor allows you to setup multiple "projects" at once. However, you can only have a single project loaded at a single time.
This panel allows you to add new projects, and change their settings.

Popcorn-Fx Project panel

Opening a project

To open a project, you can either:

  • double-click on the project you wish to open
  • select the project, and click the 'OK' button in the window's bottom-right corner.

Creating a project

You can either:

  • Add an existing project
    • click on the 'Add' button
    • An explorer window will pop and ask you to pick a 'PopcornProject.xml' file that's inside the project you want to add.
  • Create a new project from scratch
    • Click on the 'New' button
    • Pick one of the presets in the new dialog that pops up:
      SelectProject New.png
      1. Default : default PopcornFX project.
      2. Unreal Engine : Project setup to be UE4-friendly, with the proper axis-system and physics values
      3. Unity : Project setup to be Unity-friendly, with the proper axis-system
    • An explorer window will ask you to pick a folder inside which the popcorn editor should create the project file.
    • This folder does not have to be the project root folder, but MUST be inside the project directories.
    • See the Project creation and setup page for more details.

Removing a project

The little garbage-can icon on the left of each project deletes the project's entry in the project list.
It does NOT delete the project's files ! it only removes the project from the list of projects.

Relocating a project

Project relocation is a pretty powerful helper tool that came with v1.6

Clicking the 'Relocate project' button will pop the following window, and allow you to change the location of all your projects.

Relocating a project

This is especially useful if your Hard-drive changed its drive-letter during a switch to a new machine, or if you checked-out the repository containing your project datas to a new location.
Without this feature, you'd have to delete all your projects, then re-add them all by hand.

For example, let's say one of your projects was located in F:\Work\Game\PopcornFX\
After adding a new HDD, your old 'F' drive now becomes 'E' you'd have to setup the following patterns:

  • Source pattern : F:/
  • Replace pattern : E:/

Clicking 'OK' will then pop the following window, showing all the projects that matched the 'Source pattern', giving you the ability to uncheck those you don't want to be relocated.

Relocating a project

Once you're done, click 'OK', and the editor will relocate the selected projects.

NOTE: this only affects your local project files in the 'User data folder', it does not touch the PopcornProject.xml file inside the project itself.

Project settings

Clicking on the 'Settings' button pops-up a window showing the currently selected project's settings.
This is where you configure your project paths, axis system, unit scale, resource directories, bake settings, etc...

Please see the Project settings page for more details.

Upgrading projects

Sometimes, when a new version of the popcorn runtime & editor is released, some things might have changed, that will cause some assets to break.
When this happens, your project will appear RED in the project list, meaning you need to upgrade it.

Upgrading a project is just a matter of clicking the little upgrade button next to its name, and select 'OK' in the window that pops up.

For more information or details on the upgrade process, and for troubleshooting upgrades, see the Project upgrade page.

Recent files panel

This lists the recent files of each project, and allows you to select what file should be automatically opened when launching the project.

Popcorn-Fx Recent-files panel

  • 1 : if checked, opening the project will also automatically open the file that's selected in the list below
  • 2 : list of recently opened files

Online packages panel

The online-packages panel replace the previous version's 'default-packs' that were added by default on each new install.
It shows various Fx packages available online on our servers, that you can download.

You can then either import the package content inside one of your already-existing project, or create a new project from this package.

Popcorn-Fx Online packages panel

  • 1 : Package name
  • 2 : Package description
  • 3 : Download progress. Here, already download in progress. If the package has been updated online, the progress-bar will appear empty again, and you will be prompted to re-download.
  • 4 : Package thumbnail. Clicking on it will create a new project from this package, prompting you to select the directory inside which you want the project to be created.
  • 5 : Download button. When not downloaded, will download.
  • 6 : Import button. Once downloaded, will import the package into the selected project in the project-list.

Auto Updates

The popcorn editor will automatically connect to the popcornfx website to check if there are editor updates/fixes available.
If updates are found, it will display the latest update changelog:


We recommend you keep this check active to get the latest bugfixes. However, if you are bound to an older version of the C++ SDK, you might not want to get the latest editor update, as it may have features not supported by your older SDK.

To disable auto-updates, uncheck the 'Check For Updates' checkbox in the User infos window

Even with auto-updates disabled, you can manually check for updates at any time by clicking the "Check Updates" button in the projects panel. If an update is found, the update window will pop, as it would have if auto-updates were active.

170 CheckUpdates01.png

170 CheckUpdates02.png