Troubleshoot: Difference between revisions

From ENIGMA
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
This article is to provide you with common problems you may experience with the software and how to fix them.
This article is to provide you with common problems you may experience with the software and how to fix them.


'''How do I report a bug?'''<br>
== How do I report a bug? ==
All bug reports should be made on the relevant tracker. Note that suggestions should not be put on the trackers only bug reports, please see [[Bug reporting]] or [[Suggestions]] for info.
All bug reports should be made on the relevant tracker. Note that suggestions should not be put on the trackers only bug reports, please see [[Bug reporting]] or [[Suggestions]] for info.


'''Why am I getting an error about compileEGMf?'''<br>
== Why am I getting an error about compileEGMf? ==
Most likely you probably ran the LateralGM jar file, you need to open "enigma.exe" with administrative priveleges instead so that ENIGMA can build and compile its engine and create the compileEGMf library. Once you open ENIGMA the first time you will need to wait a few seconds while ENIGMA compiles its engine, you will never have to wait again after it compiles.
Most likely you probably ran the LateralGM jar file, you need to open "enigma.exe" with administrative priveleges instead so that ENIGMA can build and compile its engine and create the compileEGMf library. Once you open ENIGMA the first time you will need to wait a few seconds while ENIGMA compiles its engine, you will never have to wait again after it compiles.
If the compileEGMf file is present, then it's possible the plugin cannot use it. This is known to happen because of a 64bit JRE. You should download and install x86/32 bit Java instead.
If the compileEGMf file is present, then it's possible the plugin cannot use it. This is known to happen because of a 64bit JRE. You should download and install x86/32 bit Java instead.

Revision as of 16:47, 9 October 2014

This article is to provide you with common problems you may experience with the software and how to fix them.

How do I report a bug?

All bug reports should be made on the relevant tracker. Note that suggestions should not be put on the trackers only bug reports, please see Bug reporting or Suggestions for info.

Why am I getting an error about compileEGMf?

Most likely you probably ran the LateralGM jar file, you need to open "enigma.exe" with administrative priveleges instead so that ENIGMA can build and compile its engine and create the compileEGMf library. Once you open ENIGMA the first time you will need to wait a few seconds while ENIGMA compiles its engine, you will never have to wait again after it compiles. If the compileEGMf file is present, then it's possible the plugin cannot use it. This is known to happen because of a 64bit JRE. You should download and install x86/32 bit Java instead.

If you still get the same error you can try to manually rebuild the compiler.

  1. Close all LateralGM and ENIGMA windows.
  2. Open the git-bash program inside the ENIGMA folder.
  3. Type "rebuildcompiler" and hit enter.
  4. Once it is finished try launching "enigma.exe" again with administrative privileges.

I keep getting an error regarding resource names?
Most likely you have resources with odd names, for instance you cannot use spaces or !@#$%^&*(){}[]:;"'<,>./? symbol characters in the name of a resource it is not common practice with a game engine. Additionally you may also have two resources with the same name which ENIGMA currently does not support. Attempt to fix the names of your resources and recompile.

Why am I having trouble compiling?
This could be due to any number of reasons, but one sure cause is using spaces in your MinGW install or your compile path. MinGW and GCC do not like spaces, which is why we recommend installing MinGW to the default location on Windows.

Why am I getting a popup about d3dx9_43.dll?
On Windows ENIGMA has the ability to use its Direct3D graphics system, this is a common error message displayed by DirectX applications when run if the end user does not have the runtime installed. Just download the latest DirectX runtime from Microsoft at the link below if you intend to use DirectX for your game, or else set OpenGL instead under API settings.
http://www.microsoft.com/en-us/download/details.aspx?id=35

The full error message reads as follows...
The program can't start because d3dx9_43.dll is missing from your computer. Try reinstalling the program to fix this problem.

Why am I getting a popup about xinput1_3.dll?
Similar to the d3dx9 dll error, XInput extension is in use when this error occurs except the DirectX end user runtime is not installed, download it from the above link.

Why won't ENIGMA install on Windows 8?
If you are having problems installing ENIGMA:

  1. Right click on the installer
  2. From the menu, click Properties
  3. Click on the tab Compatibility
  4. Ensure the box 'Run this program as an administrator' is checked
  5. Try running it again
  6. If it still doesn't work, set the installer to use compatibility settings for Windows 7

Why does ENIGMA keep throwing compiling errors in Windows 8?
If you keep getting compiling errors once the program is installed:

  1. Find the shortcut to ENIGMA (in your start menu or on the desktop)
  2. Right click on it
  3. Click 'Open file location' (you should now see the program called enigma.exe or similar)
  4. Follow the steps from the question above to make this program run as an administrator

Invalid search directories returned. Start search string does not match a line
This happens when installing on a Linux machine where the OS language (locale) is other than English, to fix it:

  1. Close Enigma
  2. Open a terminal and type/copy this: gcc -E -x c++ -v /dev/null and push the enter key
  3. On your Enigma folder go to Compilers => Linux
  4. Locate this file gcc.ey
  5. Open it in your favourite text editor (Gedit, Vim, Etc.)
  6. You'll see something like this:
%e-yaml
---

Name: GNU GCC G++
Native: Yes
Maintainer: RetroX
Target-platform: Linux

#Some info about it

path:
make: make
cc: gcc
cxx: g++
defines: cpp -dM -x c++ -E $blank
searchdirs: gcc -E -x c++ -v $blank 
searchdirs-start: "#include <...> search starts here:"
searchdirs-end: "End of search list." 
resources: $exe
cppflags:
cxxflags:
cflags:
ldflags: 
links: 

Build-Extension:
Run-output: $tempfile
Run-Program: $game
Run-Params:

7) Modify the file until it matches this:

%e-yaml
---

Name: GNU GCC G++
Native: Yes
Maintainer: RetroX
Target-platform: Linux
# Some info about it
path:
make: make
cc: gcc
cxx: g++
defines: cpp -dM -x c++ -E $blank
searchdirs: gcc -E -x c++ -v $blank
 /usr/include/c++/4.7
 /usr/include/x86_64-linux-gnu/c++/4.7/.
 /usr/include/c++/4.7/backward
 /usr/lib/gcc/x86_64-linux-gnu/4.7/include
 /usr/local/include
 /usr/lib/gcc/x86_64-linux-gnu/4.7/include-fixed
 /usr/include/x86_64-linux-gnu
 /usr/include

resources: $exe
cppflags:
cxxflags:
cflags:
ldflags: 
links: 

Build-Extension:
Run-output: $tempfile
Run-Program: $game
Run-Params:

8) Save the file and close the editor

9) Run enigma

(Taken and expanded from : http://enigma-dev.org/forums/index.php?topic=1402.msg14020#msg14020 )