Harmonikater committed Mar 01, 2019 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 # 3dsMax Tools for BF2 This toolset is required for working on Battlefield 2 mods in 3ds Max, e.g. for exporting meshes and animations or for rendering lightmaps. ## Installation ### Requirements: The tools require 3ds Max 9 or any other, more recent version (tested up to Max 2019). Some lightmapping functions may only run stable when a 64-bit version of 3ds Max is used. If 3ds Max 2013 or older is used during lightmapping, [python2](https://www.python.org/downloads/release/python-2715/) will have to be manually installed. ### Option 1: Manual extraction  Harmonikater committed Nov 16, 2021 16 Download [this Archive](https://git.cmp-gaming.com/Harmonikater/BF2-3dsMax-Tools/-/jobs/artifacts/master/download?job=pack) and extract it to the main 3ds Max folder (e.g. "C:\Program Files\3ds Max 2019\")  Harmonikater committed Mar 01, 2019 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38  ### Option 2: Using git clone 1. Make sure to have [git](https://gitforwindows.org/) and [git lfs](https://git-lfs.github.com/) installed and initialized (git lfs install). 2. git clone ssh://git@git.cmp-gaming.com:2222/Harmonikater/BF2-3dsMax-Tools.git or https://git.cmp-gaming.com/Harmonikater/BF2-3dsMax-Tools.git ### Working with multiple 3ds Max installations. If multiple 3ds Max versions are required and used on the same machine, it is recommended to keep the tools in a seperate location and only create links inside the actual 3ds Max folders. Clone or extract the tools into a seperate directory (e.g. C:\Battlefield 2\BF2-3dsMax-Tools\). Open a command prompt (with admin permissions) and run these commands: mklink /D "C:\Program Files\Autodesk\3ds Max 2019\scripts\bf2" "C:\Battlefield 2\BF2-3dsMax-Tools\scripts\bf2 mklink "C:\Program Files\Autodesk\3ds Max 2019\plugins\bf2_mat_staticmesh2.ms" "C:\Battlefield 2\BF2-3dsMax-Tools\plugins\bf2_mat_staticmesh2.ms mklink "C:\Program Files\Autodesk\3ds Max 2019\plugins\game_battlefield2.dlx" "C:\Battlefield 2\BF2-3dsMax-Tools\plugins\game_battlefield2.dlx The actual folders of the 3ds Max installation and tools location will have to be changed according to actual local setup. ## Usage Check out the [docs](docs/readme.md) for more detailed information on what the tools can do and how to use them.  Harmonikater committed Sep 27, 2020 39 40 41 42 43 44 45 ## Troubleshooting Common Problems: * If the exporter doesn't produce any files, check that the executables are downloaded correctly. Since this repository uses LFS, incorrect usage of git may result in the executables not being downloaded correctly. If your executables are small text files, make sure to use [the link provided in this readme](https://git.cmp-gaming.com/Harmonikater/BF2-3dsMax-Tools/-/jobs/artifacts/master/download?job=pack) and not the download zip button that Gitlab provides. Alternatively, make sure you've installed and set up git LFS. * If the exectuables are correct, but still the exporter produces no output, make sure that 3dsmax has the required permissions to run the executables. In most cases, the default installation path of 3dsmax requires admin permissions in order to successfully export objects. * If the executables are correct and admin permissions are already set, there may also be problems with 32-bit systems and missing DirectX, check this [link at classic-battlefield-modding](https://classic-battlefield-modding.fandom.com/wiki/Getting_the_latest_3ds_Max_BF2_Tools_to_work) for more info.  Harmonikater committed Mar 01, 2019 46 47 48 49 50 51 52 53 54 55 56 57 58 ## Credits The following people have worked on or provided help to this toolset (in alphabetical order): Gavrant *(Forgotten Hope 2 - Battlefield 2 Mod Team)* Harmonikater *(Forgotten Hope 2 - Battlefield 2 Mod Team)* [R-DEV]Mats *(Project Reality - Battlefield 2 Mod Team)* [R-DEV]Mosquill *(Project Reality - Battlefield 2 Mod Team)* Point of Existence: 2 - Battlefield 2 Mod Team Remdul *(Forgotten Hope 2 - Battlefield 2 Mod Team)* Rexman *(DICE)* [R-DEV]Rhino *(Project Reality - Battlefield 2 Mod Team)* Worldlife