Skip to content

Adding Doors To Maps

Dan Volchek edited this page Apr 18, 2019 · 13 revisions

Better Doors

Contents

Introduction

In order to add a door to your map there are a couple different custom tile properties you need to set. Some things to note:

  • All properties go on the Back layer.
  • All properties go on the bottom tile where you want to place the door.
  • Make sure the bottom, middle, and top tiles of where the door is are not on the Buildings or Front layers. These will be overwritten when Better Doors draws the doors.
  • You may need to edit the map a little for horizontal doors to look good! See Fixing horizontal doors

In order to add tile properties (using Tiled), add an object named TileData to the Back layer at the tile where you want the door to be. You can do this for as many tiles as you want in any map. Set the custom string properties as follows:

Property Name Required Property value
DoorVersion Yes Just use 1.0.0.
Door Yes A string in this format: modId doorName orientation openingDirection. See below for an explanation.
DoorExtras Optional A string containing space separated words. See below for an explanation.

Door property format

Name Value Description
modId For SDV:
  • vanilla
For mods:
  • the mod unique id
The mod providing the textures.
doorName For SDV, one of:
  • light
  • window
  • saloon
For mods:
  • Depends on the mod
The name of the door you want to use. For mods, the mod should tell you valid names. See Vanilla door textures for what the vanilla doors look like.
orientation horizontal or vertical The way the hallway the door is placed in goes. Horizontal means left to right and Vertical means top to bottom.
openingDirection left or right The way the door opens when you look at it.

Example string: vanilla light vertical left.

DoorExtras property format

These are optional. If you don't want any extras, don't include the property. The following words are recognized and can be in any order:

Name Effect
automatic Makes the door automatic. That means it will automatically open when the player gets nearby and close when they leave.
double Makes the door a double door. If the door is a vertical door and has another door right next to it also marked as a double door, then opening either of the doors will open both.

Example strings: automatic or automatic double or double, etc.

Example

Here's how this all might look when put together using Tiled:

This makes a light, vertical, left opening door from vanilla that also is automatic.

Vanilla door textures

Here are the textures SDV provides:

From left to right they're named light, window, and saloon. Note that if any mod edits the SDV texture where these are found (LooseSprites/Cursors) then Better Doors will reflect that. If you always want to use one of these, copy it to your own content pack. See Adding Door Textures for how to do that.

Fixing horizontal doors

Does your door look like this?

If so, take the tile that's on the Front layer of the bottom of the door (the one that looks weird in game) and move it to AlwaysFront. Create an AlwaysFront layer if the map doesn't have one to do this - it'll work fine.