Statstrings - Revision history

Dmk: Adding a Note to the OpenXcom implementation syntax

2023-02-21T00:57:54Z

Adding a Note to the OpenXcom implementation syntax

@@ Line 2: / Line 2: @@
 =Syntax=
 The entry '''w s:-25''' would add the a "w" to the name of any soldier whose strength is 25 or less. As you can guess, "w" means "weak".
@@ Line 321: / Line 323: @@
 Anyone who hasn't hit the cap yet will have a "/TRAINME" string. Or possibly "/xkcwTRAINME" if you put it at the end of the Statstrings section.
 =See Also=
 *[[XcomUtil]]
+*[[OpenXcom]]
 [[Category:Enemy Unknown/UFO Defense]]

JConstantine: A statstrings entry...

2015-07-21T15:23:42Z

A statstrings entry...

← Older revision		Revision as of 15:23, 21 July 2015
Line 5:		Line 5:
	The entry '''w s:-25''' would add the a "w" to the name of any soldier whose strength is 25 or less. As you can guess, "w" means "weak".		The entry '''w s:-25''' would add the a "w" to the name of any soldier whose strength is 25 or less. As you can guess, "w" means "weak".

	An statstrings entry consists of two parts:		A statstrings entry consists of two parts:
	<ol><li>The statstring that will be added to a soldiers' name. It can be anything you like, but should better be short.</li>		<ol><li>The statstring that will be added to a soldiers' name. It can be anything you like, but should better be short.</li>
	<li>The condition to trigger that string which itself is made up of two parts: a one-letter handle for the stat, and the experience range.</li></ol>		<li>The condition to trigger that string which itself is made up of two parts: a one-letter handle for the stat, and the experience range.</li></ol>

Hobbes: categorizing

2013-07-23T03:09:24Z

categorizing

← Older revision		Revision as of 03:09, 23 July 2013
Line 324:		Line 324:
	=See Also=		=See Also=
	*[[XcomUtil]]		*[[XcomUtil]]

			[[Category:Enemy Unknown/UFO Defense]]

Off the Rails: Added another example

2012-10-06T17:56:14Z

Added another example

@@ Line 306: / Line 306: @@
 This results in Soldier names like "Anton Karas /321" (before Psionic Training) or "Grace Kelly /4131" (after Psi abilities have been unveiled). The scheme is:
 strength(2 first values is the full strength of the soldier) - reactions - Psi strength (resistance)
 =See Also=
 *[[XcomUtil]]

Sg2002 at 22:22, 20 November 2009

2009-11-20T22:22:18Z

Show changes

Zombie: /* Syntax */ Made into an ordered list.

2009-01-07T01:57:32Z

Syntax: Made into an ordered list.

← Older revision		Revision as of 01:57, 7 January 2009
Line 6:		Line 6:

	An statstrings entry consists of two parts:		An statstrings entry consists of two parts:
	* first, the statstring that will be added to a soldiers' name. It can be anything you like, but should better be short.		<ol><li>The statstring that will be added to a soldiers' name. It can be anything you like, but should better be short.</li>
	* second, the condition to trigger that string which itself is made up of two parts: a one-letter handle for the stat, and the experience range.		<li>The condition to trigger that string which itself is made up of two parts: a one-letter handle for the stat, and the experience range.</li></ol>
	Note that these are ranges: lower boundary, dash, upper boundary. Either one can be omitted if the range should be open-end. So 30-50 means "from thirty to fifty", -25 means "anything below 26" (and is equal to 0-25) and 60- means "sixty or higher" (equal to 60-255). 42, unsurprisingly, would mean "a value of exactly 42".		Note that these are ranges: lower boundary, dash, upper boundary. Either one can be omitted if the range should be open-end. So 30-50 means "from thirty to fifty", -25 means "anything below 26" (and is equal to 0-25) and 60- means "sixty or higher" (equal to 60-255). 42, unsurprisingly, would mean "a value of exactly 42".

Schnobs at 18:39, 6 January 2009

2009-01-06T18:39:54Z

← Older revision		Revision as of 18:39, 6 January 2009
Line 1:		Line 1:
			Statstrings allow to automatically rename your soldiers in such a way that some of their stats (such as firing accuracy, reactions, strength...) are reflected in their name. For example, "Anton Miller /wmr" would be a ''w''eak good ''m''arksman of decent ''r''eactions. However, like almost everything in XcomUtil, this is fully configurable. Custom sets of statstring definitions can be found here.

			=Syntax=

			The entry '''w s:-25''' would add the a "w" to the name of any soldier whose strength is 25 or less. As you can guess, "w" means "weak".

			An statstrings entry consists of two parts:
			* first, the statstring that will be added to a soldiers' name. It can be anything you like, but should better be short.
			* second, the condition to trigger that string which itself is made up of two parts: a one-letter handle for the stat, and the experience range.
			Note that these are ranges: lower boundary, dash, upper boundary. Either one can be omitted if the range should be open-end. So 30-50 means "from thirty to fifty", -25 means "anything below 26" (and is equal to 0-25) and 60- means "sixty or higher" (equal to 60-255). 42, unsurprisingly, would mean "a value of exactly 42".

			Single character strings accumulate. But any string with more than one character will end the search right there and no further strings will be added to the name. The strings are parsed in the order they are written in the XcomUtil.cfg file.

			=Working Examples=
	==The default configuration:==		==The default configuration:==

Line 27:		Line 41:

	The main problem with the default scheme is that sooner or later, most of your soldiers will become a "Snpr". The same string for everyone is like having no string at all.		The main problem with the default scheme is that sooner or later, most of your soldiers will become a "Snpr". The same string for everyone is like having no string at all.


	==Simple Numeric StatStrings==		==Simple Numeric StatStrings==

	Instead of Mnemnonics, many people prefer to have actual figures displayed. Like: firing accuracy from 45-54 becomes a "4", from 55-64 is a "5" and so on. The following statstrings will do just that, first digit is Firing Accuracy, second reactions, so "Anton Miller /45" would a Soldier whose firing accuracy is about 40, and reactions about 50. Just copy and paste this into the statstrings section of you XcomUtil.cfg file:		Instead of Mnemnonics, many people prefer to have actual figures displayed. Like: firing accuracy from 45-54 becomes a "5", from 55-64 is a "6" and so on. The following statstrings will do just that, first digit is Firing Accuracy, second reactions, so "Anton Miller /45" would a Soldier whose firing accuracy is about 40, and reactions about 50. Just copy and paste this into the statstrings section of you XcomUtil.cfg file:

	1 f:0-14		1 f:0-14
Line 99:		Line 114:
	e r:101-		e r:101-

	W s:0-19 //weak. can only carry Rifle + clips OR Laser Rifle + ~~grenades~~		W s:0-19 //weak. can only carry Rifle + clips OR Laser Rifle + grenade
	w s:20-25 //additional Medikit or Stun Rod or grenades possible		w s:20-25 //additional Medikit or Stun Rod or grenades possible
	n s:26-30 //normal. no problems with standard gear		n s:26-30 //normal. no problems with standard gear

Zombie: Added See Also and link.

2009-01-02T05:19:36Z

Added See Also and link.

← Older revision		Revision as of 05:19, 2 January 2009
Line 131:		Line 131:
	* I wanted to use W-w-n-s-S for weak-normal-strong, but it's impossible to distiguish an S from a 5 which really looks weird. So I settled on H for "heavy gear" instead.		* I wanted to use W-w-n-s-S for weak-normal-strong, but it's impossible to distiguish an S from a 5 which really looks weird. So I settled on H for "heavy gear" instead.
	* values for Firing accuracy and reactions are pseudo-hexadecimal, 1-9 then a-e; it may be that the sudden appearance of letters where you're used to numbers may look strange. I don't know, because my soldiers never become that good.		* values for Firing accuracy and reactions are pseudo-hexadecimal, 1-9 then a-e; it may be that the sudden appearance of letters where you're used to numbers may look strange. I don't know, because my soldiers never become that good.

			==See Also==
			*[[XcomUtil]]

Schnobs at 10:26, 1 November 2007

2007-11-01T10:26:48Z

← Older revision		Revision as of 10:26, 1 November 2007
Line 30:		Line 30:
	==Simple Numeric StatStrings==		==Simple Numeric StatStrings==

	Instead of Mnemnonics, many people prefer to have actual figures displayed. The following ~~strings~~ do just that: "Anton Miller /45" is a Soldier whose firing accuracy is about 40, and reactions about 50.		Instead of Mnemnonics, many people prefer to have actual figures displayed. Like: firing accuracy from 45-54 becomes a "4", from 55-64 is a "5" and so on. The following statstrings will do just that, first digit is Firing Accuracy, second reactions, so "Anton Miller /45" would a Soldier whose firing accuracy is about 40, and reactions about 50. Just copy and paste this into the statstrings section of you XcomUtil.cfg file:

	1 f:0-14		1 f:0-14
Line 55:		Line 55:
	==Detailed numeric strings==		==Detailed numeric strings==

	I've been using the above scheme for a while, but noticed that I ~~use only a small part~~ of the ~~range~~. ~~I'm habitually sacking soldiers with a firing accuracy below 50, for~~ example, so the numbers ~~1-4 aren't really needed -- they~~ indicate ~~that a soldier won't meet my requirements~~, that's all. ~~More generally, the purpose of statstrings is to make soldiers easily comparable when hiring~~ and ~~sacking or when you~~ have to ~~decide who's~~ the ~~first~~ to ~~go through an conspicious door~~.		I've been using the above scheme for a while, but noticed that I don't really care what the actual firing accuracy of any given soldier is – all I want to know is who's better or worse than the next man. In the following example, it's no longer easy to map the strings back to actual stats; higher numbers indicate better soldiers, that's all.

			I habitually only hire sodliers with 50+ in both reactions and firing accuracy: anyone who doesn't meet these requirements will have a dash added to the name.

			Again, you can copy this into your config file if you want to give it a try.



	NameStats		NameStats
Line 77:		Line 83:

	- r:0-45		- r:0-45
	0 r:46-49 ~~//sometimes I'm short on cash and have to hire zeroes...~~		0 r:46-49
	1 r:50-53		1 r:50-53
	2 r:54-57		2 r:54-57
Line 94:		Line 100:

	W s:0-19 //weak. can only carry Rifle + clips OR Laser Rifle + grenades		W s:0-19 //weak. can only carry Rifle + clips OR Laser Rifle + grenades
	w s:20-25 //additional Medikit or Stun Rod is possible		w s:20-25 //additional Medikit or Stun Rod or grenades possible
	n s:26-30 //normal. no problems with standard gear		n s:26-30 //normal. no problems with standard gear
	h s:31-40 //heavy or auto-cannon plus spare clip		h s:31-40 //heavy cannon or auto-cannon, each plus spare clip
	H s:41- //can handle 4 Large Rockets + Launcher		H s:41- //can handle 4 Large Rockets + Launcher

Line 110:		Line 116:

	0 k:1-15		0 k:1-15
	2 k:16-25		2 k:16-24
	3 k:25-35		3 k:25-34
	4 k:36-44		4 k:35-44
	5 k:45-54		5 k:45-54
	6 k:55-64		6 k:55-64
Line 119:		Line 125:
	9 k:85-		9 k:85-

	This results in Soldier names like "Anton Karas /13n" or "Grace Kelly /41H81". The scheme is:<br>		This results in Soldier names like "Anton Karas /13n" (before Psionic Training) or "Grace Kelly /41H81" (after Psi abilities have been unveiled). The scheme is:<br>
	firing accuracy - reactions - strength - Psi strength (resistance) - Psi skill		firing accuracy - reactions - strength - Psi strength (resistance) - Psi skill

	Notes:		Notes:
	* I wanted to use W-w-n-s-S for weak-normal-strong, but it's impossible to distiguish an S from a 5 which really looks weird. So I settled on H for "heavy gear" instead.		* I wanted to use W-w-n-s-S for weak-normal-strong, but it's impossible to distiguish an S from a 5 which really looks weird. So I settled on H for "heavy gear" instead.
	* values for Firing accuracy and reactions are hexadecimal, 1-9 then a-e; it may be that the sudden appearance of letters where you're used to numbers may look strange. I don't know, because my soldiers never become that good.		* values for Firing accuracy and reactions are pseudo-hexadecimal, 1-9 then a-e; it may be that the sudden appearance of letters where you're used to numbers may look strange. I don't know, because my soldiers never become that good.
	* Psi strength / skill will only be displayed after a soldier went through his first tenure of Psi training. So, a blank means the soldier hasn't been screened yet.

Schnobs: /* The default configuration: */

2007-11-01T10:09:04Z

The default configuration:

← Older revision		Revision as of 10:09, 1 November 2007
Line 1:		Line 1:
	==The default configuration:==		==The default configuration:==

	Open XcomUtil.cfg with any text editor. The section on Statstrings is at around line 1200 (and can be easisly found if you search for "statstrings").		Open XcomUtil.cfg with any text editor. The section on Statstrings is at around line 1200 (and can be easisly found if you search for "statstrings"). This is the default configuration as it comes out of the box. The comments have been added to make it more readable, but the actual data has not been changed. In case you messed things up and forgot to make a backup, you can copy-and-pase the following code:

	NameStats		NameStats
Line 7:		Line 7:

	x p:-30 //Psi strength (resistance) 30 or less		x p:-30 //Psi strength (resistance) 30 or less
	P p:80- //immune to Psi attacks		P p:80- //virtually immune to Psi attacks
	p p:60-79 //reasonably safe from Psi		p p:60-79 //reasonably safe from Psi
	K k:60- //high Psi Skill		K k:60- //high Psi Skill
Line 15:		Line 15:
	w s:-25 //weak		w s:-25 //weak

	Snpr f:60+ r:60+		Snpr f:60- r:60-

	M f:70- //Marksman		M f:70- //Marksman
Line 25:		Line 25:
	r r:50-59		r r:50-59

	~~This is the default configuration as it comes out of the box. The comments have been added to make it more readable, but the actual data has not been changed.~~

	The main problem with the default scheme is that sooner or later, most of your soldiers will become a "Snpr". The same string for everyone is like having no string at all.		The main problem with the default scheme is that sooner or later, most of your soldiers will become a "Snpr". The same string for everyone is like having no string at all.