The DarkMod Wiki - User contributions [en]

DarkRadiant - Flatpak Installation Guide

2022-09-18T14:20:31Z

Jonri:

== Obtaining the Flatpak version of DarkRadiant ==
Flatpak is a universal package format for Linux. Rather than having a different package for every Linux distribution, the Flatpak version will just work on almost any major distribution.

* If you've never used a Flatpak before, follow the Flatpak setup instructions for your distro here: https://www.flatpak.org/setup/
* Once Flatpak is ready, you can install the DarkRadiant package in a few ways:
** You can install the package directly from FlatHub: https://flathub.org/apps/details/net.darkradiant.DarkRadiant
** If you are making use of a graphical package installer such as Discover or GNOME Software, you can simply search for and install DarkRadiant.
** Alternatively, from the command line you can run <code>flatpak install --user flathub net.darkradiant.DarkRadiant</code>.

== Optional - Enable the sandbox ==
One of Flatpak's features is its ability to sandbox applications, providing only the minimum file and device permissions necessary for the application to run. However, DarkRadiant needs to have access to the assets from your main game path, which may be installed in any location. DarkRadiant must currently have permissions to access the entire filesystem to allow this, but you can reduce this down to your game path manually if desired. This can be done easily using [https://flathub.org/apps/details/com.github.tchx84.Flatseal Flatseal].

# Install and run [https://flathub.org/apps/details/com.github.tchx84.Flatseal Flatseal].
# In the Applications list, find and select DarkRadiant.
# In the Filesystem section, turn off the "All system files" option.
# Press the Add button inside "Other files".
# Enter the line <code>filesystem=/path/to/tdm</code>, substituting the path to the root of your DarkMod installation.

== Running DarkRadiant ==
# The Flatpak version can be launched from your window manager like any other desktop application.
# Alternatively, to launch it from the command line you can run <code>flatpak run net.darkradiant.DarkRadiant</code>.

{{darkradiant|sort=Flatpak}}
[[Category:Tutorial]]

DarkRadiant - Flatpak Installation Guide

2022-09-18T14:19:39Z

Jonri: Add category

DarkRadiant

2022-09-18T14:15:25Z

Jonri: /* Installation / Compilation */

<div style="padding: 5px; padding-bottom: 0px; float: right; background-color:#EEEEEE; border: 1px solid #CCCCCC;">
[[Image:DarkRadiant_Logo.png]]

<small>The DarkRadiant Logo</small>
</div>
'''DarkRadiant''' is The Dark Mod's very own map editor, originally based on the open-source GtkRadiant. Visit the [http://www.darkradiant.net project website] for release announcements or check the development forums. The source code is hosted on [https://github.com/codereader/DarkRadiant github].

OrbWeaver started working on it in Spring 2006, greebo joined the team as of October 2006 (the initial release was version 0.5.0). Features at this stage include a categorised entity inspector, drag-resizable lights, projected lights, customisable colour schemes, skin chooser for models, UV editor, a unified surface inspector, color selection tool for lights and numerous bugfixes over the GtkRadiant codebase.

== Alphabetical List of Articles ==

{{index-page|category=DarkRadiant|topic=DarkRadiant, the DarkMod map editor}}
== Installation / Compilation ==
* [https://github.com/codereader/DarkRadiant/releases '''Download]''' the latest release from the github project page.
* [[DarkRadiant - Quick Installation Guide]]
* [[DarkRadiant - Flatpak Installation Guide]]
* [[DarkRadiant - Compilation Guide]]

== Mappers ==
* [[DarkRadiant Video Tutorials|Video Tutorials]]
* [[Dark Radiant Keys|DarkRadiant Keys]]
* [[DarkRadiant Tips and Tricks]]
* [[Texturing in DarkRadiant]]
* [[DarkRadiant Command Reference]]
* [[Defining custom Filters in DarkRadiant]]
* [[Readable Editor]]

== Python Scripting ==
* [[DarkRadiant Script Reference]]

== Troubleshooting ==
* Check our [http://bugs.thedarkmod.com/ Bugtracker] for known and reported issues.
* [[Save a Memory Dump for debugging Crashes]]

== Developers ==

* [[DarkRadiant coding standards|Coding standards]]
* [[DarkRadiant render system|Render system]]
* [[DarkRadiant shader system|Shader system]]
* [[DarkRadiant pre-release tests|pre-release tests]]
* [[DarkRadiant Release Mechanics|Release Mechanics]]

== Weblinks ==
* [http://www.darkradiant.net/ Project Website]
* [https://github.com/codereader/DarkRadiant Git Repository]
* [https://github.com/codereader/DarkRadiant_WinDeps Git Repository hosting the Windows Dependencies]
* [http://sourceforge.net/projects/darkradiant/ (Legacy) Sourceforge Project Page]
* [http://forums.thedarkmod.com/forum/51-darkradiant-feedback-and-development/ DarkRadiant Forums]
* [http://bugs.thedarkmod.com Bugtracker]

[[Category:DarkRadiant]]
{{editing}}

DarkRadiant

2022-09-18T14:15:11Z

Jonri: /* Installation / Compilation */ Add Flatpak

<div style="padding: 5px; padding-bottom: 0px; float: right; background-color:#EEEEEE; border: 1px solid #CCCCCC;">
[[Image:DarkRadiant_Logo.png]]

<small>The DarkRadiant Logo</small>
</div>
'''DarkRadiant''' is The Dark Mod's very own map editor, originally based on the open-source GtkRadiant. Visit the [http://www.darkradiant.net project website] for release announcements or check the development forums. The source code is hosted on [https://github.com/codereader/DarkRadiant github].

OrbWeaver started working on it in Spring 2006, greebo joined the team as of October 2006 (the initial release was version 0.5.0). Features at this stage include a categorised entity inspector, drag-resizable lights, projected lights, customisable colour schemes, skin chooser for models, UV editor, a unified surface inspector, color selection tool for lights and numerous bugfixes over the GtkRadiant codebase.

== Alphabetical List of Articles ==

{{index-page|category=DarkRadiant|topic=DarkRadiant, the DarkMod map editor}}
== Installation / Compilation ==
* [https://github.com/codereader/DarkRadiant/releases '''Download]''' the latest release from the github project page.
* [[DarkRadiant - Quick Installation Guide]]
* [[DarkRadiant - Flatpak_Installation_Guide]]
* [[DarkRadiant - Compilation Guide]]

== Mappers ==
* [[DarkRadiant Video Tutorials|Video Tutorials]]
* [[Dark Radiant Keys|DarkRadiant Keys]]
* [[DarkRadiant Tips and Tricks]]
* [[Texturing in DarkRadiant]]
* [[DarkRadiant Command Reference]]
* [[Defining custom Filters in DarkRadiant]]
* [[Readable Editor]]

== Python Scripting ==
* [[DarkRadiant Script Reference]]

== Troubleshooting ==
* Check our [http://bugs.thedarkmod.com/ Bugtracker] for known and reported issues.
* [[Save a Memory Dump for debugging Crashes]]

== Developers ==

* [[DarkRadiant coding standards|Coding standards]]
* [[DarkRadiant render system|Render system]]
* [[DarkRadiant shader system|Shader system]]
* [[DarkRadiant pre-release tests|pre-release tests]]
* [[DarkRadiant Release Mechanics|Release Mechanics]]

== Weblinks ==
* [http://www.darkradiant.net/ Project Website]
* [https://github.com/codereader/DarkRadiant Git Repository]
* [https://github.com/codereader/DarkRadiant_WinDeps Git Repository hosting the Windows Dependencies]
* [http://sourceforge.net/projects/darkradiant/ (Legacy) Sourceforge Project Page]
* [http://forums.thedarkmod.com/forum/51-darkradiant-feedback-and-development/ DarkRadiant Forums]
* [http://bugs.thedarkmod.com Bugtracker]

[[Category:DarkRadiant]]
{{editing}}

DarkRadiant - Quick Installation Guide

2022-09-18T14:13:20Z

Jonri: Add Flatpak to Linux section

== Windows ==

# Download the [[DarkRadiant]] installer (it's the .exe file) from the github release page: https://github.com/codereader/DarkRadiant/releases
# Run the installer and follow the instructions until it finishes.
# Start up [[DarkRadiant]] via the Start menu.
# Go to edit -> preferences. Under the Game Settings, set your '''Engine Path''' as the path to the folder with your TheDarkMod.exe) ''example:'' C:/games/darkmod
# If you are working on a FM, the fs_game setting should point to your current fm folder. For example, '''Mod (fs_game)''': fms/myfirstfm ''(always include the fms/ first)'' If not, you can leave this field blank.
# You're done!

== Linux ==

* For '''Ubuntu''' (and official variants like Kubuntu), please use the package in the Software Center to get the "darkradiant" package which is maintained by the Debian Games Group.
* For most major distributions, the '''[[DarkRadiant_-_Flatpak_Installation_Guide|Flatpak]]''' version can be installed using GNOME Software or Discover.
* If you prefer a native binary for your distribution, you need to download the source and [[DarkRadiant_-_Compiling_in_Linux|compile DarkRadiant]]. After the compilation, use <code>make install</code> to install DarkRadiant into your system. You can then start it with simply <code>darkradiant</code>.

== Quick Mini-Tutorial ==

This is definitely not comprehensive, but here are some of the things you really must know to get started:

* To move around in the 3D view, use the arrow keys. The {{RMB}} toggles mouselook.
* To select things, hold down {{key-shift}} and use the {{LMB}}.
* To add brushes, {{LMB}} and drag the mouse in a 2D view.
* To add other things (lights, entities, models) right-click in a 2D view to get a context menu.
* To get a preview of your map with lighting in the 3D view, press {{key|F3}}. It's a bit slow (especially to initialise), but we're working on that. Pressing {{key|F3}} again will go back to the normal fullbright view.

Please continue with the [[Dark Radiant Must Know Basic Intro]] or Fidcal's [[A - Z Beginner Full Guide Start Here!]] article.

Also, poke around in the Preferences dialog (press {{key|P}}) if you feel like customizing anything. Happy mapping!

{{darkradiant|sort=Quick}}
[[Category:Tutorial]]

DarkRadiant - Flatpak Installation Guide

2022-09-18T13:57:37Z

Jonri: Update with final instructions for the released version

DarkRadiant - Flatpak Installation Guide

2022-09-15T03:14:39Z

Jonri:

= '''NOTE: This is a WIP, the Flatpak is not yet online''' =

== Obtaining the Flatpak version of DarkRadiant ==
Flatpak is a universal package format for Linux. Rather than having a different package for every Linux distribution, the Flatpak version will just work on almost any major distribution.

# If you've never used a Flatpak before, follow the Flatpak setup instructions for your distro here: https://www.flatpak.org/setup/
# Once Flatpak is ready, you can install the DarkRadiant package in a few ways:
## You can install the package directly from FlatHub: https://flathub.org/apps/details/net.darkradiant.DarkRadiant
## If you are making use of a graphical package installer such as Discover or <Gnome equivalent>, you can simply search for and install DarkRadiant.
## Alternatively, from the command line you can run <code>flatpak install --user flathub net.darkradiant.DarkRadiant</code>.

== After Installation ==
One of Flatpak's features is its ability to sandbox applications, providing only the minimum file and device permissions necessary for the application to run. For many applications, you won't ever notice a difference, but for DarkRadiant one additional step is needed to allow DarkRadiant to access the assets from your main game path. This can be done graphically using [https://flathub.org/apps/details/com.github.tchx84.Flatseal Flatseal], or by using the command line.

Start by making note of the path to your DarkMod (or other IdTech4 game) installation, then choose one of the two options below.

=== Add permissions graphically ===
# Install and run [https://flathub.org/apps/details/com.github.tchx84.Flatseal Flatseal]
# In the Applications list, find and select DarkRadiant.
# In the Filesystem section, hit the Add button inside "Other files".
# Enter the line <code>filesystem=/path/to/tdm</code>, substituting the path to the root of your DarkMod installation.

=== Add permissions from the command line ===
:Run the following command, substituting the path to the root of your DarkMod installation:

:<code>flatpak override --user --filesystem=/path/to/tdm net.darkradiant.DarkRadiant</code>

== Running DarkRadiant ==
# The Flatpak version can be launched from your window manager like any other desktop application.
# Alternatively, to launch it from the command line you can run <code>flatpak run net.darkradiant.DarkRadiant</code>.
Upon first launch, you will be prompted to select your game path. If you cannot successfully enter your game path, double-check the permissions settings above.

DarkRadiant - Flatpak Installation Guide

2022-09-15T03:11:24Z

Jonri: First draft

== Obtaining the Flatpak version of DarkRadiant ==
Flatpak is a universal package format for Linux. Rather than having a different package for every Linux distribution, the Flatpak version will just work on almost any major distribution.

# If you've never used a Flatpak before, follow the Flatpak setup instructions for your distro here: https://www.flatpak.org/setup/
# Once Flatpak is ready, you can install the DarkRadiant package in a few ways:
## You can install the package directly from FlatHub: https://flathub.org/apps/details/net.darkradiant.DarkRadiant
## If you are making use of a graphical package installer such as Discover or <Gnome equivalent>, you can simply search for and install DarkRadiant.
## Alternatively, from the command line you can run <code>flatpak install --user flathub net.darkradiant.DarkRadiant</code>.

== After Installation ==
One of Flatpak's features is its ability to sandbox applications, providing only the minimum file and device permissions necessary for the application to run. For many applications, you won't ever notice a difference, but for DarkRadiant one additional step is needed to allow DarkRadiant to access the assets from your main game path. This can be done graphically using [https://flathub.org/apps/details/com.github.tchx84.Flatseal Flatseal], or by using the command line.

Start by making note of the path to your DarkMod (or other IdTech4 game) installation, then choose one of the two options below.

=== Add permissions graphically ===
# Install and run [https://flathub.org/apps/details/com.github.tchx84.Flatseal Flatseal]
# In the Applications list, find and select DarkRadiant.
# In the Filesystem section, hit the Add button inside "Other files".
# Enter the line <code>filesystem=/path/to/tdm</code>, substituting the path to the root of your DarkMod installation.

=== Add permissions from the command line ===
:Run the following command, substituting the path to the root of your DarkMod installation:

:<code>flatpak override --user --filesystem=/path/to/tdm net.darkradiant.DarkRadiant</code>

== Running DarkRadiant ==
# The Flatpak version can be launched from your window manager like any other desktop application.
# Alternatively, to launch it from the command line you can run <code>flatpak run net.darkradiant.DarkRadiant</code>.
Upon first launch, you will be prompted to select your game path. If you cannot successfully enter your game path, double-check the permissions settings above.

SEED - Image maps

2021-09-02T02:18:47Z

Jonri: Update file type and spawnarg instructions for 2.10

== Introduction ==

For each [[SEED]] entity you can specify an '''image map''', which will influence where entities are placed. This can even be overridden for each target class of the SEED with '''seed_map'''.

The map is an 8 bit greyscale PNG image, where black is 0% and white is 100% spawn probability.

== How to use ==

For example put this spawnarg on your SEED:

"map" "spots"

or put this on a target entity:

"seed_map" "patterns"

The image map must be placed in the "textures/seed" directory of your FM, and the map name in the spawnarg must be the base name of the image file. For example, "sinus" will load "textures/seed/sinus.png".

Note: The image base map is combined with whatever distribution you set with falloff, also inhibitors are still taken into account.

=== Random maps ===

If your map spawnarg consists of multiple maps listed with ",", one of them will be chosen randomly and then used:

"map" "spots, spots2, sinus"

== Gallery ==

There are a few premade maps in TDM, here is a visual overview:

{| style="margin: 0.5em; margin-left: 1em; border: 1px solid #a0a0a0; text-align: right; border-collapse: collapse;" cellpadding="5" border="1"

|-
!bgcolor="#ffdead" align="center"|Name
!bgcolor="#ffdead" align="center"|Look
!bgcolor="#ffdead" align="center"|Usage
!bgcolor="#ffdead" align="center"|Name
!bgcolor="#ffdead" align="center"|Look
!bgcolor="#ffdead" align="center"|Usage

|-
|'''cloud'''
|[[Image:Cloud.jpg|120px]]
|align=left|Vegetation f.i. grass
|'''patterns'''
|[[Image:Patterns.jpg|120px]]
|align=left|To make vegetation placed less uniform

|-
|'''splat'''
|[[Image:Splat.jpg|120px]]
|align=left|Vegetation f.i. grass
|'''vegetation'''
|[[Image:Vegetation.jpg|120px]]
|align=left|To make vegetation placed less uniform

|-
|
|
|
|'''spots'''
|[[Image:Spots.jpg|120px]]
|align=left|Vegetation spots f.i. grass

|-
|'''two_spots'''
|[[Image:Two spots.jpg|120px]]
|align=left|To place f.i. items in front of two sitting people at a table
|'''sinus'''
|[[Image:Sinus.jpg|120px]]
|align=left|Interesting patterns f.i. for vegetation

|}

== Gallery v1.05 ==

These maps are new in TDM v1.05:

{| style="margin: 0.5em; margin-left: 1em; border: 1px solid #a0a0a0; text-align: right; border-collapse: collapse;" cellpadding="5" border="1"

|-
!bgcolor="#ffdead" align="center"|Name
!bgcolor="#ffdead" align="center"|Look
!bgcolor="#ffdead" align="center"|Usage
!bgcolor="#ffdead" align="center"|Name
!bgcolor="#ffdead" align="center"|Look
!bgcolor="#ffdead" align="center"|Usage

|-
|'''corner'''
|[[Image:Corner.png|120px]]
|align=left|Dense vegetation in a corner
|'''corner2'''
|[[Image:Corner2.png|120px]]
|align=left|Sparse vegetation in a corner

|-
|'''splat2'''
|[[Image:Splat2.jpg|120px]]
|align=left|Vegetation f.i. grass
|'''drip'''
|[[Image:Drip.png|120px]]
|align=left|For vegetation that "fades" f.i. bushes at a forest edge

|}

{{seed}}