[changed] Rewote notes for npc generation file to make it a bit clearer as to what is happening

locations/npcgeneratec.qsrc

@@ -1,19 +1,30 @@
 # npcgeneratec
 
-! {This file expects npctempgsex which is the desired sex of the NPC to be generated, $npctempgn[0], which is the used name of the generated NPC. Rapist or Red Headed Stranger, for example. And npctempgage, which is the approximate age of the NPC in years. Everything is then randomly generated, and you are expected to fix the generated NPC yourself with any special items you need from it after it completes running. So sex, what you call them until they introduce themselves, and age.}
+!! This file requires the sex, name and age for the npc to be generated
+!! You can also set their approx. home location
+!! All data produced is random so if you need a specific value you will have to overwrite it
 
-! The fourth parameters indicates what area the npc''s home is in
+!! sets sex, 1 male, 2 female, 3 female herm, 4 male herm
+npctempgsex = ARGS[0]
+
+!! Name for npc, can just be rapist or shop assistant, etc
+$npctempgn[0] = $ARGS[1]
+
+!! npc age
+npctempgage = ARGS[2]
+
+!! npc home location area
 !! 1 - Pavlovsk Residential Area
 !! 2 - Student dorms in the city
 !! 3 - St. Petersburg Residential Area
 !! 4 - St. Petersburg City Center
-!! {A example to use this would be gs 'npcgeneratec', 0, 'stranger', rand(18,45) which would generate a male with a used name of stranger between 18 and 45.}
-
-npctempgsex = ARGS[0]
-$npctempgn[0] = $ARGS[1]
-npctempgage = ARGS[2]
 temp_location = ARGS[3]
 
+!! For example
+!! gs 'npcgeneratec', 0, 'stranger', rand(18,45)
+!! Which would generate a male named stranger between ages of 18 and 45
+
+
 if temp_location = 0:
 	if $region = 'city_center' or $region = 'city' or $region = 'city' or $region = 'city_island' or $region = 'city_lake' or $region = 'city_park':
 		temp_location = rand(3,4)
@@ -22,8 +33,8 @@ if temp_location = 0:
 	end
 end
 
-!! {First we set the newly generated index number or overwrite the first blank number}
-!! {Checks to see if array 0 in the cleanup list is available for overwrite and makes the overwrite as that if so.}
+!! This sets up a newly generated index number by overwriting the first blank number
+!! The first check is to see if array 0 in the cleanup list is available and overwrites it if it is free
 if mid($cemptyarray[0],1,1) = 'C':
 	$npclastgenerated = $cemptyarray[0]
 	killvar '$cemptyarray', 0
@@ -47,7 +58,7 @@ carraynumber += 1
 
 $npc_index[$npclastgenerated] = $npclastgenerated
 
-! {Now we need a random birthday based on the rough age given.}
+!! Random birthday based on age given
 npctempc1[1] = year - npctempgage
 npctempc1[2] = rand(1,12)
 if npctempc1[2] = 4 or npctempc1[2] = 6 or npctempc1[2] = 9 or npctempc1[2] = 11:
@@ -64,7 +75,7 @@ npc_dob[$npclastgenerated] += (npctempc1[2] * 100)
 npc_dob[$npclastgenerated] += npctempc1[3]
 ! {we save the unique number of the npc, to be able to get the index of the array via arrpos}
 
-! {Now, we set the variable for the stat randomization as well as calculate chance of virginity.}
+!! Sets a seed value for the stat randomization as well as calculate chance of virginity
 if npctempgage < 18:
 	npctempc2[0] = 30
 	npctempc2[1] = rand(0,20)
@@ -72,13 +83,14 @@ else
 	npctempc2[0] = 50
 	npctempc2[1] = rand(19,24)
 end
-! {We flag virginity based on the results of the check. Overwrite it after generation if you want to be sure of status.}
+
+!! Flag for virginity
 if npctempc2[1] < 20:
 	npc_sexskill[$npclastgenerated] = 0
 end
 
 
-! {Then we need to give them a name, and establish their official gender}
+!! Fill details about their sex such as cock and breast size
 if npctempgsex = 0:
 	! {Male}
 	gs 'npcrnamefile', 'rusMale'
@@ -122,7 +134,7 @@ else
 	npc_bust[$npclastgenerated]= rand(0,10)
 end
 
-! {Then we set the names, and the stat high ends as determined earlier.}
+!! Set the names, and the stat high ends as determined by seed set earlier
 gs 'npcrnamefile', 'rusSur'
 $npc_firstname[$npclastgenerated] = $npctempgn[1]
 $npc_nickname[$npclastgenerated] = $npctempgn[2]
@@ -130,43 +142,48 @@ $npc_lastname[$npclastgenerated] = $npctempgn[3]
 $npc_usedname[$npclastgenerated] = $npctempgn[0]
 npc_intel[$npclastgenerated] = rand(1,npctempc2)
 
-! {Then we call out other stats}
+!! set them to sober
 npc_drunk[$npclastgenerated] = 0
 
-! {NPCs start with random horniness}
+!! Horniness
 npc_horny[$npclastgenerated] = rand(0,60)
 
-! {Random attractiveness}
+!! Attractiveness
 npc_apprnc[$npclastgenerated] = rand(30,60)
 
-! {Random skin quality and body hair}
-npc_height[$npclastgenerated] = 0
+!! Height
+if npc_gender[$npclastgenerated] = 0:
+	npc_height[$npclastgenerated] = rand(160,190)
+else
+	npc_height[$npclastgenerated] = rand(150,180)
+end
 
-! {Random pubic hair}
-npc_haircol[$npclastgenerated] = 0
+!! Hair colour
+npc_haircol[$npclastgenerated] = rand(0, 3)
 
-! {Starting at 0 quest state and love for the character, and slightly disliked.}
+!! Quest stage, relationship and love initialised
 npc_QW[$npclastgenerated]= 0
 npc_rel[$npclastgenerated] = 40
 npc_love[$npclastgenerated] = 0
 
-! {Start unemployed and unspecified location}
+!! initialise occupation and outfit
 npc_occupation[$npclastgenerated] = 0
 npc_outfit[$npclastgenerated] = 0
 
 ! {Unspecified dad and <<$npc_nickname[''A29'']>>, and picture. We could have a stock group of pictures and have it pick based on certain attribute types, but...}
 $npc_pic[$npclastgenerated] = 'xPICx'
 
-! {STDs are not randomly given here. For characters with a STD, you need to gs npcgenext rstd }
+!! STDs set to 0. For characters with a STD, you need to gs npcgenext rstd
 npc_herpes[$npclastgenerated] = 0
 npc_syth[$npclastgenerated] = 0
 npc_gon[$npclastgenerated] = 0
 npc_thrush[$npclastgenerated] = 0
 
+!! times you have had sex with and pervert level of npc
 npc_sex[$npclastgenerated] = 0
 npc_perv[$npclastgenerated] = 0
 
-! {Personality is called up}
+!! Personality generated
 gs 'npcgenext', 'pers'
 $npc_perstype[$npclastgenerated] = $npctempgn[6]
 
@@ -175,21 +192,22 @@ $npc_dna[$npclastgenerated] = func('DNA','create')
 
 
 
+!!	Set home details
 
-! npc_apt_type[$npclastgenerated] = 1: student dorm (only available in the city for obvious reasons)
-! npc_apt_type[$npclastgenerated] = 2: studio apartment
-! npc_apt_type[$npclastgenerated] = 3: one bedroom apartment (or 2 bedroom by UK/european definition, an apartment that has a separate bedroom unlike a studio)
-! npc_apt_type[$npclastgenerated] = 4: multi-bedroom apartment with roommates
-! npc_apt_type[$npclastgenerated] = 5: multi-bedroom apartment living alone
-! npc_apt_type[$npclastgenerated] = 6: high rise apartment (for rich people only)
-! boyfriend attributes
+!!	npc_apt_type = 1: student dorm (only available in the city for obvious reasons)
+!!	npc_apt_type = 2: studio apartment
+!!	npc_apt_type = 3: one bedroom apartment
+!!	npc_apt_type = 4: multi-bedroom apartment with roommates
+!!	npc_apt_type = 5: multi-bedroom apartment living alone
+!!	npc_apt_type = 6: high rise apartment (for rich people only)
 
-!! temp_location
-!! 1 - Pavlovsk Residential Area
-!! 2 - Student dorms in the city
-!! 3 - St. Petersburg Residential Area
-!! 4 - St. Petersburg City Center
+!!	temp_location
+!!	1 - Pavlovsk Residential Area
+!!	2 - Student dorms in the city
+!!	3 - St. Petersburg Residential Area
+!!	4 - St. Petersburg City Center
 
+!!	occupation set, list below
 
 	npc_residence[$npclastgenerated] = temp_location
 
@@ -228,13 +246,13 @@ $npc_dna[$npclastgenerated] = func('DNA','create')
 	end
 	
 	
-!	npc_style[$npclastgenerated] determines generally how they dress and what their "persona" is
-!	1 - "normal"
-!	2 - Gopnik
-!	3 - nerdy
-!	4 - sporty
-!	5 - fashionable
-!	6 - businessman
+!!	npc_style[$npclastgenerated] determines generally how they dress and what their "persona" is
+!!	1 - "normal"
+!!	2 - Gopnik
+!!	3 - nerdy
+!!	4 - sporty
+!!	5 - fashionable
+!!	6 - businessman
 	if npc_occupation[$npclastgenerated] < 15:
 		npc_style[$npclastgenerated] = rand(1,5)
 	else
@@ -352,9 +370,10 @@ $npc_dna[$npclastgenerated] = func('DNA','create')
 		$npc_occupation[$npclastgenerated] = 'investment banker'
 	end
 
+!!	type of homour
 	npc_humor[$npclastgenerated] = rand(0,3)
 	
-
+!! Preferred sexual position
 	npc_fav_pos[$npclastgenerated] = rand(1,7)
 	
 	if npc_fav_pos[$npclastgenerated] = 1:
@@ -373,7 +392,8 @@ $npc_dna[$npclastgenerated] = func('DNA','create')
 		$npc_fav_pos[$npclastgenerated] = 'anal'
 	end
 
-!! npc_cum_pref = 0: no preference
+!! Preferred cumming location
+!!	0 = no preference
 	npc_cum_pref[$npclastgenerated] = rand(0,5)
 	
 	if npc_cum_pref[$npclastgenerated] = 1:
@@ -388,41 +408,42 @@ $npc_dna[$npclastgenerated] = func('DNA','create')
 		$npc_cum_pref[$npclastgenerated] = 'pullout'
 	end
 	
+!!	Preferences for breast size and pubic hair
 	npc_tit_pref[$npclastgenerated] = rand(0,3)
-	
 	npc_bush_pref[$npclastgenerated] = rand(0,3)
 
+!! style
 	npc_style[$npclastgenerated] = rand(1,6)
 
+!!	smoking, none, casual, heavy
 	npc_smoker[$npclastgenerated] = rand(0,2)
 
-! we will skip addit for now, have a variable just for smoking
-
-!!	npc_addit[$npclastgenerated] = rand(0,1)
-
+!!	UNKNOWN
 	npc_doors[$npclastgenerated] = rand(0,2)
 	
-	npc_goal[$npclastgenerated] = rand(1,3)
 !!	npc_goal is what they want out of a relationship
 !!	1 = just sex 
 !!	2 = casual relationship 
 !!	3 = serious relationship
+	npc_goal[$npclastgenerated] = rand(1,3)
 
-	npc_fidelity[$npclastgenerated] = rand(1,10)
 !!	npc_fidelity is how they will behave in a relationship
 !!	1-3 = will cheat on you 
 !!	4-6 = will cheat on others with you
+!!		4 = cheats on them with you for the first time
+!!		5 = has been cheating and feels guilty
+!!		6 = is a serial cheater with no guilt
 !!	7 = is fine with open relationship
 !!	8-10 = will be faithful
+	npc_fidelity[$npclastgenerated] = rand(1,10)
 
-!!	4 = cheats on them with you for the first time
-!!	5 = has been cheating and feels guilty
-!!	6 = is a serial cheater with no guilt
 
 	if npc_fidelity[$npclastgenerated] >= 4 and npc_fidelity[$npclastgenerated] <= 6: npc_girlfriend[$npclastgenerated] = rand(0,1)
 
+!! initialise lover length in days
 	npc_lover_days[$npclastgenerated] = 0
 
+!! keys to their apartment
 	npc_lover_keys[$npclastgenerated] = 0
 
 	npc_residence[$npclastgenerated] = temp_location
@@ -466,7 +487,7 @@ $npc_dna[$npclastgenerated] = func('DNA','create')
 	npc_pussyeater[$npclastgenerated] = rand(-2,1)
 	npc_cum_cannon[$npclastgenerated] = rand(-3,1)
 
-! {Variables are cleaned up.}
+!! Variable clean up
 killvar '$npctempgn'
 killvar 'npctempc1'
 killvar 'npctempc2'