How to detect docking has occured on active vessel

[FreeThinker]

I used to think that OnStart was called after docking, but this turned out to be incorrect.

Now the question is, how to detect, docking has occurred with another vessel?

I need it in order to reinitialize some vessel specific variables.

Edited September 11, 2015 by FreeThinker

[MrHappyFace]

There is a docking event in the GameEvents class, it's something like GameEvents.onVesselDocked. There is probably also an undock event too, but I'm not sure.

[FreeThinker]

Interesting, how or where can I access this game event?

[EladDv]

gameevents.onvesseldocked() is the method

[MrHappyFace]

It's not a method, it's a static EventData object, found in the GameEvents class. Simply call GameEvents.onVesselDocked.Add(method) to subscribe to it, and GameEvents.onVesselDocked.Remove(method) to unsubscribe.

Example:

[KSPAddon(KSPAddon.Startup.Flight, false)]
public class GameEventSubscriber : MonoBehaviour
{
                void Start()
		{
			GameEvents.onHideUI.Add (OnHideUI);
		}
                void OnDestroy()
                {
                        //this part is important too!
                        GameEvents.onHideUI.Remove(OnHideUI);
                }


		void OnHideUI()
		{
			Debug.Log("OnHideUI");
		}
}

Unsubscribing, by calling event.Remove is important, becausde if you don't then the same method could build up, and you'd have many calls of the same method for the same event.