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.

91 lines
3.0 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. - `--trace`
  23. > Enables trace level messages. By default, they do not ever enter the message queue, and thus cost almost nothing.
  24. > When this or the config option is used, they are added and logged with the same rules as Debug messages.
  25. >
  26. > This overrides the config setting `Debug.ShowTrace`.
  27. >
  28. - `--mono-debug`
  29. > Enables the built-in Mono soft debugger engine.
  30. >
  31. > By default, it acts as a client, and requires that there be a soft
  32. > debugger server running on port 10000 on `localhost`.
  33. >
  34. > Implies `--debug`.
  35. >
  36. - `--server`
  37. > Does nothing on its own.
  38. >
  39. > When paired with `--mono-debug`, this option makes the Mono soft debugger act in server mode. It begins listening on
  40. > port 10000 on any address, and will pause startup (with no window) until a debugger is connected. I recommend using
  41. > SDB, but that is a command line debugger and a lot of people don't care for those.
  42. >
  43. - `--no-yeet`
  44. > Disables mod yeeting.
  45. >
  46. > By default, whenever BSIPA detects that the game is now running a newer version than previous runs, it will move all
  47. > mods to another folder and not load them. (They still get checked for updates though.) When this is enabled, that
  48. > behaviour is disabled.
  49. >
  50. > Overrides the config setting `YeetMods`.
  51. >
  52. - `--condense-logs`
  53. > Reduces the number of log files BSIPA will output for a given session.
  54. >
  55. > By default, BSIPA will create a subfolder in the `Logs` folder for each mod sublog, as well as each mod. This disables
  56. > that behaviour, and restricts it to only create a global log and mod logs.
  57. >
  58. > Overrides the config setting `Debug.CondenseModLogs`.
  59. >
  60. - `--no-updates`
  61. > Disables automatic updating.
  62. >
  63. > By default, BSIPA will check [BeatMods](http://beatmods.com) for all of the loaded mods to see if there is a new version
  64. > avaliable. If there is, it will be downloaded and installed on the next run. This flag disables that behaviour.
  65. >
  66. > Overrides the config settings `Updates.AutoCheckUpdates` and `Updates.AutoUpdate`.
  67. >