Guide to mapping - История изменений

imported>San7890: Adds disclaimers to every notable section of this article, with appropriate links to transfer knowledge. I also purged some reference to the DMM format because I don't want to encourage that in any method.

2022-07-25T04:11:44Z

Adds disclaimers to every notable section of this article, with appropriate links to transfer knowledge. I also purged some reference to the DMM format because I don't want to encourage that in any method.

← Предыдущая версия		Версия от 04:11, 25 июля 2022
Строка 1:		Строка 1:
			{{Important
			\|Title=Hey! Listen!
			\|Note=This guide is obsolete, please visit <big>'''[https://hackmd.io/@tgstation/SyVma0dS5 san7890's A-Z Guide to Mapping]'''</big>, a HackMD document that details the mapping essentials. It is recommended that you read that document '''first''' as it is well organized, <u>updated</u>, and contains very useful visuals that this page lacks. This page also incorporates information found in the <big>"[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]"</big>, which supersedes 95% of the information found below.
			\|Image=Notice.png
			\|Color=Red
			}}

	Other related guides: [[Understanding SS13 code]], [[SS13 for experienced programmers]], [[Guide to door access]] and [[Map Merger]]		Other related guides: [[Understanding SS13 code]], [[SS13 for experienced programmers]], [[Guide to door access]] and [[Map Merger]]


	== Map Merger ==		== Map Merger ==
	It is important that you use the [[Map Merger]] tools before ~~commiting~~ any changes to a map. See [[Map_Merger\|here]] for how.		It is important that you use the [[Map Merger]] tools before committing any changes to a map. See [[Map_Merger\|here]] for how.


	== Meta's Guide to Enthusiast Mapping ==		== Meta's Guide to Enthusiast Mapping (OBSOLETE) ==
			{{Important
			\|Title=Disclaimer
			\|Note=This guide is obsolete, please visit '''[https://hackmd.io/@tgstation/SyVma0dS5 san7890's A-Z Guide to Mapping]'''. This will get you set up with much more modern tooling. It is highly advisable to read this first.
			\|Image=Notice.png
			\|Color=Blue
			}}
	'''Written for those with any or no idea of how to use the map-maker.'''		'''Written for those with any or no idea of how to use the map-maker.'''

Строка 52:		Строка 67:

	== Pre-commit checks ==		== Pre-commit checks ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a much more in-depth and modern look at this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#Pre-Commit-Checklist this section] of the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Blue
			}}
	*Are floors with or without air, as they should be? (regular or airless)		*Are floors with or without air, as they should be? (regular or airless)
	*Does the area have an APC?		*Does the area have an APC?
Строка 76:		Строка 96:

	== General Station-wide Mapping Guidelines ==		== General Station-wide Mapping Guidelines ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a much more in-depth and modern look at this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#Verbose-Mapping-Knowledge this section] of the [https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection].
			\|Image=Notice.png
			\|Color=Blue
			}}
	=== In general ===		=== In general ===
	* Don't run pipes/cables/disposals through walls if you can avoid it. Otherwise it's a pain to repair or sabotage them, especially under r-walls.		* Don't run pipes/cables/disposals through walls if you can avoid it. Otherwise it's a pain to repair or sabotage them, especially under r-walls.
Строка 92:		Строка 117:

	== Atmospherics ==		== Atmospherics ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a more modern look at this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#On-Atmospherics this section] of the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Blue
			}}
	=== Pipes and manifolds ===		=== Pipes and manifolds ===

Строка 161:		Строка 191:

	== Power ==		== Power ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a much more in-depth and modern look on this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#On-Power this section] of the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Blue
			}}
	=== APC ===		=== APC ===
	Each new room needs at least one, this will provide all the power for the room (magically). Each piece of machinery inside the APC's area will draw power from either the lighting, equipment or environmental channel.		Each new room needs at least one, this will provide all the power for the room (magically). Each piece of machinery inside the APC's area will draw power from either the lighting, equipment or environmental channel.
Строка 173:		Строка 208:

	== Equipment ==		== Equipment ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a much more in-depth and modern look on this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#On-Power this section] of the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Blue
			}}
	=== Lights ===		=== Lights ===
	Lights take up a lot of power, don't use too many! Make sure to put in just enough so the room is fully lit, but not so many that the equipment will go out in ten minutes of the round starting.		Lights take up a lot of power, don't use too many! Make sure to put in just enough so the room is fully lit, but not so many that the equipment will go out in ten minutes of the round starting.
Строка 190:		Строка 230:

	== Room Structure ==		== Room Structure ==
			{{Important
			\|Title=Warning
			\|Note=This part is now completely obsolete. Please visit <b>[https://hackmd.io/@tgstation/ry4-gbKH5#On-Room-Structure-and-Security On Room Structure and Security] in the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Red
			}}
	=== Access ===		=== Access ===
	''' <span style="color:#FF5238"> Refer to ..\code\__DEFINES\access.dm for door access values.</span>'''		''' <span style="color:#FF5238"> Refer to ..\code\__DEFINES\access.dm for door access values.</span>'''
Строка 233:		Строка 278:

	== Step_x, step_y and the broken movement syndrome ==		== Step_x, step_y and the broken movement syndrome ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a much more in-depth and modern look on this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#On-The-Step_XStep_Y-Syndrome this section] of the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Blue
			}}
	So you compiled the map and suddenly whenever you move you no longer get the animation of moving but just 'appear' on the next tile?		So you compiled the map and suddenly whenever you move you no longer get the animation of moving but just 'appear' on the next tile?

Строка 281:		Строка 331:
	=== Pesky var edits for the `something` var are all over my map ===		=== Pesky var edits for the `something` var are all over my map ===
	Replace <tt>something</tt> with the var that needs to be removed. You need to run both replacements to catch all cases.		Replace <tt>something</tt> with the var that needs to be removed. You need to run both replacements to catch all cases.

	~~For standard dmm format:~~
	* <code>\bsomething = .+?; *</code> => nothing
	* <code>{\W\bsomething = [^;]+?\W}</code> => nothing

	For TGM format:		For TGM format:
Строка 292:		Строка 338:

	== Multi-Z ==		== Multi-Z ==
			{{Important
			\|Title=Disclaimer
			\|Note=For a much more in-depth and modern look on this section, please consult [https://hackmd.io/@tgstation/ry4-gbKH5#On-Multi-Z this section] of the <b>[https://hackmd.io/@tgstation/ry4-gbKH5 Mapping Reference Collection]</b>.
			\|Image=Notice.png
			\|Color=Blue
			}}
	Multi-Z is a feature which allows a station map to have multiple Z-levels layered on top of each other, behaving as a single station with multiple floors. This feature is currently in use on the [[Tramstation]] and [[IceboxStation]] maps. A station's multiple levels can be bundled into one map file, or in several seperate files. The traits section of the map configuration json tells SS13 how to link the maps together.		Multi-Z is a feature which allows a station map to have multiple Z-levels layered on top of each other, behaving as a single station with multiple floors. This feature is currently in use on the [[Tramstation]] and [[IceboxStation]] maps. A station's multiple levels can be bundled into one map file, or in several seperate files. The traits section of the map configuration json tells SS13 how to link the maps together.

imported>Vire: Details on working with multi-z, earned through suffering

2021-03-18T20:20:27Z

Details on working with multi-z, earned through suffering

@@ Строка 90: / Строка 90: @@
 === Power ===
 * Each area (which requires power) should have exactly one APC. For areas with a high roundstart power draw (engineering/cargo), one of the highcap subtypes can be used.
 == Atmospherics ==
@@ Строка 293: / Строка 290: @@
 * <code>{\W*\bsomething *= *[^;]+?\W*}</code> => nothing
 {{Contribution guides}}

imported>Nari Harimoto: adds a section for Multi-Z mapping so people are aware on how to prevent ATs because of upper Zs not being floored off

2021-01-21T00:36:38Z

adds a section for Multi-Z mapping so people are aware on how to prevent ATs because of upper Zs not being floored off

← Предыдущая версия		Версия от 00:36, 21 января 2021
Строка 90:		Строка 90:
	=== Power ===		=== Power ===
	* Each area (which requires power) should have exactly one APC. For areas with a high roundstart power draw (engineering/cargo), one of the highcap subtypes can be used.		* Each area (which requires power) should have exactly one APC. For areas with a high roundstart power draw (engineering/cargo), one of the highcap subtypes can be used.

			=== Multi-Z ===
			* If you are building station rooms on a lower Z level, ensure that a floor of some type is mapped on the Z level above the room. You can check the coordinates in the mapping editor to ensure you floor over the correct dimensions of the room. When running the server in Dream Daemon to test the map, you can go to the Debug tab and hit show debug verbs, go to Mapping tab and hit Show ATs, if the list is empty, you are good.

	== Atmospherics ==		== Atmospherics ==

imported>SpaceManiac: Remove "Game Resources" category

2020-12-04T03:45:34Z

Remove "Game Resources" category

← Предыдущая версия		Версия от 03:45, 4 декабря 2020
Строка 292:		Строка 292:

	{{Contribution guides}}		{{Contribution guides}}
	~~[[Category:Guides]]~~
	~~[[Category:Game Resources]]~~

imported>SpaceManiac: Add ninjanomnom's "Useful regexes for coding" from the GitHub wiki

2020-12-01T05:21:09Z

Add ninjanomnom's "Useful regexes for coding" from the GitHub wiki

@@ Строка 274: / Строка 274: @@
 If you are adding a map to the game, you need to ensure it has a JSON file under _maps, and is included in the maps config file.
-[[Category:Guides]] [[Category:Game Resources]]
+==Helpful regular expressions==
 {{Contribution guides}}

imported>Cartographer-D в 03:00, 12 сентября 2020

2020-09-12T03:00:14Z

← Предыдущая версия		Версия от 03:00, 12 сентября 2020
Строка 1:		Строка 1:
	Other related guides: [[Understanding SS13 code]], [[SS13 for experienced programmers]] and [[Map Merger]]		Other related guides: [[Understanding SS13 code]], [[SS13 for experienced programmers]], [[Guide to door access]] and [[Map Merger]]
	== Map Merger ==		== Map Merger ==
	It is important that you use the [[Map Merger]] tools before commiting any changes to a map. See [[Map_Merger\|here]] for how.		It is important that you use the [[Map Merger]] tools before commiting any changes to a map. See [[Map_Merger\|here]] for how.

imported>PixelShader: /* Access */

2020-07-06T05:36:49Z

Access

← Предыдущая версия		Версия от 05:36, 6 июля 2020
Строка 192:		Строка 192:

	=== Access ===		=== Access ===
	''' <span style="color:#FF5238"> Refer to \code\__DEFINES\access.dm for door access values.</span>'''		''' <span style="color:#FF5238"> Refer to ..\code\__DEFINES\access.dm for door access values.</span>'''

	Access to doors is handled by req_access values. There are four when editing a door - req_access, req_access_txt, req_one_access, and req_one_access_txt. The one's we're concerned with are '''req_access_txt''' and '''req_one_access_txt'''.		Access to doors is handled by req_access values. There are four when editing a door - req_access, req_access_txt, req_one_access, and req_one_access_txt. The one's we're concerned with are '''req_access_txt''' and '''req_one_access_txt'''.

imported>PixelShader: Adding a note, stating where door access values exist.

2020-06-24T16:08:27Z

Adding a note, stating where door access values exist.

← Предыдущая версия		Версия от 16:08, 24 июня 2020
Строка 192:		Строка 192:

	=== Access ===		=== Access ===
	''' <span style="color:#~~ff0000~~"> Refer to \code\__DEFINES\access.dm for door access values.</span>'''		''' <span style="color:#FF5238"> Refer to \code\__DEFINES\access.dm for door access values.</span>'''

	Access to doors is handled by req_access values. There are four when editing a door - req_access, req_access_txt, req_one_access, and req_one_access_txt. The one's we're concerned with are '''req_access_txt''' and '''req_one_access_txt'''.		Access to doors is handled by req_access values. There are four when editing a door - req_access, req_access_txt, req_one_access, and req_one_access_txt. The one's we're concerned with are '''req_access_txt''' and '''req_one_access_txt'''.

imported>PixelShader в 16:06, 24 июня 2020

2020-06-24T16:06:37Z

← Предыдущая версия		Версия от 16:06, 24 июня 2020
Строка 192:		Строка 192:

	=== Access ===		=== Access ===
			''' <span style="color:#ff0000"> Refer to \code\__DEFINES\access.dm for door access values.</span>'''

	Access to doors is handled by req_access values. There are four when editing a door - req_access, req_access_txt, req_one_access, and req_one_access_txt. The one's we're concerned with are '''req_access_txt''' and '''req_one_access_txt'''.		Access to doors is handled by req_access values. There are four when editing a door - req_access, req_access_txt, req_one_access, and req_one_access_txt. The one's we're concerned with are '''req_access_txt''' and '''req_one_access_txt'''.

imported>Hughgent в 01:56, 22 ноября 2018

2018-11-22T01:56:45Z

← Предыдущая версия		Версия от 01:56, 22 ноября 2018
Строка 21:		Строка 21:
	The first step, then, is to be able to create your first few rooms. Select a turf (floor) from the generic simulated floors. These will start with the right make-up and pressure of air on them, which is how you'll want it. Surround these floors with walls, and hey presto you have a room. Try sticking some tables in there, perhaps a vending machine or two.		The first step, then, is to be able to create your first few rooms. Select a turf (floor) from the generic simulated floors. These will start with the right make-up and pressure of air on them, which is how you'll want it. Surround these floors with walls, and hey presto you have a room. Try sticking some tables in there, perhaps a vending machine or two.

	If you want to add some chips to your new den but are unhappy of how they neatly stack on top of eachother, you can change their "pixel_x" and "pixel_y" values in the "edit" rmb-menu to arrange them as you want! (Remember to start and end the value with doublequotes! Also, all custom values are '''bold''' so it's easier to identify them.) In fact, most wall-mounted machines on stations are shifted like this, and while they APPEAR to be on a wall, they are actually on the tile in front of it. Just don't go overboard with this, as every new instance of an object is added as its own entry in the menu, and when there are dozens of them it can get hard to remember which one you wanted. ~~One~~ you've made your room you'll want to put lights in.		If you want to add some chips to your new den but are unhappy of how they neatly stack on top of eachother, you can change their "pixel_x" and "pixel_y" values in the "edit" rmb-menu to arrange them as you want! (Remember to start and end the value with doublequotes! Also, all custom values are '''bold''' so it's easier to identify them.) In fact, most wall-mounted machines on stations are shifted like this, and while they APPEAR to be on a wall, they are actually on the tile in front of it. Just don't go overboard with this, as every new instance of an object is added as its own entry in the menu, and when there are dozens of them it can get hard to remember which one you wanted. Once you've made your room you'll want to put lights in.

	{\|		{\|