The endorsed library of art and objects.
- 1 Tools
- 2 Setup
- 3 Art creation
- 3.1 Tweaking
- 3.1.1 starting the editor
- 3.1.2 moving in the editor by the mouse and keyboard
- 3.1.3 entering the game mode
- 3.1.4 saving the map
- 3.1.5 selecting objects
- 3.1.6 modes and constrains (steps) of transformation
- 3.1.7 prefabs - usage and processing
- 3.1.8 groups
- 3.1.9 modification/editing of the cgf (3d art) files
- 3.1.10 adding new brushes or entities to the map
- 3.1.11 changing present objects 3d art
- 3.1.12 the material editor
- 3.1.13 materials - effects and options
- 3.1.14 database editor - editing archetypes of entities
- 3.1.15 entities - editing individual entities
- 3.1.16 special entities - doors, elevators
- 3.2 Creating
- 3.3 Improving
- 3.4 Adding Art
- 3.1 Tweaking
The editor of the game levels, we call maps. Besides the editor itself, there are external programs that ease some steps in creating the map. Most notably creating an terrain, or calculating the time of day light effect (ToD)
NOTE: the Sandbox2 editor was never intended to be used without underlying version control software preserving the progress of the map creation
NOTE: Map creation by the means of Sandbox2 was never conceived to be performed by an lone individual. This alone might be the reason why some portions of the work pipe might seem overwhelming and too arduous.
Quite few of the artists are known to have taken an longer hiatus even before an map got finished, let alone after. It is quite a lot of work and quite an palette of skill to master - so prepare to take the time, if you want to do it proper.
- Save your map often and create backups! This is critical in case your working version becomes corrupted.
- Plan your maps before you actually begin making them. Have a good idea of how the map will flow, that is, how players are likely to interact with the terrain, buildings and/or capture zones you intend to place. You may want to run your draft map/terrain past other players to help refine your design.
- Make sure the path of the editor shortcut you use ends with the command switch -mod mwll, otherwise it will not work properly. Place this switch at the end of the file the shortcut points to.
- Most heightmaps are generated as 4096 x 4096 units in size, using a scaling of 2 meters per unit.
- Hold down the right mouse button to rotate the camera on spot. Holding down the middle mouse button lets you slide the camera side to side & up and down. Holding both the middle & right mouse buttons enables you to zoom in and out. You can also use the scroll wheel for finer control and the Speed value near the bottom of the Sandbox UI changes the sensitivity of camera movement.
- To load MWLL's prefabs into the editor, go to View > Open View Pane > Database View, click the Prefab Library tab and locate mwll_assets.xml. They will then appear under the Prefab section on the right-hand pane.
Since the new launcher is in service, the Sanbox2 is part of each installation. The various tools have each it's separate requirements and/or quirks
Being wast as it is, the Sanbox2 database of assets and items isn't a thing that can be glanced over in a day or even a week. It is recommended to take few steps at a time, not to overwhelm one self with it.
Tweaking an existing map that actually has the source files present. Useful to grasp the editor and its basic concepts.
starting the editor
Nothing much to it, launcher or direct shortcut, make it handy as practical - You will use it quite often.
moving in the editor by the mouse and keyboard
Find how the modifiers (shift, alt and control keys) affect the mouse motion and effect with the various mouse buttons pressed or rolled.
entering the game mode
Besides the editor mode, there is a game mode accessible by the [Ctrl]+[g] combo. It can be exited by pressing the [esc] key. While some of the functionality of the multiplayer mode might be absent, the engine closely resembles the physics (to a degree) and looks of the actual game. To ascertain all features beyond any doubt, however, the mapper is advised to fire up the server, load the map and access it with the client - the full game.
saving the map
For some reason or the other, the instant I save the map, or modify any file of it's folder (materials) the editor locks up while entering the game mode.
Note, tho, that one must not restart the editor if not intending to enter the game mode - just edit and save as usual. One can't overdo saving. Over time I just got used to just, save-exit-relaunch->game mode. YMMV
Maps can have quite many objects that might be impossible to point to at times.
Selecting could become a nightmare if there where no alternative options.
- Use Layers to separate objects by purpose - one can change if the map is TC or TSA - quickly, and export it ([Ctrl]+[e]) to the engine.
- Use Groups to join objects into functional entities (houses, facilities, vehicles, buildings, factories) or sub-entities.
- As well as the group can be undone (un-group) or opened/closed to make objects accessible within, they can be edited (closed or not) by attaching or detaching an member too.
- there is the selection editor,accessible by [Ctrl]+[t], that can help pinpoint that one deeply nested part, that otherwise can't be brought to highlight under the cursor - a reason more to give objects names that both make sense and partake in the overall hierarchy of the level.
As much as one keeps the level structured - the more easy will he work as the complexity increases and progresses.
Selections are part of the undo system
modes and constrains (steps) of transformation
Each select object can be subject to spatial transformation, one can - move ( key),rotate ( key) or scale ( key) the object. It can be done by entering numerical values on the bottom line of the editor, or by pulling the gimball with the mouse - single, pair or all three axis.
The change can be smooth or incremental - the increments are right next to the transform icons.
prefabs - usage and processing
Prefabs are groups that became endorsed to the distribution. Like the Main Hanger for example. Putting a prefab into an map ensures it will be automatically updated as the game develops - without the need to make any changes to the map.
Prefabs that are made in the editor will be located in the <root>/Game directory, like many other stuff, yet belong to the Mods\MWLL\Game\ once they are endorsed.
Besides saving an layer, the editor supports saving a group as well.
Once saved, the group can be copied to any map folder at will and loaded into that map. The only rule for the transfer to work are the file dependencies - each file referenced has to be accessible on the receiving side. One might consider moving the non endorsed files along with the group file - and just change the references, in the editor or directly in the file to point to the newly made copies instead. If the files referenced in the group are endorsed, no such precautions are necessary.
modification/editing of the cgf (3d art) files
The editor seems to support editing the intimate geometry of the imported *.cgf file. I am uncertain if it works as intended and if it can be exported to work any good.
adding new brushes or entities to the map
To add a brush, one has simply to click the brush button on the roll-up tab, select one from the library tree, and drag it to the map view port. After some goofing and experience, the artist will become quite skilled at doing this.
If the freshly placed entity can't be moved or adjusted - just press the  key, to enable move translation, and try on.
Placing an entity is the same, except that some entities are lacking the model assigned to them - they get placed empty on the map. Moreover, the editor seems lacking the ability to assign the proper concept to some - once placed on the map, like the particle entity.
To add particle effect, either copy & paste to the empty entity, or use the DB manager and place it from there.
changing present objects 3d art
Once an brush object has been placed into the map, it will be seen as it's assigned 3d art (the *.cgf file). One can change the file the object points to and this will immediately change its appearance on the map.
Sometimes it is easier to change the 3d art reference, than to get an different brush from the roll-up tab.
the material editor
Each 3d object in the engine can have some material assigned to it. The object has to have UV maps by it self, that is the only prerequisite. Each object can be explored with the eyedropper tool of the materials tab. Further, there are icons to assign, get or remove materials from the selected object.
If the engine finds a *.mtl file with the same name as the *.cgf file, it will try apply the materials within to the 3d art. Only the number of material slots and the order in both files determine which material gets which slot.
The material editor directly affects the *.mtl file and writes into it immediately as the fields are edited. Without an *.mtl file, the 3d art will have sooth black surface.
materials - effects and options
/TODO/ the many effects of the material surfaces
The C8 bug seems can be circumvented by using mat_water as the material of the moving rigid body. The side effect is that the surface obviously becomes splashy and odd.
database editor - editing archetypes of entities
Therefrom the artist can add new libraries to the level, like some custom turrets, particle effects (heat haze, explosions...). Especially fire and explosions are of interest.
entities - editing individual entities
Besides the motionless brushes and solids, the multiplayer game can reliably support other more complex entities. Among those are MWLL destructible entities and the RigidBodyEx.
special entities - doors, elevators
Many of those work in the editor's game mode,but are broken in one way or the other in the multiplayer game - either by being affected by an nasty bug (C8 grenade impact) or by the nasty lag/lack of sync (elevators).
Those, set up to create a new map, usually have found that there is no terrain fit for the idea. Or time of day lightning (ToD). Or the general setting of the map in question is too different.
The most efficient way to create an map from scratch, I strongly advise, is to lay it out outside of Sandbox2 editor beforehand.
- Have the size determined first, usually MW:LL maps are 8km x 8km defined as 4096px x 4096px height maps. Some maps have "natural limits" that occlude the "outer world" from the player, such maps can be constrained to the actual play area size. Others, "wide open" maps, are best created double the size and the "outer world" is obscured by "distance fog", distant mountains (or slopes), or the like.
- Decide of the game type - TC maps can be used for both TC and TSA games, SA are specific to Solaris arena game types.
- Figure out the game flow - how the match should flow, how the game will develop as the players progress with their spawn funds (and maybe more join or some leave towards the end of the match).
- Figure out the setting - DoT lightning - is it warm or cold climate? adjust the shades later accordingly.
- Does the intended terrain require any special software for terrain shape design?
- Avoid any too fancy mechanic outside the player interaction - flowgraphs usually get out of sync player-to-player and usually subtract from the immersion rather than add to it. Proper events are hard to implement properly. If it can't be avoided, go to all necessary lengths to troubleshoot it and weed out any oddities before ending the map development
After all those are defined and known in advance, one can approach the process of starting an creation from scratch.
- starting from an empty map - folder structure
- creating the initial basic terrain outside the editor - ASCII *.PNM file the Sandbox2 editor understands
- fine tuning the terrain in the editor - the tools and tips
- setting the ToD - quirks and tips - export the file and tune it by hand
- vegetation - how to efficiently make vegetation - pitfalls ("flying trees")
- further immersion factors
Game mode specific considerations.
MWLL_Flowgraph_Nodes are additional Flowgraph nodes available in Sandbox 2 Editor for crysis
Ancient_demise's 3 hour long map creation video.
Making (or tweaking) an map with items outside of the present MW:LL asset pool.
Making art and assets not currently present in MW:LL and importing them into the Sandbox2 and further to the MW:LL pool. For further information, refer to not yet endorsed art.