======Lighting guide/lighting script basics======

===== Environmental lighting =====

Roblox Bhop and Surf use the Shadowmap lighting technology. To use that in Studio, in the explorer window, navigate to Lighting. Click on it and look at the properties. The Technology property needs to be changed to ''Shadowmap''.

==== Most important game.Lighting properties ====

  * Ambient (default: 0,0,0)
    * Controls the color/brightness of shadows
  * Brightness (default: 1)
    * Controls the overall brightness of the sun
  * ColorShift_Top (default: 0,0,0)
    * Controls the tint of the sun
  * GlobalShadows (default: true)
    * If false, there will be no shadows (it may look better to tweak part's CastShadow properties instead)
  * OutdoorAmbient (default: 127,127,127)
    * Controls the color/brightness of the outdoors
  * ClockTime (default: 14)
    * Controls the time of day and position of the sun
  * GeographicLatitude (default: 41.733)
    * Controls the latitude and position of the sun
  * FogColor (default: 192,192,192)
    * Controls the color of fog
  * FogStart (default: 0)
    * Controls where fog starts; measured in studs
  * FogEnd (default: 10000)
    * Controls where fog ends (where it is strongest); measured in studs
//Note: both ClockTime and GeographicLatitude are used to control the position of the sun//

==== Basics for environmental lighting (game.Lighting) ====

To change game.Lighting properties for your map, you need to add a script to your map model.

Example:
<code Lua>local l = game.Lighting</code>
Assign a variable name to game.Lighting for ease of use, here we just use ''l''
<code Lua>
l.Ambient = Color3.fromRGB(100,100,100)
l.ClockTime = 12
l.GeographicLatitude = 21
</code>
Increase the Ambient value to make shadows less dark so indoor areas have more visibility. Change the position of the sun so it is more directly overhead and creates less shadows.

For properties that use Color3 values, simply use ''Color3.fromRGB(R,G,B)'' and fill in the R,G,B with the corresponding red, blue, and green values of your choice. The others just use numbers.

====How to add a Skybox=====

Create a Sky object in studio and put it inside your map model. Follow the instructions on this [[https://developer.roblox.com/en-us/articles/Custom-Skyboxes|Roblox Developer wiki article about custom skyboxes]] if you need help.

Next, put a script inside the Sky object. The script should say:

<code Lua>
script.Parent.Parent = game.Lighting
</code>

All this does is change the parent of script.Parent (the Sky object) to game.Lighting. This just moves the Sky from your map model to game.Lighting where it belongs.

Finally, turn off the CelestialBodiesShown property of the Sky object if the skybox already has a sun, otherwise you will have two suns (the sun from the skybox images, and the sun added by Roblox).

===== Related =====
  *[[https://www.youtube.com/watch?v=_PH4p4Z9YSo|Simple script tutorial for bhop/surf (skyboxes, terrain, lighting) (Youtube)]]
  *[[https://docs.google.com/document/d/1zNFR_TFEGBaDAMPzVrrD53hYMK-C3BGqb-JMRC8yp4A/edit#heading=h.yoex4xs80bc4|Small collection of lighting presets intended for bhop maps]]