Difference between revisions of "Mapping"

From Space Station 13 Wiki
Jump to navigation Jump to search
(Introduced an initial structure.)
(Added section about how to use the disposal pipe tester)
Line 39: Line 39:
For a general checklist, reference the [[Goonstation Map Submission Guidelines]] - they're an excellent source of ways to validate your map's functionality. As a rule of thumb, if your map hasn't been tested, there's something wrong with it - don't be afraid to ask for help fixing or testing things.
For a general checklist, reference the [[Goonstation Map Submission Guidelines]] - they're an excellent source of ways to validate your map's functionality. As a rule of thumb, if your map hasn't been tested, there's something wrong with it - don't be afraid to ask for help fixing or testing things.


( SECTION ABOUT DISPOSAL AND PIPE TESTER )
== What is this about a disposal pipe tester? ==
 
To test your disposal systems, Haine made a handy little proc you can call as an admin to test if they actually work as intended! To use it:
* Use the Advanced ProcCall verb (found in the Debug tab assuming you've already made yourself an admin.)
* Run <code>/proc/test_disposal_system</code>. Next, enter the X and Y coordinates of where stuff that goes in a disposal pipe is supposed to go, right at the end of whatever disposal pipe adventure you've created. Usually this will be the final conveyor belt right at the crusher door.
* Wait a bit and you will be notified in your debug logs whether the test succeeded or failed.

Revision as of 03:34, 31 December 2019

this is the guide to mapping! stay tuned while its slowly, eventually filled out

Getting started

Look at the coding guide for how to download and set up a local Goonstation repository to start mapping on.

Before you open up your map editor, it might be useful to doodle a rough map layout so you can build in a more organized fashion.

How big do I make this thing

For Goonstation, station maps should be 300x300 with only 1 z level (station here meaning basically anything that'll be the main area where people will play).

For any setpieces (whether for debris field, oshan trench, or an entirely separate adventure zone), the dimensions don't matter too much since they'll be copypasted into an existing level.

SAVE. Also save

Whenever you make any change that took any amount of time, save and make sure there's a backup. Dream Maker can sometimes corrupt maps, or simply not save your work, and you'll either lose part of your map or break the whole thing.

If you don't have some sort of fancier version control (i.e. git) that automatically keeps revisions when you save the map, you can make a backup by doing "save as" and adding a version number to the filename, i.e. mapname_ver(number).

Okay but how do I actually make map

General order of map creation should be something like:

  • Basic skeleton of turfs (walls, floors)
  • Objects in rooms (airlocks, machinery, etc)
  • Area placement (important for APCs, teleportation, etc)
  • Wiring (including APCs) and disposals
  • Detail work; lighting+switches, access spawners, firelock stuff, door names, bot waypoints, teleporter beacons etc.

It's okay to look at existing maps for reference when configuring objects, but it's heavily recommended you create new instances of objects and change any necessary variables when making your map - this is less likely to introduce unintended consequences, and makes you more familiar with var-editing.

I have a map and it seems to work, now what

For a general checklist, reference the Goonstation Map Submission Guidelines - they're an excellent source of ways to validate your map's functionality. As a rule of thumb, if your map hasn't been tested, there's something wrong with it - don't be afraid to ask for help fixing or testing things.

What is this about a disposal pipe tester?

To test your disposal systems, Haine made a handy little proc you can call as an admin to test if they actually work as intended! To use it:

  • Use the Advanced ProcCall verb (found in the Debug tab assuming you've already made yourself an admin.)
  • Run /proc/test_disposal_system. Next, enter the X and Y coordinates of where stuff that goes in a disposal pipe is supposed to go, right at the end of whatever disposal pipe adventure you've created. Usually this will be the final conveyor belt right at the crusher door.
  • Wait a bit and you will be notified in your debug logs whether the test succeeded or failed.