bijx / ARMA-3-Camo-Mod-Maker

An application that allows you to create a equipment mod for ARMA 3 in minutes.
Apache License 2.0
4 stars 1 forks source link
arma-3-tools arma3 automation bohemiainteractive electronjs generator javascript jimp mod-maker modding nodejs textures

Image description License Dynamic JSON Badge PRs Welcome Discord

ARMA 3 Camo Mod Maker

A standalone application that allows you to create a uniform addon for ARMA 3 based on a custom texture file.

Installation

Quickstart Tutorial Link / Youtube

Supported OS: Currently, only Windows OS is supported. Future updates may include support for MacOS and Linux.

Prerequisites:

Steps:

  1. Download the latest version from the Releases Page. Extract the ZIP file to a preferred location on your machine.
  2. In order for the application to properly convert images to .paa textures, you will need to have Arma 3 Tools installed on your machine.
    • Go to C:\Program Files\Steam\steamapps\common or the directory where your steamapps are located.
    • Open the Arma 3 Tools directory and locate the TexView2 folder.
    • Copy Pal2PacE.exe from the TexView2 folder and paste it into the vendor folder of the Camo Mod Maker app (\CamoModMaker-win32-x64\resources\app\vendor). Use the place_Pal2PacE.exe_here file as a guide for the correct location.
  3. Launch the application by running CamoModMaker.exe from the root folder (CamoModMaker-win32-x64).

Usage

Generating the Mod

  1. Input a name for your mod in the Mod Name field.
  2. Fill in your username in the Author Name field for in-game credit.
  3. Use the Choose File button to select a texture file. Optimal textures are square, at least 1024x1024px, and preferably tileable.
  4. Choose the addons to include in your mod. The Base Uniform is always included; additional equipment options are available.
  5. Optional: The Blend Uniform with Normal feature combines your texture with the base normal map for added detail such as pocket outlines and fabric wrinkles. Experiment to see which setting suits your needs.
  6. Click "Create Mod" and wait for the confirmation message. Processing time varies based on the number of selected addons. Encounter any issues? Report them here.

Packaging the Mod

Follow these steps to package your mod:

  1. Locate the Created Mod:

    • After creation, your mod will be a ZIP file in the \CamoModMaker-win32-x64\resources\app\ directory. Zip File Location
  2. Prepare the Mod Folders:

    • Move the ZIP file to an empty folder on your machine and extract it. You will get two folders named after your class, one of which is prefixed with an @ symbol. Two Generated Mod Folders
  3. Set Up the Addon Builder:

    • Open Arma 3 Tools and start the Addon Builder.
    • In Addon Source Directory, enter the path to the folder without the @ symbol.
    • In Destination Directory or Filename, enter the path to the Addons folder inside the folder with the @ symbol.
      • Example: If your mod is named EpicUSMod, set up the Addon Builder as shown: Addons Folder
  4. Build the Mod:

    • Click the Pack button in the Addon Builder and wait for the confirmation of a successful build. Build Success
  5. Load the Mod in Arma 3:

    • Drag the entire folder with the @ prefix into the Arma 3 Launcher mod menu to load your mod. Drag mod folder into launcher

Planned Features

Contributions

Your contributions are highly valued in this project! As a community-driven, open-source initiative, our goal is to simplify mod making and empower everyone to express their creativity. Here’s how you can contribute:

Developer Notes

Each addon that can be included in the final mod has a specific internal name to identify it in the code.

Internal Name Game Equivalent
baseUniform b_soldier_01 - BLUFOR Combat Fatigues (MTP)
indepUniform ia_soldier_01 - INDEP Combat Fatigues (AAF)
assaultPack backpack_compact - Assault Pack
carrierRigSpecial equip_b_carrier_spec_rig - Carrier Rig Special
carrierRig equip_b_vest02 - Standard Carrier Rig
helmetBlufor headgear_b_helmet_plain - Combat Helmet

License

This project is licensed under the Apache License 2.0. This license allows for the freedom to use the software for any purpose, to distribute it, to modify it, and to distribute modified versions of the software under the terms of the license.

Key provisions of this license include:

For the full terms and conditions, please see the Apache 2.0 License.

Special Thanks

Thanks to anyone who has contributed domain knowledge, testing efforts, or libraries/tools that made this project possible!

Made by bijx