Data interchange, editor suite, and runtime re-implementations for games by Retro Studios
Go to file
Luke Street 932b5587a2 Build fixes & cleanup for CDrone, CIceSheegoth 2020-06-06 16:40:51 -04:00
.idea Build fixes & cleanup for CDrone, CIceSheegoth 2020-06-06 16:40:51 -04:00
DataSpec Merge remote-tracking branch 'origin/drone' 2020-06-06 16:25:48 -04:00
Editor Fix inkscape call 2020-05-24 17:38:39 -07:00
NESEmulator Update fmtlib 2020-04-11 12:51:39 -10:00
Runtime Build fixes & cleanup for CDrone, CIceSheegoth 2020-06-06 16:40:51 -04:00
Shaders Shaders: Fix CFluidPlaneShaderMetal 2020-05-09 19:15:31 -04:00
amuse@70380d8fbc Update macOS build instructions 2020-05-24 12:03:33 -04:00
assetnameparser assetnameparser: Amend transposed fwrite arguments 2020-05-31 07:13:06 -04:00
assets Add screenshot to README.md 2020-04-14 16:14:09 -04:00
discord-rpc@e6390c8c41 New code style refactor 2018-12-07 19:30:43 -10:00
gbalink gbalink: Amend code to compile with jbus changes 2019-09-04 01:56:04 -04:00
gmm Numerous uninitialized memory fixes 2019-04-06 19:14:48 -10:00
hecl@6265d5c05c Update macOS build instructions 2020-05-24 12:03:33 -04:00
hecl-gui@a23a15988a Update macOS build instructions 2020-05-24 12:03:33 -04:00
jbus@b8e1e4673e Set compiler flags for building with C++20 2020-04-10 19:05:55 -10:00
kabufuda@4891a95688 Fix CMemoryCardSys 2020-04-15 04:27:06 -07:00
lldb-extras CPuddleToadGamma and animation system fixes 2019-06-20 20:02:56 -10:00
mpcksum CActorContraption fixes, better CMake dependency handling 2019-06-11 16:05:17 -10:00
nod@2783337c36 Update fmtlib 2020-04-11 12:51:39 -10:00
rapidjson@66eb6067b1 New code style refactor 2018-12-07 19:30:43 -10:00
sanitizers-cmake@6947cff3a9 Bug fixes and ASan build submodule 2017-12-11 16:06:19 -10:00
specter@f54b6e2650 MSVC & zeus fixes; update hecl-gui 2020-04-19 21:09:30 -04:00
visigen Update fmtlib 2020-04-11 12:51:39 -10:00
.appveyor.yml Use AXIODL-BUILDBOT instead of APOLLO 2020-05-27 08:02:35 -07:00
.clang-format Integrate URDEVersionInfo 2020-04-15 06:42:44 -07:00
.clang-tidy CElitePirate: Bug fixes, make member variables private, cleanup 2020-03-30 20:40:38 -04:00
.gitignore Build fixes & cleanup for CDrone, CIceSheegoth 2020-06-06 16:40:51 -04:00
.gitlab-ci.yml .gitlab-ci.yml: Use low process priority for Linux 2020-05-27 15:01:43 -04:00
.gitmodules Update file download locations 2019-07-12 01:06:23 -07:00
CMakeLists.txt Check for AppleClang as well 2020-06-01 02:51:31 -04:00
CMakeSettings.json Add CMakeSettings.json for VS 2020-04-17 21:02:50 -04:00
Doxyfile Minor fixes and cleanup 2019-08-03 17:02:53 -07:00
GMM-LICENSE DCLN cooking and various bug fixes 2017-10-16 19:51:53 -10:00
LICENSE Update copyright date 2018-01-02 14:25:48 -10:00
README.md Update macOS build instructions 2020-05-24 12:03:33 -04:00
README.msan.md Typo fix 2019-04-06 19:49:21 -10:00
version.h.in Update splash screen 2015-12-13 11:01:32 -10:00

README.md

URDE

Status: In-Game with 0-00 (v1.088) only

Official Discord Channel: https://discord.gg/AMBVFuf

URDE screenshot

Download

Precompiled builds of the command-line extraction utility (hecl) with embedded dataspec libraries are available at https://releases.axiodl.com. This will give you intermediate dumps of original formats as blender and yaml representations.

Everything else is much too experimental to make portable/stable release builds (for now)

Platform Support

  • Windows 7+ (64-bit support only)
  • macOS 10.11+ (10.15+ / Xcode 11.5+ to build)
  • Linux
    • Arch is known to function with glx vendor setup instructions (main development/testing OS)
    • [WIP] Vulkan loader detection is also integrated into the cmake for Linux
  • [Coming Soon] FreeBSD
    • Much multimedia functionality is in place, but not fully tested

Usage

  • Extract ISO: hecl extract [path].iso -o mp1
    • mp1 can be substituted with the directory name of your choice
  • Repackage game for URDE: cd mp1; hecl package
  • Run URDE: urde mp1/out

URDE options (non-exhaustive)

  • -l: Enable console logging
  • --warp [worldid] [areaid]: Warp to a specific world/area. Example: --warp 2 2
  • +developer=1: Enable developer console

Build Prerequisites:

  • CMake 3.13+
    • Windows: Install CMake Tools in Visual Studio
    • macOS: brew install cmake
  • Python 3+
    • Windows: Microsoft Store
      • Verify it's added to %PATH% by typing python in cmd.
    • macOS: brew install python@3
  • LLVM development package (headers and libs)
  • [Windows] Visual Studio 2019 Community
    • Select C++ Development and verify the following packages are included:
      • Windows 10 SDK
      • CMake Tools
      • C++ Clang Compiler
      • C++ Clang-cl
  • [macOS] Xcode 1.15+
  • [Linux] recent development packages of udev, x11, xcb, xinput, glx, asound

Prep Directions

git clone --recursive https://github.com/AxioDL/urde.git
mkdir urde-build
cd urde-build

Build Directions

ninja

cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja ../urde
ninja

CMake options

  • Build release optimized (better runtime performance): -DCMAKE_BUILD_TYPE=Release
  • Use clang+lld (faster linking): -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
  • Optimize for current CPU (resulting binaries are not portable): -DURDE_VECTOR_ISA=native

CLion

(main development / debugging IDE)

Open the repository's CMakeLists.txt.

Configure CMake options via File > Settings > Build, Execution, Deployment > CMake.

It's recommended to create a new Toolchain with clang/clang++ and configure the CMake profiles to use it.

Qt Creator

Open the repository's CMakeLists.txt via File > Open File or Project.

Configure the desired CMake targets to build in the Projects area of the IDE.

Build / Debug / Run on Windows, macOS and Linux in a unified way.

Visual Studio

Verify all required VS packages are installed from the above Build Prerequisites section.

Open the urde directory in Visual Studio (automatically imports CMake configuration).

Follow these instructions to use clang-cl. The build will not work with the normal VS compiler!

Xcode

cmake -G Xcode -DCMAKE_BUILD_TYPE=Debug ../urde

Then open urde.xcodeproj