SRB2 Message Board  

Go Back   SRB2 Message Board > Sonic Robo Blast 2 > Releases > Software

Reply
 
Thread Tools
Zone Builder v2.9 - Map editor for SRB2 Details »»
Zone Builder v2.9 - Map editor for SRB2
Version: 2.9, by MascaraSnake (Retired) MascaraSnake is offline
Developer Last Online: Jun 2020

Version: SRB2 Rating: (22 votes - 4.91 average)
Released: 01-05-2016 Last Update: 01-30-2016 Favourites: 24
Re-Useable Content Additional Software

Don't forget to download the 2.2 config, which is attached to this post! Here's how you use it:
Drop it into ZB's "Configurations" folder. Then, in ZB, go to Tools -> Game Configurations. Check the box that reads "Sonic Robo Blast 2 - 2.2". Under the Resources tab, click "Add resource...". In the window that pops up, go to the "From PK3/PK7" tab and add srb2.pk3. Check the "Exclude this file from testing parameters" box. Then, under the Testing tab, add srb2win.exe as an executable.



Zone Builder is a map editor designed specifically for SRB2. It's based on GZDoom Builder, itself a comprehensive update of Doom Builder 2.

I no longer maintain Zone Builder. Please refrain from making feature requests. The source code is archived at http://git.magicalgirl.moe/MascaraSnake/ZoneBuilder. If anyone wants to pick up the project, feel free to do so.

Features inherited from Doom Builder 2/GZDoom Builder
If you haven't used Doom Builder 2 or GZDoom Builder before, here are a few of the features that will be new to you:
  • Unlike in the old (SRB2) Doom Builder, level geometry will rarely if ever break if you copypaste it around or draw linedefs through existing geometry. New vertices will be added and sector references corrected so that everything stays intact.
  • In the regular 2D view, the floor textures of the sectors are overlaid over the map (you can also change this to show the ceiling textures or the brightness levels instead). Likewise, the real sprites of the Things in the map are shown.
  • When you hover over a control linedef or its tagged sector, an arrow will show up that shows their connection. In Sectors Mode, the sector tags are also shown inside the sectors.
  • There are several drawing modes that allow you to easily draw generic shapes like rectangles, curves and circles.
  • When creating a new linedef, its length and angle will always be visible on screen - so you don't have to play around with your viewpoint to get the whole picture.
  • You can have Things selected together with other level geometry at the same time. Just switch to another editing mode after making your selection and it will still be active. You can then move, resize, rotate and flip these selections all at once by pressing E to open Edit Selection Mode. Pressing C clears your selection.
  • There's a Nodes Viewer mode that allows you to view the data generated by the nodebuilder (pretty useless, but cool to play around with).


SRB2-specific features
Visual Mode has support for the following SRB2 features (features in bold haven't been handled properly in a SRB2 map editor before):
  • Slopes
  • FOFs (now with translucency and shadows where applicable; linedef flags that modify the appearance of FOFs are also recognized)
  • Z position handling of things (now properly clamped between 0 and 4095 at all times)
  • Things that float when given the Ambush flag are displayed as such
  • Things with the Flip flag are properly flipped
  • Repeating midtextures
  • Translucent midtextures
  • Texture alignment for FOFs is displayed correctly and can be edited in 3D mode like with any other wall
  • Flat alignment
  • Colormaps (incomplete: rendered at full intensity regardless of the specified alpha value)
  • Skies are rendered in Visual Mode
Outside of Visual Mode, notable features include the addition of a Flags Value field for all Things, so you don't have to go counting up the checkboxes and multiply the Z value by 16 each time you want to do something with a nonstandard use of flags, as well as a field for displaying and editing the Parameter value of a Thing, for the few Thing types that use it.

As you may remember, SRB2 Doom Builder had the ability to rename the Ambush flag for Thing types where it has a special significance, i.e. displaying "Float" instead of "Ambush" for rings. Workbench expanded that to the Special flag. Zone Builder is the first editor where every relevant Thing and linedef property can be renamed, including all flags, the flags value field and the Angle field. This makes it easier to set up special effects without having to look up which field does what on the Wiki all the time.



Releases

16/12/2018 - v2.9 - SRB2Kart config and improved PK3 support
Spoiler: Changelog
  • Added feature: Added the configuration file for SRB2Kart. It's enabled by default in new installations, but if you updated an existing installation, you have to enable it manually under Tools -> Game Configurations.
  • Changed behavior: The PK3 reader now looks for SOCs in the "SOC" folder rather than "SOCs", just like SRB2.
  • Added feature: Added an option to draw Things at a fixed size in the 2D view, rather than scaling them with the zoom level.
  • Added feature: Some additions to the config.


03/12/2017 - v2.8 - Two bugfixes
Spoiler: Changelog
  • Bugfix: Linedef flag settings are no longer lost when copypasting linedefs.
  • Bugfix: Fixed a crash in the Tag Statistics window if you remove a tag label.


03/11/2017 - v2.7 - A bunch of stuff that has been sitting around for way too long
Spoiler: Changelog
  • Added feature: Added texture filters for SRB2's default textures (thanks a bunch to TehRealSalt!).
  • Added feature: Colormaps and FOFs with tag 65535 (global) are now displayed in Visual Mode.
  • Added feature: PK3s are now supported as resource files (but not as map files). ZB looks for patches in the directories "patches", "textures", "flats", "sprites" and "graphics". It also reads custom Thing definitions from SOCs (in the "socs" directory) and Lua scripts (in the "lua" directory). Right now PK3 support is irrelevant for you, dear v2.1 user, but come v2.2 this will be quite useful.
  • Added feature: You can now specify a category for custom Things with the $Category keyword. It works just like $Name and $Sprite.
  • Changed behavior: The custom Thing definition parser no longer throws an error when it can't read a single value. Instead, it throws a warning and continues parsing the rest of the file.
  • Added feature: The custom Thing definition parser can now read addition in a very limited manner, so stuff like "16*FRACUNIT + 32768" will no longer throw an error.
  • Added feature: The custom Thing definition parser now recognizes -- comments in Lua files.
  • Added feature: The custom Thing definition parser now recognizes the flags MF_SOLID and MF_SPAWNCEILING. In particular, this means that Things with the MF_SPAWNCEILING flag are now displayed properly in 3D mode.
  • Added feature: Added a nodebuilder configuration for normal ZenNode without REJECT. This might be useful for test builds on very large and complex maps, where ZenNode's fast setting produces errors.
  • Bugfix: ZWADs are now rejected with an error message instead of crashing the program.
  • Added feature: Added an option to disable the crosshair in 2D view.
  • Bugfix: Fixed a bunch of typos in the config.
  • Changed behavior: Changed the names of a few specials in the config that were bothering me. For example, monitors are now listed under "Monitors" instead of "Item boxes".


28/01/2017 - v2.6 - SRB2 Top Down config and bugfixes
Spoiler: Changelog
  • Added feature: Added the configuration file for SRB2 Top Down. It's enabled by default in new installations, but if you updated an existing installation, you have to enable it manually under Tools -> Game Configurations.
  • Bugfix: When changing the offsets of a linedef with a repeating middle texture (either manually or with the auto-alignment tool), the multiples of 4096 that control how often the texture is repeated are no longer cut off.
  • Bugfix: ZB no longer crashes if the loaded files contain multiple SOC/Lua lumps with the same name - it simply ignores all duplicates and prints a warning in the console.
  • Bugfix: "Slope backside" linedef types with the No Knuckles flag now use the offsets of the back sidedef as they should, instead of the front sidedef.
  • Bugfix: Thing angles outside of 0-359 are now recognized in Find/Replace mode.
  • Bugfix: The ROIH and ROII versions of the Bustable Block Sprite Parameter sector types are no longer mixed up.


17/09/2016 - v2.5 - Updates for 2.1.16 and bugfixes
Spoiler: Changelog
  • Added feature: Various minor updates for 2.1.16, such as updating the Lua syntax highlighting and adding new slope-related linedef types and flags to the config.
  • Changed behavior: Adapted the pegging behavior for lower textures with the Lower Unpegged flag, which was changed in 2.1.15.
  • Bugfix: Fixed two issues with the Lua parser's $Name parameter: Spaces are now accepted in the name and there's no longer a ] at the end of every name.
  • Bugfix: Fixed some issues with the skewing of upper textures on slopes.
  • Bugfix: Colormap is now applied correctly to flipped Things.
  • Bugfix: Indefinitely tiled middle textures with a vertical offset are now displayed correctly in 3D mode.
  • Bugfix: Fixed a crash when creating a custom FOF with an invalid back upper texture.
  • Bugfix: Fixed a crash when opening the edit window for a linedef with action 402 (aka the weirdest bug ever).
  • Bugfix: Fixed some description errors with linedef type 414 in the config.
  • Bugfix: Fixed several crashes in the Choose Thing Type window that happened when pressing certain keys while no Thing is selected.
  • Bugfix: Thing angles outside of 0-359 are now preserved when copypasting or placing new Things.
  • Bugfix: The BLOCKMAP and REJECT lumps are now deleted before nodebuilding to prevent outdated data from being loaded in-game and messing everything up.


24/05/2016 - v2.4 - Updates for 2.1.15
Spoiler: Changelog
  • Added feature: Various minor updates for 2.1.15, such as updating the Lua/SOC syntax highlighting and removing the "+ Slopes" from the config name
  • Added feature: Colormap rendering can now be disabled in Visual Mode by pressing Alt+C.
  • Added feature: You can now supply a name to be displayed in the editor for custom Things. This is done with the $Name parameter; the syntax is the same as for $Sprite.
  • Added feature: Updated the codebase to revision 2501 of GZDoom Builder, so now I'm only 135 revisions behind instead of 144. :X


06/04/2016 - v2.3 - Lua and SOC support in the script editor, custom Things supports

Spoiler: Changelog
  • Added feature: The script editor now supports Lua and SOC scripts, with syntax highlighting and autocompletion. It will automatically open tabs for all SOC_ and LUA_ lumps in the currently loaded file, as well as for the MAINCFG and OBJCTCFG lumps (even if they don't exist yet). You can also create and edit standalone SOC and Lua files, but you can't add new script lumps to existing WADs (except for MAINCFG and OBJCTCFG in the currently loaded file), because Zone Builder isn't a lump editor and I don't plan for it to become one.
  • Added feature: Zone Builder now automatically searches all Lua and SOC scripts in the currently loaded files for custom Thing definitions. These custom Things are then recognized by the editor and added to the list of Things. You can set the sprite that the editor displays for a custom Thing with a special comment; look here for an explanation.
  • Added feature: You can now assign shortcuts for increasing/decreasing the number of Things and the radius in Insert Things Radially Mode. If you're updating from a previous version, you may have to set the shortcuts yourself, otherwise the default values are Ctrl+ScrollUp/ScrollDown for Increase/Decrease Number of Things and Shift+ScrollUp/ScrollDown for Increase/Decrease Radius.
  • Bugfix: When testing a map, the temp file that contains potentially unsaved changes is no longer loaded if it's identical to an already loaded file. This was changed because SRB2 is stupid and refuses to start if it loads two identical files.
  • Bugfix: Fixed a bug that caused offsets to be incorrectly applied to middle textures.


01/03/2016 - v2.2 - Texture skewing, Parameter, Insert Things Radially

Spoiler: Changelog
  • Added feature: Added support for texture skewing in 3D mode. If you're asking yourself "What's texture skewing?", see https://wiki.srb2.org/wiki/Slope#Texture_skewing for an explanation.
  • Added feature: The Parameter property of Thing types is now recognized and can be edited in the Thing edit form. Things with the same type but a different parameter value are now recognized as having the same type.
  • Added feature: Added Insert Things Radially Mode, which allows you to place a circle of Things in the map (useful for NiGHTS mapping).
  • Changed behavior: When testing a map with unsaved changes, the game now loads the unsaved changes as well. If you have already set up a testing configuration, you will have to edit it for this to work: In the Testing tab of the Game Configurations window, check the "Customize parameters" box. In the Parameters field, add "%F" (with quotes) after -file "%AP".
  • Changed behavior: Disabled the Visplane Explorer by default since it's useless for SRB2 and prone to crashes. You can re-enable it under Game Configurations -> Modes if you like crashes.


01/02/2016 - v2.1 - Bugfixes
Spoiler: Changelog
  • Bugfix: Creating and copypasting certain FOF control linedefs no longer crashes the editor.
  • Bugfix: The nodebuilder is no longer invoked twice when entering 3D mode.
  • Bugfix: Due to an oversight, the nodebuilder was called with the "Save" settings rather than the "Test" settings when entering 3D mode, which took much longer. This is now fixed.
  • Bugfix: Entering 3D mode in a map with invalid nodebuilder data (for example a map with only one sector) no longer crashes the editor.


30/01/2016 - v2.0 - Skies, NiGHTS path, customizable Thing/linedef field descriptions, and lots more

Spoiler: Changelog
  • Added feature: Added an option to extend the crosshair in classic modes to the map boundaries.
  • Added feature: The NiGHTS path (i.e. axis transfer lines and circles around axes) is now drawn on the map.
    • Each mare is drawn in a different color; the colors are configurable under Preferences.
    • There's a toolbar button for toggling NiGHTS path drawing, which you can bind to a key if you want.
    • The precision with which the circles are drawn is configurable under Preferences.
  • Added feature: Special Z position handling for NiGHTS item circles, axes and hoops in 3D mode.
  • Added feature: The Flags value field for Things is now directly writeable (instead of having to manipulate flags and height seperately).
  • Added feature: The game configuration now handles many game-dependent things, including the following:
    • Marking slope/FOF linedef types and setting their properties.
    • FOFs that change their properties when certain flags are checked are now always displayed correctly.
    • The descriptions for linedef/Thing flags are renamed for linedef/Thing types where they have special significance. For example, the "Ambush" flag is renamed to "Float" for rings.
    • For Things, the flags value and Angle description are also renamed where they have a special significance. For example, the Angle box is renamed to "Tag" for the slope vertex Thing.
    • Thing types that float when given the Ambush flag are marked in the config and displayed as such in 3D mode.
    • Thing types that ignore the Flip flag are marked in the config and displayed as such in 3D mode.
  • Added feature: FOFs in 3D mode now support rendering planes and sides seperately.
  • Added feature: Skies are now rendered in 3D mode, which can be toggled on and off.
  • Added feature: The "Peg Midtextures" flag (see changed behaviour) is now recognised in 3D mode.
  • Added feature: In the Testing tab of the Game Configurations menu, the skill level option has been replaced with skin and gametype option for SRB2 configurations.
  • Added feature: Updated the codebase to revision 2492 of GZDoom Builder. Besides skies, the most notable addition on the GZDB side is that Find/Replace mode now allows you to search for floor and ceiling flats.
  • Changed behaviour: The minimum segment length for the Draw Curve tool is now 1.
  • Changed behaviour: Changed the "About Zone Builder" icon.
  • Changed behaviour: Changed the uninstaller icon.
  • Changed behaviour: Visplane Explorer is now available for SRB2 maps.
  • Changed behaviour: "Copy Properties" tool is now available for SRB2 maps.
  • Changed behaviour: The default texture for SRB2 maps is now "GFZROCK", the default flats are "GFZFLR01" and "F_SKY1".
  • Changed behaviour: Updated the default flag names for Effects 1-5 to reflect their usage in the Public Next SRB2 repository.
  • Bugfix: Prevented negative Thing heights for SRB2 maps (rollover led to them being extremely far off the ground in-game despite rendering properly in the editor).
  • Bugfix: Raised maximum number of segs from 32767 (signed 16-bit) to 65535 (unsigned 16-bit), like it is in SRB2 (as a result, large maps no longer crash Visual Mode).
  • Bugfix: Lumps in the same WAD file are not autocapitalised when saving a map (for those of you who want to recreate 1.09.4 and bundle terrible characters with your level packs).
  • Bugfix: Now handles patch offsets properly (they are signed 16 bit integers, not 32 bit - someone messed up when defining the ACZ sky...).
  • Bugfix: Removed the updater from new installs (my apologies to those who were curious and clicked on it - ending up with the latest version of GZDoom Builder instead of Zone Builder)


10/01/2016 - v1.1 - Mostly bugfixes and minor changes

Spoiler: Changelog
  • Added feature: .srb files are shown directly in the assets file picker, so you don't have to change the filter anymore to see them.
  • Added feature: Added an "All Files" filter to the level and assets file pickers.
  • Added feature: The number of maximum backup files is now configurable under Preferences -> Interface.
  • Changed behavior: Slope vertices are now rendered so that their center intersects with the slope, rather than the bottom.
  • Changed behavior: The selection isn't automatically cleared anymore in Visual Mode by default. You can re-enable this setting under Preferences -> Editing.
  • Changed behavior: Linedef angles are now displayed like in SRB2 (0 degrees means the linedef goes from west to east).
  • Bugfix: Vertex slopes are now always displayed correctly in Visual Mode. Unfortunately, this means that the nodebuilder is now run every time you enter Visual Mode with unsaved changes. It normally shouldn't take more than a few seconds even on large maps, but if you have issues with it, go to Preferences -> Editing and check "Use blockmap instead of nodes in Visual Mode". Note that this may cause some vertex-based slopes to be displayed incorrectly.
  • Bugfix: Fixed an issue with repeating middle textures sometimes being displayed incorrectly.
  • Bugfix: The orientation of rotated flats is now displayed correctly.


05/01/2016 - v1.0 - Initial release

Installing Zone Builder
Just download the installer in the attachment below and run it. It will take care of all the necessary dependencies. On the off chance that something goes wrong, here's what you need:
  • Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) (required only by the Nodes Viewer plugin)
  • Microsoft .Net Framework 3.5
  • DirectX 9.0 Runtime
After installing, you need to point Zone Builder to SRB2's IWAD and executable. For that, go to Tools -> Game Configurations in the menu bar and select "Sonic Robo Blast 2 - 2.1". In the Resources tab, click Add resource... and the folder symbol in the window that pops up to select the IWAD. Navigate to your SRB2 folder and select "srb2.srb". Then, in the Testing tab, select SRB2 as your application. After that, you're good to go!

If you have trouble mapping with this editor, have a look at the Zone Builder tutorial on the Wiki, which explains the basics of mapping with Zone Builder. If you have any further questions, please ask in Discord or as a reply to this thread. Happy mapping!

Download Now

File Type: zip Zone Builder Setup.zip (17.32 MB, 7941 views)
File Type: zip SRB2-22.zip (18.9 KB, 1903 views)

Screenshots

Click image for larger version

Name:	zonebuilderlogo.png
Views:	46739
Size:	43.7 KB
ID:	7176   Click image for larger version

Name:	zones%20at%202016.03.01%2023-22-47.860%20%5BR2492%5D.png
Views:	42573
Size:	154.3 KB
ID:	7606   Click image for larger version

Name:	zones%20at%202016.03.01%2023-21-37.024%20%5BR2492%5D.png
Views:	42478
Size:	453.1 KB
ID:	7607  

Supporters / CoAuthors

Show Your Support

  • The author of this addon has given explicit permission for its content to be re-used and/or reproduced.

Comments
Old 06-15-2020   #422
Ace Dragon
 
Ace Dragon's Avatar
Default

I don't know what went on, but I want to say that there are a lot of people who have nothing but appreciation for what you are doing for those who make custom content for SRB2 (and how you were pushing things forward with UDMF).

Don't get discouraged, perhaps the next few months could see less time on any form of social media and more time in code and getting things done as planned. I hope you change your mind about dev. work in the future.

Last edited by Ace Dragon; 06-15-2020 at 05:26 PM.
Ace Dragon is offline   Reply With Quote
Old 06-15-2020   #423
MascaraSnake
Retired
 
MascaraSnake's Avatar
Default

Thank you for the kind words. I don't think it would be appropriate to go into detail here, but I assure you that I didn't make this decision lightly. It has nothing to do with being discouraged about a lack of progress. Things were making great progress. But unfortunately I no longer feel comfortable with being a part of this community anymore.
MascaraSnake is offline   Reply With Quote
Old 06-23-2020   #424
Ackeneister
A SRB2 Fanatic
 
Ackeneister's Avatar
Default

Error when launching:




Alright, I uninstalled and reinstalled ZB, then booted it up. I'm guessing the problem is the 2.2 config file?

Last edited by Ackeneister; 06-25-2020 at 11:37 PM.
Ackeneister is offline   Reply With Quote
Old 06-25-2020   #425
Ace Dragon
 
Ace Dragon's Avatar
Default

Quote:
Originally Posted by MascaraSnake View Post
Thank you for the kind words. I don't think it would be appropriate to go into detail here, but I assure you that I didn't make this decision lightly. It has nothing to do with being discouraged about a lack of progress. Things were making great progress. But unfortunately I no longer feel comfortable with being a part of this community anymore.
This reply is late, but it should be made clear that we who make content for SRB2 will welcome you back should you decide to rejoin the community.

Thank you for all the work you put into Zone Builder so far.
Ace Dragon is offline   Reply With Quote
Old 4 Weeks Ago   #426
verifiaman
The master of verification.
 
verifiaman's Avatar
Default

So I have no idea what's going on here, but I cannot make Sectors, Lines, or Vertices at all in Zone Builder. I have done nothing to the software whatsoever, and reinstalling it does nothing. The button used for drawing functions normally when doing other things such as selecting, dragging, etc, but as of now I cannot use Zone Builder. What happened?


Edit: I think I fixed it. I have no idea how though.
__________________
I am the master of verification

Last edited by verifiaman; 4 Weeks Ago at 01:17 AM.
verifiaman is offline   Reply With Quote
Old 4 Weeks Ago   #427
Kaleb_Advent
Just another Kart guy
 
Kaleb_Advent's Avatar
Default

As someone who just installed and started using Zone Builder today, I have a problem. If anyone can help, that'd be fantastic.

I've made a small test room in Zone Builder. However, every time I try to test the room in SRB2 Kart, this error window shows up.

Click image for larger version

Name:	parsing error.png
Views:	29
Size:	10.8 KB
ID:	34372

The linedefs have sidedefs, the floor and sky are unchanged. There's a start point.

I've got the three default SRB2 configurations on -- 2.1, Kart 1.0 and Top Down 1.0 -- and nothing else.

The only resource I'm using is srb2.pk3.

Is there something I'm missing?

Keep in mind, if it matters, I'm trying to make a level for Kart, not normal SRB2.
__________________
I have a universe in my head, and I can't explain a single piece of it.

Last edited by Kaleb_Advent; 3 Weeks Ago at 09:10 PM. Reason: typo
Kaleb_Advent is offline   Reply With Quote
Old 3 Weeks Ago   #428
sphere
Developer
Default

Here's an updated config which adds the new linedef types from 2.2.5, alongside some small bugfixes.
Attached Files
File Type: zip SRB2-22.zip (18.7 KB, 63 views)
sphere is offline   Reply With Quote
Old 2 Weeks Ago   #429
Kaleb_Advent
Just another Kart guy
 
Kaleb_Advent's Avatar
Default

...I didn't realize this was directed at me for some reason.

Okay, I've downloaded the config. How do I get it to show up in the builder? Where do I put it?
__________________
I have a universe in my head, and I can't explain a single piece of it.
Kaleb_Advent is offline   Reply With Quote
Old 2 Weeks Ago   #430
yfyfyfyfyfy
 
yfyfyfyfyfy's Avatar
Default

Quote:
Originally Posted by Kaleb_Advent View Post
...I didn't realize this was directed at me for some reason.

Okay, I've downloaded the config. How do I get it to show up in the builder? Where do I put it?
Insert with replacement.
Attached Thumbnails
Click image for larger version

Name:	Скриншот 18-07-2020 133114.png
Views:	22
Size:	31.4 KB
ID:	35246   Click image for larger version

Name:	Скриншот 18-07-2020 133833.png
Views:	22
Size:	37.7 KB
ID:	35249  
__________________
My discord: yfyfyfyfyfy#8483
yfyfyfyfyfy is offline   Reply With Quote
Reply

Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump


All times are GMT. The time now is 06:20 AM.


Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2020, vBulletin Solutions, Inc.