MW Factions
Factions are the MekWars equivalent of teams. Players in the same faction share resources, such as components and bays, and have a faction-specific dedicated Chat channel. For MegaMekNET-specific Faction information, check here.
Faction Definition
Factions are defined at initial server start in data/factions.xml. A sample faction entry, taken from the default factions.xml shipped with MekWars is as follows:
<FACTION> <NAME>Davion</NAME> <MONEY>180</MONEY> <COLOR>#808000</COLOR> <ABBREVIATION>D</ABBREVIATION> <LOGO>http://www.megamek.com/NoLogo.jpg</LOGO> <ID>0</ID> </FACTION>
There is more that could be in this file, though, as noted by factions.dtd:
<!ELEMENT ABBREVIATION (#PCDATA)> <!ELEMENT BASEGUNNER (#PCDATA)> <!ELEMENT BASEPILOT (#PCDATA)> <!ELEMENT COLOR (#PCDATA)> <!ELEMENT CONQUERABLE (#PCDATA)> <!ELEMENT INHOUSEATTACKS (#PCDATA)> <!ELEMENT ISMERCENARY (#PCDATA)> <!ELEMENT LOGO (#PCDATA)> <!ELEMENT MAYUSEBM (#PCDATA)> <!ELEMENT MONEY (#PCDATA)> <!ELEMENT NAME (#PCDATA)> <!ELEMENT CONQUERABLE (#PCDATA)> <!ELEMENT INHOUSEATTACKS (#PCDATA)> <!ELEMENT HOUSEPLAYERCOLOR (#PCDATA)> <!ELEMENT DEFECTTO (#PCDATA)> <!ELEMENT DEFECTFROM (#PCDATA)> <!ELEMENT ISNEWBIE (#PCDATA)>
Once a faction has been created, it can be edited from the Faction Configuration menu within MekWars (Server Configs -> Faction Configuration)
There are many options in this menu (warning, this is a work in progress, unfinished at the moment):
Direct Sales Tab
This tab relates to the ability of players in a faction to sell units directly to each other.
- The "Use Direct Sell" checkbox enables or disables Direct Sell for this faction.
- The Pricemod for each unit type is an amount added to the direct sales price, paid for either by the seller or recipient, depending on the "Seller Pays" checkbox on the Server Direct Sales menu.
Faction Tab
This tab contains miscellaneous configuration options for the faction.
- Medium, Heavy, Assault XP: How many experience points necessary to purchase a unit of this weight
- Min House Techs: What is the minimum number of techs/bays a member of this faction will have, regardless of how many bay planets the faction loses
- EXP for Bay: At each interval, the player will get a tech/bay
- Donations Allowed: How many units per tick can a player donate
- Scraps Allowed: How many units per tick can a player scrap
- Max MOTD Length: How many characters are allowed in the faction MOTD
- Welfare Ceiling: Max # of cbills a player can have to collect welfare
- Total Hangar BV for Welfare: Maximum BV in a players hangar to collect welfare
- Cost Multi @ Donate: Multiplied by the purchase price of a new unit, charged at donation
- Cost Multi to Buy Used: Multiplied by the purchase price of a new unit, this is the cost of a unit from the faction bays
- Cost Multi @ Scrap: Multiplied by the purchase price of a new unit, charged at scrapping
- Armor Scrap Cost: Percent of a unit's buy price to charge when scrapping a unit with minor armor damage
- Critical Scrap Cost: Percent of a unit's buy price to charge when scrapping a unit with damaged criticals
- Engined: Percent of a unit's buy price to charge when scrapping a unit with a destroyed engine
- Forum Group Name: Only used if MySQL integration and PHPBB integration is turned on. Automates faction forum access.
- Days Between Promotions: How many days must a player wait between subfaction promotions
- Donate @ Unenroll: If checked, a player's units will be donated to the faction if he unenrolls. If unchecked, the units will be scrapped.
- Faction Names on Games: If checked, the faction name will appear in game resolution announcements. If unchecked, the player name will appear.
- Faction Names in News: If checked, the faction name will appear in the RSS feed. If unchecked, the player name will appear in the RSS feed.
- Auto Promote Sub Factions: If checked, a player will be automatically promoted to a new subfaction when he qualifies for it
Factory Options Tab
Configuration settings related to factories:
- Refresh fields: How many miniticks to refresh a factory after a unit is pulled from it
- Sale Time fields: For how many ticks does a unit that goes to the black market get listed
- Max Light Units: How many light units of each type will the faction bays hold
- Max Other Units: How many units of other weights will the faction bays hold
- Comp Gain Every: Gather component generation stats and show it to faction every X ticks
- Disputed Planet Color: Color to display a planet on the map when no faction owns enough CP to be considered the owner
- Min Planet Ownership: Minimum CP owned to have control of a planet
- Auto Factory Refresh: Number of points the factories should refresh each tick even without active players
- Produce w/o factory: If checked, units will be produced even without an appropriate factory
- Output Multipliers: If checked, active players will be shown their contribution to faction production
Influence Tab
Configuration settings related to Influence. These override server-wide settings.
- Max Player Influence: Maximum flu a player can have
- Min Time for flu: How long after going active, will the player be eligible for influence gain. Influence will be gained starting at the next slice after the active player has passed this number. Milliseconds.
- Floor Penalty: How much influence gain will an army be docked if it abuts the minimum BV.
- Ceiling Penalty: How much influence gain will an army be docked if it abuts the maximum BV.
- Overlap Penalty: How much influence gain will both armies be docked if they are too close together.
- flue Per Army: How much influence does each army grant before modifications.
Pilots Tab
Configuration settings having to do with faction pilots.
- Skill Change:
- Skill Gain:
- XP Loss:
- Cost for Mek Pilot:
- Max Pilots From House:
- Base Pilot Survival:
- Trapped In Mech Survival:
- Damage Per Hit:
- Cost for Proto Pilot:
- Total Skill to Retire:
- Early Retire Cost:
- Best Gunnery:
- Best Piloting:
- Best Total Pilot:
- Base Level Up Roll:
- Roll Multiplier:
- Health per Tick:
- MedTech per Tick:
- Elite BV Mod:
- MaxTech Skills:
- Unlevel@Queue:
- Allow Green Pilots:
- Allow Vet Pilots:
- Allow PPQ:
- Allow Extra Pilots:
- Downed Pilots Roll:
- Allow Retirement:
- Early Retirement:
- Elite Retirements:
- Common Names Only:
- Random Pilot Levels:
- Pilot Damage Transfers:
Pilot Skills (Mek) Tab
Configuration settings having to do with Mek pilots
- Each of these is the experience cost to purchase the given skill. 0 disables the skill.
Pilot Skills Tab
Configuration settings for non-Mek pilots
- Each of the skill boxes sets the experience cost to purchase that skill. Setting to 0 disables that skill.
- Banned WS Weapons: Weapons listed here cannot be specialized in
Pilot Skill Mods Tab
Repodding Tab
Rewards Tab
Techs Tab
Units Tab
Units 2 Tab
Unit Limits Tab