Editing Pikmin 2 cave lighting files

{{todo|This page may contain inaccurate information. Please edit any discrepancies on information that you know for a fact is true.}}
Lighting configuration files for caves can be found under <code>"root/user/Abe/cave/"</code> as .txt files. There are 67 in total.

=Configuration Format=
If the light file has a custom name and is not included in the game's <code>\root\&&SystemData\Game.toc</code> the file will simply be ignored by the game when it is compiled. An easy way to fix this is to simply enable "Do not use 'game.toc'" under the options tab in GCRebuilder before opening the root folder.
{{note|Be aware that the first of the two set of parameters are used for when the [https://www.pikminwiki.com/Stellar_Orb Stellar Orb] has been collected. To edit the default lighting thats used before collecting this part of the Explorer's kit edit the second set.}}

The example below represents settings for <code>bluefog00.ini</code> taken directly from the file and broken up into segments.
<source lang="powershell">
############################################### 
# 
# Game Light Mgr Setting  
# 
############################################### 
#=============================================== 
#	共通設定 <Common Setting>
#=============================================== 
{0001} 	# バージョン <Version>
1	# タイプ <Type>
</source>
The first line represents what version the lighting file is. This can be changed to {0000} and {0001} and have different effects. Might have to do with how the lighting file is parsed. More testing is needed.

The second number below represents the type of lighting. Setting this to 0 seems to set the light source at a far fixed angle creating a sunrise and sunset effect with heavy contrast between lit and unlit surfaces (Seems to work on certain files and can crash. Might be related to parameters that don't work with it).
 
Setting this to 1 seems to be the regular light source situated directly overhead the player. 

<source lang="powershell">
#=============================================== 
#	スポットタイプ設定 <Spot Type Setting>
#=============================================== 
#----------------------------------------------- 
# パラメタ <Parameter>
#----------------------------------------------- 
# MoveParms
{
	{f000} 4 1000.000000 	# 光源までの距離 <Distance To Light Source>
	{_eof} 
}
</source>

Self explainatory. The setting for how many units above the player the light source will be.
'''AGAIN. If you are looking to change the default lighting of the cave, edit the second set of parameters.'''
<source lang="powershell">
#----------------------------------------------- 
#　ライト設定 <Write Setting>
#----------------------------------------------- 
# メインライト <Main Light
# ColorParms
{
	{u800} 4 144 	# 赤 <Red>
	{u801} 4 137 	# 緑 <Green>
	{u802} 4 109 	# 青 <Blue>
	{u803} 4 255 	# アルファ <Alpha>
	{_eof} 
}
# SpotParms
{
	{f000} 4 45.000000 	# カットオフ <Cut Off>
	{_eof} 
}
</source>

This is the basic settings for the main light source above the player. Uses RGBa settings {u800}-{u802} to determine color. {u803} while apparently affects alpha levels doesn't seems to do anything (Can be safe to say that this setting is completely useless) and the {f000} property determines the cut off angle of the light source. It seems as though all light files have the exact same angles for their cut off properties at 45 degrees. This however makes sense since they can just simply raise or lower the light source to increase or decrease the radius of light around the player. A great example of how raising the light source rather than making the cut off angle wider is effective is shown by how the developers made <code>jyoou_light_lv4_5.ini</code> to be raised 1500 units above the player for a spotlight effect and <code>jyoou_light_lv0.ini</code> is raised 5000 units above the player for a bright effect.
<source lang="powershell">
# サブライト <Sub Light>
# ColorParms
{
	{u800} 4 60 	# 赤 <Red>
	{u801} 4 60 	# 緑 <Green>
	{u802} 4 60 	# 青 <Blue
	{u803} 4 255 	# アルファ <Alpha>
	{_eof} 
}
# SpotParms
{
	{f000} 4 30.000000 	# カットオフ <Cut Off Angle>
	{_eof} 
}
</source>
This lighting property is hard to notice but only seems to act as the light that reflected from the ground up to the player models. To keep this realistic try to keep it the same color as the light used for the main lighting.

<source lang="powershell">
# スペキュラライト <Specular Light>
# ColorParms
{
	{u800} 4 255 	# 赤 <Red>
	{u801} 4 255 	# 緑 <Green>
	{u802} 4 255 	# 青 <Blue>
	{u803} 4 0 	# アルファ <Alpha>
	{_eof} 
}
</source>
Simliar to sub light however this affects every object in the game. Specular light relates to light that is reflected off surfaces. Changing this setting will result in a change of color that reflected off glossy surfaces. 

<source lang="powershell">
# アンビエントライト <Ambient Light>
# ColorParms
{
	{u800} 4 19 	# 赤 <Red>
	{u801} 4 39 	# 緑 <Green>
	{u802} 4 30 	# 青 <Blue>
	{u803} 4 0 	# アルファ <Alpha>
	{_eof} 
}
</source>
Ambient light refers to lighting that relates to the immediate surroundings. This would be static light that exists before adding in main lighting and fog.

<source lang="powershell">
# フォグ <Fog>
# ColorParms
{
	{u800} 4 67 	# 赤 <Red>
	{u801} 4 159 	# 緑 <Green>
	{u802} 4 213 	# 青 <Blue>
	{u803} 4 255 	# アルファ <Alpha>
	{_eof} 
}
# GameFogParms
{
	{f000} 4 0.000000 	# 開始z値 <Fog Start Z Value>
	{f001} 4 8000.000000 	# 終了z値 <Fog End Z Value>
	{_eof} 
}
</source>
Controls fog color and start and end values.

<source lang="powershell">
# 影 <Shadow>
# ColorParms
{
	{u800} 4 0 	# 赤 <Red>
	{u801} 4 0 	# 緑 <Green>
	{u802} 4 0 	# 青 <Blue>
	{u803} 4 128 	# アルファ <Alpha>
	{_eof} 
}
</source>
Unsure. Doesn't seem to change anything to do with shadows?
==Vanilla Light File Gallery==

Note that <code>light_blue.ini</code> and <code>light_red.ini</code> '''WILL CRASH THE GAME'''. This is because these files seems to use an older format that the game no longer reads. To fix these all you have to do is simply reformat the values to a normal light file.

<div align="center>
{| class="wikitable mw-collapsible"
! File Name
! Far Angle
! Close Angle
|-
| bluefog00.ini||[[File:bluefog00-far.png|500px|thumb|center|]]||[[File:bluefog00-close.png|500px|thumb|center|]]
|-
| chikahimi_metal_light_lv4.ini||[[File:chikahimi_metal_light_lv4-far.png|500px|thumb|center|]]||[[File:chikahimi_metal_light_lv4-close.png|500px|thumb|center|]]
|-
| forest_2_siro_light.ini||[[File:forest_2_siro_light-far.png|500px|thumb|center|]]||[[File:forest_2_siro_light-close.png|500px|thumb|center|]]
|-
| forest_3_light.ini||[[File:forest_3_light-far.png|500px|thumb|center|]]||[[File:forest_3_light-close.png|500px|thumb|center|]]
|-
| hiroba_light.ini||[[File:hiroba_light-far.png|500px|thumb|center|]]||[[File:hiroba_light-close.png|500px|thumb|center|]]
|-
| hiroba_toy_light_cha.ini||[[File:hiroba_toy_light_cha-far.png|500px|thumb|center|]]||[[File:hiroba_toy_light_cha-close.png|500px|thumb|center|]]
|-
| houdai_light.ini||[[File:houdai_light-far.png|500px|thumb|center|]]||[[File:houdai_light-close.png|500px|thumb|center|]]
|-
| jyoou_light_lv0.ini||[[File:jyoou_light_lv0-far.png|500px|thumb|center|]]||[[File:jyoou_light_lv0-close.png|500px|thumb|center|]]
|-
| jyoou_light_lv1.ini||[[File:jyoou_light_lv1-far.png|500px|thumb|center|]]||[[File:jyoou_light_lv1-close.png|500px|thumb|center|]]
|-
| jyoou_light_lv2.ini||[[File:jyoou_light_lv2-far.png|500px|thumb|center|]]||[[File:jyoou_light_lv2-close.png|500px|thumb|center|]]
|-
| jyoou_light_lv3.ini||[[File:jyoou_light_lv3-far.png|500px|thumb|center|]]||[[File:jyoou_light_lv3-close.png|500px|thumb|center|]]
|-
| jyoou_light_lv4_5.ini||[[File:jyoou_light_lv4_5-far.png|500px|thumb|center|]]||[[File:jyoou_light_lv4_5-close.png|500px|thumb|center|]]
|-
| jyoou_light_lv6.ini||[[File:jyoou_light_lv6-far.png|500px|thumb|center|]]||[[File:jyoou_light_lv6-close.png|500px|thumb|center|]]
|-
| key_light_lv0.ini||[[File:key_light_lv0-far.png|500px|thumb|center|]]||[[File:key_light_lv0-close.png|500px|thumb|center|]]
|-
| key_light_lv1.ini||[[File:key_light_lv1-far.png|500px|thumb|center|]]||[[File:key_light_lv1-close.png|500px|thumb|center|]]
|-
| king_light.ini||[[File:king_light-far.png|500px|thumb|center|]]||[[File:king_light-close.png|500px|thumb|center|]]
|-
| kumomei_light_cha.ini||[[File:kumomei_light_cha-far.png|500px|thumb|center|]]||[[File:kumomei_light_cha-close.png|500px|thumb|center|]]
|-
| kusachi_light_cha.ini||[[File:kusachi_light_cha-far.png|500px|thumb|center|]]||[[File:kusachi_light_cha-close.png|500px|thumb|center|]]
|-
| kusachi_light_lv0.ini||[[File:kusachi_light_lv0-far.png|500px|thumb|center|]]||[[File:kusachi_light_lv0-close.png|500px|thumb|center|]]
|-
| light.ini||[[File:light-far.png|500px|thumb|center|]]||[[File:light-close.png|500px|thumb|center|]]
|-
| light_blue.ini||[[File:light_blue-far.png|500px|thumb|center|]]||[[File:light_blue-close.png|500px|thumb|center|]]
|-
| light_red.ini||[[File:light_red-far.png|500px|thumb|center|]]||[[File:light_red-close.png|500px|thumb|center|]]
|-
| metal_light_cha.ini||[[File:metal_light_cha-far.png|500px|thumb|center|]]||[[File:metal_light_cha-close.png|500px|thumb|center|]]
|-
| metal_light_lv0.ini||[[File:metal_light_lv0-far.png|500px|thumb|center|]]||[[File:metal_light_lv0-close.png|500px|thumb|center|]]
|-
| metal_light_lv1.ini||[[File:metal_light_lv1-far.png|500px|thumb|center|]]||[[File:metal_light_lv1-close.png|500px|thumb|center|]]
|-
| metal_light_lv2.ini||[[File:metal_light_lv2-far.png|500px|thumb|center|]]||[[File:metal_light_lv2-close.png|500px|thumb|center|]]
|-
| metal_light_lv3.ini||[[File:metal_light_lv3-far.png|500px|thumb|center|]]||[[File:metal_light_lv3-close.png|500px|thumb|center|]]
|-
| metal_light_lv4.ini||[[File:metal_light_lv4-far.png|500px|thumb|center|]]||[[File:metal_light_lv4-close.png|500px|thumb|center|]]
|-
| muraon_light_lv0.ini||[[File:muraon_light_lv0-far.png|500px|thumb|center|]]||[[File:muraon_light_lv0-close.png|500px|thumb|center|]]
|-
| muraon_light_lv1.ini||[[File:muraon_light_lv1-far.png|500px|thumb|center|]]||[[File:muraon_light_lv1-close.png|500px|thumb|center|]]
|-
| muraon_light_lv2.ini||[[File:muraon_light_lv2-far.png|500px|thumb|center|]]||[[File:muraon_light_lv2-close.png|500px|thumb|center|]]
|-
| muraon_light_lv3.ini||[[File:muraon_light_lv3-far.png|500px|thumb|center|]]||[[File:muraon_light_lv3-close.png|500px|thumb|center|]]
|-
| muraon_light_lv4.ini||[[File:muraon_light_lv4-far.png|500px|thumb|center|]]||[[File:muraon_light_lv4-close.png|500px|thumb|center|]]
|-
| normal_light_cha.ini||[[File:normal_light_cha-far.png|500px|thumb|center|]]||[[File:normal_light_cha-close.png|500px|thumb|center|]]
|-
| normal_light_lv0.ini||[[File:normal_light_lv0-far.png|500px|thumb|center|]]||[[File:normal_light_lv0-close.png|500px|thumb|center|]]
|-
| normal_light_lv1.ini||[[File:normal_light_lv1-far.png|500px|thumb|center|]]||[[File:normal_light_lv1-close.png|500px|thumb|center|]]
|-
| normal_light_lv2.ini||[[File:normal_light_lv2-far.png|500px|thumb|center|]]||[[File:normal_light_lv2-close.png|500px|thumb|center|]]
|-
| normal_light_lv3.ini||[[File:normal_light_lv3-far.png|500px|thumb|center|]]||[[File:normal_light_lv3-close.png|500px|thumb|center|]]
|-
| normal_light_lv4.ini||[[File:normal_light_lv4-far.png|500px|thumb|center|]]||[[File:normal_light_lv4-close.png|500px|thumb|center|]]
|-
| oootakara_light.ini||[[File:oootakara_light-far.png|500px|thumb|center|]]||[[File:oootakara_light-close.png|500px|thumb|center|]]
|-
| qchap_light.ini||[[File:qchap_light-far.png|500px|thumb|center|]]||[[File:qchap_light-close.png|500px|thumb|center|]]
|-
| sirohana_light_lv0.ini||[[File:sirohana_light_lv0-far.png|500px|thumb|center|]]||[[File:sirohana_light_lv0-close.png|500px|thumb|center|]]
|-
| sirohana_light_lv1.ini||[[File:sirohana_light_lv1-far.png|500px|thumb|center|]]||[[File:sirohana_light_lv1-close.png|500px|thumb|center|]]
|-
| sirohana_light_lv2.ini||[[File:sirohana_light_lv2-far.png|500px|thumb|center|]]||[[File:sirohana_light_lv2-close.png|500px|thumb|center|]]
|-
| sirohana_light_lv3.ini||[[File:sirohana_light_lv3-far.png|500px|thumb|center|]]||[[File:sirohana_light_lv3-close.png|500px|thumb|center|]]
|-
| sirohana_light_lv4.ini||[[File:sirohana_light_lv4-far.png|500px|thumb|center|]]||[[File:sirohana_light_lv4-close.png|500px|thumb|center|]]
|-
| sirohana_light_lv5.ini||[[File:sirohana_light_lv5-far.png|500px|thumb|center|]]||[[File:sirohana_light_lv5-close.png|500px|thumb|center|]]
|-
| sniper_light_lv0.ini||[[File:sniper_light_lv0-far.png|500px|thumb|center|]]||[[File:sniper_light_lv0-close.png|500px|thumb|center|]]
|-
| suityu_light_lv0.ini||[[File:suityu_light_lv0-far.png|500px|thumb|center|]]||[[File:suityu_light_lv0-close.png|500px|thumb|center|]]
|-
| suityu_light_lv1.ini||[[File:suityu_light_lv1-far.png|500px|thumb|center|]]||[[File:suityu_light_lv1-close.png|500px|thumb|center|]]
|-
| suityu_light_lv2.ini||[[File:suityu_light_lv2-far.png|500px|thumb|center|]]||[[File:suityu_light_lv2-close.png|500px|thumb|center|]]
|-
| suityu_light_lv3.ini||[[File:suityu_light_lv3-far.png|500px|thumb|center|]]||[[File:suityu_light_lv3-close.png|500px|thumb|center|]]
|-
| suityu_light_lv4.ini||[[File:suityu_light_lv4-far.png|500px|thumb|center|]]||[[File:suityu_light_lv4-close.png|500px|thumb|center|]]
|-
| toy_light_cha.ini||[[File:toy_light_cha-far.png|500px|thumb|center|]]||[[File:toy_light_cha-close.png|500px|thumb|center|]]
|-
| toy_light_lv0.ini||[[File:toy_light_lv0-far.png|500px|thumb|center|]]||[[File:toy_light_lv0-close.png|500px|thumb|center|]]
|-
| toy_light_lv1.ini||[[File:toy_light_lv1-far.png|500px|thumb|center|]]||[[File:toy_light_lv1-close.png|500px|thumb|center|]]
|-
| toy_light_lv2.ini||[[File:toy_light_lv2-far.png|500px|thumb|center|]]||[[File:toy_light_lv2-close.png|500px|thumb|center|]]
|-
| toy_light_lv3.ini||[[File:toy_light_lv3-far.png|500px|thumb|center|]]||[[File:toy_light_lv3-close.png|500px|thumb|center|]]
|-
| toy_light_lv4.ini||[[File:toy_light_lv4-far.png|500px|thumb|center|]]||[[File:toy_light_lv4-close.png|500px|thumb|center|]]
|-
| tutorial_1_light.ini||[[File:tutorial_1_light-far.png|500px|thumb|center|]]||[[File:tutorial_1_light-close.png|500px|thumb|center|]]
|-
| vs_2_light.ini||[[File:vs_2_light-far.png|500px|thumb|center|]]||[[File:vs_2_light-close.png|500px|thumb|center|]]
|-
| vs_6_light.ini||[[File:vs_6_light-far.png|500px|thumb|center|]]||[[File:vs_6_light-close.png|500px|thumb|center|]]
|-
| vs_7_light.ini||[[File:vs_7_light-far.png|500px|thumb|center|]]||[[File:vs_7_light-close.png|500px|thumb|center|]]
|-
| vs_8_light.ini||[[File:vs_8_light-far.png|500px|thumb|center|]]||[[File:vs_8_light-close.png|500px|thumb|center|]]
|-
| vs_10_light.ini||[[File:vs_10_light-far.png|500px|thumb|center|]]||[[File:vs_10_light-close.png|500px|thumb|center|]]
|-
| yakushima_2_light.ini||[[File:yakushima_2_light-far.png|500px|thumb|center|]]||[[File:yakushima_2_light-close.png|500px|thumb|center|]]
|-
| yakushima_3_16x17r_light.ini||[[File:yakushima_3_16x17r_light-far.png|500px|thumb|center|]]||[[File:yakushima_3_16x17r_light-close.png|500px|thumb|center|]]
|-
|}
</div>

Credits: [[User:Kai Vang|Kai Vang]] ([[User talk:Kai Vang|talk]]) 14:15, 27 April 2018 (UTC)