Content Packages: Difference between revisions

From Official Barotrauma Wiki
Jump to: navigation, search
BTGamepedia>Telyak
(Various things.)
Tag: visualeditor
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Stub}}
'''Content Packages''', also referred to as '''Mods''', are a feature in ''[[Barotrauma]]'' that allow players to create their own unique XML based content in the game. This content includes enemies, weapons, items, missions, outposts, subs, jobs, and even entire new areas within the game's maps. They also allow the creator to edit certain existing game content, or disable it entirely.
'''Content Packages''', also called mods, are a feature in ''[[Barotrauma]]'' that allow players to create their own unique content in the game. This content includes enemies, weapons, items, missions, and even entire new areas within the game's maps. They also allow the creator to edit existing game content, or disable it entirely.


Content packages are the backbone of Barotrauma's XML modular-modding system, and is generally what people mean when they refer to mods. It is not to be confused with the more niche Source Code Modding.
==Installation==
==Installation==
Installing a Content Package is rather simple. For this example, we will be using the [http://puu.sh/w6KVH.zip| Example Content Package], although you may use any Content Package you so desire. Content Packages are usually .rar or .zip files, and this guide will operate assuming so.
===Steam Workshop===
The Steam Workshop is the officially supported method of installing content packages, and the generally the easiest when it works. Content packages from the workshop will be automatically updated when new versions of packages are released, ensuring that every package installed through workshop is always up to date.


1. Open the [https://steamcommunity.com/app/602960/workshop/ Steam Workshop]. Through the Steam client, you can go to COMMUNITY > Workshop and search for "Barotrauma" in the search workshop bar to find the Barotrauma workshop.
*Opening through an internet browser also requires you to log in with your Steam account be able to use it.
2. Find your desired mod's workshop item page.


1. First, unzip the Package. The amount of files and folders present will vary, but you should look for two: an .xml file and and a folder, usually bearing the name of the Content Package. For our Example Content Package these two files (both named ExamplePackage) will be immediately present, although as previously stated it may vary.
3. Click the subscribe button.
*Note: Some content packages depend on other content packages in order to work, the required items are displayed right of the subscribe button.
*If you wish to install multiple content packages, find their respective pages and subscribe to them all.
*The files for the content package should be automatically installed as soon as Steam is open on computers with Barotrauma installed.
**If Steam does not briefly show a download progress bar on the bottom of the window, or does not initiate a new download, try completely shutting down steam and relaunching it.
4. Launch Barotrauma.
In the main menu, go to settings. On the left is a list of all the content packages available to you.  
*The square tick-box next to each name allows content packages to individually be enabled and disabled, and the multiple dots on the left serve as handles to allow you to drag the mods up and down to change their load order.
**Note: Load order only matters if you are hosting a game, all client's load orders will be the same as the host's.
5. After you have enabled and ordered the mods to your liking, press Apply. If the game tells you to restart the game, do so. Afterwards, the mods should be applied.
*If you would like to check to be sure, the sub editor and character editor should show all items and creatures available respectively.
===Server Browser Quick-Install ("Get Missing Packages")===
Select content packages can also be quickly installed when joining a modded server.


2. Drag the aforementioned folder into the Mods folder in your Barotrauma directory.  
1. Launch Barotrauma, and go to the server browser as usual. Find a modded server, indicated by its purple color. When you click to join, a dialogue prompt should appear asking if you want to install any uninstalled mods the server has enabled. Accept the dialogue and multiple progress bars will appear for the installation. Wait for the mods to finish downloading.
* The game window should be kept in focus while the mods install, or else installation may not proceed properly.
2. The mods should enable automatically, but mods with UI changes may require a restart in order to make the UI changes appear. You will then join the selected modded server. These mods will automatically enable/disable when you join or leave the server respectively, and will continue to operate this way in the future.
===Manual Installation===
Manual installation is the less recommended method of installing Content Packages. Mods installed this way will not automatically update and will remain as they are forever.


3. Drag the aforementioned .xml file into the ContentPackages folder in the Data folder in your Barotrauma directory.
Using [https://www.dropbox.com/s/cc2vriuwtv954yv/ExampleMod.zip?dl=0 ExampleMod] as an example content package.


4. Run the Barotrauma Launcher exe (NOT the Barotrauma exe itself!)
1. Locate the Barotrauma game folder on your computer:
*On Windows, this path is usually <samp>/Program Files (x86)\Steam\steamapps\common\Barotrauma\</samp>


5. Select the Content Package by pressing the "Content package" button in the launcher. Once this is done, press the Start button and, if the previous steps were done correctly, the game should launch with the Content Package active.
*On Linux, this path is usually <samp>~/.local/share/Steam/steamapps/common/Barotrauma/</samp>


*On OSX (Mac) this path is <samp>~/Library/Application Support/Steam/steamapps/common/Barotrauma/</samp>
2. Unzip the contents into the <samp>Barotrauma/Mods<samp> folder
*Exact path to the mod should be <samp>Barotrauma/Mods/ExampleMod</samp>
3. Select the content package in the game settings and restart the game if it tells you to.
==Creation==
==Creation==
{{main|Content Packages/Creation}}
{{main|Content Packages/Tutorial}}
Creating a Content Package is, at first, a daunting task, but once you understand the basics it becomes a swim through the underwater park. ''[[Barotrauma]]'' was specifically designed to be highly compatible with user modifications, and as such no special software is required (or even recommended) to make a Content Package.
Creating a Content Package is, at first, a daunting task, but once you understand the basics it becomes a swim through the underwater park. ''[[Barotrauma]]'' was specifically designed to be highly compatible with user modifications, and as such no special software is required (or even recommended) to make a Content Package.
==Trivia==
*[[:Category:Creatures|Creatures]] introduced in Content Packages cannot be spawned through use of [[Console Commands]], because their files are descendants of the Mods folder instead of the Content folder.
**The same goes for items introduced in Content Packages.

Revision as of 04:27, 13 November 2020

Content Packages, also referred to as Mods, are a feature in Barotrauma that allow players to create their own unique XML based content in the game. This content includes enemies, weapons, items, missions, outposts, subs, jobs, and even entire new areas within the game's maps. They also allow the creator to edit certain existing game content, or disable it entirely.

Content packages are the backbone of Barotrauma's XML modular-modding system, and is generally what people mean when they refer to mods. It is not to be confused with the more niche Source Code Modding.

Installation

Steam Workshop

The Steam Workshop is the officially supported method of installing content packages, and the generally the easiest when it works. Content packages from the workshop will be automatically updated when new versions of packages are released, ensuring that every package installed through workshop is always up to date.

1. Open the Steam Workshop. Through the Steam client, you can go to COMMUNITY > Workshop and search for "Barotrauma" in the search workshop bar to find the Barotrauma workshop.

  • Opening through an internet browser also requires you to log in with your Steam account be able to use it.

2. Find your desired mod's workshop item page.

3. Click the subscribe button.

  • Note: Some content packages depend on other content packages in order to work, the required items are displayed right of the subscribe button.
  • If you wish to install multiple content packages, find their respective pages and subscribe to them all.
  • The files for the content package should be automatically installed as soon as Steam is open on computers with Barotrauma installed.
    • If Steam does not briefly show a download progress bar on the bottom of the window, or does not initiate a new download, try completely shutting down steam and relaunching it.

4. Launch Barotrauma. In the main menu, go to settings. On the left is a list of all the content packages available to you.

  • The square tick-box next to each name allows content packages to individually be enabled and disabled, and the multiple dots on the left serve as handles to allow you to drag the mods up and down to change their load order.
    • Note: Load order only matters if you are hosting a game, all client's load orders will be the same as the host's.

5. After you have enabled and ordered the mods to your liking, press Apply. If the game tells you to restart the game, do so. Afterwards, the mods should be applied.

  • If you would like to check to be sure, the sub editor and character editor should show all items and creatures available respectively.

Server Browser Quick-Install ("Get Missing Packages")

Select content packages can also be quickly installed when joining a modded server.

1. Launch Barotrauma, and go to the server browser as usual. Find a modded server, indicated by its purple color. When you click to join, a dialogue prompt should appear asking if you want to install any uninstalled mods the server has enabled. Accept the dialogue and multiple progress bars will appear for the installation. Wait for the mods to finish downloading.

  • The game window should be kept in focus while the mods install, or else installation may not proceed properly.

2. The mods should enable automatically, but mods with UI changes may require a restart in order to make the UI changes appear. You will then join the selected modded server. These mods will automatically enable/disable when you join or leave the server respectively, and will continue to operate this way in the future.

Manual Installation

Manual installation is the less recommended method of installing Content Packages. Mods installed this way will not automatically update and will remain as they are forever.

Using ExampleMod as an example content package.

1. Locate the Barotrauma game folder on your computer:

  • On Windows, this path is usually /Program Files (x86)\Steam\steamapps\common\Barotrauma\
  • On Linux, this path is usually ~/.local/share/Steam/steamapps/common/Barotrauma/
  • On OSX (Mac) this path is ~/Library/Application Support/Steam/steamapps/common/Barotrauma/

2. Unzip the contents into the Barotrauma/Mods folder

  • Exact path to the mod should be Barotrauma/Mods/ExampleMod

3. Select the content package in the game settings and restart the game if it tells you to.

Creation

Main article: Content Packages/Tutorial


Creating a Content Package is, at first, a daunting task, but once you understand the basics it becomes a swim through the underwater park. Barotrauma was specifically designed to be highly compatible with user modifications, and as such no special software is required (or even recommended) to make a Content Package.