Difference between revisions of "Old Art"

Revision as of 15:39, 13 March 2019

The endorsed library of art and objects.

Tools

Sandbox2

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.

PROTIPS:

• 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.

Setup

Caveat: I assume all info as if the game was installed in "C:\Program Files (x86)\Electronic Arts\Crytek\Crysis Wars". However it is recommended not to do so. Pick a path other than "C:\Program Files (x86)\" to avoid the ever increasing issues when running this game on Win10 and newer operating systems.

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
Besides of that we want to make the Sandbox2 editor accessible via following 4 icons:

The most left one is the game shortcut - i prefer to have it launch for the least time possible to streamline the process of troubleshooting.
This is how we make those shortcuts: 1. find where you installed the game and find the Bin32 and Bin64 folders:

2. Right click and copy the Editor.exe
3. get to the Desktop and right click & paste shortcuts there:

4. right click on the shortcut and select properties:

(I renamed mine SandBox2)
5. Edit the Target line to include the rest of the text as shown in the editor on the above image
6. Apply, close and try run it - make sure no omissions or type errors are present.

Sample code:

"C:\Program Files (x86)\Electronic Arts\Crytek\Crysis Wars\Bin64\Editor.exe" -mod MWLL -root "C:\Users\cest\Documents\My Games\Crysis Wars\MWLL\Editor"

7. Now make a copy of the working shortcut

8. Changing the 64 to 32 or vice versa in the copyed shortcut will provide for both 32 and 64 bit direct Editor access.

there are functions that are accessible only to the 32 bit editor while, the 32bit edotr's GUI is broken and won't work as good as the 64bit one. We use the 32bit shortcut obly for those rare functions and as soon as we save the changes to disk - run the 64bit editor and work on in it.

9. Now make copies of both 64 and 32 bit shortcuts and edit them:
So to omit the -mod MWLL from the target box. leave the remaining -root "..." designation stay, just get rid of the -mod parameter.
This will provide you with direct access to an editor without the MWLL mod overhead - while many things will be missing and/or different, the sole basic terrain forming and ToD functions are just the same - this is for heavy terrain development as the non modded editor is reputable or running smoother and somewhat more stable (Still can't overdo saving and backup)
10. All that is left is to wade to the My Games\... and make a shortcut to the MWLL\Server folder right on the desktop - to streamline deploying an different map to the local server and access to tweaking the various options somewhat quicker.

Art creation

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

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

selecting objects

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.
• Space bar helps highlight the names of the objects - can help pinpoint that one effect or object evading selection.
• Control key allows adding to the selection with left mouse clicks.

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 ([1] key),rotate ([2] key) or scale ([3] 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.

groups

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 [1] 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).

Creating

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.

Concept

The most efficient way to create an map from scratch, I strongly advise, is to lay it out outside of Sandbox2 editor beforehand.

1. 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.
2. Decide of the game type - TC maps can be used for both TC and TSA games, SA are specific to Solaris arena game types.
3. 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).
4. Figure out the setting - DoT lightning - is it warm or cold climate? adjust the shades later accordingly.
5. Does the intended terrain require any special software for terrain shape design?
6. 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

Creation

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 - Folderstructure
• 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
• water
• clouds
• weather
• layers
• vegetation - how to efficiently make vegetation - pitfalls ("flying trees")
• further immersion factors
• effects

Specifics

Game mode specific considerations.

• TC
• TSA
• SA

Terrain_Control_Tutorial_for_Mappers is based on Wilsons Terrain Control Mapping Guide.

MWLL_Flowgraph_Nodes are additional Flowgraph nodes available in Sandbox 2 Editor for crysis

Ancient_demise's 3 hour long map creation video.

Improving

Making (or tweaking) an map with items outside of the present MW:LL asset pool.

Adding Art

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.