Notes.txt

Publish on Steam:
	C:\Steam\steamapps\common\Distant Worlds 2> ./distantworlds2 --ugc-publish mods/XL

	xq -x ".ArrayOfShipHull.ShipHull[] | {ShipHullId, Role}" '.\xl\ShipHulls_Ackdarian.xml'

Link (must be administrator)
	New-Item -Path "C:\Users\steve\Downloads\DW2 Unstable\mods" -ItemType SymbolicLink -Value "C:\Steam\steamapps\common\Distant Worlds 2\mods"

distantworlds2 options:
	 --gen-xsd		generates the xsd's in data/schema
	 --help 		for a display of all options

After generating the xsd:
	replace minOccurs="1" with minOccurs="0" or you'll have a ton of meaningless errors according to the schema

LET'S fix:

GIVE Boskara TORPEDOES more raw damage but increase their loss over distance - super good short ranged, super fast fall off rate
	? Do the opposite for Mortalen?

- Nova missiles
	- genuinely high dmg / aoe

- Fighters & Bombers
	- Make all races use the same tech levels
	- Boil these down to just what's needed (0,1,2,3,4,5)
		- Ditch extra racial techs for Humans and Teekans
	- Make a rational progression of
		- Slots (General, Weapon, Defense, Engine)
		- Bonuses (Targeting, Countermeasures, Ship Manuevering, Ion Defense, Reactive Rating)
		- Size & Cost ($ and resources)

<!-- TODO: separate upper tier planetary defense installations and use higher tier weapon effects for them -->
<!-- TODO: maybe make a script to sync them against a base component with a known scaling factor for all types -->

Specialzed Hulls
	- Offensive (bigger / more weapons)
	- Defensive (more defenses)
	- Fast (more engines)
	- Command (more sensors)

	- Fast / Patrol
		- EE, FF, DD, Patrol Cruiser
	- Battle / War / Heavy
		- EE, FF, DD, Battle Cruiser
	- Shield / ??? WTF is this ???
		- Cruiser, Galaxy Cruiser
	- Command / Sensors / Strategic?
		- FF, DD, Cruiser, Fleet Cruiser

- Bomber variants of
	- Blasters
	- Beams
	- Ion Cannons
	- Rail Guns
	- Gravitic

Hangar Hooks?  Microbay? Tertiary Bay?
	size 10, holds 1/1 ftr/bomber (or even 2/0 with a 0/2 variant?)

Cool Ideas:
- Hull: Boarding Assault variants
	- less weapons / bays, more general slots for assault pods
- Gravitic Torps
	- Like energy torps, but with bypass as other gravitic weapons
- Cutting beams
	- beam weapon with +% vs. armor
- Disruptors
	- blasters with +% vs. shields & ion value?

PLANETARY Facilities
- Increase targeting for v2, v3
- Increase visual effects for v2, v3
- Increase shields?

NULL OUT A RESEARCH PROJECT:
	<ResearchProjectDefinition>
		<ResearchProjectId>450</ResearchProjectId>
		<Name>Undefined: (450)</Name>
		<ImageFilename>UserInterface/Placeholder</ImageFilename>
		<Size>0</Size>
		<EnabledByDefault>false</EnabledByDefault>
		<ProjectAppearanceProbability>0</ProjectAppearanceProbability>
		<Column>0</Column>
		<Row>0</Row>
	</ResearchProjectDefinition>

Freighter classes?
Rock Hopper
Star Jumper
Long Hauler

- RACES -
------------------------------------------------------------------------------
race-id, name, diplomacy tech (BASIC, EFFECTIVE +1, ADVANCED +2, COMPLETE +3)
------------------------------------------------------------------------------
 0 Human 		688
 1 Ackdarian 	692
 2 Teekan 		696
 3 Haakonish 	700
 4 Mortalen		704
 5 Ikkuro 		708
 6 Boskara		712
 7 Zenox 		716
 8 Wekkarus		720
 9 Atuuk 		724
10 Dhayut 		728
11 Gizurean 	732
12 Ketarov		736
13 Kiadian		740
14 Naxxilian 	744
15 Quameno		748
16 Securan		752
17 Shandar		756
18 Sluken 		760
19 Ugnari 		764
20 Shakturi
249 Hive (?)

Governments
0	Republic
1	Mercantile Guild
2	Democracy
3	Tribal Bloodlines
4	Monarchy
5	Stratocracy
6	Technocracy
7	Hive Mind
8	Way of Darkness
9	Way of the Ancients
10	Path of the Ancients
11	Harmonious Utopia
12	Surveillance Oligarchy
51	Archivist

Habitable Planet Types
7	Continental
8	Marshy Swamp
9	Warm Ocean
10	Sandy Desert
11	Snowball
12	Rocky Volcanic
17	Continental Forests
18	Grasslands
19	Rocky Desert
20	Savanna
21	Tundra
22	Ice
23	Cold Ocean
27	Mangrove Swamp
29	Carbonaceous Hothouse
30	Sulphur Volcanic

Airless Bodies
13	Rocky Silicon
25	Rocky Metallic
26	Rocky Ice

Asteroid Fields
16	Rocky Asteroid

PQ is currently
.2 - .5 carbonaceous
.2 - .7 volcanic,  Sulphur volcanic
.3 - .7 snow, ice, tundra, deserts (all), savannah
.4 - .8 continental, swamp, mangrove, oceans, grasslands, forests

----------------------------------------
	Construction Resources
----------------------------------------

0	Emeros Crystal
1	Nekros Stone
2	Osalia
3	Kaasian Crystal
6	Tyderios
7	Silicon
8	Steel
9	Mebnar
10	Aculon
11	Cuprica
12	Polymer
13	Carbonite
77	Dyrillium Quartz
78	Hexodorium

----------------------------------------
	Gaseous Resources
----------------------------------------

4	Argon
5	Krypton
14	Caslon

----------------------------------------
	Luxury Resources
----------------------------------------

15	Loros Fruit
16	Megallos Nut
17	Falajian Spice
18	Korabbian Spice
19	Ekarus Meat
20	Nepthys Wine
21	Rephidium Ale
22	Wiconium
23	Vodkol
24	Questurian Skin
25	Bifurian Silk
26	Caguar Fur
27	Terallion Down
28	Dantha Fur
29	Aquasian Incense
30	Natarran Incense
31	Zentabia Fluid
32	Ilosian Jade
33	Otandium Opal
34	Jakanta Ivory
35	Ucantium Pearl
36	Yarras Marble
37	Podanthia Root
38	Vofula Scent
39	Suculos Wood
40	Copandil
41	Norjak Eggs
42	Breqiian Berries
43	Kasotti
44	Oksunum Steak
45	Attarion Fur
46	Muurion Wine
47	Inkasdia Fruit
48	Feraxian Firestone
49	Vakala Crystal
50	Decarion Ale
51	Obrudan Amber
52	Yapara Leaf
53	Giraxian Nectar
54	Hapek Obsidian
55	Lukaarin Fungus
56	Rhylig
57	Shudasta Scales
58	Tebraakian Granite
59	Xukantar
60	Korduva Grain
61	Losarn Syrup
62	Akrasan Amber
63	Doakan Tea
64	Yotapian Onyx
65	Hyutil Resin
66	Darkhul Tentacles
67	Sokalian Brandy
68	Bartak Wood
69	Wruzos Anemone
70	Tassont Moth Fiber
71	Ordulos Shell
72	Tebrullian Moss
73	Sarrobia Coral
74	Korhuga Beans
75	Ardilus Tentacles
76	Gravillex Crystal

----------------------------------------
-                 ROWS                 -
----------------------------------------

ROW 0 IS ALWAYS UNDEFINED NOW!

Weapons		     1..99
	tractor		 1..05 (5)
	gravitic 	10..18 (9)
	beam  		20..28 (9)
	pulsed  	30..36 (7)
	kinetic   	40..44 (5)
	bombs		50..52 (3)
	torps		60..67 (8)
	area 		70..73 (4)
	missile 	80..86 (7)
	ion   		90..96 (7)
	misc		98..99 (2)

nova row 88

Armor       100..
	Standard 100..102
	Flux     110
	Interlaced (Gizurean) 120..121

Dmg-ctrl    130..131

Shields		140..148

Troops		160..177

Reactors 	180..183

hyperjump	200..210

Engines     220..235

Hangars &
Fighters	240..249

Assault Pods
& Marines 	260..267

Construction 280..290

Sensors
& Stealth	300..307

Targeting	320..324
Countermeasures 330..333

Exploration
&
Colonizing 	340..361

Storage
&
Transport	380..385

Mining &
Energy		390..392

Command &
Medical		400..412

Commerce &
Recreation	420..421

Research	440..455
	Science 	440-445
	Facilities	450-455

Espionage &
Diplomacy  	460..484

Ancient Guardian 500..524

----------------------------------------
Initial Techs
----------------------------------------

Blasters			768
Beam Weapons		0
Ion Weapons			1
Area Weapons		2
Torpedo Weapons		3
Missile Weapons		4
Kinetic Weapons		5
Ground Combat		6
Pulsed Wave Weapons 7 (Wekarus)
Tractor Beams		35
Bombardment Weapons 17
Plasma Blasters     316

Ground Combat		6

Improved Ion Cannons	10
Ion Area Weapons	11

----------------------------------------
Component Sizes
----------------------------------------
Fighter:		5
Bomber:			10
PD:				11
Direct Fire:	11/22/44
Tracking:		13/26/52
AoE:			52
Bombard:		26
Hangars:		25/50/100

Armors:			10
Shields:		20
Ion Shields:	20
Dmg Con:		20

Assault Pods:	10

Hyperdrives:	15-2?
Power:			15-24
Engines:		15-20

---------------------------------------------------------------------------------
 0   1   2    3    4    5    6    7     8     9    10     11 (repeatables) 12 (super tech)
---------------------------------------------------------------------------------
75 300 600 1200 2400 3600 5400  7200 14400  28800  57600  ....
---------------------------------------------------------------------------------
25  75 300  600 1200 2400 4800  9600 19200  38400  76800 153600
25  75 450  900 1800 3600 7200 14400 28800  57600 115200 125000
25  75 600 1200 2400 4800 9600 19200 38400  76800 153600 307200

25  75 600 1200 2400 4800 7200 14400 28800  38400  76800 153600

25  75 450  900 1800 3600  7200 14400 28800 57600 115200 125000
33 100 300  900 2700 5400 10800 21600 32400 48600  72900 109350             60750
  3x  3x  3x   3x  2x    2x   2x    3/2x   3/2x  3/2x   3/2x

clear
copy data\ResearchProjectDefinitions.xml data\ResearchProjectDefinitions.old
perl adjustcol.pl data\ResearchProjectDefinitions.old 1 999 10 99 4 data\ResearchProjectDefinitions.xml


hyper drive fuel efficiency (purely speed/energyK)
type          |  L2  |  L3  |  L4  |  L5  |  L6  |  L7  |  L8
---------------------------------------------------------------
Sojourn       |.2    |.15   |.1111 |.0916 |.0666 |.0542 |.0388
Snap          |      |.1616 |.1333 |      |.0888 |      |.0555
Smart         |      |.14   |.1143 |      |.06   |      |.0357
Hyperstream   |      |.1692 |.1333 |      |.0871 |      |.0538

type 		 efficiency			  accuracy		range	init	recharge	insulation
--------------------------------------------------------------------------------------
Skip		 50:100K=.5				5000		.75M	20		30				 0
Bubble 		 70:200K=.35			5000		120M	17		28				 0
Sojourn		 80:400K=.2				4250		140M	16		25				10
		     90:600K=.15			3750		168M	15		23				15
		    100:900K=.1111			3250		216M	14		21				20
		    110:1200K=.0916			2750		246M	13		19				25
Torrent		120:1.8M=.0666			2250		293M	 9		15				30
			130:2.4M=.0542			1750		374M	 8		12				35
			140:3.6M=.0388			1250		450M	 6		10				40
Snap	    100:600K=.1616			3500		140M	12		12				15
			120:900K=.1333			3000		180M	10		10				20
			160:1.8M=.0888			2000		220M	 6		 6				30
			200:3.6M=.0555			1000		260M	 2		 2				40
Smart	 70:500K=.14			3500		225M	26		13				15
			 80:700K=.1143			3000		350M	24		12				20
			 90:1.4M=.06			2000		500M	22		11				30
			100:2.8M=.0357			1000		650M	20		10				40
Hyperstream		110:650K=.1692			4500		168M	16		22				15
			130:975K=.1333			4000		216M	14		20				20
			170:1.95M=.0871			3000		293M	12		18				30
			210:3.9M=.0538			2000		450M	10		16				40
Wormhole	200:5.0M=.04			 500		500M	 1		 1				50
Hive		 22:1.2M				1600		180M	30		54				20
			 27:2.4M				1400		260M	25		48				30
			 29:4.8M				1200		320M	20		42				40

		<PrerequisiteProjectsMinimumPathCount>2</PrerequisiteProjectsMinimumPathCount>

ReactorFuelUnitsForFullCharge * X = ReactorEnergyStorageCapacity
X = ReactorEnergyStorageCapacity/ReactorFuelUnitsForFullCharge
1/X = ReactorFuelUnitsForFullCharge/ReactorEnergyStorageCapacity
FuelRatio = 1000 * ReactorFuelUnitsForFullCharge/ReactorEnergyStorageCapacity

ReactorFuelUnitsForFullCharge = ReactorEnergyStorageCapacity*FuelRatio/1000

= 300 * .001333


Reactors	size		v1				v2				v3				hyper 	v2		v3
Caslon		23		 54/ 90/.21	    68/115/.2
Fusion 		16		 80/120/.26		100/150/.3		120/187.5/.33		160		200		240
Harmonic	20		120/180/.495	140/225/.6		160/281.25/.675		200		240		280
Plasmatic	24		160/240/.96		180/300/1.1		200/375/1.2			240		280		320
Novacore 	20		120/240/.24		150/300/.3		188/375/.375
Zero		15		311/605/.6
Dark Star	20		500/1000/.875

                         Fuel ratio/1k
----------------------------------------------------------------
Caslon Fusion					0.0015			0.0014			0.0013
Harmonic Caslon					0.0017			0.0016			0.0015
Coronal					0.0019			0.0018			0.0017

[ftr]		size		v1		v2		v3		v4		Hyper	v1		v2		v3
Starfighter	10			19		21
Fusion 		 6			24		27		33				4		40		48		57
Harmonic	 8			26		30		37				6		45		54		64
Plasmatic	10			35		41		50				8		60		71		83
Novacore	 7			35		43		52		64
Zero Point	 5			83
Dark Star	 7			130


		<PrerequisiteProjectsMinimumPathCount>2</PrerequisiteProjectsMinimumPathCount>

---------------------------------------------------------------------------------------------------

Vanilla Hull Sizes
type        standard	specialized
Escort		375			 415 10.6..%
Frigate		450			 490  8.8..%
Destroyer	600			 675 12.125%
Cruiser		750			 840 12    %		 900  7.14%
BB+CV		1200		1300  8.3..%		1500 15.38%			1800	20.00%

DW2-XL Hull Sizes
type        standard	specialized			massive/advanced	colossal/super
Escort		375			 450 20.0%
Frigate		450			 540 20.0%
Destroyer	600			 720 20.0%
Cruiser		800 (6.6%)	 960 20.0%		 	1120 20.0%
BB+CV		1200		1440 20.0%			1728 20.0%			2074	20.0%

names:

Heavy Carrier -> Super Carrier
Carrier -> Heavy Carrier
Light Carrier -> Carrier

Heavy Battleship -> Super Battleship
Battleship -> Heavy Battleship
Battlecruiser -> Battleship

Heavy Cruiser -> Battlecruiser
Exploration Cruiser -> Galaxy Cruiser
Cruiser -> Heavy Cruiser
Long Range Cruiser -> Shield Cruiser
Light Cruiser -> Cruiser

---------------------------------------------------------------------------------------------------

Vanilla Armor Blast Ratings
Standard	 72
Heavy		104		Ion	Sheath			 83
Enhanced	125		Enhanced Ion Sheath	 94
Reactive	150		Ion Hardened		113
Ultra-Dense	180		Ultra-Dense Ion		135
Absorbing	225		Absorbing Ion		169
Stellar		320

---------------------------------------------------------------------------------------------------

		<Name>Undefined</Name>
		<ImageFilename>UserInterface/Placeholder</ImageFilename>
		<Size>0</Size>
		<EnabledByDefault>false</EnabledByDefault>
		<ProjectAppearanceProbability>0</ProjectAppearanceProbability>
		<Column>0</Column>
		<Row>0</Row>

---------------------------------------------------------------------------------------------------
dw2bt help
dw2bt help list
dw2bt help extract
dw2bt help convert

dw2bt extract "C:\Steam\steamapps\common\Distant Worlds 2\data\db\bundles\Human.bundle" "UserInterface/Races/Human"

dw2bt convert "UserInterface\Races\Human" "UserInterface\Races\human.png"

C:\Users\steve\Downloads\DW2BT> .\DW2BT.exe extract "C:\Users\steve\Downloads\DW2 Unstable\data\db\bundles\CoreContent.bundle" Environment/OrbTypes/Large/Grasslands
Extracting 1/1
Extraction complete.
C:\Users\steve\Downloads\DW2BT> .\DW2BT.exe convert Environment/OrbTypes/Large/Grasslands Environment/OrbTypes/Large/Grasslands.png

----------------------------------------------------------------------------------------
Rail gun overhaul:

Rail gun slugs exist for 2s -- so range is however far they travel in 2 game-seconds (2x their speed)
	The round speed tends to get higher for Large over Medium, and again for Medium over Small (hence range follows large > medium > small)
Rail guns are a slow weapon to fire - 6s intervals for t0..t5, and dropping to 9s intervals for forge batteries, while speeding up to 3s intervals for autocannons, and 2.5s for hail Cannons (humans only)
Rail guns have a -33% against armor from t0..t5, but lose that malus from t6 and above (at all sizes)
Rail guns follow a straight 4:2:1 power ratio from large:medium:small
Rail guns do not lose damage potential with distance

cool regex:

	// non-zero decimal pattern:
		((0\.|[1-9]\.?)\d*)
	// any non-zero decimal or floating or scientific notation number:
		((0\.|[1-9]\.?)\d*((e|E)(\+|-)\d+)?)

	// token followed by a word then optionally another word which isn't one of a verboten set (e.g. matches "<Description>Loros Fruit" and "<Description>Caslon")
		<Description>\b((\w+)( (?!is|are)\w+)?)
		replace: <Description>[RESOURCE]$1[/RESOURCE]

Tech Bonus Categories

	All				...all... (note: Diplomacy only benefits from All)
	Industrial		Terraforming, Colonization
	Construction	Fighters, Starships
	High Tech		Research,  Medical, Economic

	...the rest are pretty self evident

----------------------------------------------------------------------------------------
Tech and government reveal keys
________________________	_________________________________________
ResearchProjectUnlockIds	Artifacts
ResearchProjectEnable		GameEvents
GovernmentUnlockIds			Artifacts
GovernmentUnlocked			GameEvents

----------------------------------------------------------------------------------------
CODE MODDING

the dialog class is DistantWorlds.UI.StartNewGameDialog
it has a private member DWPanel[] member you can overwrite if you want to prepend, insert or append custom panels to
there's an instance of that class on DistantWorlds2.MenuRenderer called StartNewGameDialog,
two instances of MenuRenderer exist on DistantWorlds2.ScaledRenderer which can be found on DWGame which can be found from (finally!) a static member on DistantWorlds2.DWGame
... the architecture isn't the most explorable, but that's what I'm here for! (edited)
[6:29 AM]
alternately from the MenuRenderer(s) you can replace the click event on the 'new game' button to call your method instead of MenuRenderer.StartNewGameClick