Universe Sandbox Wiki
Register
Tag: Visual edit
(Updated gravity button description)
Tag: Visual edit
(34 intermediate revisions by 2 users not shown)
Line 3: Line 3:
 
The UI in Universe Sandbox changes often with updates, so not everything may be exactly as it appears in the latest version.
 
The UI in Universe Sandbox changes often with updates, so not everything may be exactly as it appears in the latest version.
   
  +
[[File:UIMap.jpg|thumb|upright=2|right|The basic user interface of Universe Sandbox, with several features labeled.]]
[[File:User Interface Overview.png|none|thumb]]
 
   
 
==Home==
 
==Home==
  +
[[File:Home Menu.png|left|thumb|The Home menu]]
  +
The Home button can be found in the upper left corner of the screen, and is represented by three horizontal lines. The Home menu contains the following:
   
 
===New===
 
===New===
Create a new, blank simulation.
+
Creates a new, empty simulation.
   
 
This is the first step in building a simulation from scratch. See [[Getting Started]] for more information.
 
This is the first step in building a simulation from scratch. See [[Getting Started]] for more information.
  +
 
===Save & Share===
 
Opens options for saving the current simulation as a custom simulation, or sharing on Steam Workshop. Saved simulations can be found in Home > Open > My Sims.
   
 
===Open===
 
===Open===
Browse a list of included simulations.
+
Opens a list of [[Included Simulations|included simulations]] and saved simulations.
 
===Save===
 
Save the current simulation as a custom simulation. Saved simulations can be found in Home > Open > My Sims.
 
   
 
===Settings===
 
===Settings===
Adjust general game settings, like Graphics settings, Audio settings, and Performance Settings. These settings are global and will persist when a new simulation is loaded. For simulation-specific settings, see View Settings and Sim Settings below.
+
Opens adjustable general [[Game Settings Menu|game settings]], like Graphics settings, Audio settings, and Performance Settings. These settings are global and will persist when a new simulation is loaded. For simulation-specific settings, see View Settings and Sim Settings below.
   
==Bottom Bar==
+
===Guides===
   
  +
Opens a list of [[Guides|guided tutorials and lessons]].
=== Play/Pause Button ===
 
Pause a running simulation or a play a paused simulation. This can also be controlled with the Spacebar on a [[Keyboard Controls|keyboard]].
 
   
=== Date and Time ===
+
===Exit===
This displays the current date and time in the simulation. When clicked, it opens the [[Time Zone]] setting.
 
   
  +
Closes Universe Sandbox.
=== Timer ===
 
Allows the user to run the simulation until a certain time or date, at which point the simulation will pause or change its Time Step.
 
   
=== Step ===
+
===Workshop===
The Step menu contains additional time step settings and controls, including the [[Target Time Step]], and the [[Advance One Time Step]], [[Reload Simulation]], and [[Pause on Collide]] controls.
 
   
  +
Opens a list of simulations created by other users on the Steam Workshop.
===Time Step===
 
   
  +
===What's New===
Displays the simulation [[Time Step]], which can be adjusted using the slider or by entering a value in the text box with the keyboard.
 
   
  +
Shows the What's New information for the most recent update.
===Edit===
 
   
  +
=== Help Translate ===
Allows the user to [[Edit Tool|adjust]] the [[Position Vector|position]], rotation, and [[Velocity Vector|velocity]] of a selected object or objects.
 
   
  +
Shows information about how to help translate Universe Sandbox into other languages. Turning on the Help Translate toggle in this message will add the Translate button to the bottom bar.
===Add===
 
[[Add Tool|Adds]] a new object to the simulation.
 
   
===Tools===
+
===Credits===
Provides access to several tools for manipulating the simulation:
 
   
  +
Opens the Credits page for Universe Sandbox in your internet browser.
* More
 
** Opens the full [[Sim Actions Menu]]
 
* [[Teleport Tool|Teleport]]
 
** Sends the [[camera]] to the selected object
 
* [[Explode Tool|Explode]]
 
** Explodes the selected object, creating a [[supernova]] if the object is a [[star]].
 
* [[Delete Tool|Delete]]
 
** Removes the selected object from the simulation.
 
* [[Force Tool|Force]]
 
** Applies a cone-shaped force extending from the cursor's position.
 
* [[Pulse Tool|Pulse]]
 
** Launches a ring of particles from the position of the selected object.
 
* [[Fireworks Tool|Fireworks]]
 
** Launches fireworks from the selected object.
 
* [[Material Tool|Material]]
 
** Launches a stream of particles from the cursor, made up of a given material.
 
* Launch
 
** [[Add Tool|Adds]] a body to the simulation with the Launch setting.
 
   
===Chart===
+
=== Send Feedback===
   
Rearrange the objects in the simulation to be ordered according to size or mass.
+
Allows the user to send an email to the Universe Sandbox team with comments or bug reports.
  +
===View===
 
  +
===Debug Tools===
  +
  +
Opens additional settings and tools that can help track down bugs and their causes.
  +
  +
===Performance Test===
  +
  +
Runs through a series of simulations to test the user's hardware performance. After the test, provides an options for emailing the test to the Universe Sandbox team.
  +
 
===Help===
  +
 
Opens the Input tab in the Settings menu.
  +
  +
===External Links===
  +
  +
Opens links to the Universe Sandbox Discord, Twitter, and Facebook pages, Steam forum, this wiki, and the Universe Sandbox blog.
  +
  +
===Email Subscription Form===
  +
  +
A textbox where a user can enter their email address and subscribe to email updates.
  +
  +
==Bottom Bar==
  +
[[File:Bottom Bar.png|center|thumb|The bottom bar, including shortcuts for the Add tool (in the center), and the Laser, Photo, and Video tools (on the right)|alt=|720x720px]]
  +
<br />
 
===Play/Pause Button ===
 
Pause a running simulation or a play a paused simulation. This can also be controlled with the Spacebar on a [[Keyboard Controls|keyboard]].
  +
 
=== Time ===
  +
 
This displays the current date and time in the simulation, and the current [[Simulation Speed]]. When clicked, it opens the Time menu with the following options:
  +
  +
*[[Reload Simulation|Restart]]
  +
**Reloads the current simulation
  +
*Reverse Time
 
**Reverses the direction of time in this simulation
  +
* Timer
 
**Allows the user to run the simulation until a certain time or date, at which point the simulation will pause or change its Simulation Speed
  +
*Play/Pause
  +
**Works just like the Play/Pause button on the bottom bar
  +
*[[Advance One Time Step|Step]]
  +
** Pauses the simulation, if unpaused, and moves the simulation forward exactly one time step
  +
*Slower/Faster
  +
**Increases or decreases the simulation speed. These buttons can be clicked or held down.
  +
*[[Target Simulation Speed]]
  +
**The simulation speed that Universe Sandbox will attempt to reach
  +
  +
Clicking the arrow in the upper right will open the Time section of the [[Sim Settings Menu]].
  +
[[File:Sim Menu.png|thumb|The Sim menu, opened by the Sim button on the bottom bar]]
  +
 
===Sim===
 
These settings affect only the currently opened simulation.
 
These settings affect only the currently opened simulation.
   
  +
*Objects
* More
 
** Opens the full [[View Settings Menu]]
+
**The total number of objects in the simulation. Clicking this box will open the full [[Stats Menu]].
 
*Attracting
* Labels
 
 
**The number of [[Attracting]] objects in the simulation. Clicking this box will open the full [[Stats Menu]].
** Toggles object [[Label|labels]] on or off
 
 
*Search
* Trails
 
 
**Displays all objects in the currently opened simulation. Clicking one of the objects in the Search menu will focus the [[camera]] on that object.
** Toggles [[Displayed Trail|displayed trails]] on or off
 
 
*Gravity
* Orbits
 
  +
**Toggles whether or not objects [[Gravity|attract]] each other gravitationally.
** Toggles [[Displayed Orbit|displayed orbits]] on or off
 
 
*Collide
* Habitable
 
 
**Toggles whether or not objects collide. If turned off, objects will pass through each other instead of colliding.
** Displays or hides the [[Habitable Zone|habitable zones]] of [[Star|stars]]
 
 
*Fragment
 
**Toggles creation of fragments, which can be caused by collisions, Roche limit fragmentation, and friction fragmentation from explosions. Also toggles creation of volatiles from extreme heats and solar winds.
  +
*Temperature
  +
**Toggles simulation of temperature changes, including the spread of heat across the surface of an object
  +
  +
Clicking the arrow in the upper right will open the full [[Sim Settings Menu]].
  +
[[File:View Menu.png|thumb|The View menu, opened by the View button on the bottom bar]]
  +
  +
 
===View===
 
These settings affect only the currently opened simulation.
  +
 
*Labels
 
**Toggles object [[Label|labels]] on or off
 
*Trails
 
**Toggles [[Displayed Trail|displayed trails]] on or off
 
*Orbits
 
**Toggles [[Displayed Orbit|displayed orbits]] on or off
 
* Grid
 
* Grid
** Displays or hides the [[Simulation Grid]]
+
**Displays or hides the [[Simulation Grid]]
 
*Habitable
 
**Displays or hides the [[Habitable Zone|habitable zones]] of [[Star|stars]]
  +
* Camera: Overview
 
** Zooms the [[camera]] out to view the entire simulation.
  +
* Camera: Reset
  +
**Returns the camera to its previous position from Overview.
  +
*Modes: Chart
  +
**Rearranges the objects in the simulation to be ordered according to size or mass.
  +
*Modes: Surface Lock
  +
**Enables [[Surface View|Surface Lock]] feature
 
* Background
 
* Background
** Changes the background of the simulation.
+
**Changes the [[background]] of the simulation.
 
*Colors
* Light
 
 
**Changes the colors of objects and their trails, labels, and icons to represent the relative strength of velocity, acceleration, or mass compared with other objects in the simulation.
  +
*Lighting
 
** Changes the [[lighting]] of the simulation.
 
** Changes the [[lighting]] of the simulation.
 
*Object Visibility
* Colors
 
  +
**Toggles between Always, which ensures that all objects are visibly onscreen, and Realistic, which realistically simulates the visibility of objects given their distance, size, and brightness.
** Changes the colors of objects and their trails, labels, and icons to represent the relative strength of velocity, acceleration, or mass compared with other objects in the simulation.
 
   
  +
Clicking the arrow in the upper right will open the full [[View Settings Menu]].
===Sim===
 
  +
[[File:Tools Menu.png|thumb|The Tools menu, opened with the Tools button on the bottom bar]]
These settings affect only the currently opened simulation.
 
   
 
=== Tools===
* More
 
 
Provides access to several tools for manipulating the simulation:
** Opens the full [[Sim Settings Menu]]
 
* Collide
 
** Toggles whether or not objects collide. If turned off, objects will pass through each other instead of colliding.
 
* Fragment
 
** Toggles creation of fragments, which can be caused by collisions, Roche limit fragmentation, and friction fragmentation from explosions. Also toggles creation of volatiles from extreme heats and solar winds.
 
* Gravity
 
** Changes the strength of the [[Gravitational Constant]].
 
   
  +
*Create
===Stats===
 
 
** [[Add Tool|Add]]
Displays statistics about the currently opened simulation:
 
 
*** Adds a new object to the simulation.
* Object Count
 
 
**[[Material Tool|Material]]
** The total number of objects in the simulation
 
 
***Launches a stream of particles from the cursor, made up of a given material.
* Simulated
 
 
**[[Pulse Tool|Pulse]]
** The number of objects being actively simulated
 
 
***Launches a ring of particles from the position of the selected object.
* Non-Simulated
 
 
**[[Fireworks Tool|Fireworks]]
** The number of suspended objects not being actively simulated
 
 
***Launches fireworks from the selected object.
* Attracting
 
  +
*Modify
** The number of [[attracting]] objects exerting a [[Gravity|gravitational]] force
 
  +
**[[Transform Tool|Transform]]
* Non-Attracting
 
 
***Adjusts the [[Position Vector|position]], rotation, and [[Velocity Vector|velocity]] of a selected object or objects.
** The number of objects not exerting a gravitational force
 
 
**[[Delete Tool|Delete]]
* Decals
 
** The number of impact decals used in the simulation
+
***Removes the selected object from the simulation.
  +
**[[Planetscaping Tool|Planetscaping]]
* Star Count
 
  +
***Directly edits the an object's [[Surface Simulation|surface]] properties.
** The number of [[Star]] objects in the simulation
 
* Mass
 
** The total [[mass]] of all objects in the simulation
 
* Velocity
 
** The magnitude of the sum of the [[Velocity Vector|Velocity Vectors]] of all objects in the simulation
 
* Momentum
 
** The magnitude of the sum of the [[Momentum|Momentum Vectors]] of all objects in the simulation
 
* Mass Lost
 
** The total amount of mass lost to the simulator during the simulation
 
* Momentum Lost
 
** The total amount of momentum lost to the simulator during the simulation
 
   
  +
*Navigation
===Search===
 
  +
**[[Fly Tool|Fly]]
Displays all objects in the currently opened simulation. Clicking one of the objects in the Search menu will focus the [[camera]] on that object.
 
 
***Sends the [[camera]] to the selected object.
  +
**Search
 
***Shows a list of objects in the simulation.
  +
*Powers
  +
**[[Laser Tool|Laser]]
  +
***Fires a laser from the cursor, forward from the camera.
 
**[[Explode Tool|Explode]]
 
***Explodes the selected object, creating a [[supernova]] if the object is a [[star]].
 
**[[Force Tool|Force]]
  +
***Applies a force to spin or push an object.
  +
*Capture
  +
**[[Photo Tool|Photo]]
  +
***Captures a still screenshot.
  +
**[[Video Tool|Video]]
  +
*** Captures an animated gif screenshot.
   
  +
Any of the tool icons can be dragged down to the bottom bar as shortcuts. Clicking any tool icons will make the tool active and open the related tool settings menu.
Objects are sorted into tabs according to their [[Object Types|object types]], including [[Star|Stars]], [[Planet|Planets]], [[Moon|Moons]], [[Solar System Object|Minor]], [[Human-Scale Object|Misc]], [[Galaxy|Galaxies]], and [[Black Hole|Black Holes]]. There is a text box for searching all simulation objects by [[name]].
 
   
  +
Clicking the arrow in the upper right will open the full [[Tools Menu|Tools]] menu.
===Video===
 
   
  +
===Translate===
Tools and settings for capturing video.
 
 
===Photo===
 
Tools and settings for taking screenshots.
 
   
  +
If the Help Translate toggle is on (see [[Interface#Help Translate|Help Translate]] in the [[Interface#Home|Home]] menu), this icon will appear on the far right of the bottom bar. When clicked, all text in the user interface will be color-coded based on whether translation of that text is possible. When a piece of text is clicked, the related CrowdIn page will open in an internet browser, to allow for crowd-sourced translation. Pressing F2 on the [[Keyboard Controls|keyboard]] will also toggle this translation mode on and off.
   
 
==Object Properties Panel==
 
==Object Properties Panel==
  +
[[File:Properties Panel.png|thumb|right|The Earth's properties panel, with the View Panel at the top displaying a live image of the Earth in the simulation, and the Overview tab selected below]]
Right-clicking an object in the simulation will open the object's properties panel, which will include one or more tabs displaying properties specific to that object. These tabs can include:
 
  +
Right-clicking an object in the simulation or clicking its mini-info panel will open the object's properties panel, which will display a variety of data about the object. At the top of the properties panel, the object's [[View Panel]] will display a preview of the object, a cutaway diagram of the object's [[Materials|composition]], and the object's [[Surface Simulation|surface properties]], if available. Below the View Panel, one or more tabs will display the object's properties. These tabs can include:
 
*[[Overview Tab|Overview]]
 
*[[Overview Tab|Overview]]
 
*[[Motion Tab|Motion]]
 
*[[Motion Tab|Motion]]
*[[Composition Tab|Composition]]
+
*[[Surface Tab|Surface]]
 
*[[Temperature Tab|Temperature]]
 
*[[Temperature Tab|Temperature]]
*[[Climate Tab|Climate]]
+
*[[Composition Tab|Composition]]
  +
*[[Appearance Tab|Appearance]]
 
*[[Actions Tab|Actions]]
 
*[[Actions Tab|Actions]]
 
*[[Galaxy Tab|Galaxy]]
 
*[[Galaxy Tab|Galaxy]]
Line 157: Line 214:
 
*[[Nova Tab|Nova]]
 
*[[Nova Tab|Nova]]
 
*[[Barycenter Tab|Barycenter]]
 
*[[Barycenter Tab|Barycenter]]
  +
 
[[Category:Basics]]
 
[[Category:Basics]]

Revision as of 22:09, 23 June 2022

This page is an overview of the user interface (UI) in Universe Sandbox. It is meant to describe the general purposes of different parts of the UI and help in finding different settings and controls.

The UI in Universe Sandbox changes often with updates, so not everything may be exactly as it appears in the latest version.

UIMap

The basic user interface of Universe Sandbox, with several features labeled.

Home

Home Menu

The Home menu

The Home button can be found in the upper left corner of the screen, and is represented by three horizontal lines. The Home menu contains the following:

New

Creates a new, empty simulation.

This is the first step in building a simulation from scratch. See Getting Started for more information.

Save & Share

Opens options for saving the current simulation as a custom simulation, or sharing on Steam Workshop. Saved simulations can be found in Home > Open > My Sims.

Open

Opens a list of included simulations and saved simulations.

Settings

Opens adjustable general game settings, like Graphics settings, Audio settings, and Performance Settings. These settings are global and will persist when a new simulation is loaded. For simulation-specific settings, see View Settings and Sim Settings below.

Guides

Opens a list of guided tutorials and lessons.

Exit

Closes Universe Sandbox.

Workshop

Opens a list of simulations created by other users on the Steam Workshop.

What's New

Shows the What's New information for the most recent update.

Help Translate

Shows information about how to help translate Universe Sandbox into other languages. Turning on the Help Translate toggle in this message will add the Translate button to the bottom bar.

Credits

Opens the Credits page for Universe Sandbox in your internet browser.

Send Feedback

Allows the user to send an email to the Universe Sandbox team with comments or bug reports.

Debug Tools

Opens additional settings and tools that can help track down bugs and their causes.

Performance Test

Runs through a series of simulations to test the user's hardware performance. After the test, provides an options for emailing the test to the Universe Sandbox team.

Help

Opens the Input tab in the Settings menu.

External Links

Opens links to the Universe Sandbox Discord, Twitter, and Facebook pages, Steam forum, this wiki, and the Universe Sandbox blog.

Email Subscription Form

A textbox where a user can enter their email address and subscribe to email updates.

Bottom Bar

Bottom Bar

The bottom bar, including shortcuts for the Add tool (in the center), and the Laser, Photo, and Video tools (on the right)


Play/Pause Button

Pause a running simulation or a play a paused simulation. This can also be controlled with the Spacebar on a keyboard.

Time

This displays the current date and time in the simulation, and the current Simulation Speed. When clicked, it opens the Time menu with the following options:

  • Restart
    • Reloads the current simulation
  • Reverse Time
    • Reverses the direction of time in this simulation
  • Timer
    • Allows the user to run the simulation until a certain time or date, at which point the simulation will pause or change its Simulation Speed
  • Play/Pause
    • Works just like the Play/Pause button on the bottom bar
  • Step
    • Pauses the simulation, if unpaused, and moves the simulation forward exactly one time step
  • Slower/Faster
    • Increases or decreases the simulation speed. These buttons can be clicked or held down.
  • Target Simulation Speed
    • The simulation speed that Universe Sandbox will attempt to reach

Clicking the arrow in the upper right will open the Time section of the Sim Settings Menu.

Sim Menu

The Sim menu, opened by the Sim button on the bottom bar

Sim

These settings affect only the currently opened simulation.

  • Objects
    • The total number of objects in the simulation. Clicking this box will open the full Stats Menu.
  • Attracting
    • The number of Attracting objects in the simulation. Clicking this box will open the full Stats Menu.
  • Search
    • Displays all objects in the currently opened simulation. Clicking one of the objects in the Search menu will focus the camera on that object.
  • Gravity
    • Toggles whether or not objects attract each other gravitationally.
  • Collide
    • Toggles whether or not objects collide. If turned off, objects will pass through each other instead of colliding.
  • Fragment
    • Toggles creation of fragments, which can be caused by collisions, Roche limit fragmentation, and friction fragmentation from explosions. Also toggles creation of volatiles from extreme heats and solar winds.
  • Temperature
    • Toggles simulation of temperature changes, including the spread of heat across the surface of an object

Clicking the arrow in the upper right will open the full Sim Settings Menu.

View Menu

The View menu, opened by the View button on the bottom bar


View

These settings affect only the currently opened simulation.

  • Labels
    • Toggles object labels on or off
  • Trails
  • Orbits
  • Grid
  • Habitable
  • Camera: Overview
    • Zooms the camera out to view the entire simulation.
  • Camera: Reset
    • Returns the camera to its previous position from Overview.
  • Modes: Chart
    • Rearranges the objects in the simulation to be ordered according to size or mass.
  • Modes: Surface Lock
  • Background
  • Colors
    • Changes the colors of objects and their trails, labels, and icons to represent the relative strength of velocity, acceleration, or mass compared with other objects in the simulation.
  • Lighting
  • Object Visibility
    • Toggles between Always, which ensures that all objects are visibly onscreen, and Realistic, which realistically simulates the visibility of objects given their distance, size, and brightness.

Clicking the arrow in the upper right will open the full View Settings Menu.

Tools Menu

The Tools menu, opened with the Tools button on the bottom bar

Tools

Provides access to several tools for manipulating the simulation:

  • Create
    • Add
      • Adds a new object to the simulation.
    • Material
      • Launches a stream of particles from the cursor, made up of a given material.
    • Pulse
      • Launches a ring of particles from the position of the selected object.
    • Fireworks
      • Launches fireworks from the selected object.
  • Modify
  • Navigation
    • Fly
      • Sends the camera to the selected object.
    • Search
      • Shows a list of objects in the simulation.
  • Powers
    • Laser
      • Fires a laser from the cursor, forward from the camera.
    • Explode
      • Explodes the selected object, creating a supernova if the object is a star.
    • Force
      • Applies a force to spin or push an object.
  • Capture
    • Photo
      • Captures a still screenshot.
    • Video
      • Captures an animated gif screenshot.

Any of the tool icons can be dragged down to the bottom bar as shortcuts. Clicking any tool icons will make the tool active and open the related tool settings menu.

Clicking the arrow in the upper right will open the full Tools menu.

Translate

If the Help Translate toggle is on (see Help Translate in the Home menu), this icon will appear on the far right of the bottom bar. When clicked, all text in the user interface will be color-coded based on whether translation of that text is possible. When a piece of text is clicked, the related CrowdIn page will open in an internet browser, to allow for crowd-sourced translation. Pressing F2 on the keyboard will also toggle this translation mode on and off.

Object Properties Panel

Properties Panel

The Earth's properties panel, with the View Panel at the top displaying a live image of the Earth in the simulation, and the Overview tab selected below

Right-clicking an object in the simulation or clicking its mini-info panel will open the object's properties panel, which will display a variety of data about the object. At the top of the properties panel, the object's View Panel will display a preview of the object, a cutaway diagram of the object's composition, and the object's surface properties, if available. Below the View Panel, one or more tabs will display the object's properties. These tabs can include: