Skip to content

Commit

Permalink
Merge pull request #1 from sinewavey/runtime-map-building
Browse files Browse the repository at this point in the history
Clarify NetRadiant workflow
  • Loading branch information
RisingThumb authored May 19, 2024
2 parents 80791c3 + 566911d commit 4ee83f8
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 16 deletions.
Binary file modified FuncGodot Manual/images/tips_editorbuild_radiant1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 13 additions & 16 deletions FuncGodot Manual/pages/tips_runtime_building.html
Original file line number Diff line number Diff line change
Expand Up @@ -88,27 +88,24 @@ <h3>TrenchBroom</h3>

<h3>NetRadiant Custom</h3>

<p>NetRadiant Custom utilizes a <code>default_build_menu.xml</code> file defined in your game's gamepack folder for its build processes. This file is automatically generated by NetRadiant Custom after setting up your gamepack configuration with the map editor, though it needs some additional setup in order to work with Runtime building.</p>
<p>
First, in Radiant, navigate to <code>Build > Customize...</code>.
<p>NetRadiant Custom utilizes a <code>default_build_menu.xml</code> file, located in your game's gamepack folder for its build processes. This file is automatically generated by NetRadiant Custom after setting up your gamepack configuration, though it needs some additional setup in order to work with your project.</p>

Here, we can see some build variables available:
<p align="center"><img src="../images/tips_editorbuild_radiant1.png"><br></p>
<p>To do so, you must define at least one or more build <b>commands</b>, which may refer to build <b>variables</b> also defined here, or one of the default variables the editor provides for you. To preview these defaults, or any of your defined commands and their current values, select <code>Build > Customize...</code> in the top menu bar and check the <code>build variables</code> option.</p>

To create an entry, open up your build profile <code>&lt;path_to_radiant>\gamepacks\&lt;gamepack name>.game\default_build_menu.xml</code>.
<p>A build profile might look somehting like this:</p>

You can issue a command to execute depending on the currently running platform like so:
<code><pre>&lt;?xml version="1.0"?>
&lt;project version="2.0">
&lt;var name="game">"[EnginePath]example_project.[ExecutableType]"&lt;/var>
&lt;build name="Run and build map in exported project">
&lt;command>[game] -- run_map::"[MapFile]"&lt;/command>
&lt;/build>
&lt;/project></code></pre>

<code><pre>&lt;?xml version="1.0"?>
&lt;project version="2.0">
&lt;var name="game">"[EnginePath]example_project.[ExecutableType]"&lt;/var>
&lt;build name="Run and build map in exported project">
&lt;command>[game] -- run_map::"[MapFile]"&lt;/command>
&lt;/build>
&lt;/project></code></pre>
<p>After making any changes to this file, restart NetRadiant Custom. The build menu will now show your new options; selecting one will run the command you defined above!</p>

<p align="center"><img src="../images/tips_editorbuild_radiant1.png"><br></p>

Restart NetRadiant, and you should see a new option in the build menu. Selecting your new option will run the command you defined above!
</p>
</div>
<br><br><br>
</body>
Expand Down

0 comments on commit 4ee83f8

Please sign in to comment.