XMAPEDIT on GitHub Online manual Changelog YouTube channel New features for mappers NBlood on GitHub

THE XMAPEDIT

A BLOOD GAME EDITOR

Wish to thank all the beta testers that helping to find the bugs and suggesting their ideas.

Original MAPEDIT by Nick Newhard and Peter Freese.

XMAPEDIT version created by nuke.YKT and NoOne.

Based on JonoF's BUILD port.

DOWNLOAD dos
DOS or compatible system required
Built: AUG 10 2021 (651KB)
 DOWNLOAD x86
Windows 98 or higher required
Built: APR 26 2025 (700KB)
 DOWNLOAD x64
Windows Vista x64 or higher required
Built: APR 26 2025 (828KB)
  FULL MANUAL ENG
Updated: APR 26 2025 (16MB)
Language: ENG
 FULL MANUAL RUS
Updated: APR 26 2025 (10MB)
Language: RUS
  
VIEW ALL RELEASES...

ABOUT XMAPEDIT

XMAPEDIT is an Open Source extended version of original Blood map editor with fixed bugs, lots of new features and extended limits. It includes support of SEQ and QAV game animation editing with built-in ART files editor. All of it allows to easy build mods for this great game.

The Windows port based on JonoF's BUILD port. It's compatible with vanilla Blood, supports widescreen resolutions, includes modern object types for level designers and most of the features of the DOS XMAPEDIT version.

Any suggestions and comments are welcome in Blood related Discord channel at https://discord.gg/V9fY5wE or via e-mail to baitd@yandex.ru. You may also visit GitHub page to get the most recent source code.

Requirments, Installation & Notes

In order to run recent builds of the program you need a computer that have at least 600Mhz CPU and 32MB RAM with Windows 98 or higher operating system running on it. To get easy access to all features, it's recommended to have mouse and full format keyboard or separated numpad device, however, if you don't have access to numpad keys, a key mapper file is provided. For installing the program, just copy all the files from package in the Blood directory.

Other notes that are good to know:

  1. Windows Defender may mark it as a virus program for some unknown reason.
  2. Make sure you have read/write access for all directories or files you are planning to use.
  3. XMAPEDIT do support extended object limits (sectors, sprites, walls etc) that also extended in modern ports such as NBlood, Raze or GDX, but NOT in vanilla Blood and Fresh Supply. So, once you reach at least one of vanilla limits, the map will not work in it. Sloped or non power of two floor oriented sprites is not supported by vanilla as well.
  4. XMAPEDIT can correctly work in all screen resolutions (include widescreen), but i personally still recommend 1024x768 or 1280x1024 in windowed mode because it gives good picture and font size.

CHANGELOG

  1. APR 26 2025

    • Off-line Manual:

      1. Russian translation has been added. Thanks to Life_My_Agony.
      2. All manual packages are now containing sample maps and files.

    • General:

      1. Added: Undo/Redo feature for map editing which supports up to 128 actions. Press [CTRL]+[Z] to undo action or [CTRL]+[SHIFT]+[Z] to redo. Available in both edit modes and affects almost any action.
      2. Added: "MapUndoRestoreCamPos" INI option in [General] section. See description in config chapter.
      3. Max tiles limit has been raised from 9216 to 30592!
      4. Removed: Sector merge menu for key [J] when pointing on white wall.
      5. Improved program stability.
      6. Various minor updates and fixes.

    • 2D Mode:

      1. Added: Now is possible to draw wall loops that cover another wall loops properly. The covering loop will become red sector automatically when all of it's points inside of parent sector and all of it's loops which is inside will be transfered in it.
      2. Added: Loop split tool which allows to quickly split wall loop. Works best with circle shaped sectors. See Loop Split chapter to get more info.
      3. Classic sector drawing:
        1. Added: White walls loop autocompletion feature. It allows to quickly connect new white sector to another. Press [SPACE] to insert point on a white wall. Once status bar shows the message about autocompletion, wait a bit to actually see the future loop or just press [SPACE] on same point again to create it immediately. Note that this feature will not work if there is any line intersections.
        2. Added: You can hold [SHIFT]+[SPACE] to insert new point on currently hovered wall vertex without grid snap it.
      4. Added: You can hold [SHIFT]+[INSERT] to insert new point on currently hovered wall vertex without grid snap it.
      5. Performance boost for translucent effects.

    • 3D Mode:

      1. Auto-create xsectors when applying "Light Phase" and "Z-Phase" in "Sector Tricks" menu.
      2. Added: "Clean matching" feature in "Sector Tricks" menu. It allows to clean x-sectors properties that matching currently hovered x-sector.
      3. Removed: Raise/lower floor and ceilings with mouse.

    • Split Mode:

      1. Fixed: There was some mouse problems in 3D area when mouse-look enabled.

    • HUD:

      1. Fixed: Tile box is not showing on resolutions greater than 640x480 and less than 1024x768.
      2. Fixed: Damage names in edit dialogs was a bit incorrect.
      3. Added: Set busy value when changing state of object in edit dialog (useful for panning/lighting).

    • File Browser:

      1. Fixed: Potential crash when browsing SEQ/QAV files.

    • Preview Mode:

      1. Fixed: Incorrect Z-motion sector behavior when crushing sprites.
      2. Fixed: Incorrect place of FX effect when selecting middle position in Effect Gen type (modern maps only).
      3. Added: Laser (type 505) preview (modern features).
      4. Added: Path Sector SPRITE (type 611) preview (modern features).

  2. JAN 08 2025

    • Site:

      1. All release packages is not include full off-line manual anymore by default due to filesize. If you want to have one, please download it manually on the top of this site.

    • General:

      1. Added: Experimental sector texture auto-alignment feature, which is available in 3D mode and in 2D (when textured map is enabled). Hold [ALT] and change panning with [PAD ARROWS] and other sectors with same texture and z-coordinate will be aligned to current one.
      2. Added: Import of BUILD maps version 5.
      3. Fixed: Random crash on .PFB (prefab) file load/save.
      4. Fixed: Changing first wall of sector should not affect auto-align wall.
      5. Various changes and fixes.

    • 2D Mode:

      1. Added: Arc wizard that allows to automatically create new arcs. See Arc wizard chapter to learn how to use it.
      2. Added: Masked wall indication for edit screen.
      3. Sector shape menu has been renamed to Sector tools menu.
      4. Door wizard has been moved to Sector tools menu.
      5. Door wizard ignores wall points on target red wall line when you want to create rotate doors.
      6. Fixed: Data1 sound can play twice for double rotate doors that using Link command technique (if there is no Data2 sound defined). If you have such doors, you need to disable "send at ON" and "send at OFF" checkboxes on both sides.
      7. Fixed: Splitting sector may lead to walls duplication.

    • 3D Mode:

      1. Added: Wall texture auto-alignment to the left. Press [<] to use (still may have issues).
      2. Fixed: Gradient Shading tool was not working properly.
      3. Fixed: Frame for hovered sprites has a bit incorrect size for face sprites.
      4. Fixed: Highlighted sprite extents should not go through angled walls when you drag such sprites.

    • HUD:

      1. Added: "Cstat" field in edit dialogs of common objects (sectors, sprites, walls).
      2. Added: "Detail" field in edit dialog of common sprite.
      3. Added: Helper function for "Cstat" and "Hi-tag" fields which allows to pick required flags instead of typing it manually. Press [F10] to call it. Note: editing flags may lead to unexpected results. Please, make sure you understand what each flag supposed to do before selecting it.
      4. Added: Helper function for "Pan angle" and "Wind angle" fields in sector fx dialog which automatically sets the angle relative to first wall of the sector.
      5. Fixed: Many incorrect limit values in object edit dialogs.

    • File Browser:

      1. Added: Confirmation before file deletion.

    • Tile viewer:

      1. Fixed: Cannot remove last favorite tile.

    • SEQEDIT / QAVEDIT:

      1. Added: Automatic test map generation when launched in standalone mode, which allows to test animations in 3D mode always.

  3. JUL 28 2024

    • General:

      1. Added: Starting from this release, the editor gets a full offline manual that covers most of features! The whole thing was created by by Seizhak for xmapedit so you should thank him! To open it directly from the program, just press [F1]. You can open it manually any time in explorer as well since it written using standard HTML Help format (CHM).
      2. Added: A simple key mapper file (keyremap.ini) It could be useful for users who doesn't have numpad keyboard as it allows to define a different keys. Refer to Configuring XMAPEDIT chapter for more details.
      3. Added: A lot more items (but not all) added to the editor options dialog.
      4. Added: Exclusive fullscreen mode (may have issues with ALT+TAB switching!).
      5. Added: Experimental FPS lock based on "WGL_EXT_swap_control" OpenGL extension.
      6. Added: Up to 8 external commands with macros support. For example, it allows to launch NBlood (or anything else) to test the map you currently editing. See ExternalCommands chapter overwiew to learn how it works.
      7. Added: External map test feature (based on external commands) to the main menu. By default, if you press "Test Board" button, it will save a temporary copy of you map, and try to open Nblood in current directory to play it. The player position will be set to current editor position.
      8. Global visibility limit raised from 4096 to 131072.
      9. Various minor updates and fixes.

    • HUD:

      1. Fixed: Checkboxes may remain pink after using advanced clipboard dialog.
      2. Fixed: The editor may crash after using advanced clipboard dialog.

    • 2D Mode:

      1. Fully new code Auto-Red Wall feature that should make it more stable and produce better results.
      2. Fixed: Sprites may temporary disappear after inserting the wall loop inside another sector.
      3. Fixed: Sometimes deleting points may lead to corrupted sector or crash.
      4. Fixed: It was possible to attach one-sided wall of highlighted sector to two-sided wall of sector outside highlight.
      5. Various minor changes.

    • Tile Viewer:

      1. Fixed: Incorrect names for some items in Game Objects menu.

  4. APR 27 2024

    • General:

      1. Added: Split edit mode (horizontal or vertical) which allows to edit map in 3D and 2D mode at a time. Use [PAD PERIOD]+[PAD ENTER] to toggle it. There is also a few other keys available in this mode exclusively, so you can fine tune it. Be sure to read Split Edit Mode chapter to learn it.
      2. Added: The Advanced Clipboard which allows to copy only selected x-properties from source to destination objects (and all objects of such type in a highlight). Press [CTRL]+[ALT]+[ENTER] to call the dialog. If you want to copy sector FX properties, hold [SHIFT].
      3. Fixed: Sometimes the editor is unable to find any video mode to work with on some displays.
      4. Fixed: Sometimes the INI parser may show a false-positive error on node deletion.
      5. Fixed: A potential sound crash with x64 builds when compiled with fresh compilers (thanks Hendricks266).
      6. Fixed: A potenial slope crash (thanks Hendricks266).
      7. Fixed: Autosave files is not appearing in the main menu for maps in subfolders.
      8. Auto-disable NumLock key status when the program just starts.
      9. Filebrowser shows the SEQ animation palette in the thumbnail preview now.
      10. Various minor updates and fixes.

    • HUD:

      1. You can see the editor build date in the logo at the left corner.
      2. Added 7 different font sizes (Use [CTRL]+[ALT]+[F11] to select).
        • [06x06] Tiny (best for 640x480 in fullscreen, probably).
        • [08x08] Small.
        • [08x10] Smaller.
        • [08x12] Normal (default).
        • [08x14] Large.
        • [08x16] Larger.
        • [08x18] Huge.

    • 2D Mode:

      1. The sectors is no longer gets detached automatically once gets highlighted.
      2. It's safe to insert point while drawing new sector.
      3. Inserting point is no longer breaks the wall panning.
      4. Sector highlight is not resets anymore when deleting outside sector.
      5. The highlight frame is no longer "follows" the player, which means it is possible to make it as larger as required.
      6. Various minor fixes.

    • 3D Mode:

      1. Added: [CTRL] + [ALT] + [PAGEUP/DN] allows to z-offset all sectors in a highlight.
      2. Added: [CTRL] + [SHIFT] + [P] allows to disable local sky. Hold [ALT] for global scope.
      3. Fixed: Broken custom tile font in Sprite Text tool.
      4. Fixed: Hover effect was at incorrect position for masked wall.
      5. Return fine global visibility setup key sequence by a request ([D]+[+/-]).
      6. Various minor changes.

    • Preview Mode:

      1. Fixed: Sometimes the projectile impacts at incorrect position.
      2. Fixed: No hover effect for hovered sprite.
      3. A bit better ROR drawing.

  5. JAN 27 2024

    • General:

      1. Added screen DPI awareness flags into manifests which should fix incorrect window size and position for users that have different DPI properties.

  6. JAN 25 2024

    • General:

      1. The editor just got the whole new filebrowser with longer filenames support and ability to display thumbnails for the most of supported file types (MAP, PFB, SEQ, QAV, ART, PAL, DAT, PLU, BMP, PNG, JPG, PCX, TGA). There is also some basic file management included (rename, delete, create directory etc.). Be sure to learn how to use it's additional options in Filebrowser chapter.
      2. Prefabs dialog update: it is possible to save prefab and attach a custom thumbnail, which will be shown in the filebrowser. Note that if is not attached, a new one will be generated automatically.
      3. Autosave icon is now showing in the main hud logo instead of top right corner.
      4. Added: Unique stack id search for walls (wall stack type only). Press [F10] in edit dialogue.
      5. Better [ALT]+[TAB] task switching and mouse movement handling.
      6. Fixed: Sometimes the program may hang during importing graphics with "tile road map" enabled in Import Wizard.
      7. Fixed: False positive error when isolating TX/RX channels in maps with a lot of it already taken.
      8. Fixed: Z and Slope values ignored when edit sector using dialog ([CTRL]+[F5]).
      9. Various minor updates and fixes.

    • 2D Mode:

      1. Added: You can create some basic geometric shapes (Rectangle, Circle, Square, Triangle). Just press [ALT]+[SPACE] to select the shape and start drawing. For more details, go to the Shape Tool chapter.
      2. Added: [CTRL]+[ALT]+[G] allows snap all selected wall points to current grid
      3. Added: Dragging sprite while holding [ALT] will make that sprite to take hovered wall angle
      4. Fixed: Sometimes RX/TX channel tracker may point on incorrect destination object.
      5. Fixed: Sometimes when dragging sprite, the sectnum of that sprite is not changing.

    • 3D Mode:

      1. Fixed: Teleport target marker sprite was invisible.
      2. Fixed: [ALT]+[PAGEUP/DN] functionality is working correctly now.
      3. Fixed: Hitscan returns incorrect coordinates with widescreen modes.

  7. NOV 11 2023

    • Site:

      1. Older builds available for download. Even DOS builds!
      2. Added menu to the top.

    • General:

      1. Builds for x64 platforms has been introduced!
      2. Automatically set state to On for Ambient Sound sprites if it was inserted using Game Object menu.
      3. Some default prefabs were fixed and sorted.
      4. Added new vanilla compatible hidden powerup called "Death Mask" (type 131). While it's active, the player becomes invisible for Axe Zombie and Bloated Butcher enemy types only. Note that powerup active time is ~30sec.
      5. The parallax sky tiles behavior has been changed:
        By default is looking for the tiles with same size starting from base tile to the limit which is automatically counts from width of the base tile or can be set directly in Setup Board window (see Repeat Amount option). When not enough tiles to wrap the sky around were found, it simply starts to repeat previous sequence. That should give more freedom for setting appearance of the sky because even simple texture may show interesting results. For example, try to set tile 232!
      6. Import Wizard tool should adjust the sky better when importing maps from another BUILD engine games.
      7. Fix a small regression in GUI when typing numbers.
      8. Improved program stability.
      9. Various minor updates.

    • 2D Mode:

      1. You can hold [SHIFT] when dragging sectors to stop global oriented textures to scroll with it (classic behavior).
      2. Added some map statistics. You need to put mouse cursor in the empty space to see it in the HUD. For example, it counts the total number of items and dudes and shows the difference between difficulty levels. If you want to change game mode, just select it in Preview Mode menu.
      3. Added flip X and Y feature for highlighted sectors. Press [CTRL]+[X] or [CTRL]+[Y] inside the highlight box to flip the sectors.
      4. Added "Auto Red Wall" feature which allows to properly insert highlighted sectors after dragging it in another parent sector. Press [ALT]+[S] inside the highlight box to perform insert. This feature also tries to keep correct outside walls texturs and set z-offsets relative to old parent sectors when possible.
      5. Draw box for highlighted sectors.
      6. Various minor updates.

    • 3D Mode:

      1. Allow to set global parallax sky palette when pressing [CTRL]+[P].
      2. The return of [D] + [-/+] key sequence (change global visibility) by a request.
      3. Fix double highlighted sector processing.

    • Artedit:

      1. Small update for documentation.

  8. AUG 24 2023

    • General:

      1. There was created a GUI based dialog that allows to easy edit global map properties.
        As a matter of fact, the following hot-keys is no longer available:
        1. [CTRL] + [P]: Change parallax type.
        2. [CTRL] + [ALT] + [P]: Change amount of parallax tiles.
        3. [CTRL] + [F]: Toggle Fog mode.
        4. [D] + [-/+]: Change global visibility.

        To open it, go in the main menu and press "Setup board" button. Also it opens automatically when you starting the new board.

      2. You can set width and height of 2D board space for each map.
      3. Removed duplicated hotkeys for object rotation (keys [ and ]).
      4. Increased max waitTime and busyTime in sector edit dialog from 255 to 4095 (vanilla compatible).
      5. Optimize RX/TX channel, path markers, ROR stacks isolation features.
      6. New config option "ForceEditorPos" added in the General section.
      7. Various minor updates.

    • 2D Mode:

      1. Added a new door wizard tool that supports automatic slide marked and rotate doors creation. Learn how to use it in this chapter.
      2. Added a textured map preview that supports of showing floors and ceilings. Use key [F11] to cycle through draw modes. When it enabled, it's also allowed to change texture panning for sectors with the pad keys just like in 3D mode.
      3. Fixed that it's impossible to insert point on really long wall.
      4. Fixed that sometimes incorrect wall information showed for currently hovered wall.
      5. Captions and borders is no longer disappear when object is behind the screen space.
      6. Tracers is no longer disappear on small zoom.
      7. Show borders of all floor sprites while dragging such sprites.
      8. Show wall length in grid units and angle caption when dragging or drawing new walls.
      9. Show teleport destination tracers.
      10. Added snap grid support for circle points feature (hold [SHIFT] to snap).
      11. Global aligned floor and ceiling textures moves with sectors in a highlight while dragging it (experimental). Also, it working when all walls of sector in point highlight.
      12. Minor updates for RX/TX tracker.
      13. Various minor updates and fixes.

    • 3D Mode:

      1. Take in account lowest and highest points of slope when using CTRL+PAGEUP/DN.
      2. Added a GUI based sprite text tool that allows to print text on the walls, floor or ceilings.
      3. Added a function that allows to quickly reverse the door position (supports Rotate and Sliders).
      4. Added experimental sprite hover indicator (similar to wall hover one).
      5. Use effect sprites for gradient highlight instead of magenta background.

    • HUD:

      1. Auto-scroll the status bar message if it's too long.
      2. Added a mini-screen that shows 2D screen when user in 3D and vise versa.
      3. Show rotate direction for door and path markers (CW or CCW) in the status bar message.

    • Preview mode:

      1. Fix inaccuracy with Fluorescent Light and some other types (should not be able to receive commands).

  9. APR 20 2023

    • General:

      1. The editor can show Custom Dude V2 appearance and version. As always, refer to Modern Features for Mappers page to get more info.
      2. Fixed a bug with external models that supposed to spin.
      3. Added option for disabling auto-adjusting statnum for thing types (400 - 431). See more in [AutoAdjusting] section.

  10. OCT 28 2022

    • 3D Mode:

      1. Key [P] and [ALT]+[P] functionality has been swapped. This means that you don't have to hold ALT for palette selection anymore, but need to do it when toggling parallax sectors.
      2. Added a visual object palette selection window. By default all palettes are sorted by efficiency percent relative to current tile. This window contains some options, including classic palette selection (in case you don't like the new window for some reason).
      3. Fixed a regression with wall masking when you was not able toggle the mask without raising or lowering the sector.
      4. Added experimental hover indicator for the wall you pointing in.

    • Preview mode:

      1. Added vanilla and modern sprite physics!
      2. All modern types, that was implemented for preview mode previously, now updated to the most actual game state.
      3. There is more than 1 message shows on the screen. Most recent message always on top.
      4. The following new modern types was added:
        1. Slope Changer (type 504)
        2. Velocity Changer (type 506)
        3. IF (types 501 and 502)

          Note that this is partial support! "Player" and "Dude" conditions are not implemented yet, but most of others (more than 100) should work fine.

  11. SEP 19 2022

    • GENERAL:

      1. The editor is fully compatible with Windows 98/ME/2K/XP and higher versions. You may need to adjust mouse speed settings as mouse handling has been changed.
      2. Changed video output method to the OpenGL. This should help some screen grabbers to capture xmapedit window for video recording (Bandicam is a fine example). If your device is not supporting OpenGL for some reason, the output method will be switched back to the classics.
      3. Added a new map Channel Cleaner tool. It will search and reset unlinked TX and RX channels for all objects in the map. Available in the main menu, under the Tools section.
      4. Added a new INI option "Gamma" to the [Screen] section.
      5. If both "going on" and "going off" object properties disabled, but TX ID is not zero, both of will be enabled automatically when saving the map.
      6. Added a helper function for Dude Spawn sprite type when editing it through the edit dialog. It allows to quickly pick enemy to spawn if you press [F10] on the data field.
      7. Added a item type #150 in lists. This item reveals full map outline (modern maps only).
      8. Various minor changes.

    • 3D Mode:

      1. You can travel through stacks (ROR sectors) without Preview Mode enabled. Note that for gravity Z-mode you must press [A] or [Z] when in one of such sectors.

    • 2D Mode:

      1. Added a First (F) and Auto-align (A) wall indication when pointing mouse in the sector. If you don't see it, try to zoom-out until it starts to blink.
      2. Various minor changes.

  12. Jun 09 2022

    • GENERAL:

      1. Potential broken map CRC fix. If you got "Map does not match CRC" error when loading maps that was saved with previous (Jun 05 2022) build, download this one, load the map and save it again. The map itself is fine. Sorry.

  13. JUN 05 2022

    • GENERAL:

      1. Added a GUI based Import Wizard tool that helps to load maps and graphics from another BUILD engine game. It will be automatically called when loading a BUILD engine map.
      2. Added config version check and some config options was deleted or replaced. Note that your settings will be reset to defaults.
      3. File browser supports up to 1024 files per directory.
      4. Fixed that sometimes the editor hangs when trying to start newboard using the menu.
      5. There is no more tile #2048 (the Monolith logo) in the top right corner will shown in the game for maps that saved with xmapedit.
      6. Map file revisions won't be incremented due autosaving.
      7. XMAPEDIT release package now includes additional documentation for some tools. See docs directory.
      8. Various minor changes.

    • ARTEDIT:

      1. Artedit can import the following image formats: .PNG, .BMP, .JPG, .DDS. Thanks to the Ken Silverman's KPLIB image decoding library!

    • QAVEDIT:

      1. Make tile movement keys work a bit slower.

    • 3D Mode:

      1. A way to work with parallax sectors has been re-imagined: it does not required to change properties for each sector anymore since the editor treats a group of such sectors as "Local" or "Global" sky.

        The "Local" sky is the group of sectors that is not separated by a non-parallaxed sector and "Global" is all the parallxed sectors in the map. This allows to quickly apply propeties such as y-offset, shade, palette to the whole room or map depending on selected scope.

        See more info in related chapter.

      2. You can rotate the global sky (ceiling and floor) horizontally if have more than 1 sky tiles. The more sky tiles used, the more angles available. For example, all the standard Blood skies can be rotated to 16 sides.

  14. MAY 03 2022

    • GENERAL:

      1. XMAPEDIT is Open Source.
        Visit GitHub project.
      2. A bit changed save changes dialog for all editors. If you got unsaved changes in artedit, a checkbox will appear that allows to save it with other changes you made. Note that it is enabled by default.
      3. Various minor changes.

    • ARTEDIT:

      1. Added import of .CEL and FLOORS image formats from Chasm: The Rift game.

    • TILE VIEWER:

      1. Added CRC32 of tile in info window available with F1.

  15. APR 23 2022

    • GENERAL:

      1. QAVEDIT was successfully ported and updated. As a matter of fact it was built-in into xmapedit. This is the tool for editing QAV files which contains the screen animation such as weapon or interface. This version can handle up to 4096 frames and supports 3D mode editing that gives additional advantages. See for detailed description to learn how to use it in the "Tools" section.
      2. Added "SoundVolume" and "MusicVolume" parameters in "Sound" section of config file.
      3. Fixed that in some cases you can't set statnum of sprite to 0.
      4. Fixed that you can't overwrite existing prefab file even if confirmed.

    • 2D Mode:

      1. Fixed that a wrong sector may be offered for editing when pressing F5 and there is wall or sprite in a highlight).
      2. Fixed that wrong wall may be offered when pressing keys (for example K) when there wall point and wall line in a highlight. The line is always priority now.

    • Seqedit:

      1. There is no more "AllowOnlySprites" option in config file since is not required anymore. If target object is not a sprite, seqedit will ask you to confirm spawning SEQ on such object. If there is no objects at all, 3D mode editing is not available.
      2. Readme file changes.

  16. APR 03 2022

    • GENERAL:

      1. Added a map comment system. It allows to create a textual notes and show it directly in 2D mode of the editor. The comments may be standalone or you can bind it to any object in the map. This feature available in both edit modes. See more detailed description in the manual.
      2. Key [J] can be applied to white walls. The editor allows to select which exactly action you want to perform: to create outer loop (ALT+S) only, or create it and merge automatically.
      3. 2D mode object edit dialog (HUD) was updated and now available in 3d Mode as well. Added the ability to edit some common properties of objects. All object dialogs got mouse support (see mouse controls for details). As a matter of fact, old 3D mode info hud was removed.
      4. Better number editing for HUD numeric fields.
      5. The editor will automatically load the last map you edited if AutoLoadMap setting enabled. If no file exists, it will load or start newboard.map.
      6. The editor now loads maps in 2d mode by default, but saves the last mode you were in.
      7. Added new settings and sections in xmapedit configuration file.
      8. Added more prefabs in default package.

    • 2D Mode:

      1. You can select the exact sprite you want to focus when there is more than one sprites at same X/Y coordinates. Just hover sprite, hold [ALT] and scroll [MOUSE WHEEL].
      2. Added 5 layout types for HUD: None, Full, Compact, Slim and Dynamic (shows compact layout when you draw sectors and full otherwise).
      3. Fixed that wall textures was stretched after dragging wall points. I got reverted it back to classic BUILD behavior, so editor will fix texture size for you like it did before with one important exception: walls that marked for movement (blue or green ones) will not be fixed. This should help to avoid annoying texture resizing when working with slide sectors and stuff like that.
      4. Added smaller grid types and greater zoom.

    • Preview Mode:

      1. Touch trigger flags of objects is available for testing. Note that for walls it works only when you using modern features for level designers.
      2. Items now picking up automatically.
      3. Added a log messages. You can see it in console (key [TILDE]) or in xmapedit.log file.
      4. You can fire a missile with key [F] (works best with mouse look). Hold [RIGHT SHIFT] to change missile type.
      5. You can change type of explosion created with key [E] if you hold [RIGHT SHIFT].

    • TILE VIEWER:

      1. Added a mouse wheel support for tile scrolling.

    • SEQEDIT:

      1. Fixed a crash that may occur when saving SEQ files because file is read only.
      2. Seqedit will start in 2D mode by default if you call it from 2D mode of xmapedit.

    • 3D Mode:

      1. XMAPEDIT displaying non-existing (blank) tiles on sprites with "No tile" icon. This is a view effect sprite, so actual tilenums won't be replaced when you save the map. It allows to actually see such sprites even if user don't have art for it.
      2. Added 4 layout types for HUD (None, Full, Compact, Slim).
      3. You can adjust camera height for gravity mode.
      4. The editor skips "Locked/Step" Z-mode by default. You can change it through INI file.
      5. Fixed hitscan on widescreen resolutions.
      6. Fixed that sometimes sprite that you drag with mouse may be placed behind the wall.
      7. Fixed that new sprite not becomes wall oriented automatically when placing it on the wall.
      8. Fixed that when placing sprites on bottom swapped walls you got opposite sprite angle.
      9. Fixed that changing Z of ceilings or floors with mouse controls is not working.

  17. FEB 04 2022

    • GENERAL:

      1. The editor now asks you if you want to enable Cryptic Passage art when you launch it first time. If you allow, it will add a line in Resources.Art section of your xmapedit.ini. (see configuring xmapedit).
      2. Fix flammable tree is not playing burning animation in the game.
      3. Fixed that imported BUILD maps may hang the editor when inserting or deleting sprites. Also fixed wrong orientation for some sprites.

    • 2D Mode:

      1. Fix random sectors may become highlighted when deleting another highlighted sector.
      2. Fix grid snapping is not working when dragging many wall points.

  18. JAN 19 2022

    • GENERAL:

      1. Fixed a runtime crash or freezing on specific Windows versions while creating standard colors palette.
      2. Fixed crash when changing screen palettes with [ALT] + [G] in 3D mode.
      3. Fixed that tile viewer window may not change it's size when changing resolution through options menu.
      4. Fixed that Ok button was not clickable with the mouse in About dialog.

  19. JAN 14 2022

    • GENERAL:

      1. I'm happy to announce that XMAPEDIT was successfully ported on modern Windows systems thanks to nuke.YKT and does not require DosBOX to work anymore!

        Since this day the support of DOS version is over, however the links to download it will stand still.

      2. Added new tool: ARTEDIT. This is a tool for editing ART files which contains game graphics. The main advantage of this art editor against all other programs is that this tool is native and makes real-time tile editing possible. In simple terms: you can edit ART files (include importing new images in it) when you in process of creating maps or even SEQ animations. See detailed description in the Tools section.
      3. Key [J] (sectors joining) works in both edit modes and acts a bit differently. It's enough to press it once near another red wall (or wall line in 2d mode) and next sector will be automatically merged with current. Hold [SHIFT] for classic behavior.
      4. [CTRL] + [DEL] (sector deletion) works in both modes.
      5. Added noclip mode. You are allowed to move outside sectors and go higher or lower than highest or lowest Z point of the map. Don't complain about HOMs or black screen if you use it. [ALT] + [CAPSLOCK] toggles it on or off in both modes.
      6. Added a feature that allows to quickly connect object from clipboard with another by RX/TX channels and it works in both edit modes. Copy some object in clipboard first, then press [Q] on next object. The destination object will receive RX ID according to TX ID of source object.

        Hold [SHIFT] to connect object from clipboard with the destination one: in that case the clipboard object will receive RX ID according to TX ID of the destination object.

        If objects have no RX\TX channels, it will get some unique ones automatically. The feature is early WIP, but it does it's job. I still have some more plans on it :)

      7. Various minor changes.

    • 3D Mode:

      1. Fixed wrong offsets of an external voxels (thanks nuke.YKT!).
      2. Changing palookup of an object now shows it's efficiency percent. The ones that have zero efficiency will be automatically skipped while holding SHIFT, but you still able to set it anyway through the dialog (ALT+P).
      3. Added the enemy icons that appear above the Dude Spawn and Custom Dude Spawn sprite markers. This way you can actually see which enemy will appear at which angle once spawner is triggered.

    • 2D Mode:

      1. The colors of the overhead editor was a bit changed since it uses colors from the game palette closest to the standard VGA palette, not directly from VGA palette. This allows to actually show the game graphics.
      2. Wall and floor sprite icons now showing it's actual width.
      3. Player start position markers was changed to arrows with different colors and editor start arrow is now bold.
      4. New and larger font for object captions. Also you will always see the caption of an object you currently hovering on the top of other objects.
      5. You can zoom in/out with the mouse wheel.
      6. You don't have to hold shift anymore to highlight the points. Also try to hold [CTRL] while pressing [MIDDLE MOUSE]: If you hover sprite, it will select all the sprites of the current sector and if you hover wall points, it will select all walls of the sector.

    • Preview Mode:

      1. You can test&feel the strength of earthquake while in 3D mode.
      2. Random item generator (modern features) should now work.
      3. Gib walls are now affected by explosions.
      4. Sleeping and buried axe zombies will now morph in normal Axe Zombies once you get closer to them.

    • SEQEDIT:

      1. Minor fixes for loading and saving SEQ files.

    • Tile viewer:

      1. It now have translucent background (enabled by default), better fonts, better tile thumbnails and it shows additional info about the tiles on it. All of this are optional.
      2. It's possible to toggle art editing mode via pressing [SPACE].
      3. All hotkeys for settings been moved to a single GUI based checkbox list which available by pressing key [F12].

  20. AUG 10 2021

    • GENERAL:

      1. XMAPEDIT now supports loading up to 1024 external voxel models! This allows you to load existing voxel packs or define your own models without modifying the ART, DAT and RFF files. Refer to "External models" section for detailed info.
      2. Fixed that Wall Crack and other thing types may not change statnum to required value when inserted via Game Objects menu.
      3. You cannot (re)load the map through the menu anymore if it was not saved before.
      4. Fixed that sometimes first wall of the first sector resets it's texture to 0 if new map was not started normally (through the menu button).
      5. You don't have to erase text field in the directory explorer everytime you want to type new filename. Just start typing and it will be erased automatically.
      6. Various minor fixes.

    • 3D Mode:

      1. Added a feature that allows to define how many bits (tiles) required for the parallax sky to wrap around.
      2. Fixed that sometimes sprite could be placed directly on the wall line or behind it if grid size is too small or too big.
      3. Fixed wrong sector colored lighting effects bug.
      4. Added new mouse controls for sprites (change Z only).

    • 2D Mode:

      1. Fixed that hints in the edit dialogs may display incorrectly.
      2. Wall textures should not stretch anymore when dragging wall points with the mouse.
      3. Sprites should not change Z when dragging it with the mouse (unless it gets fully buried in the ceiling or floor).
      4. The editor now shows the tracers of Path Markers with magenta color.
      5. Added INI message helper function to the sprite edit edit dialog.
      6. Added Gib selection helper function to the sprite and wall edit edit dialog.
      7. Added path drawing feature. Create complex paths for Path sectors or enemies with just 2 keys!
      8. Fixed the arrow position when starting new map.

    • SEQEDIT:

      The tool has been done a complete overhaul. Be sure to re-read seqedit documentation to learn new key bindings and edit modes.

      1. Added 3D mode editing, so you don't have to call Preview Mode anymore. Just load the map, point on object and call Seqedit from the tools menu. You will always get in the game what do you see in the editor.
      2. It's allowed to move in seqedit just like in mapedit while in 3D mode.
      3. Added dynamic screen resolution support.
      4. Removed move seqedit origin function as it does not required anymore.
      5. Added import frames from another SEQ animation function (merge SEQs).
      6. Added reverse frames order function.
      7. Added copy/paste features that allows to copy whole frame or it's properties to another frame (see seqedit documentation for details).
      8. You can change surface type of the view tile directly in the editor.

    • Tile viewer:

      1. Removed tile sorting feature.
      2. Empty tiles is now marking in the tile screen.
      3. Larger tile number font.
      4. Settings such as stretching small tiles or show transprent color will now be saved in xmapedit.ini
      5. Added detailed tile information window which you can call via [F1] key or [MIDDLE MOUSE].

  21. MAY 13 2021

    • GENERAL:

      1. Fixed that sometimes wrong walls starts panning in Blood: Fresh Supply port even if is not intended to do such. This update could also fix other similar issues with objects in FS. You have to load and save your maps with this new build.
      2. Fixed that you cannot save the map if you started it from scratch.
      3. Fixed that secrets is not count correctly if AutoCountSecrets is enabled.

    • 3D MODE:

      1. The editor now displays "VIEW 8 FULL" sprites correctly.
      2. Some sprites (mostly enemy) reads it's SEQ animation info such as size, palette and picture instead of using hardcoded information, so if you edit seq file, the changes will be reflected in the editor too.

  22. MAY 08 2021

    • GENERAL:

      1. Added directory explorer to Open/Save menu dialogs. It also will be automatically shown if you start XMAPEDIT with no parameters, so it allows you to select map file to load. You may control this behavior with "AutoLoadNewboard" setting in XMAPEDIT.INI.
      2. Fixed a bug when some object statistics was not reset when loading or starting new map.
      3. Fixed that useless "Normal Off" sectors was not erased automatically when saving the map.
      4. Improved sector copying algorithm, so there is should be a way less chance to see a broken geometry when merging the maps.
      5. Various minor fixes.

    • 2D Mode:

      1. Classic BUILD menu has been replaced with the main menu from 3D mode.
      2. You can drag sprites through white walls without adding it in a highlight.
      3. Added copy/paste feature for x-properties of objects. At the moment it works pretty same as [ALT]+[ENTER] key sequence in 3D Mode. You just press [TAB] on source object, then [ENTER] on the destination object and all x-properties will be copied from object in the buffer.
      4. Fixed a crash that may occur when switching to 2D mode from 3D after inserting or deleting sprites.

    • Tile viewer:

      1. Key [Q] allows to cycle through texture types (sprite, wall, floor etc...).

  23. APR 17 2021

    • GENERAL:

      1. XMAPEDIT now stores it's files in "XMAPEDIT" folder. This means that if you want to keep your old settings, the following files must be copied in it: XMAPEDIT.INI and XMAPEDIT.FTL.

        Don't copy any files if you want perform clean install.

      2. Added sprite prefabs feature and editor now comes with 60 ready prefabs ready to use! Refer to prefabs section in the manual to learn how to create your own and use it. There is also availabe file format description for coders.
      3. Introduced batch object processing (early WIP).
      4. You can rotate a group of highlighted sprites with keys [SEMICOLON] and [APOSTROPHE]. [SHIFT] and/or [CTRL] leads to finer step.
      5. Fixed that items cannot be respawned even if Optional respawn was selected in multiplayer.
      6. The editor can load maps from RFF archive, if file is not exists on the disk.
      7. Changed the way how x-objects allocates for usage. This could prevent potential issues in Fresh Supply port and increase overall editor stability.
      8. Autosave files now should be created in working directory always instead of current.
      9. Fixed a bug when there was one more than MaxSaveCopies of autosaves created.
      10. The crash that may occur when editing sector sound sprites now should be fixed.
      11. Added highlighted objects statistics in top left corner of the screen.
      12. Added Path marker unique IDs sequence generation. This works pretty same as RX/TX channel sequence generation and available with same key [F10].

    • PREVIEW MODE:

      1. Fixed that preview mode may not work when loading maps from sub-folders.
      2. Fixed that sprites intended for teams mode only still available if bloodbath mode selected.
      3. Fixed a bug with hitscan that could occur after previwing maps with missile generators.
      4. Sectors with same RX ID will not be triggered all together when triggering with mouse just one of them if TranslateObjects setting is disabled.
      5. Sectors in movement can also drag camera if z-mode is gravity or in 2d mode. Don't forget to check "drag" in sector editing dialog!

    • 2D MODE:

      1. Added middle mouse highlighting feature. This allows to select object (include sectors) one by one in different screen area. Refer to mouse controls section for more info.
      2. Removed:
        1. Set floor and ceiling palette (key P).
        2. Check sector pointers (key ENTER).
        3. Show default properties for x-objects (key LEFT ALT).
      3. You can see clipdist radius of Path marker when highlight it. This may be useful for patrol enemies that use markers to follow it (modern features).
      4. Better function for finding free RX/TX channels, free stack id and free path marker ids for edit dialog that takes in account current dialog value. Example: try press F10 on RX ID field and then TX ID field.
      5. There is no more required to hold [CTRL] when pressing [H] to toggle hitscan flag.

    • 3D MODE:

      1. Added visual effects for sprites like halo for candles or flame for torches.
      2. Added setor's colored lights displaying, so sprites will be painted with colors you selected in sector fx dialog settings just like in game.
      3. You can drag and rotate many sprites while holding [LEFT MOUSE].
      4. You can highlight sprites with [MIDDLE MOUSE].
      5. It's possible to duplicate sprites using key [INSERT] just like you do it in 2D mode.
      6. It's allowed to insert sprites in/on other sprites now.
      7. You cannot select "Free/Mouselook" z-mode anymore if mouse look is actually disabled.
      8. Key [ALT] + [PAGE UP/DN] puts highlighted sprites on ceiling or floor keeping the shape.
      9. Key [SPACE] + [ESC] clears the clipboard buffer.
      10. Removed:
        1. Mouse look modes 1 and 2 (only free look still available). I'm pretty sure no one ever used it anyway.
      11. Key [O] now requires to hold [CTRL] to ornament sprite on the wall.
      12. Key [ALT] + [PAD ARROWS] changes actual X / Y position of the sprite.
      13. Key [CTRL] + [SHIFT] + [PAGE UP/DN] gives perfect z-step when raising or lowering sprites.
      14. Added arrow that shows current sprite angle. It works only for face and non 1-sided sprites.

  24. FEB 26 2021

    Meet the largest update for XMAPEDIT since release!

    • GENERAL:

      1. Fixed broken links to the Discord channel of Blood community and modern features doc.
      2. Now you can safely edit XMAPEDIT.INI outside even if xmapedit is opened, but changes made inside the editor will not be saved.
      3. The following keys are now working for both modes:
        • [LEFT ALT] + [X] disables auto slopes for all walls in a highlight.
        • [CTRL] + [B] toggles blocking walls to block move on and off.
      4. Added settings for sprite auto-adjusting to the XMAPEDIT.INI.
      5. Added map revisions message when loading the map.
      6. Fixed (hopefully) some weird vanilla bug that appears when using standard DOSBox with mouse that may cause wrong look direction when switching between modes or loading the map.
      7. Key [TILDE] is now [CAPS-LOCK] analogue for both modes, so in 2D it shows x-stats, and in 3D it cycles z-mode type. Done just because of standard DOSBox caps-lock bug.
      8. The editor now loads in graphical mode, which should give a little boost to loading time. We're opened for xmapedit logo ideas :)
      9. The editor now tries to detect magic sprite or map version to auto-set ShowAdvancedTypes value for you (for modern features).
      10. The SEQEDIT are now built-in xmapedit tool! You able open it two ways: from 3d menu, in the TOOLS list, when xmapedit is loaded or directly from command line by enterring something like "xmapedit myseq" or "xmapedit ID". Refer to the Tools section for more details.

    • PREVIEW MODE:

      1. Changed sector busy process indication in 2d mode: when sector goes from on to off state, it gets filled with blue color, and when it goes from off to on, it gets filled with the red. If sector have any continous motion effects active, it gets filled with dark grey color.
      2. Key [S] in 3d mode allows to spawn selected seqID on object you currently pointing at.
      3. The following modern (and updated vanilla) types was added in preview and can be tested:
        1. DudeSpawn (type 18, spawn random dude feature).
        2. Custom Dude Spawn (type 24).
        3. RandomTX (type 25, also supports Event Redirection).
        4. SequentialTX (type 26, also supports Event Redirection).
        5. Teleport Target (type 8).
        6. Properties Changer (type 28, cstat change only).
        7. Resizer (type 31).
        8. Picture Changer (type 29).
        9. Sector Lighting Changer (type 34).
        10. Data Changer (type 35).
        11. SEQ Spawner (type 27).
        12. Effect Gen (type 38).
        13. Sector Wind Gen (type 39).
        14. Inc-Dec (type 37).
        15. Damager (type 36, killing only).
        16. EctoSkull Gen (type 704).
        17. SFX Gen (type 708).
        18. 1-Way switch (for walls).
      4. Added difficulty and game mode display to the preview mode icon in the top right corner.
      5. Flame Trap is now working.
      6. Missiles are now working, so missile generators like FireBall Gen or EctoSkull Gen (modern only) should be fully functional now. Also the circle around missile sprite in 2D mode displays it's clipdist.
      7. Preview Mode button was added in 3d menu, to the TOOLS list.
      8. You cannot "kill" locked enemies anymore.

    • 2D MODE:

      1. Fixed that sometimes a crash may occur when deleting multiple sectors.
      2. Blocking walls is not block movement of the arrow anymore by default.
      3. Game objects menu which available in 3D mode with [ALT] + [S] keys are now available in 2D mode if you press [SHIFT] + [S].
      4. The walls you currently drawing are now painting with light grey color and info such as angle and length displaying in the top left corner.
      5. Sounds you currently listen in 2D Mode by pressing [F10] are now displays additional info such as volume, sample rate and looping flag.
      6. Added sector sound settings in 2d mode sector edit dialog. It will create new/modify existing sector sfx sprite. for you if sound values are not zero or remove all the sector sfx sprites in current sector if they are. Note that it takes in account only first found sprite, because it's a very rare case when same sector have more than one sfx sprites. Same as for data fields, you can listen defined sounds by pressing [F10].
      7. For now you can't insert points anymore while drawing a sector. This might be changed later.
      8. Pressing [G] alone will not lead to off grid anymore, so you have to press [ALT] + [G].
      9. Added auto-grid feature. It changes grid size for you while zooming. You may toggle it off and on by pressing [CTRL] + [G]. There is also section [AutoGrid] was added that allows to control zoom value for each of 6 possible grids. Note that auto grid is not working when grid is disabled at all.
      10. There was added 2 more grid sizes which is extremely tiny and probably will be rarely used. It won't appear if you pressing just [G], so you have to press [SHIFT] + [G].
      11. There is no more required to press [ALT] + [F] when setting first wall of sector. Just [F] is fine.

    • 3D MODE:

      1. Added modern types list in Game objects menu.
      2. [SHIFT] + [TILDE] or [SHIFT] + [CAPSLOCK] toggles mouse look on and off.
      3. Added new INI setting for MouseLook section called "Turn2Strafe". Set 1 if you want to strafe with keyboard instead of turning. Disabled by default.
      4. [SHIFT] + [B] are now works (one side blocking wall).
      5. ZMode type now saves in XMAPEDIT.INI.
      6. Added "About" button in main menu where you can get xmapedit version info.
      7. Fixed that free z-modes may not work properly for parallaxed sectors that have absolute ceilingZ.
      8. Fixed that sometimes sprite could receive wrong angle if clipboard was not empty.
      9. The return of key [O] function in 3D Mode (never liked it!) by request.
      10. Added an option to the [Mouse] section that allows to define fixed size of grid for sprite dragging.
      11. Sprites that was highlighted in 2D mode are now also blinking in 3D mode.

  25. JAN 23 2021

    • Site update: there will be no manual in the xmapedit package anymore since you can just read all the info right here (you may also just save this whole page).

    • 2D Mode:

      • Captions is not displaying anymore while zooming. This leads to great performance boost, especially in complicated maps.
      • The enemies and dude spawn markers now paints with light red color.
      • Smaller vertex size.

    • Preview mode:

      • Fix: preview speed was one tick slower than in game (if you have Speed param changed, please return it back to 4).
      • Goo palette was not set when go in underwater sectors with goo markers.
      • Fix: underwater palette was not reset when preview is finished.
      • Fix: 2d mode palette change.
      • Fix: moving through stacks is more correct now.
      • Fix: the camera was teleporting with enemies even when only enemies should teleport.
      • Added game difficulty menu.
      • Added game mode menu.
      • Correct sprite removal, so it won't trigger when deleted.
      • Added episode INI option. Define your INI to see the actual INI messages or play MIDI songs.
      • Gargoyle Statues, Cerberus and Beast Cultist now morphing in their next stage instead of just being removed.
      • Fix: Cryptic Passage (and other custom textures) was erased when using preview mode.
      • Added create standard explosion feature. Try press [E].
      • SEQ animation is now working for some of sprites.
      • Gib FX effects are now working.
      • Proximity trigger flag now can be tested (vanilla and modern).
      • Sight trigger flag now can be tested (modern only).
      • You can see explosion radius in 2d mode.
      • If have gravity z-mode, it will be automatically switched to mouse look when falling into underwater sectors.
    • There is no more "Missing ambient sound" error.
    • There is no more "Missing voxel" error.
    • Earth Zombie finally always will be put on floor.
    • Fixed vanilla's weird crash when flying too high in parallaxed sectors (you cannot go higher than ceilingz*4 anymore).
    • Fixed that the camera starts flying instead of falling in gravity mode once map is loaded.
    • Correct XMAPEDIT.INI creation at first launch.
    • [CTRL] + [HOME] sequence now working in 3d and 2d modes.
    • The mouse will not set statnum for your sprites automatically when you drag sprites in 3d mode.
    • There was added new tool to the ESC menu in 3d mode called "Exploder Sequence". Try this out.

  26. JAN 04 2021

    • There was added a cool Preview Mode feature. Works in both 2D and 3D modes and allows to test trigger sequences, sector motion, sounds (include ambient ones) and ROR sectors in real time. Refer to manual for details.
    • There was added a main menu when you press key [ESC].
    • Added new z-mode that allows to select z direction with mouse.
    • You can move through stacks.
    • Added commands for sector pause/continue motion (modern only compatible).
    • Added stealth dude flag (modern only compatible).
    • Key [K] now working in both modes.
    • Key [CTRL] + [HOME] now working in both modes.
    • Key [F12] now working in both modes.
    • Key [U] now working in both modes.
    • Key [X] now working in both modes.
    • Key [R] now working in both modes.
    • Key [1] now working in both modes.
    • Various minor fixes.

XMAPEDIT MANUAL

Note: This is a short version of offline manual that available for download on the site header. It contains brief description of program features.

Another good resources where you can find info about vanilla MAPEDIT is a MAPEDIT.TXT that comes with your copy of Blood or BME's web-site: http://baitd.bloodgame.ru/bme.htm.

  1. About XMAPEDIT
  2. Installation & Notes
  3. Brief features, updates and fixes overview
    1. General
    2. 3D Mode
    3. 2D Mode
  4. Comment system
  5. Prefabs
  6. External models
  7. The preview mode
  8. Mouse controls
  9. Filebrowser
  10. External Commands
  11. Split edit mode
  12. Tile viewer
  13. Local and Global Sky editing
  14. Batch object processing
  15. The tools
    1. Loop split
    2. Arc Wizard
    3. Door Wizard
    4. Shape tool
    5. Sprite Text
    6. Import Wizard
    7. Artedit
    8. Qavedit
    9. Seqedit
    10. Exploder sequence
    11. Gradient shading
  16. Configuring XMAPEDIT
    1. XMAPEDIT.INI
      1. Screen
      2. Sound
      3. PreviewMode
      4. Mouse
      5. MouseLook
      6. TileViewer
      7. AutoSave
      8. Compatibility
      9. General
      10. Comments
      11. HUD
      12. AutoGrid
      13. AutoAdjusting
      14. Rotation
      15. RESOURCES.ART
      16. RESOURCES.RFF
      17. ExternalCommands
    2. KEYREMAP.INI
      1. KeyRemap

Brief features, updates and fixes overview

Comment system

Overview

Comment system allows to create textual notes and show it directly in 2D mode of the editor. The comments may be standalone or you can bind it to any object in the map. It useful for author of the map to mark some areas, to have a reminder or for other users that want to use it as example.

At the momemnt of writing this text, comments for each map stored in separated file that automatically saves in same directory where the map is going to be saved. It always has same name as the map file, but different extension (.MCT) since it allows to avoid losing all the info if saving with classic MAPEDIT, older versions of XMAPEDIT or other editors. It is a plain text file format with INI stucture, so you can always edit it in notepad.

For advanced security, a MapCRC parameter added. By default XMAPEDIT compares this value with actual map file CRC to make sure comments got bound with correct objects. This check can be disabled in configuration file (see [Comments] section).

How to use

To create a new comment, press [ALT]+[W] anywhere in the map, so an editing form appear. Type the text that cannot be longer than 128 characters. Now you can just press "Confirm" to save changes and comment will be created with default settings. For advanced customization see the description below:

  1. Font button allows to select a different font, however you must note that non-default fonts have fixed size and won't be scaled to the current zoom. Also the color of colored fonts cannot be overriden via Foreground property.
  2. Foreground changes the color of the text (if monochrome font selected) and/or tracer, while "Background" alters the background of the text. Select "None" if you want it to be transparent.
  3. With tracer: When checked it means that arrow will be added to the comment, so you can drag it anywhere you want. If disabled and you can't uncheck it, it means that comment is NOT standalone, and arrow will change it's position automatically depending on object's average point.
  4. Thick: Check it to make tracer arrow bold.
  5. Standalone comment: Uncheck it if you want to bind the comment to an object. If you can't, it means that there is no any objects near the place you gonna create the comment and it will be created as standalone.
  6. Delete unbinds and deletes existing comment from the map.

In 2D edit mode you may hold [MIDDLE MOUSE] to drag the text or the tracer anywhere you want. To edit existing comment, you must press [ALT]+[W] when it's text or object which is commented under mouse cursor. Press it on the end of the tracer (if available) to make object bind menu appear that allows you to select actions such as bind comment to object, unbind it or remove the tracer.

Prefabs

Overview

Prefab is a text file with INI structure that contains information about sprites that should be automatically created once user inserting it in a map. File format description available in this file. Basically, it keeps all necessary properties of common sprites such as geometry, coordinates and appearance.

Another good thing that it also keeps properties of xsprites, which is allows to save whole trigger sequence and make it unique once inserted in a map. The following image shows a piano trigger sequence from E1M1 map with newly defined RX/TX channel IDs:

Creation and usage

All default prefab files stored in "XMAPEDIT\PREFABS" directory and have "PFB" extension, but since is a text file, it can be opened in any text editor. To insert a prefab, you just call Game Objects menu with [ALT] + [S] in 3D Mode or [SHIFT] + [S] in 2D Mode and hit "Insert" button under Prefabs section.

To create a new prefab, you need to go through following steps:

  1. Highlight at least 1 sprite with [SHIFT] or [MIDDLE MOUSE].

  2. Open Game Objects menu and hit "Save" button to call the prefab options window that will ask you to tweak a few prefab properties:

    The left part of the window allows you to define prefab face side. This is required to determine which side the prefab should be turned to user when gets inserted in the map. The default angle is 1536, but you may leave arrow buttons unpressed if you want to save it as is.

    The right part just shows a thumbnail that will be attached to the prefab file so you can preview it in filebrowser. Disable "Attach thumbnail" checkbox if you don't want any, but keep in mind that the browser will generate it automatically, which is just may not always look good enough.

  3. Finally, just hit "Confirm" button to save the prefab!

External models

Overview

XMAPEDIT can load up to 4096 external models without modifying original game files. This allows level designers to place sprites with correct angles without guessing what user will see when playing the map with various voxel packs installed. One of voxel packs that already support xmapedit available on https://github.com/fgsfds/Blood-Voxel-Pack.

The model file must be correct standard BUILD .KVX voxel saved with all 5 mips and colors converted into Blood palette. The path to the file must be shorter than 144 characters. Only face sprites supported at the moment, so voxel won't show if sprite is wall or floor oriented.

Usage

To define a new external model, it must be added into XMAPEDIT database first. You must open "MODELS.INI" (filename can be changed in xmapedit.ini) file usually stored in XMAPEDIT directory with any plain text editor (if you don't have such file, just create the new one).

Each line in this file is the tile number and path to the KVX file separated with "=" (equal) sign. Now you just need to define your voxel by writing something like that: [Default]
Tile300 = FOLDER\FOLDER2\MYMODEL1.KVX
Tile2048 = FOLDER\FOLDER2\MYMODEL2.KVX

In the example above "MYMODEL1.KVX" file will be assigned to tile #300 and "MYMODEL2.KVX" to the tile #2048. That's it!

To force voxel spin flag (weapons like), you may just add "*" (star) sign before the KVX file path: [Default]
Tile300 = *FOLDER\FOLDER2\MYMODEL1.KVX

Options

XMAPEDIT configuration file provides some additional settings: Please, refer to "ShowExternalModels" description in the [General] section and "ExternalModels" in [RESOURCES.ART].

The Preview Mode

Overview

This feature can be activated any time, works in both 2D and 3D modes and allows to test trigger sequences, sector motion, sounds (include ambient ones), ROR sectors, SEQ animation of some sprites, FX effects of gib objects and even INI messages in real time.

Basically, it allows to play the map directly in the editor to see how it will look in the game. When preview mode enabled, you cannot edit anything, however, when testing is finished, it restores all objects to the editor's state.

Controls

To enable preview mode, press key [HOME], to disable press [ESC] or [HOME] again. If you wish to change difficulty and game mode settings, hold [SHIFT] while pressing [HOME].

Mouse controls allows to trigger objects by commands depending on mouse button you clicked. The default commands can be changed in XMAPEDIT.INI as well as some other settings. Refer to "CONFIGURING XMAPEDIT" chapter for more info. There is also supported trigger flags such as Enter, Exit, Sight (modern features only) and Proximity.

Mouse controls

  1. HUD Edit dialogs

    Move mouse or hold [Q] and scroll [MOUSE WHEEL] to focus on property you want to edit.
    Press [LEFT MOUSE] to toggle checkbox state.
    Press [RIGHT MOUSE] to reset value of an item to 0.
    Press [MIDDLE MOUSE] to call a helper function if available.
    Scroll [MOUSE WHEEL] to change the value of property by 1. Hold [ALT] for greater step or [CTRL] to set min or max value accordingly.

  2. Tile viewer

    Press [LEFT MOUSE] to select a tile.
    Press [MIDDLE MOUSE] to open detailed info window.
    Move mouse to the first row and hold [RIGHT MOUSE] to scroll the tiles up.
    Move mouse to the last row and hold [RIGHT MOUSE] to scroll the tiles down.
    Scroll [MOUSE WHEEL] to scroll tiles up or down.

  3. Sprites (3D Mode)

    Hold just [LEFT MOUSE] to drag the sprite(s) you currently pointing at by XYZ axis. If sprite was placed on a wall, you may also hold [RIGHT MOUSE] to align it according to that wall angle. It doesn't work for group of sprites thought.

    Press and hold [RIGHT MOUSE] first, then hold also [LEFT MOUSE] to drag sprites only by Z axis.

    Press [RIGHT MOUSE] repeatedly when aiming in floors or ceilings to just rotate sprite in CCW order, holding [SHIFT] leads to rotate the opposite way. Grid size and grid lock affects x/y dragging.

  4. Sprites (2D Mode)

    If there is more than one sprite at same XY coordinates and you want to focus on specific, you may hold [ALT] and repeatedly scroll [MOUSE WHEEL] until you meet the one that you needed.

  5. Walls and sectors (3D Mode)

    Hold [LEFT MOUSE] to raise the sector or [RIGHT MOUSE] to lower it. Hold [SHIFT] for finer step or [CTRL] to set Z of sector to the closest neighbor sector(s).

  6. Highlighting objects

    • 2D Mode

      Press [MIDDLE MOUSE] without [LEFT SHIFT] to highlight or unhighlight wall point or sprite. Note that all sprites and wall points with same coordinates will be automatically added or removed from a highlight. Holding [LEFT SHIFT] leads to sectors highlighting that allows to select sectors from different areas of the map:

    • 3D Mode

      Press [MIDDLE MOUSE] to highlight an wall or sector for gradient shading (see TOOLS). Press again on it to unhighlight. Usually, highlighted objects displays as pink colored, however sometimes it might display as normal (for instance, after you applied the gradient shading). To show previously highlighted objects, continue holding [RIGHT MOUSE] and press [CTRL]. To reset highlight, just press [ESC].

      Pressing mouse on a sprite will add or remove it from standard highlight.

Filebrowser

The filebrowser allows to save and load file or multiple files. It supports generating thumbnails for most of files the editor can handle. You can use [ARROWS] or [MOUSE WHEEL] to navigate through file list. Press [ENTER] or double click [LEFT MOUSE] button to select the file you need.

Additonal controls:

[BACKSPACE] Move up one directory level
[INSERT] Create new directory
[DELETE] Remove file or directory
[SPACE] Rename file or directory
[PAGE UP/DN] Scroll one page up or down
[HOME] Go to first file
[END] Go to last file
[F2] Toggle showing thumbnails
[F3] Toggle stretching image in the large preview area
[F5] Rescan current directory
[CTRL]+[F5] Clear thumbnails cache and rescan current directory
[SHIFT]+[LT/RT ARROW] Set less or more columns
[SHIFT]+[UP/DN ARROW] Set less or more rows
[SHIFT]+[UP/DN ARROW] Set less or more rows
[F10] Reset columns and rows to defaults

Split Edit Mode

It allows to edit map in both 3D and 2D modes at a time. To enable or disable split mode, press [PAD PERIOD] + [PAD ENTER]. To switch between viewports, you may move [MOUSE] or press [PAD ENTER] (if you have Mouse Look enabled in 3D Mode). Main HUD have it's own layout for this mode, so you may need to setup it accordingly.

There is vertical and horizontal window split supported. Press [CTRL]+[ARROW RIGHT/LEFT] to set a vertical split or [CTRL]+[ARROW UP/DOWN] to set it horizontal. By default the program selects it automatically depending on resolution format. Continue holding [CTRL]+[ARROWS] to setup the first window size (default is 50%).

By default split size swapping is enabled. It means that viewport you just switched on will get more size, than inactive one when size is not 50%. This could be useful for low resolutions. If you wish to toggle this feature, please press [CTRL]+[SCROLL LOCK].

External commands

Overview

XMAPEDIT supports up to 8 custom external commands that can be executed by operating system. For example, you can write a command that will open Nblood (or anything else) for testing the map you currently editing.

Usage

To manage commands, open XMAPEDIT.INI and find the "ExternalCommands" section. Unlike most of other settings in this file, here you don't need to use "Key=Value" pair, so you can add commands directly (one line for one command).

The easiest way to create a basic command, is to just write absolute or relative path to .EXE/COM/CMD/BAT file as it shown in example below. Map you currently editing will be passed to as argument automatically: [ExternalCommands]
C:\Folder\nblood.exe
SubFolder\other1.exe
other2.exe

Sometimes is just not enough. If that is case, you may need to use extended syntax with macros support to make your commands more flexible. Keep in mind that all macros must be prefixed with "%" character and must be written in upper or lower case, but not both:

%CWD Absolute path to current working directory.
%FILE Absolute path to file that is currently opened in editor.
%file Relative path to file that is currently opened in editor.
%BLOOD_RFF Absolute path to game resource archive that specified in [Resources.RFF] section.
%blood_rff Relative path to game resource archive that specified in [Resources.RFF] section.
%SOUNDS_RFF Absolute path to sound resource archive that specified in [Resources.RFF] section.
%sounds_rff Relative path to sound resource archive that specified in [Resources.RFF] section.
%EPISODE_INI Absolute path to game episode INI file that specified in [PreviewMode] section.
%episode_ini Relative path to game episode INI file that specified in [PreviewMode] section.

When using extended syntax, keep in mind that path to executed file must be quoted as shown in example below: [ExternalCommands]
"C:\Folder\nblood.exe" -game_dir %CWD -quick -map %file -ini %episode_ini
"SubFolder\nblood.exe" -quck -map %FILE

Example shows that for first command system will launch "nblood.exe" in "C:\Folder\" directory, then we tell nblood to use current working directory as game directory, show no logos, open the map file we currently editing and use our episode ini (for example, to show correct text messages). We use relative path to MAP and INI because we already set absolute path to game directory.

For second command the system will launch "nblood.exe" in "SubFolder" of current working directory, then we tell nblood to show no logos and open the map file we currently editing. We use absolute path to MAP file because we launch nblood from subfolder.

Tile viewer updates

  1. Added translucent background (enabled by default).
  2. Added a GUI dialog which you can call by pressing key [F12].
    • Stretch tiles (stretch tiles to the thumbnail size).
    • Show transparent color.
    • Play animation (some animations may bounce).
    • Translucent background.
    • Always show misc tile info (such as view type or animation frames).
  3. Transparent color is no longer showing by default. You can control it by pressing [T].
  4. Added palswaps support. Press [P] to enter PLU id, [RSHIFT] + [P] cycles PLUs to the left, [LSHIFT] + [P] to the right.
  5. Key [Q] allows to cycle through texture types (sprite, wall, floor etc...).

  6. Added "Favorite tiles" feature that allows to save selected tile in XMAPEDIT.FTL and use it in other maps instead of searching for it every time you start a new board. Also it allows to bind a type which is useful for sprites.

    Press [F] to add current tile to the favorites or remove it from the list. When adding a tile, it will also ask to define a type for sprites. You can enter name, caption or id. If you don't want to define anything, just leave it empty and it will be automatically defined as decoration.

    If tile added in favorites, tile viewer prints "FAV" sign in the bottom right corner of the tile.

Sky editing

Xmapedit offers you to work with parallax sectors under the new perspective: the Local and Global sky.

The Local sky is the group of sectors that is not separated by a non-parallaxed sector and Global is all the parallxed sectors in the map. This allows to quickly apply propeties such as y-offset, shade, palette to the whole room or map depending on selected scope.

  1. [PAD8] or [PAD2]: Offset local sky Y position. Hold [ALT] for global scope.
  2. [PAD4] or [PAD5]: Rotate global sky by 1 tile. The smore sky tiles used, the more angles available. This feature available for global scope only. Note that it also affects floor and ceiling sky.
  3. [PAD0], [PAD-] or [PAD+]: Change local sky shade. Hold [ALT] for global scope.
  4. [PAD5]: Reset sky x-panning and y-panning. Hold [ALT] for global scope.
  5. [L]: Toggle the local forced floor shade bit. Hold [ALT] for global scope.
  6. [CTRL] + [SHIFT] + [P]: Disable local sky.Hold [ALT] for global scope.
  7. [P]: Change local sky palette.

Batch object processing

The following new actions (apart from vanilla's ones) available for batch processing at the moment:

  1. Sprite deletion: Hold [SHIFT] to delete just one sprite.
  2. Sprite shading: Hold [SHIFT] to shade just one sprite.
  3. Sprite palette set: With key [ALT] + [P] only.

More actions are planned for next updates.

The tools

Configuring XMAPEDIT

There is few configuration files available for editing (currently XMAPEDIT.INI and KEYREMAP.INI). These files will be automatically created inside XMAPEDIT folder once you launch the program for the first time.

XMAPEDIT.INI

This file contains general editor settings, which allows to fine tune the program.

KEYREMAP.INI

This file allows to map keys. For example, it could be useful for laptops without numpad keyboard.