ModOptions.lua

   
-- $Id: ModOptions.lua 4642 2009-05-22 05:32:36Z carrepairer $


--  Custom Options Definition Table format
--  NOTES:
--  - using an enumerated table lets you specify the options order

--
--  These keywords must be lowercase for LuaParser to read them.
--
--  key:      the string used in the script.txt
--  name:     the displayed name
--  desc:     the description (could be used as a tooltip)
--  type:     the option type ('list','string','number','bool')
--  def:      the default value
--  min:      minimum value for number options
--  max:      maximum value for number options
--  step:     quantization step, aligned to the def value
--  maxlen:   the maximum string length for string options
--  items:    array of item strings for list options
--  section:  so lobbies can order options in categories/panels
--  scope:    'all', 'player', 'team', 'allyteam'      <<< not supported yet >>>
--

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
--
--  Example ModOptions.lua
--

local options = {
-- do deployment and tactics even work?
	{
		key    = 'a_important',
		name   = 'Important',
		desc   = 'Commonly used options.',
		type   = 'section',
	},
	{
		key    = 'startconds',
		name   = 'Start',
		desc   = 'Start condition settings.',
		type   = 'section',
	},
	{
		key    = 'mapsettings',
		name   = 'Map',
		desc   = 'Map settings.',
		type   = 'section',
	},
	{
		key    = 'multipliers',
		name   = 'Multipliers',
		desc   = 'Statistics multipliers.',
		type   = 'section',
	},
	{
		key    = 'silly', -- lava, fun, zombies
		name   = 'Silly',
		desc   = 'Silly options for trolling.',
		type   = 'section',
	},
	{
		key    = 'commends',
		name   = 'Team Commander Ends',
		desc   = 'Causes an allyteam to lose if they have no commanders left on their team',
		type   = 'bool',
		def    = false,
		section= 'a_important',
	},
	
	{
		key     = 'sharemode',
		name    = 'Commshare',
		desc    = 'Determines whether players can merge together during gameplay.',
		type    = 'list',
		section = 'a_important',
		def     = 'invite',
		items   = {
			{ key='all', name = "Merge All", desc = 'Merges all at game start. Recommend using allowunmerge = false with this.' },
			{ key='invite', name = "Invite Only", desc = 'Allows players to merge only if both give consent.' },
			{ key='none', name = "Off", desc = 'Turns commsharing off.' },
		},
	}, -- memorylimit
	{
		key    = 'memorylimit',
		name   = 'Lua allocation limit',
		desc   = "In MB. Controls how much memory is allocated to lua.",
		type   = 'number',
		section= 'a_important',
		def=4048,
		min=1536,
		max=10000,
		step=1,
	},
	{
		key = "noelo",
		name = "No Elo",
		desc = "Prevent battle from affecting Elo rankings",
		type = "bool",
		section= 'a_important',
		def = false,
	},
	{
		key = "commwars",
		name = "Commander Wars",
		desc = "Blocks commanders from constructing and enables balance around commwars.",
		type = "bool",
		section= 'a_important',
		def = false,
	},
	{
		key = "houserules",
		name = "House Rules",
		desc = "Add some rules here. This will popup during pregame to remind people of rules set here.",
		type = "string",
		section= 'a_important',
		def = "",
	},
	{
		key = "isplanetwars",
		name = "Planet Wars",
		desc = "This setting is used to transport important information at the end of the game to FW infra.",
		type = "bool",
		section= 'a_important',
		def = false,
	},
	{
		key = "planetwarsdata",
		name = "PW Data",
		desc = "This setting is used to transport important information in game.",
		type = "string",
		section= 'a_important',
		def = "",
	},
	{
		key    = 'commeco',
		name   = 'Enable Efficient Resourcing',
		desc   = "Support commander regains Efficient Resourcing Module.",
		type   = 'bool',
		section= 'a_important',
		def    = false,
	},
	{
		key     = 'mutespec',
		name    = 'Mute Spectators',
		desc    = 'Determines whether spectators can talk to players.',
		type    = 'list',
		section = 'a_important',
		def     = 'autodetect',
		items   = {
			{ key='mute', name = "Mute", desc = 'Mutes spectators.' },
			{ key='autodetect', name = "Autodetect", desc = 'Mutes spectators in FFA (more than two teams).' },
			{ key='nomute', name = "No Mute", desc = 'Does not mute spectators.' },
		},
	},
	{
		key     = 'mutelobby',
		name    = 'Mute Lobby',
		desc    = 'Determines whether chat in the lobby is visible ingame.',
		type    = 'list',
		section = 'a_important',
		def     = 'autodetect',
		items   = {
			{ key='mute', name = "Mute", desc = 'Mutes the lobby.' },
			{ key='autodetect', name = "Autodetect", desc = 'Mutes the lobby in FFA (more than two teams).' },
			{ key='nomute', name = "No Mute", desc = 'Does not mute the lobby.' },
		},
	},
	{
		key    = 'resource_handicap',
		name   = 'Resource Handicap',
		desc   = "Multiplies a team's resources and BP by a certain amount. Split by a space. EG: 1 1 1 2 gives normal income to teams 1 to 3, but 4 has a 2.0 resource multiplier.",
		type   = 'string',
		def    = '',
	},
	{
		key    = 'ai_resourcecheat',
		name   = 'AI Cheat Multiplier',
		desc   = "Multiplies AI resources, allowing them to cheat. Also impacts buildspeed. Note: AI will become crazy at high mults!",
		type   = 'number',
		section= 'multipliers',
		def = 1,
		min = 1,
		max = 50,
		step = 0.1,
	},
	{
		key    = 'playable_zombies',
		name   = 'Spectators Become Zombies',
		desc   = "Spectators are allowed to control zombies.",
		type   = 'bool',
		section= 'silly',
		def    = false, --commeco
	},
	{
		key    = 'zombies',
		name   = 'Enable zombies',
		desc   = "All features self-resurrect.",
		type   = 'bool',
		section= 'silly',
		def    = false, --commeco
	},
	{
		key    = 'zombies_delay',
		name   = 'Zombie min spawn time',
		desc   = "In seconds, unit will resurrection no faster than this.",
		type   = 'number',
		section= 'silly',
		def=10,
		min=1,
		max=600,
		step=1,
	},
	{
		key    = 'zombies_rezspeed',
		name   = 'Zombie resurrection speed',
		desc   = "In metal per second.",
		type   = 'number',
		section= 'silly',
		def=12,
		min=1,
		max=10000,
		step=1,
	},
	{
		key    = 'zombies_permaslow',
		name   = 'Zombie permaslow modifier',
		desc   = "If more than 0 zombies are permaslowed to half of that amount, so 1 means 50% slow.",
		type   = 'number',
		section= 'silly',
		def=1,
		min=0,
		max=1,
		step=0.01,
	},
	{
		key    = 'zombies_partial_reclaim',
		name   = 'Zombies partially reclaimable',
		desc   = "Partially reclaimed zombies are partially damaged.",
		type   = 'bool',
		section= 'silly',
		def = false,
	},
	{
		key    = 'goingnuclear',
		name   = 'Nuclear Death Mode',
		desc   = "All units explode like nukes.",
		type   = 'bool',
		section= 'silly',
		def = false,
	},
	{
		key = "max_com_level",
		name = "Commander level limit",
		desc = "Choose the commander level limit. 0 for unlimited.",
		type = "number",
		section= 'startconds',
		def = 0,
		min = 0,
		step = 1,
		max = 20,
	},
	{
		key    = "equalcom",
		name   = "Equalize team commanders",
		desc   = "Give extra commanders to players on teams with fewer players, so that each team has the same number of commanders. Automatically enabled in 'Team' type rooms.",
		type   = "list",
		section= 'startconds',
		def    = "auto",
		items  = {
			{
				key  = "off",
				name = "Disabled",
				desc = "No extra commanders are spawned for smaller teams.",
			},
			{
				key  = "auto",
				name = "Autodetect",
				desc = "Spawn extra commanders for some players on the smaller team in the room type 'Team'.",
			},
			{
				key  = "enable",
				name = "Enabled",
				desc = "Spawn extra commanders for some players on smaller teams to make up the difference in team size.",
			},
		},
	},
	{
		key		= "disabledunits",
		name	= "Disable units",
		desc	= "Prevents specified units from being built ingame. Specify multiple units by using + ",
		section	= 'startconds',
		type	= "string",
		def		= "",
	},
	{
		key		= "disabledcommmodules",
		name	= "Disable Modules",
		desc	= "Prevents commanders from having access to certain weapons or modules. Specify multiple by using + ",
		section	= 'startconds',
		type	= "string",
		def		= "",
	},
	{
		key		= "metaladjustment",
		name	= "Adjust Metal Values",
		desc	= "Adjusts metal values if playercount is above 5.",
		section	= 'startconds',
		type	= "bool",
		def		= true,
	},
	{
		key = 'globallos',
		name = 'Full visibility',
		desc = 'No fog of war, everyone can see the entire map.',
		type = 'bool',
		section = 'startconds',
		def = false,
	},
	{
		key = "overdrivesharingscheme",
		name = "Economy returns investment",
		desc = "In a team game, resource gathering buildings return their cost over time to the players who build them.",
		type = 'bool',
		section= 'a_important',
		def = true,
	},
	{
		key = "enablelagmonitor",
		name = "Inactive Player Unit Sharing",
		desc = "Whether to automatically share units of inactive players to another player within the team.",
		type   = "list",
		section= 'a_important',
		def    = "on",
		items  = {
			{
				key  = "on",
				name = "Enable",
				desc = "Share units of inactive players.",
			},
			{
				key  = "auto",
				name = "PvP Only",
				desc = "Enable if there are at least two teams of non-AIs. Lagging or dropped players will still share units.",
			},
			{
				key  = "off",
				name = "Disable",
				desc = "Do not share units of inactive players. Lagging or dropped players will still share units.",
			},
		},
	},
	{
		key         = "allyreclaim",
		name        = "Reclaimable allies",
		desc        = "Allows reclaiming allied units and structures",
		type        = "bool",
		section     = "experimental",
		def         = false,
	},
	{
		key         = "groundunitygravity",
		name        = "Ground Unit Gravity",
		desc        = "I have no idea what this does, but it sounds funny.",
		type        = "bool",
		section     = "silly",
		def         = false,
	},
	{
		key    = "shuffle",
		name   = "Start Boxes",
		desc   = "Start box settings.",
		type   = "list",
		section= 'startconds',
		def    = "auto",
		items  = {
			{
				key  = "off",
				name = "Fixed",
				desc = "Startboxes have a fixed correspondence to teams.",
			},
			{
				key  = "shuffle",
				name = "Shuffle",
				desc = "Shuffle among boxes that would be used.",
			},
			{
				key  = "allshuffle",
				name = "All Shuffle",
				desc = "Shuffle all present boxes.",
			},
			{
				key  = "auto",
				name = "Autodetect",
				desc = "Shuffle if FFA.",
			},
			{
				key  = "disable",
				name = "Start Anywhere",
				desc = "Allow to place anywhere. Boxes are still drawn for reference but are not obligatory.",
			},
		},
	},
	{
		key='setaispawns',
		name='Set AI Spawns',
		desc='Allow players to set the start positions of AIs.',
		type='bool',
		section= 'startconds',
		def=false,
	},
	{
		key='disable_ai_team_resign',
		name='Disable AI Resignation',
		desc='Prevents AIs from resigning when they run out of constructors and factories.',
		type='bool',
		section= 'a_important',
		def=false,
	},
	{
		key='disable_forcestart',
		name='Disable Autostart',
		desc='Disables the force start while waiting for players.',
		type='bool',
		section= 'a_important',
		def=false,
	},
	{
		key='disable_overwhelming_advantage',
		name='Disable Overwhelming Advantage',
		desc='Disable team reveal when the opposing team has 25x more assets.',
		type='bool',
		section= 'a_important',
		def=false,
	},
	{
		key='disable_local_widgets',
		name='Disable Local Widgets',
		desc='Disable loading of local widget.',
		type='bool',
		section= 'a_important',
		def=false,
	},
	{
		key='campaign_chassis',
		name='Allow campaign commander chassis',
		desc='Allows you to choose the campaign commander chassis.',
		type='bool',
		section= 'startconds',
		def=false,
	},
	{
		key='typemapsetting',
		name='No roads',
		desc='Some maps have roads that allow faster unit movement. When enabled, units will move at their regular unboosted speed on roads.',
		type='bool',
		section= 'mapsettings',
		def=false,
	},
	{
		key    = 'sudden_death_minutes',
		name   = 'Sudden Death Minutes',
		desc   = 'How many minutes until sudden death begins. This mode quickly determines a winner via a contracting death circle. Set -1 to disable.',
		type   = 'number',
		section= 'mapsettings',
		def    = -1,
		min    = -1,
		max    = 2000,
		step   = 1,
	},
	{
		key    = 'sudden_death_sweep_seconds',
		name   = 'Sudden Death Sweep Seconds',
		desc   = 'How many seconds it takes for the sudden death circle to contract to the centre of the map.',
		type   = 'number',
		section= 'mapsettings',
		def    = 60,
		min    = 1,
		max    = 9000,
		step   = 1,
	},
	{ -- Might cause desync, check if they occur.
		key    = 'waterlevel',
		name   = 'Manual Water Level',
		desc   = 'How much to raise water level, in elmos.',
		type   = 'number',
		section= 'mapsettings',
		def    = 0,
		min    = -2000,
		max    = 2000,
		step   = 1,
	},
	{
		key    = 'waterpreset',
		name   = 'Water Level',
		desc   = 'Adjusts the water level of the map',
		type   = "list",
		section= 'mapsettings',
		def    = 'manual',
		items  = {
			{
				key  = "manual",
				name = "Manual",
				desc = "Input height manually",
			},
			{
				key  = "dry",
				name = "Dry",
				desc = "Drain the map of water",
			},
			{
				key  = "flooded",
				name = "Flooded",
				desc = "Cover half the map area with water",
			},
		},
	},
	{
		key    = 'metalmult',
		name   = 'Metal Extraction Multiplier',
		desc   = 'Multiplies metal extraction rate. For use in large team games when there are fewer mexes per player.',
		type   = 'number',
		section= 'multipliers',
		def    = 1,
		min    = 0,
		max    = 100,
		step   = 0.05,  -- quantization is aligned to the def value
					-- (step <= 0) means that there is no quantization
	},
	{
		key    = 'energymult',
		name   = 'Energy Production Multiplier',
		desc   = 'Useful for speed games without relying on map units.',
		type   = 'number',
		section= 'multipliers',
		def    = 1,
		min    = 0,
		max    = 100,
		step   = 0.05,  -- quantization is aligned to the def value
						-- (step <= 0) means that there is no quantization
	},
	{
		key    = 'experimental',
		name   = 'Experimental',
		desc   = 'Experimental.',
		type   = 'section',
	},
	{
		key    = 'shield_merge',
		name   = 'Shield type',
		desc   = 'Shield merge method.',
		type   = 'list',
		section= 'experimental',
		def    = 'none',
		items = {
			{key = 'none', name = "None", desc = 'Shield link only'},
			{key = 'share', name = "Impact sharing", desc = 'On impact, neighbours contribute charge to make up the required charge.'},
			{key = 'penetrate', name = "Partial Penetrate", desc = 'Projectiles drain shields that they penetrate but lose effective damage for subsequent shield impacts.'},
		},
	},
	{
		key    = 'mtpath',
		name   = 'Multithread Pathfinding',
		desc   = 'Use multiple cores for pathfinding calculations.',
		type   = 'bool',
		section= 'experimental',
		def    = true,
	},
	{
		key    = 'terracostmult',
		name   = 'Terraform Cost Multiplier',
		desc   = 'Multiplies the cost of terraform.',
		type   = 'number',
		section= 'multipliers',
		def    = 1,
		min    = 0.01,
		max    = 100,
		step   = 0.01,
	},
	{
		key    = 'terrarestoreonly',
		name   = 'Terraform Restore Only',
		desc   = 'Restore is the only terraform option available.',
		type   = 'bool',
		section= 'experimental',
		def    = false,
	},
	{
		key    = 'explodeondefeat',
		name   = 'Enemies explode on victory',
		desc   = 'Causes units and structures of defeated teams to explode when the game ends.',
		type   = 'bool',
		def    = false,
		section= 'experimental',
	},
	{
		key    = 'enemyterra',
		name   = 'Allow Terraform Near Enemies',
		desc   = 'Without this option terraform progress is 20x slower if an enemy unit is visible nearby.',
		type   = 'bool',
		section= 'experimental',
		def    = false,
	},
	{
		key     = "tweakunits",
		name    = "Tweak Units",
		desc    = "A base64 encoded lua table of unit parameters to change.",
		section = 'experimental',
		type    = "string",
		def     = "",
	},
	{
		key     = "tweakdefs",
		name    = "Tweak Defs",
		desc    = "A base64 encoded snippet of code that modifies game definitions.",
		section = 'experimental',
		type    = "string",
		def     = "",
	},
--[[
	{
		key    = 'damagemult',
		name   = 'Damage Multiplier',
		desc   = 'Multiplies the damage dealt by all weapons, except for D-guns; autoheal; repair; and capture.',
		type   = 'number',
		section= 'experimental',
		def    = 1,
		min    = 0.01,
		max    = 10,
		step   = 0.01,
	},
	{
		key    = 'unitspeedmult',
		name   = 'Unit Speed Multiplier',
		desc   = 'Multiplies the speed, acceleration, and turn rate of all units.',
		type   = 'number',
		section= 'experimental',
		def    = 1,
		min    = 0.01,
		max    = 10,
		step   = 0.01,
	},
]]--
	{
		key    = 'cratermult',
		name   = 'Cratering Multiplier',
		desc   = 'Multiplies the depth of craters.',
		type   = 'number',
		section= 'multipliers',
		def    = 1,
		min    = 0,
		max    = 1000,
		step   = 0.01,
	},
	{
		key    = 'hpmult',
		name   = 'Unit Health Multiplier',
		desc   = 'Multiplies all unit HPs.',
		type   = 'number',
		section= 'multipliers',
		def    = 1,
		min    = 0.000001,
		max    = 10000,
		step   = 0.05,
	},
	{
		key    = 'xmas',
		name   = 'Enable festive units',
		desc   = "Zero K units get into the spirit of the season with a festive new look.",
		type   = 'bool',
		section= 'silly',
		def    = false,
	},
	{
		key     = 'maxunits',
		name    = 'Max units',
		desc    = 'Determines how many units and buildings a player is allowed to own at a time',
		type    = 'number',
		section = 'multipliers',
		def     = 10000, -- don't change to anything reachable, won't take effect; engine default is ~10K
		                 -- (actually 32K / #teams so 1v1+gaia allows ~10K each)
		min     = 10,
		max     = 10000,
		step    = 10,
	},
	{
		key     = 'minspeed',
		name    = 'Minimum game speed',
		desc    = 'Sets the minimum speed that the players will be allowed to change to',
		type    = 'number',
		section = 'multipliers',
		def     = 0.3, -- don't change, won't take effect as this is engine value
		min     = 0.1,
		max     = 8.0,
		step    = 0.1,
	},
	{
		key    = 'allowfpsmode',
		name   = 'Enable first person control',
		desc   = "Allow players to take direct control of units without cheats enabled. Select a unit and press Alt+P to toggle.",
		type   = 'bool',
		section= 'silly',
		def    = false,
	},
	{
		key     = 'maxspeed',
		name    = 'Maximum game speed',
		desc    = 'Sets the maximum speed that the players will be allowed to change to',
		type    = 'number',
		section = 'multipliers',
		def     = 20.0, -- don't change, won't take effect as this is engine value
		min     = 0.5,
		max     = 20.0,
		step    = 0.1,
	},
	{
		key     = 'disablemapdamage',
		name    = 'Disable map deformation',
		desc    = 'Prevents the map shape from being changed by weapons and terraforming',
		type    = 'bool',
		section = 'mapsettings',
		def     = false, -- don't change, won't take effect as this is engine value
	},
	--[[ Engine option, would need proper UI before enabling
	{
		key     = 'fixedallies',
		name    = 'Disallow ceasefire',
		desc    = 'Is ceasefire banned? For FFA.',
		type    = 'bool',
		section = 'experimental',
		def     = true, -- don't change, won't take effect as this is engine value
	},
	]]

  --{
  --  key		= "enableunlocks",
  --  name	= "Enable unlock system",
  --  desc	= "Enables the unlock system (disabling will enable all units by default)",
  --  type	= "bool",
  --  def		= true,
  --  section	= "experimental",
  --},
--  { -- Causes desync https://springrts.com/mantis/view.php?id=5936
--    key		= "pathfinder",
--    name	= "Pathfinder type",
--    desc	= "Sets the pathfinding system used by units.",
--    type	= "list",
--    def		= "standard",
--    section	= "experimental",
--    items  = {
--      {
--	key  = 'standard',
--	name = 'Standard',
--	desc = 'Standard pathfinder',
--      },
--      {
--	key  = 'qtpfs',
--	name = 'QTPFS',
--	desc = 'New Quadtree Pathfinding System (experimental)',
--      },
--    --  {
--	--	key  = 'classic',
--	--	name = 'Classic',
--	--	desc = 'An older pathfinding system without turninplace or reverse',
--    --  }
--    },
--  },
  
	{
		key    = 'chicken',
		name   = 'Chicken',
		desc   = 'Settings for Chicken: Custom',
		type   = 'section',
	},
	{
		key	= "eggs",
		name = "Chicken Eggs",
		desc = "Enables eggs mode (applies to all chicken difficulties); metal extractors are disabled but chickens drop twice as many eggs",
		type = "bool",
		def	= false,
		section = 'chicken',
	},
	{
		key	= "speedchicken",
		name = "Speed Chicken",
		desc = "Game lasts half as long; no miniqueens. (applies to all chicken difficulties)",
		type = "bool",
		def	= false,
		section = 'chicken',
	},
	{
		key     = 'chicken_endless',
		name    = 'Infinite Chicken',
		desc    = 'Queen does not spawn, waves go on forever. (applies to all chicken difficulties)',
		type    = "bool",
		def     = false,
		section = 'chicken',
	},
	{
		key    = 'chickengaiaai',
		name   = 'Gaia Chickens',
		desc   = "Automatically adds a chicken AI to the game on the Gaia team to bypass limitations with lobby room types. Experimental",
		type   = 'list',
		section= 'chicken',
		def    = 'none',
		items = {
			{ key = 'none', name = "none", desc = 'No chickens at all.' },
			{ key = 'Casual', name = "Chicken: Casual", desc = 'A difficulty for those who are just picking up RTS games.' },
			{ key = 'Normal', name = "Chicken: Normal", desc = 'A difficulty for players who are new to Future Wars.' },
			{ key = 'Hard', name = "Chicken: Hard", desc = 'A Chill and easy experiance that still offers challange.' },
			{ key = 'Brutal', name = "Chicken: Brutal", desc = 'A mix between challange and feasibility.' },
			{ key = 'Suicidal', name = "Chicken: Suicidal", desc = 'A challanging experiance meant for experianced Future Wars players.' },
			{ key = 'Nightmare', name = "Chicken: Nightmare", desc = 'An Onslaught meant for grizzled veterans of Future Wars.' },
			{ key = 'Annihilation', name = "Chicken: Annihilation", desc = 'This clucking hell will push the very best players to their limits. Good Luck.' },
			{ key = 'Custom', name = "Chicken: Custom", desc = 'Customize your chicken.' },
		},
	},
	{
		key    = 'chickenqueentime',
		name   = 'Queen Time',
		desc   = 'How soon the queen appears on her own, in minutes. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 30,
		min    = 1,
		max    = 300,
		step   = 1,
	},
	{
		key    = 'chickenwaveduration',
		name   = 'Chicken Wave Duration',
		desc   = 'Sets the Duration of chicken waves, in seconds. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 105,
		min    = 60,
		max    = 500,
		step   = 1,
	},
	{
		key    = 'chickengraceduration',
		name   = 'Chicken Grace Duration',
		desc   = 'Sets the Duration of grace period between waves, in seconds. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 120,
		min    = 5,
		max    = 500,
		step   = 1,
	},
	{
		key    = 'chickenramptime',
		name   = 'Ramp up Time',
		desc   = 'Time before chickens reach full strength, in seconds. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 350,
		min    = 0,
		max    = 1000,
		step   = 1,
	},
	{
		key    = 'chickenwavesizemult',
		name   = 'Wave size multiplier',
		desc   = 'The size of each chicken wave is multiplied by this number. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 1,
		min    = 0.1,
		max    = 40,
		step   = 0.1,
	},
	{
		key    = 'chickenstrengthpersec',
		name   = 'Hive Strength Per Second',
		desc   = 'The rate at which hive strength increases, in percent per second (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 0.15,
		min    = 0,
		max    = 1,
		step   = 0.01,
	},
	{
		key    = 'chickenmenacestart',
		name   = 'Menace Start Wave',
		desc   = 'The first wave on which chicken menaces will spawn. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 3,
		min    = 1,
		max    = 10,
		step   = 1,
	},
	{
		key    = 'chickenmenacemax',
		name   = 'Maximium Menace Amount',
		desc   = 'The maximium amount of menaces that will spawn per wave. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 1,
		min    = 1,
		max    = 10,
		step   = 1,
	},
	{
		key    = 'chickenmenaceevomod',
		name   = 'Menace Strength Modifier',
		desc   = 'Modifies the strength of chicken menaces and the queen. Use values above 1 at your own peril. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 0,
		min    = -3,
		max    = 10,
		step   = 1,
	},
	{
		key    = 'chickendefensemult',
		name   = 'Defense Count Multiplier',
		desc   = 'Multiplies the amount of chicken defenses which will spawn. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 0.7,
		min    = 0.1,
		max    = 3,
		step   = 0.1,
	},
	{
		key    = 'chickendefenseevomult',
		name   = 'Defense Strength Multiplier',
		desc   = 'Multiplies the strength of chicken defenses which will spawn. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 0.85,
		min    = 0.1,
		max    = 3,
		step   = 0.1,
	},
	{
		key    = 'chickentechcostmult',
		name   = 'Chicken Technology Multiplier',
		desc   = 'Multiplies the rate at which chickens will unlock new chicken types. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 1,
		min    = 0.1,
		max    = 100,
		step   = 0.1,
	},
	{
		key    = 'chickenbasehyperevo',
		name   = 'Chicken Base Hyperevolution',
		desc   = 'A base amount of hyperevolution which the chickens always will have. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 0,
		min    = 0,
		max    = 100,
		step   = 0.1,
	},
	{
		key    = 'chickenstarttechs',
		name   = 'Chicken Base Technologies',
		desc   = 'How many technologies the chickens will start with. (WARNING: requires Chicken: Custom difficaulty)',
		type   = 'number',
		section= 'chicken',
		def    = 0,
		min    = 0,
		max    = 10,
		step   = 1,
	},
--[[
  {
	key    = 'burrowtechtime',
	name   = 'Burrow Tech Time',
	desc   = 'How much time each burrow shaves off chicken appearance times per wave (divided by playercount), seconds',
	type   = 'number',
	section= 'chicken',
	def    = 12,
	min    = 0,
	max    = 60,
	step   = 1,
  },
]]--
--[[ broken, prevent newbie footgun (cf. #3567 gameside ticket)
  {
    key = "playerchickens",
    name = "Players as chickens",
    desc = "Shared chickens with players, take commanders away",
    type = "bool",
    def = false,
    section = 'chicken',
  },
]]
}

for i = 1, 9 do
	options[#options + 1] =  {
		key     = "tweakunits" .. i,
		name    = "Tweak Units " .. i,
		desc    = "A base64 encoded lua table of unit parameters to change.",
		section = 'experimental',
		type    = "string",
		def     = "",
		noLobby = true,
	}
end

for i = 1, 9 do
	options[#options + 1] =  {
		key     = "tweakdefs" .. i,
		name    = "Tweak Defs " .. i,
		desc    = "A base64 encoded snippet of code that modifies game definitions.",
		section = 'experimental',
		type    = "string",
		def     = "",
		noLobby = true,
	}
end

--// add key-name to the description (so you can easier manage modoptions in springie)
for i=1,#options do
  local opt = options[i]
  opt.desc = opt.desc .. '\nkey: ' .. opt.key
end

return options