Extras ====== These files are optional extras you can use at your own risk, and are not part of the officially supported DBPro language. The files in this collection will allow you to compile the entire FPSC source code using the above Upgrade, plus provide the key files required to integrate DBO access into your own third party plugins. How To Compile the DarkLIGHTS IDE example ----------------------------------------- 1. Copy the entire contents of the 'DBPro_for_DarkLIGHTS' folder to the root folder of your 'Dark Basic Pro' folder (so that the files overwrite files of the same name). You should find the DLL 'Enhancements.dll' in the Compiler\ plugins-licensed folder and must not be located anywhere else! 2. You can now compile and run the Lightmapper IDE which is available in the full version of DarkLIGHTS How To Compile The FPSC Source Code ----------------------------------- 1. Download and install V115 update to ensure you have the latest files prior to using this source code. 2. In your 'Dark Basic Pro' folder, inside Compiler folder, rename the PLUGINS-LICENSED to XPLUGINS-LICENSED and then rename PLUGINS-USER to XPLUGINS-USER to protect your current installation versions. FPSC requires slightly modified DLLs in these folders to compile the source code properly. 3. Copy the entire contents of the 'DBPro_for_FPSC' folder to the root folder of your 'Dark Basic Pro' folder (so that the files overwrite files of the same name). There should ultimately be three DLLs in the LICENSED folder and two DLLs in the USER folder. 4. Run DBPro, and open the FPSC-Game project which should be found in your projects folder. Press F4 to compile the source code and it will produce a 'FPSC-Game.exe' in the same folder. 5. Copy this FPSC-Game.exe file into your FPS Creator installation, typically 'C:\Program Files\The Game Creators\ FPS Creator\FPSC-Game.exe'. 6. Use FPS Creator software as normal, and your own modified engine will replace the one provided with the original tool. How To Get The DBO structure for U6.X ------------------------------------- If you are an experienced C++ coder, you can find the header files for the DBO structure inside the 'Misclanious' folder, and also the entire project source code for the ODE DLL too. NOTES ----- You may have previously used earlier Extras files to attempt some of the above. Be aware that the locations of the files may have changed in U6.X, so ensure that if you are compiling FPSC, it is VITAL that you delete the Enhancement Pack (Enhancements.dll) from the plugins-licensed folder and delete any previous EnhancementsFPSC.dll file from both plugins-user and plugins-licensed before proceeding. The best way is to follow the above steps and protect your original plugin folders by renaming them and copying over the ones needed to compile FPS Creator freshly. F.A.Q ----- Q> I installed the U6.X extras pack prior to getting the U62B extras pack and I get a plugin error when compiling FPSC code? A> This was a faulty extras pack. The pack you are using now is the correct one, and you should follow the NOTES above to resolve the integration of the new files that accompany these fixed files. It is vital you DELETE the EnhancementsFPSC.DLL from the folder called plugins-licensed found in the Compiler directory Q> I copied the DBPro folder contents to my installation to compile FPSC source code, then went back to my own project and now things are going wrong? A> The files you copied have altered your old installation. You must delete the EnhancementsFPSC.DLL from the plugins-user folder and re-install your Enhancements.DLL if this product was installed. You must also open up the SETUP.INI and ensure the field 'RemoveSafetyCode' is set to No. You may also want to delete all the items under the '[EXCLUSIONS]' group as this section will exclude the specified DLLs when you compile your applications.