Installing and Running Fan Missions: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
Fidcal (talk | contribs)
Geep (talk | contribs)
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Go to www.thedarkmod.com to get hold of mission packages available for [[The Dark Mod]].
= Installing a New Mission =
== Download the mission PK4 ==
<big>There are two ways to install a new mission:
[[Image:Installing fms02.png|right|200px]]Each FM is contained in a PK4 file, which contains all the files necessary to run the mission. Download and drop the PK4 file into the fms/ folder, e.g. <tt>C:\Games\doom3\darkmod\fms\</tt>.
# By downloading a mission pk4 file and placing it in the fms folder
# By using the in-game mission downloader
</big>


== Launch The Dark Mod and Install the Mission ==
== By downloading the mission PK4 ==
When launching The Dark Mod, the game will detect the new mission package in the fms/ folder and will add it to the list of available missions (note: the PK4 file will be automatically moved into a subfolder, this is normal operation).
# Go to [https://www.thedarkmod.com/missions/ thedarkmod.com/missions] (say, by selecting "Missions" from the site top menu strip) to see a list of available FMs.
# For an FM of interest, click on "Download Details".
# Each FM is contained in a PK4 file, which contains all the files necessary to run the mission. Choose one of the equivalent links to download, and drop the PK4 file into the fms/ folder, e.g. <tt>C:\Games\darkmod\fms\</tt>.
# Launch The Dark Mod game to '''automatically install the mission'''. That is, upon launch, the game will detect the new mission package in the fms/ folder and will add it to the list of available missions. (Note: the PK4 file will be automatically moved into a subfolder. This is normal operation).


# Hit ''New Mission'' and you'll see a list of available missions.
== By installing with the in-game downloader ==
# Select the desired mission from the list and hit ''Install Mission'' on the lower left.  
[[Image:Download-mission210.jpg|right|thumb]]
# Launch The Dark Mod.
# From the main menu, click ''Mission List'' (''formerly ''New Mission'', as shown in figures here).
# Click ''Download Missions'' in the lower border of the Mission List.
 
In this screen on the left is the ''Online Mission Archive'', with a list of FMs that:
* you don't yet have, but are available to download and install; and
* you '''do''' have already installed, but that have an update or new (or at least not-yet-installed) translation available.
If you click on a listed mission, you see information under it. You can click on ''More...'' to get a more detailed screen with a description and screenshots from the mission.
 
Last steps:
# With a row selected, click on ''Select for download'' to move a listing to the right-hand ''Download Status/Selected For DownLoad'' pane. Repeat to build up a list to download.
# Or ''Select all'' to download all missions, but '''not recommended''' because it will stress the download mirrors unnecessary.
# Then click "Start Download". FMs will be queued to download and automatically install.
 
 
= Selecting a New or Different Mission to Play =
[[Image:new-mission210.jpg|right|thumb]]
# From the main menu, click ''Mission List''
# On the right of the screen, you'll see a list of available missions that you've installed.
# Click on a mission within the list. Information about it will pop up in the left pane (as shown in figure), and ''Notes'' often has more.
# When you've made your choice, click ''Select Mission'' at the lower right corner.  
# The game will restart itself automatically.<br style="clear: both" />
# The game will restart itself automatically.<br style="clear: both" />
== Start the Mission ==
== Starting the mission ==
[[Image:Installing fm01.png|right|330px]]After restart, go the ''New Mission'' page again. The mission name will appear on the top left as ''Currently Installed Mission''.
After the restart, click ''Start this Mission''. You'll be taken to the mission's briefing.<br style="clear: both" />


Just hit the ''Start this Mission'' button to launch the mission. You'll be taken to the missions' briefing.<br style="clear: both" />
== Resuming a mission ==
== Resuming a Mission ==
Once installed, a Fan Mission will stay installed until you uninstall it (click ''deselect mission'') or install a different FM. As each Fan Mission is "run" in a separate folder, your savegames '''will be preserved''' when switching between them. (However, a savefile will generally not be functional after an update to its FM or core TDM.)
Once installed, a Fan Mission will stay installed until you uninstall it or install a different FM. As each Fan Mission is "run" in a separate folder, your savegames '''will be preserved''' when switching between them.


To resume a mission from a savegame, make sure the FM is installed, then just go to the Load/Save game menu and select one from the list.
To resume a mission from a savegame, make sure the FM is installed, then just go to the Load/Save game menu and select one from the list.


== Updating a Mission ==
== Updating a mission ==
Whenever the mission author releases a new version of his FM, you need to re-install the mission. Download the new PK4 file and drop it into the fms/ folder as before. Be sure to '''uninstall''' and re-install the mission before continuing to play.
Whenever the mission author releases a new version of his FM, you need to re-install the mission. Missions do not auto-update. See above for instructions.
 
= Does a Mission Have Translations? =
Some FMs support additional languages besides English, contained in a "Localization Pack". This is a separate PK4 file, routinely named <myFM>_l10n_<checksum>.pk4, where "l10n" abbreviates "localization".
 
== Overviews across FMs ==
For an overview of which FMs have Localization Packs, see [[Fan Missions for The Dark Mod]], and look at the table's 'Translation Pack' column.
 
Unfortunately, at this time it is difficult to know which FMs have a Localization Pack that includes ''your'' particular language of interest. The [[I18N Status]] page (where "I18N" stands for Internationalization) gives information about some older FMs, but has not been updated for quite awhile.
 
== For a Given FM ==
It's easy enough to verify if a Localization Pack is available; the installation process described below will let you know if not.
 
As for support for a particular language, after you install the Localization Pack:
* look within the .pk4 (temporarily renamed to .zip if necessary) and its /strings/ folder. The presence of a *.lang (e.g., french.lang) is required for support.
* or just play the game to find out. Be aware that there are degrees of translation support.
= Installing a Mission's Translations =
The basic install above provides English. '''Do that first'''. There are then two official ways to get and install a Localization Pack.
 
== By downloading the localization pack ==
Starting from the site's ''Mission'' page and then to the ''Download Details'' page for given FM, the Localization Packs section will tell you if a pack of translations is available, and if so provide a choice of equivalent links. [I guess download into the /fms folder and get it auto-installed on game restart? Or download it into the particular /fm folder? TBD]
 
== By installing with the in-game downloader ==
For this process to work, you must have already installed the FM. Then, revisit the ''Online Mission Archive'' page. Is there an "#" annotation (for "# Translation") next to your FM name? Then '''download again''' to get the Pack and have it auto-installed. Note - Only in the 'Online Mission Archive' page will there be "#" and "*" (for "* Update") annotations; not in the Mission List page.


== See also ==
== See also ==
Line 25: Line 74:
* [[FAQ]] (for troubleshooting etc.)
* [[FAQ]] (for troubleshooting etc.)
[[Category:Gameplay]]
[[Category:Gameplay]]
[[Category:Fan Missions]]
[[Category:Gameplay concepts and settings]]

Latest revision as of 19:53, 1 July 2025

Installing a New Mission

There are two ways to install a new mission:

  1. By downloading a mission pk4 file and placing it in the fms folder
  2. By using the in-game mission downloader

By downloading the mission PK4

  1. Go to thedarkmod.com/missions (say, by selecting "Missions" from the site top menu strip) to see a list of available FMs.
  2. For an FM of interest, click on "Download Details".
  3. Each FM is contained in a PK4 file, which contains all the files necessary to run the mission. Choose one of the equivalent links to download, and drop the PK4 file into the fms/ folder, e.g. C:\Games\darkmod\fms\.
  4. Launch The Dark Mod game to automatically install the mission. That is, upon launch, the game will detect the new mission package in the fms/ folder and will add it to the list of available missions. (Note: the PK4 file will be automatically moved into a subfolder. This is normal operation).

By installing with the in-game downloader

  1. Launch The Dark Mod.
  2. From the main menu, click Mission List (formerly New Mission, as shown in figures here).
  3. Click Download Missions in the lower border of the Mission List.

In this screen on the left is the Online Mission Archive, with a list of FMs that:

  • you don't yet have, but are available to download and install; and
  • you do have already installed, but that have an update or new (or at least not-yet-installed) translation available.

If you click on a listed mission, you see information under it. You can click on More... to get a more detailed screen with a description and screenshots from the mission.

Last steps:

  1. With a row selected, click on Select for download to move a listing to the right-hand Download Status/Selected For DownLoad pane. Repeat to build up a list to download.
  2. Or Select all to download all missions, but not recommended because it will stress the download mirrors unnecessary.
  3. Then click "Start Download". FMs will be queued to download and automatically install.


Selecting a New or Different Mission to Play

  1. From the main menu, click Mission List
  2. On the right of the screen, you'll see a list of available missions that you've installed.
  3. Click on a mission within the list. Information about it will pop up in the left pane (as shown in figure), and Notes often has more.
  4. When you've made your choice, click Select Mission at the lower right corner.
  5. The game will restart itself automatically.

Starting the mission

After the restart, click Start this Mission. You'll be taken to the mission's briefing.

Resuming a mission

Once installed, a Fan Mission will stay installed until you uninstall it (click deselect mission) or install a different FM. As each Fan Mission is "run" in a separate folder, your savegames will be preserved when switching between them. (However, a savefile will generally not be functional after an update to its FM or core TDM.)

To resume a mission from a savegame, make sure the FM is installed, then just go to the Load/Save game menu and select one from the list.

Updating a mission

Whenever the mission author releases a new version of his FM, you need to re-install the mission. Missions do not auto-update. See above for instructions.

Does a Mission Have Translations?

Some FMs support additional languages besides English, contained in a "Localization Pack". This is a separate PK4 file, routinely named <myFM>_l10n_<checksum>.pk4, where "l10n" abbreviates "localization".

Overviews across FMs

For an overview of which FMs have Localization Packs, see Fan Missions for The Dark Mod, and look at the table's 'Translation Pack' column.

Unfortunately, at this time it is difficult to know which FMs have a Localization Pack that includes your particular language of interest. The I18N Status page (where "I18N" stands for Internationalization) gives information about some older FMs, but has not been updated for quite awhile.

For a Given FM

It's easy enough to verify if a Localization Pack is available; the installation process described below will let you know if not.

As for support for a particular language, after you install the Localization Pack:

  • look within the .pk4 (temporarily renamed to .zip if necessary) and its /strings/ folder. The presence of a *.lang (e.g., french.lang) is required for support.
  • or just play the game to find out. Be aware that there are degrees of translation support.

Installing a Mission's Translations

The basic install above provides English. Do that first. There are then two official ways to get and install a Localization Pack.

By downloading the localization pack

Starting from the site's Mission page and then to the Download Details page for given FM, the Localization Packs section will tell you if a pack of translations is available, and if so provide a choice of equivalent links. [I guess download into the /fms folder and get it auto-installed on game restart? Or download it into the particular /fm folder? TBD]

By installing with the in-game downloader

For this process to work, you must have already installed the FM. Then, revisit the Online Mission Archive page. Is there an "#" annotation (for "# Translation") next to your FM name? Then download again to get the Pack and have it auto-installed. Note - Only in the 'Online Mission Archive' page will there be "#" and "*" (for "* Update") annotations; not in the Mission List page.

See also