Construction Set Extender⚓︎
The Construction Set Extender, also known as CSSE, is a project that aims to improve the functionality of the TES Construction Set. This page serves to document the project.
For a list of recent changes, visit the CSSE project folder commit history.
This project also improves Morrowind's execution. Read more about fixes and features for the core game on the patches page.
CSSE requires MGE XE v0.14.3 (released July 29, 2022) or later in order to be automatically loaded into the Construction Set.
If using OpenMW, you will still need to install MGE XE into your Morrowind installation directory (the same directory that you launch the Construction Set).
You can obtain the CSSE using one of the following methods:
MGE XE includes the MWSE-Update program. This program will download the latest CSSE file (as well as the latest MWSE) into your Morrowind installation directory.
To get CSSE with this method, simply run the program and follow any prompts that may be displayed (such as closing the Construction Set). It may only open briefly, in which case you are likely already up-to-date. The updater won't download the file if you already have the latest version.
The same download can be found on the Automated Build release on GitHub. You can download the mwse.zip file, which contains both MWSE and CSSE.
Once you have the zip file downloaded, extract its contents to the Morrowind installation directory. Both CSSE.dll and TES Construction Set.exe must reside in the same directory.
If you are strictly an OpenMW user but also a TES Construction Set user, you need only extract the CSSE.dll file into your Morrowind directory. However, for testing in the vanilla engine you should still have the Morrowind Code Patch and MWSE installed. MWSE offers various patches and other features to help make the original engine faster and more stable, in the same way that CSSE does for the Construction Set.
If you are using Construction Set Better UI, CSSE will not automatically load. To get CSSE to work with Better UI, you will need to rename the Better UI executable to "TES Construction Set" and replace the existing vanilla CS file. Be sure to back the original up first!
Prefer to learn from videos? Danae has made a non-exhaustive summary video of the CSSE, last updated May 5th, 2023.
- General optimizations to UI rendering. Status updates are throttled to only update once every 20ms, which drastically improves load times.
- The following warnings will no longer or only conditionally create popup windows, but will still be written to Warnings.txt:
- "Following string is different for topic" and "Previous string is different for topic" are suppressed entirely.
- The "1 duplicate references were removed" from loading Tribunal and Bloodmoon will no longer make a popup. If this is not the vanilla duplicate reference, or if there is more than one duplicate reference, a popup will still be shown.
- Fixed GMST pollution bug caused when not loading Tribunal and Bloodmoon.
- A QuickStart feature. In the render window, use the context menu (Q) to save the currently loaded plugins, the active plugin, current cell, camera position, camera orientation. Whenever the CS is loaded with no other plugin loading, it will automatically load all the saved plugins, and load the cell with the viewport saved. This can be cleared or disabled. This can be done with no active loaded cell if you do not want to automatically load a cell on startup.
- The CS will no longer adopt a working directory externally. This means that when opening esm/esp files from the Data Files folder from double clicking it, the Morrowind.ini file and all other configs/logs will correctly load from the root Morrowind folder.
- Loading an active file without manually loading its masters will no longer lead to a potential crash.
- Opening the Construction Set through Mod Organizer 2 is no longer slowed by the number of active MO2 mod folders.
- The NetImmerse NiLinesData structure loads correctly.
- Symbolically linked files now list and load correctly.
Testing from the Construction Set⚓︎
Both Morrowind and OpenMW can be launched from the CS with a specified environment. Two new buttons have been added to the toolbar, the first with Morrowind's icon, and the second with OpenMW's icon.
When one of these buttons is clicked, the appropriate game launches with only the active plugins loaded in the Construction Set loading. Instead of seeing the main menu, you will be loaded to a specified position with a mostly fresh character.
To change the starting location, use the Render Window's quick menu. You can click on a reference and test at its position (e.g. where a door marker is, or on a carpet) or at the camera position.
The OpenMW icon will only display if a valid OpenMW installation directory has been provided. This must be entered into the csse.toml file:
[openmw] location = "D:\\Games\\OpenMW"
Because of the implementation of the OpenMW support, a custom config directory is used. This means user settings such as resolution must be reconfigured the first time the game is run from this environment.
Developers can customize the starting environment of the test character to test changes in quests. This can be done by editing the csse.toml file to specify items, spells, topics, quest states, and global variable values they want to use. Below is an example environment that gives the player a relatively fresh start with some experience in the Mages' Guild:
[test_environment] spells = ["fireball","mark","recall","levitate"] topics = ["duties", "advancement", "latest rumors", "little secret"] [test_environment.inventory] "iron dagger" = 1 ingred_gold_kanet_01 = 3 ingred_stoneflower_petals_01 = 4 ingred_willow_anther_01 = 2 ingred_heather_01 = 4 gold_001 = 5000 [test_environment.journal] MG_Flowers = 10 MG_Sabotage = 100 MG_BCShrooms = 100 [test_environment.globals] chargenstate = -1.0
- Significantly improved UI responsiveness.
- The tab style has been changed to be more button-like. This prevents tabs from moving around.
- Added a footer to the window, with a new filter input. This input can be focused by using CTRL+F while the Object Window is active. This can be used to filter objects by a matching id, name, icon, model, enchantment, script, or book text fragments.
- Regex search options and case-sensitive search options can be enabled in the config file.
- The footer also supports a toggle button to only show modified objects.
- The data rendering and behavior has been completely rewritten. Strings and alignment is more consistent. New columns can be added.
- A new modified column is displayed, showing if the object is modified. This can be sorted on.
- Fixed issue where box selection in the object window would cause the mouse to snap to the edge of the screen.
- Modified objects are highlighted with a light green background.
- Deleted objects are highlighted with a light red background.
- The spell list lists the range of the spell.
Actor Editing Windows⚓︎
- The AI window opens more quickly.
- Clicking on the return button in the AI window when no cell has been loaded no longer crashes the CS.
- Optimized UI. Changing between INFOs should be nearly instantaneous. Initial dialogue load time reduced by 60%.
- Condition variable lists will now always be wide enough to fit the convents. Journals, locals, and items will no longer have their IDs cut off.
- Modified topics/INFOs are highlighted green. Deleted topics/INFOs are highlighted red.
- The window can be filtered to only show modified data.
- The window can now be resized and maximized.
- Layout changes:
- The sex condition is now under the race condition, instead of above the function/variable list. It is not hidden (but is disabled) when viewing journal dialogues.
- The journal conditions (name/finished/restart) are shown but disabled for other dialogue types.
- The general UI has minor other position layout changes.
- Select all control (Ctrl+A) now functions in the edit boxes.
- The window will remember the user preferences for column widths, as well as the overall window size.
- Conditional columns display the value being compared against to make it easier at a glance what the INFO requires.
- Clicking or otherwise interacting with skinned objects, such as NPCs, no longer consumes the mouse. It is now easier to click on objects near actors.
- Reference rotation is now performed on the world axis, rather than the local axis. To rotate on the local axis as it worked in vanilla, hold the alt key.
- Dropping a reference (using the F key) is more reliable and accurate. It works on skinned references as well.
- References can be group-scaled. By holding the alt key when scaling, all selected references will scale together and reposition accordingly.
- Reference moving will follow the cursor, instead of using the movement scale. This can be disabled in the settings window.
- Camera panning will anchor to be relative to the object under the cursor, instead of moving at a fixed rate. This can be disabled in the settings window.
- References can be moved onto surfaces. By holding the alt key when drag-moving a reference, it will rotate and snap onto the surface under the cursor. The context menu (Q) can be used to set the axis to snap to.
- Extended editor marker support. Toggling markers (M) will now also toggle markers supported by the game executable. This allows custom markers to be toggled by tagging them with a MRK string and adding a EditorMarker node, or by defining objects whose name begins with or matches "Tri EditorMarker".
- A new context menu is available, using the Q key. From it you can access some new features:
- Set the snap axis when alt-drag-moving references.
- Toggle between world axis or local axis rotations by default.
- Hide selected references, culling them from the scene so you can work behind them.
- Restore hidden references, restoring to view any references hidden with the hide selection option.
- Set or clear the QuickStart data from the current render window perspective.
- Set the testing environment to use the selected reference position/rotation or that of the camera.
- Hide landscape.
- The field of view (FOV) and antialiasing (multisamples) can be overwritten in the config file.
- The update rate of the render window can be changed from the default of 25 FPS. By default it now runs at (up to) 60 FPS.
- Fixed an issue with bound calculations. Any bound-related functions, such as focusing the camera (C or T keys) on a light will never send the camera into the stratosphere.
The following changes to the rendering window apply when landscape editing:
Skeys can now be used to enter flatten and smooth vertices modes.
]keys can be used to decrement/increment the terrain editing radius.
- The terrain editing disc is no longer hidden when hiding objects (Shift+C).
- You can use control+right mouse button to sample the texture at the cursor's position. This will select the matching texture under the cursor automatically in the landscape editing menu.
Search & Replace Window⚓︎
- Optimized performance of initial display by 80% (e.g. 1.9 seconds instead of 9.7 seconds).
Text Search Window⚓︎
- Elements may now be double clicked to open the relevant edit window. The right context will be shown, if applicable. For example, a faction will be automatically selected, or a particular INFO record will be displayed.
- Full searches work correctly on long text, such as script or book text.
- Searches can be performed with regex, or made case-sensitive through the settings window.
- Significantly improved UI responsiveness.