Loading...

Jun 24, 2013

How to Install Leadwerks 3 Game Engine


Leadwerks 3 is software to create games.  Many developers will have no issues installing Leadwerks, however there are those of us who will have problems.  Yes, the software does not work smoothly after running the updater.  There are several components that are required before you can compile games.  The following were steps that I had to take when using a fresh/clean install of Win 7 (no updates).

List of things you will need:

Run the Updater
Extract and then run the LeadwerksUpdater, type in or copy/paste your key, assign your desired directory. click on Update button.  Wait for it to finish downloading all files, and then close the updater.  You could install all things above and you may be error free, but if you are not then follow each of the sections below.

Leadwerks.exe - System Error

Occurs: When launching Leadwerks editor.

Message: "The program can't start because OpenAL32.dll is missing from your computer.  Try reinstalling the program to fix this problem.

The problem: Leadwerks 3 uses OpenAl, a cross-platform 3D audio API, to handle many audio file types.  Leadwerks software may or may not come bundled with the software.

Solution: download and install OpenAl


Windows exception

Occurs: When launching Leadwerks editor, during loader part.

Message: "EXCEPTION_ACCESS_VIOLATION"
Other message: "Warning: OpenGL 210 or GLSL 120 are not supported."

The problem: Leadwerks has System Requirements, one of them being OpenGL 2.1 compatible graphics cards.  It is quite interesting that these requirements are not easily found on the product sales pages, instead they are found in the Documentation section.

Solution: If you have a desktop PC you may have to purchase a graphics card to support Leadwerks.  If you have a laptop with integrated and discrete graphics you must ensure that your system switches to the discrete graphics.


Failed to launch

Occurs: When clicking "Debug" or "Run" buttons, or if F6 is pressed in the IDE.
Message: "Failed to launch.  C:/Leadwerks/Projects/DarknessAwaits\DarknessAwaits.debug.exe"

The problem: In order to compile projects you must have Visual C++ Studio 2010 Express installed.

Solution: Download and install Visual Studio 2010 Express from the MSDN website, no the latest 2012 version is likely NOT to work.  In this instance year-version matters and you may have to uninstall latter versions of VS.

Additional: It is likely that you will have to open [projectname].sln found in "C:\[leadwerkspath]\Projects\[projecname]\Projects\Windows\" and build for both release and debug.  Every new project may have to go through this tedious routine.


Problems Building in MS VS 2010.


If MS Visual C++ 2010 Express gives you this error, or similar:
1>------ Build started: Project: DarknessAwaits, Configuration: Debug Win32 ------
1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\Microsoft.CppBuild.targets(299,5): warning MSB8004: Output Directory does not end with a trailing slash.  This build instance will add the slash as it is required to allow proper evaluation of the Output Directory.
1>  main.cpp
1>..\..\Source\main.cpp(31): warning C4018: '<' : signed/unsigned mismatch
1>  App.cpp
1>  Generating Code...
1>LINK : fatal error LNK1123: failure during conversion to COFF: file invalid or corrupt
========== Build: 0 succeeded, 1 failed, 0 up-to-date, 0 skipped ==========

Solution: go download and install VS Studio 2010 Service Pack 1.


If MS Visual C++ 2010 Express gives you this error, or similar:
1>------ Build started: Project: DarknessAwaits, Configuration: Debug Win32 ------
1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\Microsoft.CppBuild.targets(299,5): warning MSB8004: Output Directory does not end with a trailing slash.  This build instance will add the slash as it is required to allow proper evaluation of the Output Directory.
1>  main.cpp
1>c:\le3\projects\darknessawaits\source\App.h(3): fatal error C1083: Cannot open include file: 'Leadwerks.h': No such file or directory
1>  App.cpp
1>c:\le3\projects\darknessawaits\source\App.h(3): fatal error C1083: Cannot open include file: 'Leadwerks.h': No such file or directory
1>  Generating Code...
========== Build: 0 succeeded, 1 failed, 0 up-to-date, 0 skipped ==========

Solution: Go to "C:\[Leadwerks path]\Engine\Source\", find "headers.zip" and extract the contents.  When I say contents of the zip I mean the .h files and the folders, these contents should be placed in the "C:\[Leadwerks path]\Engine\Source\" folder and NOT "C:\[Leadwerks path]\Engine\Source\headers".


At this stage the game engine should work.


It took me a few hours to figure out each step required for the engine to work, and frankly I begun to get angry, and at one point wished I hadn't purchased the engine.  In my opinion the installation of Leadwerls 3 and it's components should not take this much effort.  I hope that the developers make the installation process easier and in this way ensure customer satisfaction.  Until the issues are solved this page may be useful to new users of the Leadwerks engine.  And now that the engine is up and running it's time to begin testing and making games with the editor.

No comments:

Post a Comment