UncivilizedGuy
King of the Universe
- Joined
- May 24, 2012
- Messages
- 1,096
All right kids, let the fun begin!
Copied from Ara WikiAra Modding Setup Guide
This document will show you how to get started with modding Ara: History Untold.In this initial version of mod support, we provide a copy of our source game data files in the Ara installation directory. You can install these source files as a mod in your Documents folder and enable mod loading in the Ara settings. We will walk through each step below.
QuickStart
- Find the game data source mod zip in the Ara installation folder at `assets\SourceMods\GameDataSource_v1.0.4.zip`.
- Extract it into `Documents\My Games\Ara History Untold\Mods\` so that the file `GameCoreData.zdata` is in the `Documents\My Games\Ara History Untold\Mods\GameDataSource_v1.0.4` folder. Create the "Mods" folder first if it does not exist.
- Navigate to `%LOCALAPPDATA%\Ara History Untold` with File Explorer (open File Explorer with WinKey + E) and open the latest settings text file (e.g. `Settings_V122.txt`).
- Set the line `EnableMods=0` to `EnableMods=1`. If this line is missing, add it to the end of the file.
- Set the line `GameCoreMod0Source=` to `GameCoreMod0Source=GameDataSource_v1.0.4`. If this line is missing, add it to the end of the file.
- Start Ara – it will load your modified source files from your Documents folder into the game. Multiplayer and achievements will be disabled while mods are enabled.
Step 1: Find the game data source zip file
If you own the game through Steam, you can get to your installation files quickly through the Steam Library tab. For Windows Store installations (e.g. from Game Pass), you can find the top-level Ara folder by starting at `%LOCALAPPDATA%\Microsoft\WindowsApps`.Find Ara in your Steam library
Right-click the game in the library list, select Manage -> Browse Local Files.You should have a File Explorer window (WinKey + E) open with the following folder:
Open the `assets\SourceMods` folder and locate the `GameDataSource_v1.0.4.zip` file. Right-click on the `GameDataSource_v1.0.4.zip` file and select the 'Copy' menu item.
Step 2: Unzip into Mods folder
Use File Explorer to open your Documents folder and navigate to `My Games` and then, in a separate window, the `Ara History Untold` folder.In `Documents\My Games\Ara History Untold`, create a `Mods` folder (if it does not already exist).
Right-click in the Mods folder and select the Paste menu item to make a copy of `GameDataSource_v1.0.4.zip` in the Mods folder. Extract the contents of the .zip file by right-clicking and selecting the 'Extract All' option.
You should end up with a folder `GameDataSource_V1.0.4` in the Mods folder, containing all of the game data files.
Step 3: Enable modding in Ara settings
Open a File Explorer window and navigate to `%LOCALAPPDATA%\Ara History Untold`.This folder contains a settings file, such as `Settings_v121.txt`. Open the one with the largest version number (the "v121" or similar at the end).
You can open this file using a text editor such as Notepad or Visual Studio Code.
In the file, you should find two lines: `EnableMods=0` and `GameCoreMod0Source=`. If you haven't run the game since the last update, you may need to do so for these to show up. Alternatively, you can also add them to the end of the file manually.
Change these lines to: EnableMods=1 GameCoreMod0Source=GameDataSource_v1.0.4
Save and close the file.
Step 4: Run Ara
If you launch Ara again, you should now start with mods enabled and the source files from `GameDataSource_v1.0.4` loaded as your active game rules.If there are errors loading the mod files, you will receive a data error popup, and the game will proceed loading only its built-in, un-modded data.
(Note: Pressing 'Ctrl-C' will copy all the text from the error popup)
`%LOCALAPPDATA%\Ara History Untold\logs\Ara.log` contains a diagnostic log of the mods loaded (if any) and errors found.
While you are running with mods enabled, achievements and multiplayer will be disabled.
Guides
- Modding for fun and profit
- This page was last edited on 11 October 2024, at 00:39.
- This wiki is not affiliated with Oxide Games or Microsoft in any way. It is run entirely by the community.
Some icons are from smashicons.com, icon-icons.com, and freepik.com.
Modding Tips
- When creating a new folder name for your mod don't use spaces. Underscores are fine. Learning this the hard way caused me quite a headache.
- Mods load in the order they are listed in the Settings file. So mods loaded after other mods override the first mods. Ara coding doesn't appear to have an update mechanism where individual fields can be changed. Instead entire blocks of code are required to update something. Example: a mod changes the cost of the Leatherworking tech. Then the next mod adds a recipe to the Leatherworking tech. So whatever the tech cost is in the second mod will override the first mod. Mod compatibility will be a major issue with Ara unless some new information comes out that we don't already have.
- Icon atlases are in DDS format. So creating new 2d art is similar to Civ
- Files that point to the atlases and the UI files are in xml format. We just need a way for the game core to recognize modded XML files so that new art can be added without replacing files directly.
Spoiler Reference: Unused Art ID's :
Unused Art ID's
.Technologies
.AtlasID = "Astronomy",
.AtlasID = "Botany",
.AtlasID = "Furnaces",
.AtlasID = "IndustrialRecycling",
.AtlasID = "Cryonics",
.AtlasID = "LivingBuildingMaterials",
Some of the weapons icons below are also used as unit icons but not all. Primarily the ships and siege weapons I believe. It doesn't hurt to keep a record of them anyway.
.Items
.AtlasID = "Compasses",
.AtlasID = "Cosmetics",
.AtlasID = "HourGlass",
.AtlasID = "MassProducedToys",
.AtlasID = "MosaicTiles",
.AtlasID = "PDAs",
.AtlasID = "SewingMachines",
.AtlasID = "Toys",
.AtlasID = "WorkBoots",
.AtlasID = "Trousers",
.AtlasID = "Slippers",
.AtlasID = "Sneakers",
.AtlasID = "AircraftCarrier",
.AtlasID = "Anti-AirGun",
.AtlasID = "Androids",
.AtlasID = "AssaultOcteres",
.AtlasID = "AssaultRifle",
.AtlasID = "BallistaHowdah",
.AtlasID = "BattleAxe",
.AtlasID = "Battleship",
.AtlasID = "Bayonet",
.AtlasID = "Bomber",
.AtlasID = "LightBow",
.AtlasID = "HeavyBow",
.AtlasID = "Cannon",
.AtlasID = "SettlerPack",
.AtlasID = "Caravel",
.AtlasID = "Dragoon",
.AtlasID = "Carrack",
.AtlasID = "Chariot",
.AtlasID = "Cog",
.AtlasID = "Commando",
.AtlasID = "Crossbow",
.AtlasID = "CulverinHowdah",
.AtlasID = "DeathRay",
.AtlasID = "Destroyer",
.AtlasID = "Dreadnought",
.AtlasID = "EmbarkPass",
.AtlasID = "FighterPlane",
.AtlasID = "Flamethrower",
.AtlasID = "FlintlockPistol",
.AtlasID = "ShipoftheLine",
.AtlasID = "GatlingGun",
.AtlasID = "GiantMech",
.AtlasID = "Halberd",
.AtlasID = "Harquebus",
.AtlasID = "Helicopter",
.AtlasID = "HolyBook",
.AtlasID = "Howdah",
.AtlasID = "IronClad",
.AtlasID = "JetFighter",
.AtlasID = "Lance",
.AtlasID = "LongBow",
.AtlasID = "Catapult",
.AtlasID = "MechanizedInfantry",
.AtlasID = "MissileCruiser",
.AtlasID = "Mortar",
.AtlasID = "ModernArmor",
.AtlasID = "Musket",
.AtlasID = "NuclearSubmarine",
.AtlasID = "Partisan",
.AtlasID = "PlatedSaddle",
.AtlasID = "Platemail",
.AtlasID = "PoweredExoskeleton",
.AtlasID = "Raider",
.AtlasID = "Railgun",
.AtlasID = "Rifle",
.AtlasID = "RocketArtillery",
.AtlasID = "RPG",
.AtlasID = "Saddles",
.AtlasID = "SAMBattery",
.AtlasID = "ShortStaff",
.AtlasID = "Spear",
.AtlasID = "Staff",
.AtlasID = "StealthBomber",
.AtlasID = "Submarine",
.AtlasID = "Sword",
.AtlasID = "Tank",
.AtlasID = "Trebuchet",
.AtlasID = "Trireme",
.AtlasID = "UAV",
.AtlasID = "WarCommission",
.AtlasID = "Zamburak",
.AtlasID = "Zeppelin",
.AtlasID = "Clothes", ??
Last edited: