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

The 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

The 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

The 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

The Influence Tab

Pilots Tab

The Pilots Tab

Pilot Skills (Mek) Tab

The Pilot Skills (Mek) Tab

Pilot Skills Tab

The Pilot Skills Tab

Pilot Skill Mods Tab

The Pilot Skill Mods Tab

Repodding Tab

The Repodding Tab

Rewards Tab

The Rewards Tab

Techs Tab

The Techs Tab

Units Tab

The Units Tab

Units 2 Tab

The Units 2 Tab

Unit Limits Tab

The Unit Limits Tab

Autoproduction Tab

The Autoproduction Tab