AxioDL
/
PrimeWorldEditor
mirror of https://github.com/AxioDL/PrimeWorldEditor.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Modding tools and editor suite for the Metroid Prime series
1,261 Commits 4 Branches 6 Tags 102 MiB
C++ 59.6%
C 39.7%
CMake 0.5%
Go to file
Luke Street b578bd9973 CI: Install LLVM 2021-03-26 19:55:49 -04:00
.github/workflows CI: Install LLVM 2021-03-26 19:55:49 -04:00
.idea/codeStyles Enable clang-format in CLion 2021-03-26 17:40:04 -04:00
cmake Ensure .rc language is en_US 2019-11-24 18:05:11 -10:00
dist Update python3.6 ppa 2020-03-30 21:09:13 -10:00
externals Compile fixes, update submodules 2020-10-08 19:20:42 -07:00
resources Correct asset directories/names 2021-02-07 17:21:34 -08:00
src Copyright & attribution update 2021-03-26 17:39:35 -04:00
templates Correct asset directories/names 2021-02-07 17:21:34 -08:00
.clang-format Segfault fixes 2019-11-16 15:24:46 -10:00
.gitignore Linux build fixes 2019-05-25 20:24:13 -10:00
.gitmodules LibCommon now being integrated as an add_subdirectory submodule 2019-06-04 14:44:39 -10:00
CMakeLists.txt CI test 2021-03-26 18:21:53 -04:00
CMakeSettings.json CI test 2021-03-26 18:21:53 -04:00
LICENSE Copyright & attribution update 2021-03-26 17:39:35 -04:00
README.md LibCommon now being integrated as an add_subdirectory submodule 2019-06-04 14:44:39 -10:00
appveyor.yml Add appveyor.yml 2019-08-16 21:00:15 +02:00
dew.cmake dew.cmake requires CMake 3.12 2019-11-29 12:35:54 -10:00
dewfile.json Update nod and lzokay 2021-03-26 13:56:17 -07:00

README.md

Prime World Editor

Prime World Editor is a custom editor suite for Retro Studios' GameCube and Wii games, including the Metroid Prime series and Donkey Kong Country Returns.

Clone Submodules First!

Builders on all platforms should ensure submodules are up to date with the current PrimeWorldEditor by running git submodule update --init --recursive.

Building on Windows

Requirements

64-bit Note: Except for Visual Studio and the Qt installer, ensure 64-bit (x86-64, x64) packages are installed.

Build using Qt Creator

Compiler Note: Before starting, it is wise to select the 64-bit compiler by opening Tools > Kits > Kits tab. The C and C++ compilers should be set to Microsoft Visual C++ Compiler 15.0 (amd64).

CMake Note: At the time of writing, Qt Creator will search for a user-installed CMake but this is not necessary. The CMake that comes with Visual Studio may be manually selected by opening Tools > Kits > CMake tab, then adding a manual CMake with the path: C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe.

Debugger Note: To use Qt Creator for debugging, Debugging Tools for Windows must be installed from the Windows SDK package. Once installed, the Qt Creator kit should automatically detect CDB. Make sure the x64 version is selected.

  1. File > Open File or Project
  2. Select CMakeLists.txt at root of cloned PrimeWorldEditor
  3. Select desired build configurations within the Desktop Qt Kit. It is generally fine to just check Debug and Release.
  4. Click Configure Project
  5. Wait for dependencies to build and CMake project to generate (this may take a while).
  6. Edit/Build/Debug/Run

Build using Visual Studio

Qt Note: It may be necessary to edit both CMAKE_PREFIX_PATH entries in the CMakeSettings.json file. They should be set to C:/Qt/<QT VERSION>/msvc2017_64/lib/cmake/Qt5.

  1. File > Open > CMake
  2. Select CMakeLists.txt at root of cloned PrimeWorldEditor
  3. Wait for dependencies to build and CMake project to generate (this may take a while).
  4. Edit/Build/Debug/Run

Build using Command Line

  1. Launch x64 Native Tools Command Prompt for VS 2017
  2. cd <PATH TO PrimeWorldEditor ROOT>
  3. mkdir build
  4. cd build
  5. cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=C:/Qt/<QT VERSION>/msvc2017_64/lib/cmake/Qt5 ..
  6. ninja
  7. PrimeWorldEditor.exe is found in the build/bin directory.

Building on macOS

Requirements

Build using Xcode

  1. cd <PATH TO PrimeWorldEditor ROOT>
  2. mkdir build
  3. cd build
  4. cmake -G Xcode -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=~/Qt/<QT VERSION>/clang_64/lib/cmake/Qt5 ..
  5. Open PrimeWorldEditor.xcodeproj
  6. Edit/Build/Debug/Run

Build using Command Line

  1. cd <PATH TO PrimeWorldEditor ROOT>
  2. mkdir build
  3. cd build
  4. cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=~/Qt/<QT VERSION>/clang_64/lib/cmake/Qt5 ..
  5. ninja
  6. PrimeWorldEditor.app is found in the build/bin directory.

Building on Linux

Requirements

  • A working compiler toolchain (GCC or Clang)
  • cmake, ninja, python3, qt5 (dev), clang (dev) packages

Build using Command Line

  1. cd <PATH TO PrimeWorldEditor ROOT>
  2. mkdir build
  3. cd build
  4. cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
  5. ninja
  6. PrimeWorldEditor is found in the build/bin directory.