This is the same as v0.6.3 but with fixed zips.
Mostly refactoring cleanup work and introduces new tools for modders and non-windows users.
Installation now can be done from any directory (and should be done outside the Managed folder on at least macOS). So new installation instructions while I work on the wiki:
- Download
BTML-v0.x.x.zip
- Unzip.
- Place
0Harmony.dll
andBattleTechModLoader.dll
in your BTG Managed folder. - Run the executable
- on windows you should be able to plave run the executable from within the Managed folder
- for non-windows run the executable via
mono
and specify your managed directory as an option. e.g. here is me running the executable from within the mods folder:
janxious [Mods] $ mono BattleTechModLoaderInjector.exe /install /manageddir ../Data/Managed/
I have also added tools for other modders who embed BTML to do version checks as part of their BTML installation. /requiredversion
and /reqmismatchmsg
can be used to specify a required BTG version and fail installation if it's not there. For example, I have the beta abilities preview installed (1.2.300), and someone might specify they want the current non-beta version (1.2.1) and would see this during installation:
janxious [Mods] $ mono BattleTechModLoaderInjector.exe /install /requiredversion=1.2.1 /reqmismatchmsg='Please run the current non-beta version of BTG.'
Expected BTG v1.2.1
Actual BTG v1.2.300
Please run the current non-beta version of BTG.
I have added additional error codes that can occur when running using the /manageddir
and /requiredversion
options. The full list is:
0 - everything worked as expected
1 - an unhandled error occurred
2 - bad options were passed on the command line
3 - the backup file was missing during a /restore
operation
4 - the backup file was injected by BTML and couldn't be /restor
'ed
5 - the managed directory provided didn't exist or didn't contain the BTG assembly file
6 - the BTML dll couldn't be found in the managed dir
7 - the version specified by /requiredversion
did not match the version of the BTG assembly
RTML-v0.6.3.zip
is a special version of BTML for RogueTech that shouldn't be used outside of the RogueTech installer.
This is what the help looks like with this version.
Mods $ mono BattleTechModLoaderInjector.exe --help
BattleTechModLoader Injector
----------------------------
Usage: BattleTechModLoaderInjector.exe [OPTIONS]+
Inject the BattleTech game assembly with an entry point for mod enablement.
If no options are specified, the program assumes you want to /install.
Options:
/d, /detect Detect if the BTG assembly is already injected
/g, /gameversion Print the BTG version number
/h, /?, /help Print this useful help message
/i, /install Install the Mod (this is the default behavior)
/manageddir=VALUE specify managed dir where BTG's Assembly-CSharp.
dll is located
/y, /nokeypress Anwser prompts affirmatively
/reqmismatchmsg=VALUE Print msg if required version check fails
/requiredversion=VALUE Don't continue with /install, /update, etc. if the
BTG game version does not match given argument
/r, /restore Restore pristine backup BTG assembly to folder
/u, /update Update mod loader injection of BTG assembly to
current BTML version
/v, /version Print the BattleTechModInjector version number