You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

83 lines
2.7 KiB

  1. # The Command Line
  2. BSIPA has 2 command lines: the installer, and the game.
  3. Their documentation is below.
  4. # [The Installer (`IPA.exe`)](#tab/installer)
  5. The installer has quite a few options, which are documented inline with the `-h` or `--help` flag.
  6. This is what it currently looks like:
  7. [!code[IPA command line](_ipa_command_line.txt "the result of IPA.exe -h")]
  8. # [The Game](#tab/game)
  9. The game *also* gets quite a few command line options, though there isn't anything as convenient as a help page for them.
  10. Here's a quick list of what they are and what they do.
  11. - `--verbose`
  12. > Makes a console appear with log information at startup.
  13. >
  14. - `--debug`
  15. > Enables the loading of debug information in Mono. The debugging information must be in the portable PDB format,
  16. > in the same location as the DLL that it's for.
  17. >
  18. > This option also forces BSIPA to show all debug messages in the console, as well as where they were called.
  19. >
  20. > This overrides the config settings `Debug.ShowDebug` and `Debug.ShowCallSource`.
  21. >
  22. - `--mono-debug`
  23. > Enables the built-in Mono soft debugger engine.
  24. >
  25. > By default, it acts as a client, and requires that there be a soft
  26. > debugger server running on port 10000 on `localhost`.
  27. >
  28. > Implies `--debug`.
  29. >
  30. - `--server`
  31. > Does nothing on its own.
  32. >
  33. > When paired with `--mono-debug`, this option makes the Mono soft debugger act in server mode. It begins listening on
  34. > port 10000 on any address, and will pause startup (with no window) until a debugger is connected. I recommend using
  35. > SDB, but that is a command line debugger and a lot of people don't care for those.
  36. >
  37. - `--no-yeet`
  38. > Disables mod yeeting.
  39. >
  40. > By default, whenever BSIPA detects that the game is now running a newer version than previous runs, it will move all
  41. > mods to another folder and not load them. (They still get checked for updates though.) When this is enabled, that
  42. > behaviour is disabled.
  43. >
  44. > Overrides the config setting `YeetMods`.
  45. >
  46. - `--condense-logs`
  47. > Reduces the number of log files BSIPA will output for a given session.
  48. >
  49. > By default, BSIPA will create a subfolder in the `Logs` folder for each mod sublog, as well as each mod. This disables
  50. > that behaviour, and restricts it to only create a global log and mod logs.
  51. >
  52. > Overrides the config setting `Debug.CondenseModLogs`.
  53. >
  54. - `--no-updates`
  55. > Disables automatic updating.
  56. >
  57. > By default, BSIPA will check [BeatMods](http://beatmods.com) for all of the loaded mods to see if there is a new version
  58. > avaliable. If there is, it will be downloaded and installed on the next run. This flag disables that behaviour.
  59. >
  60. > Overrides the config settings `Updates.AutoCheckUpdates` and `Updates.AutoUpdate`.
  61. >