readme.md 3.75 KB
Newer Older
Harmonikater's avatar
Harmonikater committed
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's avatar
Harmonikater committed
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's avatar
Harmonikater committed
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's avatar
Harmonikater committed
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's avatar
Harmonikater committed
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