This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Basics
Rendering
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Version Control
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Managing Worlds

A world in UNIGINE is a scene that includes a set of different built-in objects with certain parameters. UnigineEditor provides an ability to create new worlds, load or reload existing ones, and save them if any changes are made. You can also adjust various settings for the worlds you create.

See Also#

  • World class to manage worlds via code

Creating a New World#

To create a new world via UnigineEditor:

  1. Click File -> Create New World in the Main Menu, or press CTRL + N.

  2. In the window that opens, specify a name for the new world and choose the target directory within your project.

After that, a new asset is created in the target folder: your_world_name.world - an XML file containing rendering settings of the created world.

Notice
A new world with default sun node will be created. You can keep this node or delete it at your own discretion.

Unlike the world, which is created at the project creation, all other worlds are created without a world script file. If necessary, this file is added as a script to the *.world file via UnigineEditor as follows:

  1. Click the Create button in the Asset Browser and select Create USC. The script.usc file is created. You can rename and relocate the created file.

  2. Select the required *.world file in the Asset Browser.
  3. In the Parameters tab, assign the *.usc that you created as a script.

Loading an Existing World#

To load an existing world via UnigineEditor:

  1. Click File -> Open World in the Main Menu, or press CTRL + O.

  2. Choose the directory and select the required world.
    Notice
    Via UnigineEditor, you can only load worlds that are available within your project.

  3. Click OK. The selected world will be loaded.

To load one of the recently closed worlds, click File -> Recent Worlds in the Main Menu, choose the required world and select it.

Saving a World#

To save the current world under a different name via UnigineEditor:

  1. Click File -> Save World As... in the main menu.

  2. Specify a new name for the world to save and choose the target directory within your project:

  3. Click OK.

To save a world under its current name:

  1. Click File -> Save World in the main menu, or press CTRL + S.

Reloading a World#

To reload the current world:

  1. Click File -> Reload World in the main menu.

    If there are unsaved changes in the world, the dialog box will open.
  2. Click Yes in the dialog box to save all changes before reloading.

Closing a World#

To close the current world:

  1. Click File -> Close World in the main menu.

    If there are unsaved changes in the world, the dialog box will open.
  2. Click Yes in the dialog box to save all changes before closing.

    The world will be closed as a result.

Assigning a Script#

By default, your world is assigned the script, which is created when a new world is created. To assign another script, select the world in the Asset Browser and drag and drop a script to the Parameters Tab:

Adjusting World Settings#

Each world can have its unique sound, physics, and rendering settings. This allows you to adjust everything from gravity to how the Global Illumination will look in a particular world. All world settings are available in the corresponding section of the Settings window.

To view or adjust settings for your current world:

  1. Click Windows -> Settings in the Main Menu.

  2. Then in the left panel of the Settings window choose the desired section from Runtime -> World.

You can save your settings in a corresponding settings file: *.physics, *.sound, *.render and use them for another world or project.

Learn more about the Settings window.

Last update: 2024-08-16
Build: ()