TiMan: Create shared HPL3 Model Editor preferences guide from installed editor configuration and persistence files

2026-10-02T17:34:19Z

Create shared HPL3 Model Editor preferences guide from installed editor configuration and persistence files

New page

The Model Editor's '''Preferences''' window contains application-level settings shared by the Model Editors shipped with SOMA, Amnesia: Rebirth, and Amnesia: The Bunker.

== Preferences window ==

Open '''Preferences''' from the editor menu. The common controls are:

* '''Resolution''': the editor window's width and height.
* '''Undo stack size''': the number of editor actions retained for undo.

A larger undo stack retains more editing history but requires more memory. Resolution is stored as two values, corresponding to the horizontal and vertical window dimensions.

== Configuration files ==

The editor uses several files with separate responsibilities. By default, their home directory is the <code>HPL3</code> folder under the user's documents directory; the actual resolved home directory is printed in <code>ModelEditor.log</code> when the editor starts.

{| class="wikitable"
! File !! Purpose
|-
| <code>MainEditorSettings.cfg</code> || Defines the editor home, temporary, thumbnail, and session directory names. The three shipped games use <code>HPL3</code>, <code>Temp</code>, <code>Thumbnails</code>, and <code>Sessions</code> respectively.
|-
| <code>ModelEditor.prf</code> || Stores Model Editor preference data. A file containing only <code><Preferences /></code> represents no explicitly saved non-default values.
|-
| <code>ModelEditor.cfg</code> || Stores other application state, including screen size, graphics/performance values, and recent entity files.
|-
| <code>ModelEditor.log</code> || Records startup paths, initialized subsystems, loaded resources, warnings, and errors.
|}

These files are not entity assets and should not be distributed as part of an entity. If preferences appear not to persist, close the editor normally and check the home directory reported in the log. A redirected Documents folder can place the files somewhere other than the conventional local Documents path.

== Per-entity state is separate ==

Viewport camera, render, grid, and enlargement state can be saved inside an entity's <code>EditorSession</code>. Those settings belong to the <code>.ent</code> file and are not controlled by the application-level Preferences window. See [[HPL3/Entities/Model Editor Controls|Model Editor Controls]] for the saved viewport fields.

[[Category:English]]

HPL3/Entities/Model Editor Preferences - Revision history

TiMan: Create shared HPL3 Model Editor preferences guide from installed editor configuration and persistence files