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

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

The 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

The 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

The 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: Pilots may not gain WS for weapons listed here.

Pilot Skill Mods Tab (not finished)

The Pilot Skill Mods Tab

Configuration settings that modify BV based on pilot skills or Mek equipment

• Dodge Maneuver Mod:
• Melee Specialist Mod:
• Hatchet Mod:
• Pain Reistance BV Mod:
• Iron Man BV Mod:
• MA BV Mod:
• MA Speed Rating:
• Tactical Genius BV:
• EI bv mod:
• Edge bv mod:
• Max Edge:
• VDNI:
• BVDNI:
• Pain Shunt:

Repodding Tab (not finished)

The Repodding Tab

Configuration settings about repodding omnimechs

• Cost CB:
• Use Factory:
• Uses Comps:
• Common Table:
• Allow Random:
• Random Only:
• L/M/H/A CB:
• L/M/H/A flu:
• L/M/H/A Components:
• L/M/H/A Refresh:
• Percent of Cost for Random:
• No Factory Repod Folder:

Rewards Tab (not finished)

The Rewards Tab

Configuration settings about Reward Points

• DISPLAY:
• flu:
• Techs:
• Units:
• Rares:
• Repods:
• Refresh:
• Repairs:
• Crit Repairs:
• Max Reward Points:
• XP for Reward:
• Techs for RP:
• Flu for RP:
• Rare Multiplier:
• RP to refresh:
• RP to buy Green Tech:
• RP to buy Reg Tech:
• RP to Buy Vet Tech:
• RP to Buy Eleite Tech:
• RP to Repair a crit:
• RP to Repair a unit:
• Repod Cost:
• NonHouse Multiplier:
• Rewards Repod Folder:
• Rewards Rare Build Table:

Techs Tab (not finished)

The Techs Tab

Configuration settings related to Techs (not Technicians). On a server using Advanced Repair, Techs are synonymous with Bays.

• Use Techs
• Use XP:
• Decreasing Cost:
• Sender Pays:
• Recipient Pays:
• Base Tech Cost:
• XP for Decrease:
• Minimum Tech Cost:
• Additive Per Tech:
• Additive Ceiling:
• Transfer Payment:
• Maint Increase:
• Maint Decrease:
• Base Unmaint Level:
• Unmaintain Penalty:
• Transfer Scrap Level:
• Techs To Proto Point Ratio:
• Techs per Light/Medium/Heavy/Assault Mek/Vehicle/Infantry/BattleArmor/Aero:

Units Tab (not finished)

The Units Tab

Configuration settings related to combat units

• Light/Medium/Heavy/Assault Mek/Veh/Inf Cost:
• Light/Medium/Heavy/Assault Mek/Veh/Inf Flu:
• Light/Medium/Heavy/Assault Mek/Veh/Inf PP:
• Max Armies:
• Base Army Weight:
• Cost Multiplier:
• Use Vehs/Inf/BA/Proto:
• Light Inf:
• Light Vehs:
• Free Foot:
• Real Cost: (Disabled - this is set at the server level)

Units 2 Tab (not finished)

The Units 2 Tab

More configuration settings for combat units

• Light/Medium/Heavy/Assault Proto/BA/Aero Cost:
• Light/Medium/Heavy/Assault Proto/BA/Aero Flu:
• Light/Medium/Heavy/Assault Proto/BA/Aero PP
• NonOrig Money/Flu/PP Multi:
• Light/Medium/Heavy/Assault Type:
• Mek/vee/Inf/Proto/BA/Aero Class:
• Allow Mek/Vee/Inf/Proto/BA/VTOL/Aero Commanders:
• Allow Fighting Without Commanders:

Unit Limits Tab (not finished)

The Unit Limits Tab

Configuration settings regarding hangar and black market limits

Hangar Limits

• How many of each unit type and weight a player can have in his hangar. -1 is no limit.

Black Market LImits

• Are players allowed to purchase each unit type and weight from the Black Market

• Disable Activation:
• Disable AFR:
• Use Sliding Hangar Limits:
• Multiplier:
• Apply to Purchase:
• Apply to Payout:

Autoproduction Tab

The Autoproduction Tab

Configuration settings about Faction autoproduction

• Use Classic Autoproduction: Enables Classic AP, where all component stashes have the same failure rate, and all unit types of the same class share number limits
• Use New Autoproduction: Enables New AP, where failure rate and unit numbers are controlled by individual weight/type

Classic AP

• Lights/Mediums/Heavies/Assaults to AP: How many unit's worth of components before AP kicks in
• AP Failure Rate: Percent chance that components will be destroyed instead of used to produce a unit

New Autoproduction Model

• Units: How many unit's worth of components before AP kicks in
• Failure: Percent chance that components will be destroyed instead of used to produce a unit