Documentation
Readme
View as plain text
# Mech Resizer
BattleTech Mod (using [BTML](https://github.com/Mpstark/BattleTechModLoader) and [ModTek](https://github.com/Mpstark/ModTek)).
Change the size of mechs on a per-chasis basis. Always wanted a 200 meter tall Locust? Now you can!
## Features
* change the default size of all mechs in game without vanilla json modification.
* change the size of any specific mech (based on chassis) in game
* change the default size of all vehicles in game
* change the size of any specific vehicle (based on chassis) in game
## Download
Downloads can be found on [Github](https://github.com/janxious/MechResizer/releases).
## Install
- [Install BTML and Modtek](https://github.com/Mpstark/ModTek/wiki/The-Drop-Dead-Simple-Guide-to-Installing-BTML-&-ModTek-&-ModTek-mods).
- Put the `MechResizer.dll` and `mod.json` files into `\BATTLETECH\Mods\MechResizer` folder.
- If you want to change the settings do so in the mod.json.
- Start the game.
## Settings
Setting | Type | Default | Description
--- | --- | --- | ---
`mechResizeMultipliers` | json hash | {} | change the size of mechs using the format `"chassis string" : multiplier`. A big locust would be like `"chassisdef_locust_LCT-1V": 15`
`mechResizeMultiplierVectors` | json hash | {} | change mech sizes using three dimensional multipliers with format ``"chassis string": { "x": Xmulti, "y": Ymulti, "z": Zmulti }``. A very tall locust might look like `"chassisdef_locust_LCT-1V": {"x": 1,"y": 2, "z": 1}``
`defaultMechSizeMultiplier` | float | 0.9 | override this to globally change all mech sizes in combat. Vanilla is 1.25
`vehicleResizeMultipliers` | json hash | {} | change the size of vehicles using the format `"chassis string" : multiplier`. A big APC would be like `"vehiclechassisdef_APC_Wheeled": 3`
`mechResizeMultiplierVectors` | json hash | {} | change vehicle sizes using three dimensional multipliers with format ``"chassis string": { "x": Xmulti, "y": Ymulti, "z": Zmulti }``. A very long APC might look like `"vehiclechassisdef_APC_Wheeled": {"x": 1,"y": 1, "z": 2}``
`defaultVehicleSizeMultiplier` | float | 1 | override this to globally change all vehicle sizes in combat. Vanilla is 1
The dimensions for the `*Vectors` settings are measured like: <x> - width (shoulder to shoulder), <y> - height (toes to head), <z> - depth (chest to back)
## Screenshots
Big Locust
<img width="885" alt="screen shot 2018-05-22 at 2 08 16 pm" src="https://user-images.githubusercontent.com/50124/40382747-306be6b8-5dcd-11e8-8956-078891fd6722.png">
Big Everythings
<img width="973" alt="screen shot 2018-05-22 at 2 26 07 pm" src="https://user-images.githubusercontent.com/50124/40382748-30800814-5dcd-11e8-8de0-f1943be2af53.png">
## Sample Config
Normal vehicles size, smaller than vanilla mechs, slenderman griffin, giganto thunderbolt, weirdly stretched galleon, giganto striker.
```
{
"Name": "MechResizer",
"Enabled": true,
"Version": "0.3.0",
"Author": "janxious",
"Website": "https://github.com/janxious/MechResizer",
"DLL": "MechResizer.dll",
"DLLEntryPoint": "MechResizer.MechResizer.Init",
"DependsOn": [],
"ConflictsWith": [],
"Settings": {
"defaultMechSizeMultiplier": 0.9,
"mechSizeMultipliers": {
"chassisdef_thunderbolt_TDR-5SE": 4
},
"mechSizeMultiplierVectors": {
"chassisdef_griffin_GRF-1N": { "x": 1, "y": 2, "z": 1 }
},
"defaultVehicleSizeMultiplier": 1,
"vehicleSizeMultipliers": {
"vehiclechassisdef_STRIKER": 4
},
"vehicleSizeMultiplierVectors": {
"vehiclechassisdef_GALLEON": { "x": 2, "y": 4, "z": 2 }
}
}
}
```
## Special Thanks
HBS, @Mpstark, @Morphyum
## Maintainer Notes: New HBS Patch Instructions
* pop open VS
* grab the latest version of the assembly
* copy the new version of the methods in `original_src` over the existing ones
* see if anything important changed via git