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.

218 lines
9.4 KiB

  1. <!DOCTYPE html>
  2. <!--[if IE]><![endif]-->
  3. <html>
  4. <head>
  5. <meta charset="utf-8">
  6. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  7. <title>The Command Line </title>
  8. <meta name="viewport" content="width=device-width">
  9. <meta name="title" content="The Command Line ">
  10. <meta name="generator" content="docfx 2.59.3.0">
  11. <link rel="shortcut icon" href="../favicon.ico">
  12. <link rel="stylesheet" href="../styles/docfx.vendor.css">
  13. <link rel="stylesheet" href="../styles/docfx.css">
  14. <link rel="stylesheet" href="../styles/main.css">
  15. <link rel="stylesheet" href="../styles/fix.css">
  16. <link href="https://fonts.googleapis.com/css?family=Roboto" rel="stylesheet">
  17. <meta property="docfx:navrel" content="../toc.html">
  18. <meta property="docfx:tocrel" content="toc.html">
  19. <meta property="docfx:rel" content="../">
  20. <meta property="docfx:newtab" content="true">
  21. </head> <body data-spy="scroll" data-target="#affix" data-offset="120">
  22. <div id="wrapper">
  23. <header>
  24. <nav id="autocollapse" class="navbar navbar-inverse ng-scope" role="navigation">
  25. <div class="container">
  26. <div class="navbar-header">
  27. <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar">
  28. <span class="sr-only">Toggle navigation</span>
  29. <span class="icon-bar"></span>
  30. <span class="icon-bar"></span>
  31. <span class="icon-bar"></span>
  32. </button>
  33. <a class="navbar-brand" href="../index.html">
  34. <img id="logo" class="svg" src="../logo.svg" alt="">
  35. </a>
  36. </div>
  37. <div class="collapse navbar-collapse" id="navbar">
  38. <form class="navbar-form navbar-right" role="search" id="search">
  39. <div class="form-group">
  40. <input type="text" class="form-control" id="search-query" placeholder="Search" autocomplete="off">
  41. </div>
  42. </form>
  43. </div>
  44. </div>
  45. </nav>
  46. <div class="subnav navbar navbar-default">
  47. <div class="container hide-when-search" id="breadcrumb">
  48. <ul class="breadcrumb">
  49. <li></li>
  50. </ul>
  51. </div>
  52. </div>
  53. </header>
  54. <div class="container body-content">
  55. <div id="search-results">
  56. <div class="search-list">Search Results for <span></span></div>
  57. <div class="sr-items">
  58. <p><i class="glyphicon glyphicon-refresh index-loading"></i></p>
  59. </div>
  60. <ul id="pagination" data-first="First" data-prev="Previous" data-next="Next" data-last="Last"></ul>
  61. </div>
  62. </div>
  63. <div role="main" class="container body-content hide-when-search">
  64. <div class="sidenav hide-when-search">
  65. <a class="btn toc-toggle collapse" data-toggle="collapse" href="#sidetoggle" aria-expanded="false" aria-controls="sidetoggle">Show / Hide Table of Contents</a>
  66. <div class="sidetoggle collapse" id="sidetoggle">
  67. <div id="sidetoc"></div>
  68. </div>
  69. </div>
  70. <div class="article row grid-right">
  71. <div class="col-md-10">
  72. <article class="content wrap" id="_content" data-uid="articles.command_line">
  73. <h1 id="the-command-line">The Command Line</h1>
  74. <p>BSIPA has 2 command lines: the installer, and the game.</p>
  75. <p>Their documentation is below.</p>
  76. <div class="tabGroup" id="tabgroup_lvD3mivo-k">
  77. <ul role="tablist">
  78. <li role="presentation">
  79. <a href="#tabpanel_lvD3mivo-k_installer" role="tab" aria-controls="tabpanel_lvD3mivo-k_installer" data-tab="installer" tabindex="0" aria-selected="true">The Installer (<code>IPA.exe</code>)</a>
  80. </li>
  81. <li role="presentation">
  82. <a href="#tabpanel_lvD3mivo-k_game" role="tab" aria-controls="tabpanel_lvD3mivo-k_game" data-tab="game" tabindex="-1">The Game</a>
  83. </li>
  84. </ul>
  85. <section id="tabpanel_lvD3mivo-k_installer" role="tabpanel" data-tab="installer">
  86. <p>The installer has quite a few options, which are documented inline with the <code>-h</code> or <code>--help</code> flag.</p>
  87. <p>This is what it currently looks like:</p>
  88. <pre><code name="IPA command line" title="the result of IPA.exe -h">usage:
  89. IPA.exe [FLAGS] [ARGUMENTS]
  90. flags:
  91. -h, --help
  92. prints this message
  93. -v, --version
  94. prints the version that will be installed and is currently installed
  95. -w, --waitfor=PID
  96. waits for the specified PID to exit
  97. -f, --force
  98. forces the operation to go through
  99. -r, --revert
  100. reverts the IPA installation
  101. -n, --nowait
  102. doesn&#39;t wait for user input after the operation
  103. -s, --start=ARGUMENTS
  104. uses the specified arguments to start the game after the patch/unpatch
  105. -l, --launch
  106. uses positional parameters as arguments to start the game after patch/unpatch
  107. -R, --no-revert
  108. prevents a normal installation from first reverting
  109. </code></pre></section>
  110. <section id="tabpanel_lvD3mivo-k_game" role="tabpanel" data-tab="game" aria-hidden="true" hidden="hidden">
  111. <p>The game <em>also</em> gets quite a few command line options, though there isn&#39;t anything as convenient as a help page for them.</p>
  112. <p>Here&#39;s a quick list of what they are and what they do.</p>
  113. <ul>
  114. <li><p><code>--verbose</code></p>
  115. <blockquote><p>Makes a console appear with log information at startup.</p>
  116. </blockquote>
  117. </li>
  118. <li><p><code>--debug</code></p>
  119. <blockquote><p>Enables the loading of debug information in Mono. The debugging information must be in the portable PDB format,
  120. in the same location as the DLL that it&#39;s for.</p>
  121. <p>This option also forces BSIPA to show all debug messages in the console, as well as where they were called.</p>
  122. <p>This overrides the config settings <code>Debug.ShowDebug</code> and <code>Debug.ShowCallSource</code>.</p>
  123. </blockquote>
  124. </li>
  125. <li><p><code>--trace</code></p>
  126. <blockquote><p>Enables trace level messages. By default, they do not ever enter the message queue, and thus cost almost nothing.
  127. When this or the config option is used, they are added and logged with the same rules as Debug messages.</p>
  128. <p>This overrides the config setting <code>Debug.ShowTrace</code>.</p>
  129. </blockquote>
  130. </li>
  131. <li><p><code>--mono-debug</code></p>
  132. <blockquote><p>Enables the built-in Mono soft debugger engine.</p>
  133. <p>By default, it acts as a client, and requires that there be a soft
  134. debugger server running on port 10000 on <code>localhost</code>.</p>
  135. <p>Implies <code>--debug</code>.</p>
  136. </blockquote>
  137. </li>
  138. <li><p><code>--server</code></p>
  139. <blockquote><p>Does nothing on its own.</p>
  140. <p>When paired with <code>--mono-debug</code>, this option makes the Mono soft debugger act in server mode. It begins listening on
  141. port 10000 on any address, and will pause startup (with no window) until a debugger is connected. I recommend using
  142. SDB, but that is a command line debugger and a lot of people don&#39;t care for those.</p>
  143. </blockquote>
  144. </li>
  145. <li><p><code>--no-yeet</code></p>
  146. <blockquote><p>Disables mod yeeting.</p>
  147. <p>By default, whenever BSIPA detects that the game is now running a newer version than previous runs, it will move all
  148. mods to another folder and not load them. (They still get checked for updates though.) When this is enabled, that
  149. behaviour is disabled.</p>
  150. <p>Overrides the config setting <code>YeetMods</code>.</p>
  151. </blockquote>
  152. </li>
  153. <li><p><code>--condense-logs</code></p>
  154. <blockquote><p>Reduces the number of log files BSIPA will output for a given session.</p>
  155. <p>By default, BSIPA will create a subfolder in the <code>Logs</code> folder for each mod sublog, as well as each mod. This disables
  156. that behaviour, and restricts it to only create a global log and mod logs.</p>
  157. <p>Overrides the config setting <code>Debug.CondenseModLogs</code>.</p>
  158. </blockquote>
  159. </li>
  160. <li><p><code>--plugin-logs</code></p>
  161. <blockquote><p>Causes each plugins&#39; log messages to be written to files in their own folder for ease of debugging.</p>
  162. <p>This was the default through 4.1.6, however is now disabled by default.</p>
  163. <p>Overrides the config setting <code>Debug.CreateModLogs</code>.</p>
  164. </blockquote>
  165. </li>
  166. </ul>
  167. </section>
  168. </div>
  169. </article>
  170. </div>
  171. <div class="hidden-sm col-md-2" role="complementary">
  172. <div class="sideaffix">
  173. <div class="contribution">
  174. <ul class="nav">
  175. <li>
  176. <a href="https://github.com/nike4613/BeatSaber-IPA-Reloaded/blob/757388ebd92c145e7ea246ff25edeac0185f7edd/docs/articles/command-line.md/#L1" class="contribution-link">Improve this Doc</a>
  177. </li>
  178. </ul>
  179. </div>
  180. <nav class="bs-docs-sidebar hidden-print hidden-xs hidden-sm affix" id="affix">
  181. <h5>In This Article</h5>
  182. <div></div>
  183. </nav>
  184. </div>
  185. </div>
  186. </div>
  187. </div>
  188. <footer>
  189. <div class="grad-bottom"></div>
  190. <div class="footer">
  191. <div class="container">
  192. <span class="pull-right">
  193. <a href="#top">Back to top</a>
  194. </span>
  195. <span>Generated by <strong>DocFX</strong></span>
  196. </div>
  197. </div>
  198. </footer>
  199. </div>
  200. <script type="text/javascript" src="../styles/docfx.vendor.js"></script>
  201. <script type="text/javascript" src="../styles/docfx.js"></script>
  202. <script type="text/javascript" src="../styles/main.js"></script>
  203. </body>
  204. </html>