Difference between revisions of "Level browser"

From Divinity Engine Wiki
Jump to: navigation, search
(Created page with "center <br /> == Description == <p>The project browser is used for loading and creating projects. Here you can see all existing projects, a...")
 
m (Protected "Level browser" ([Edit=⧼protect-level-larianeditonly⧽] (indefinite) [Move=⧼protect-level-larianeditonly⧽] (indefinite)))
 
(19 intermediate revisions by the same user not shown)
Line 3: Line 3:
  
 
== Description ==
 
== Description ==
<p>The project browser is used for loading and creating projects. Here you can see all existing projects, as well as the different types of new projects you can create.</p>
+
<p>The level browser is used for loading and creating levels. <br />
 +
Here you can see all existing levels, as well as the different types of new levels you can create.</p>
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
|A similar browser exists for opening and creating levels: [[Level browser]]
+
|A similar browser exists for opening and creating projects: [[Project browser]]
 
|-
 
|-
 
|}
 
|}
  
== Existing Projects ==
 
[[File:Projectbrowser-existing-annotated.png]]
 
 
<br />
 
<br />
  
#Go to the "New Project" tab to create a new project
+
== Existing Levels ==
#Filters (text and type) [CTRL + F]
+
<div>
#Recently opened projects (right-click to remove from list)
+
[[File:Levelbrowser-existing-annotated.png]]
 +
</div>
 +
<sub> The existing levels browser with annotated elements </sub>
 +
 
 +
 
 +
#Go to the "New Level" tab to create a new project or open the sandbox level
 +
#Filters (text and inherited levels) [CTRL + F]
 +
#Recently opened levels (right-click to remove from list)
 +
#Navigation bar
 
#Size slider [CTRL + scroll]
 
#Size slider [CTRL + scroll]
#All projects
+
#All levels (right-click to rename/remove a level)
#Info on the currently selected project
+
#Info on the currently selected level
#Editor preferences
+
 
 +
<br />
 +
=== Inherited Levels ===
 +
 
 +
<p>When a project is dependent on another one, it inherits all data from that project. <br />
 +
Thus, in a given project, it is possible to load the levels from all dependent projects. An inherited item is marked with the following icon:
 +
[[File:Inherited.png|30px]]
 +
</p>
 +
 
 +
{| class="wikitable"
 +
|-
 +
|We refer to the available guides for more info on dependencies when creating custom content: [[Larian guides]]
 +
|-
 +
|}
  
=== Editor Preferences ===
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
|The editor preferences button (7) open the preferences window also available via the editor's Options tab. An explanation of the available settings can be found here: [[Editor preferences]]
+
|A more thorough, internal explanation on our system of dependencies can be found here: [[Modding internals]]
 
|-
 
|-
 
|}
 
|}
  
== New Project ==
 
[[File:Projectbrowser-new-annotated.png]]
 
 
<br />
 
<br />
  
#Project type (Adventure or Add-on)
+
=== Level Names ===
#Project Settings
 
 
 
=== Project Type and Settings ===
 
 
 
<p>When creating a new project, there are two types to choose from: Adventure and Add-on. Adventures are full campaigns, like the main story. When creating your own campaign, you are expected to create your own story, or edit an existing one, and do the necessary scripting. Add-ons are (smaller) projects that can be toggled on/off while playing an Adventure. An example would be an add-on that adds 2 new swords to the game. Story (scripting) is not available in add-ons and an add-on is not required to be able to play an adventure.</p>
 
  
<p>Next to the project name, there are two more possible project settings. Both can later be altered in the Project Settings window ([[Project settings]]). Story, Arena and GM (Game Master) define our three game modes that are shipped with the game. Each of them is a project we created internally. Selecting any of them in "Load Data From" means that the new project will be dependent on the selection: it will load data, story,... from this project. In a similar fashion, selecting any in "Target Project For" means that, when someone downloads your published project, it will only be available for use in the game modes you selected.</p>
+
The levels in the above image have 2 names. <br />
 +
One being the name given on creation (f.e. DOS2_Arena_O) and the other being the displayed name in game (f.e. Ravenshaw Mansion). <br />
 +
Such a displayed name is a "translated string" and can be set in the editor's translated string key editor.
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
|We refer to the available guides for more info on creating, publishing and downloading custom content: [[Larian guides]]
+
|More info on the translated string key editor can be found here: [[Translated string key editor]]
 
|-
 
|-
 
|}
 
|}
 +
 +
<br />
 +
 +
=== Level Thumbnails ===
 +
 +
Level thumbnails are not automatically generated. <br />
 +
If you want your level to have a custom thumbnail in the editor, you can add a "thumbnail.png" file in the level's data folder.<br />
 +
The level folder is located in your editor's data folder under: "Data/Mods/YourModName/Levels/YourLevelName/".
 +
 +
<br />
 +
 +
== New Level ==
 +
<div>
 +
[[File:Levelbrowser-new-annotated.png]]
 +
</div>
 +
<sub> The new level browser with annotated elements </sub>
 +
 +
 +
#Level template
 +
#Level settings
 +
 +
<br />
 +
=== Level Templates ===
 +
 +
<p>When creating a new level, there are several templates to choose from: Basic, Empty, Copy, The Sandbox.</p>
 +
*'''Basic''': A simple empty level, with all necessary items to immediately jump into game mode.
 +
*'''Empty''': Nothing. A completely empty canvas.
 +
*'''Copy''': Select another level via the "Copy From" (2) option and create a new level, identical to the selected one.
 +
*'''The Sandbox''': This option does not create a new level, but opens a clean version of The Sandbox. Level changes are not saved in here so you can test things without the need to setup an actual level.
  
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
|A more thorough, internal explanation on our system of different project types and custom content ("mods") can be found here: [[Modding internals]]
+
|For more information on The Sandbox, check here: [[Sandbox]]
 
|-
 
|-
 
|}
 
|}

Latest revision as of 12:47, 2 October 2017

Levelbrowser-overview.png


Description

The level browser is used for loading and creating levels.
Here you can see all existing levels, as well as the different types of new levels you can create.

A similar browser exists for opening and creating projects: Project browser


Existing Levels

Levelbrowser-existing-annotated.png

The existing levels browser with annotated elements


  1. Go to the "New Level" tab to create a new project or open the sandbox level
  2. Filters (text and inherited levels) [CTRL + F]
  3. Recently opened levels (right-click to remove from list)
  4. Navigation bar
  5. Size slider [CTRL + scroll]
  6. All levels (right-click to rename/remove a level)
  7. Info on the currently selected level


Inherited Levels

When a project is dependent on another one, it inherits all data from that project.
Thus, in a given project, it is possible to load the levels from all dependent projects. An inherited item is marked with the following icon: Inherited.png

We refer to the available guides for more info on dependencies when creating custom content: Larian guides
A more thorough, internal explanation on our system of dependencies can be found here: Modding internals


Level Names

The levels in the above image have 2 names.
One being the name given on creation (f.e. DOS2_Arena_O) and the other being the displayed name in game (f.e. Ravenshaw Mansion).
Such a displayed name is a "translated string" and can be set in the editor's translated string key editor.

More info on the translated string key editor can be found here: Translated string key editor


Level Thumbnails

Level thumbnails are not automatically generated.
If you want your level to have a custom thumbnail in the editor, you can add a "thumbnail.png" file in the level's data folder.
The level folder is located in your editor's data folder under: "Data/Mods/YourModName/Levels/YourLevelName/".


New Level

Levelbrowser-new-annotated.png

The new level browser with annotated elements


  1. Level template
  2. Level settings


Level Templates

When creating a new level, there are several templates to choose from: Basic, Empty, Copy, The Sandbox.

  • Basic: A simple empty level, with all necessary items to immediately jump into game mode.
  • Empty: Nothing. A completely empty canvas.
  • Copy: Select another level via the "Copy From" (2) option and create a new level, identical to the selected one.
  • The Sandbox: This option does not create a new level, but opens a clean version of The Sandbox. Level changes are not saved in here so you can test things without the need to setup an actual level.
For more information on The Sandbox, check here: Sandbox