diff --git a/doc/lua/openstarbound.md b/doc/lua/openstarbound.md
index d888e55..432743c 100644
--- a/doc/lua/openstarbound.md
+++ b/doc/lua/openstarbound.md
@@ -302,6 +302,17 @@ Sets the player's mode. **mode** must be either `"casual"`, `"survival"` or `"ha
 
 ---
 
+#### `Color` player.favoriteColor()
+
+Returns the player's favorite color.
+It is used for the beam shown when wiring, placing, and highlighting with beam-tools (Matter Manipulator).
+
+#### `void` player.setFavoriteColor(`Color` color)
+
+Sets the player's favorite color. **color** can have an optional fourth value for transparency.
+
+---
+
 #### `Vec2F` player.aimPosition()
 
 Returns the player's aim position.