Skip to content

XCOM Map Workshop 0.5.0 (preview)

Choose a tag to compare

@ruskyandrei ruskyandrei released this 13 Nov 21:44
· 633 commits to main since this release

An early preview: see the README for what you need and the user guide (in the release) for how it works.

Download XCOM-Map-Workshop-0.5.0-Setup.exe (recommended) or the zip. Windows SmartScreen may say "Windows protected your PC" because the installer isn't signed: choose More info, then Run anyway.

Upgrading from 0.4.1: install over it. Your projects, builds and the maps you installed in the game are kept. Two things happen by themselves:

  • Each map is read from the game again the first time you open it (about half a minute), because the editor now takes more from each map: its buildings, its landing zones, its storeys. The page says "Map schema updated. Re-exporting." and carries on.
  • Old copies of opened maps are deleted when the editor starts, and after each map it reads again, keeping only the newest of each map. Here that freed 11 GB of 14. Projects saved on an older copy build from the newest one, and saving a project moves it onto the copy it was edited on.
  • Old build work folders are cleared by the first Build. Each project keeps its three newest whole, and only the logs and small records of older ones. Here that freed about 4.5 GB.

Faster baked builds

Builds with Bake the lighting ticked are three to four times faster, and faster again when a project is built a second time.

  • The Temple Ship project here took about 10 minutes to build before. It now takes under 3 minutes on a fresh bake, and under 2 minutes when built again after a small change. Edits on the Bar went from 2½–5 minutes to between 40 seconds and 1½ minutes.
  • Quick builds (Bake the lighting off) take a few seconds instead of up to a minute.
  • How:
    • each package is decoded once and kept for the next build;
    • a large piece is split up and relit by several workers at once, the largest first;
    • a light is worked out only where it reaches;
    • only the parts of a piece that the edit can change are relit.
  • Each project keeps its relit pieces, so building it again after a change relights only what that change can reach.
  • More of the game's own lighting is kept as it was:
    • a piece whose light changes by less than a small amount is left alone;
    • a piece keeps its lightmap's original scale where the new light fits under it;
    • the parts of a lightmap that no edit touches stay as they were;
    • the edges around each lightmap are written along with it.

New features

  • Pieces from other maps. The piece list (P) has All maps: every piece of every map your install plays, to place in the map you are editing. The game's maps are read once (about half a minute), and the list can be filtered, sorted (most used, recently used and more) and starred.
    • Destructible props, collectibles, fracturing pieces, physics props, doors, ladders, cars, vans and prefab pieces all come across. A car, a door with its frame or a van with its building is one entry, brought whole and placed as one.
    • Pieces brought from another map are lit by a baked build like the map's own.
  • Prefabs. A set of pieces, or a whole building with its lights, saved to place again in any map and passed on as a file (Add a piece → Prefabs).
    • The prefab builder (Prefabs → New) makes one from nothing, on a blank workspace.
    • Test in game in the builder plays the prefab on a lit stage, with no aliens.
    • A prefab whose pieces your install lacks is opened with a warning, and Find missing pieces looks for them again after All maps has been read.
  • Buildings. The Buildings view (Shift+B) draws the floor boxes that make a roof hide and the walls cut down in the game as the cursor goes up and down the storeys.
    • Draw them over a house you put together, storey by storey, so the game treats it as a building.
    • The map's own buildings can be changed the same way: moved, made larger or smaller, given storeys, or deleted.
    • A building moves with its pieces when they are grouped, and a map building copied with its pieces brings its floor boxes along.
  • Clear map (Project menu) takes every piece off a map, to build a new one on its light, sky and landing. It can keep the scenery outside the play area.
  • Map grid (tool strip) resizes the play area by its handles: larger and taller on any map, and any size, smaller too, once the map is cleared. On a grown map the new storeys get the cursor's floors, and the scenery in the new area is walkable.
  • Landing zones. Where the squad lands, in a view of its own (Shift+Z): move and turn a zone with its gizmo, add one from the Add panel, delete one, and set which game uses it (Long War, plain Enemy Within or both).
    • Land here plays a battle with the squad on that zone.
    • Maps with no drop zone frame (Basic Training, the Temple Ship, the alien bases) have their landing as a zone too.
    • A moved Skyranger takes its shadow with it in a baked build.
  • Box select (T): a box drawn over the ground selects everything inside it.
  • Four views: Normal, Buildings, Lights and Landing zones (Shift+N, Shift+B, Shift+L, Shift+Z). Each picks only its own kind of thing; the Normal view can show lights and floor boxes beside the pieces.
  • Groups in groups, and groups that hold lights and buildings, so a house moves with its lamps and its floor boxes.
  • Cover blocks that break: a cover block grouped with a breakable piece, with Break together in the game ticked, goes when the piece is destroyed, so it leaves no invisible wall.
  • A copy by dragging: hold Shift as you take a move handle, and a copy is dragged off while the original stays.

Changes

  • The Build warns far more often than it refuses. A warning means "this may behave oddly in the game", and the map is built all the same. Now built with a warning, where the Build used to stop:
    • a ladder that isn't expected to climb (it is built without a climb of its own);
    • moving or deleting a piece the mission script uses, or one of the landing's own pieces (move the landing zone instead);
    • deleting a piece of a kind the editor can't otherwise build, such as merged scenery.
  • Doors without a frame build. They haven't been played in the game yet.
  • A ladder's check counts the floors your project adds (walls and storeys you built, invisible floors, a grown grid's levels), in the editor and in the Build.
  • The header's change count includes buildings, a resized grid, landing zones and a cleared map, and Reset all puts them all back.
  • The user guide has a New in this version section, new sections for prefabs, buildings, Clear map, Map grid, landing zones, and cover blocks and invisible floors, five new typical tasks, and its pictures taken again. What it can't do yet is rewritten to what holds now.

Bugs fixed

  • A project saved after the editor had read its map again kept building from the older copy, so it missed what the newer one adds. Saving now moves the project onto the copy it was edited on.
  • The opened maps' folder kept every older copy of each map, about 150 MB a map for each version of the editor. Old copies are deleted now (see Upgrading).
  • The builds folder kept every build's work folder, several GB after a few weeks of baked builds. Old ones are cleared now (see Upgrading).
  • If one of the bake's workers died, the Build could wait forever. It now stops, and names the pieces that were left.
  • A baked build's progress now counts pieces as they finish, so it no longer sits still while large pieces are relit.

Known limits

  • Played once or twice in the game: pieces from other maps, prefabs and their test stage, buildings made from nothing, the map's own buildings changed, a cleared map with its own landing zones, cover blocks that break with their group.
  • Built, but not played yet: doors without a frame; a map grown larger or taller as it is; Clear map with the scenery outside kept; a landing moved on a map with no drop zone (Basic Training, the Temple Ship, the alien bases); the moved Skyranger's shadow; a ladder built with the warning that it isn't expected to climb; a building marked UFO; landing zones on plain Enemy Within. These build without errors. Reports of how any of them plays are very welcome.
  • The faster bake's lighting hasn't been played in the game yet. It matches the old bake byte for byte when told to work as before, and the tests compare the new way with it, but no one has played a map baked the new way. Please report anything that looks lit wrong, with Save a bug report from the Build panel.
  • A new map starts from one of the game's. Clear map empties it, but the sun, the time of day and the mission stay the base map's.
  • Only the game's own pieces: you can't import your own models, textures or sounds.
  • Maps installed for campaigns haven't been played in a campaign yet, and only abductions have been played with an edited map.
  • Council missions can be replaced but not added to: install a map to replace the original to play it there.
  • Long War Rebalance's invisible cover stays where it was when the piece it covers moves, and a mission's own pieces (the data recovery's encoder) can't be moved.
  • The test battle is a plain one with six squaddies, not a campaign mission.
  • Tried with Long War Rebalance through Steam. Plain Enemy Within is a best guess, and other Long War versions and game folders outside Steam haven't been tried.

Checksums (SHA-256)

a1c8497fb3bcca455f30a6df141eb923fd0f26f5a2afc147c475fdb2fc46cd20  XCOM-Map-Workshop-0.5.0-Setup.exe
a5177c53c8123635e68ca7c185c99924e776bb42b4986b0c5c87e12088a7f94b  XCOM-Map-Workshop-0.5.0.zip