LibCareerDB is a storage library for capturing player careers in scenarios and groups and saving them between sessions.
By default, the WAR API does not make career data available for units outside of groups or scenarios. This addon simply saves that data for later retrieval.
Data capture and storage is automatic. If you have ever seen a player in a scenario or a group, you will know the career of that player whenever you run across them. Devs simple need to access the stored data using one of the following two methods:
Usage
playerCareer, hasCareer = CareerDB.GetCareer(playerName)
---where playerName = wstring of player's name; parses out extra characters if needed
playerCareer, hasCareer = CareerDB.GetCareerByTarget(targetType)
---where targetType = "selffriendlytarget" or "selfhostiletarget" or "mouseovertarget"
Getting other TargetInfo:
This library is designed to only save Career information because that is the only information not easily found in the Default API. Most other information can be found by simple using the default WAR API:
TargetInfo.m_Units[targetType].name
TargetInfo.m_Units[targetType].entityid
TargetInfo.m_Units[targetType].healthPercent
TargetInfo.m_Units[targetType].type (ex: SystemData.TargetObjectType.SELF)
TargetInfo.m_Units[targetType].level
TargetInfo.m_Units[targetType].tier
TargetInfo.m_Units[targetType].conType
TargetInfo.m_Units[targetType].isPvP
TargetInfo.m_Units[targetType].isNPC
TargetInfo.m_Units["selffriendlytarget"].name = returns the player name of your friendly target.
Proof of concept
Please see my proof of concept addon CareerText for an example of how to use this data.
Installation Guide
- Exit "Warhammer Online" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Verify your WAR Installation Path
That is where you are running WAR from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your Warhammer Online folder. (default is C:\Program Files\Warhammer Online\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start Warhammer Online
Translations
When you download a mod, please be sure that the mod is compatible with your translation of WAR. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
Directory Structure
Warhammer Online
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.mod
|_ *AddonName*.lua
|_ (possibly others as well)...