Skip to content

Commit

Permalink
New mesh door models, and extensive door API
Browse files Browse the repository at this point in the history
This patch replaces the default door nodes with a new mesh model
and nodes.

Two new models were added that are 2 blocks high. One for left-hinge
and one for right-hinge doors. This allows us to make a single texture
fit on both models. The alternative would have been 1 model and 2
unmapped textures, which is more work for mod developers.

Doors work exactly like the old doors, including ownership, breaking
doors, opening and closing.

Under the hood, we can prevent the top part of the door from being
obstructed by placing an invisible node. This prevents liquids from
flowing through doors or people placing sand or other blocks in the
top half. The door code automatically places and removes these as
needed.

Metadata is used to store door state, just like the old version.

A doors API is added, it allows mods to use the API to open/close or
toggle door states without worrying about sounds, permissions and
other details. This is intended for e.g. mesecons. This API allows
mods to manipulate or inspect doors for players or for themselves.

In-game old door nodes are automatically converted using an ABM and
preserve ownership and orientation and state.

TNT blows up all doors and trapdoors except for the steel ones,
who can survive a blast. We return an itemstack in on_blast(),
which requires a TNT API patch which is also pending.

We enable backface culling for most of these doors, as this gives
the identical visual appearance that the old doors had. In the case
of the glass door, there's a slight twist.

The texture files used by the new doors have new names that do
not conflict with previous texture file names to avoid texture
pack conflicts.

Thanks to red-001 <red-001@users.noreply.github.com> for some
of the conversion code, cleanups, and extra textures.
  • Loading branch information
sofar authored and paramat committed Feb 13, 2016
1 parent 9e54b37 commit f600a9f
Show file tree
Hide file tree
Showing 26 changed files with 499 additions and 386 deletions.
50 changes: 31 additions & 19 deletions game_api.txt
Expand Up @@ -71,43 +71,55 @@ doors.register_door(name, def)
-> Registers new door

doors.register_trapdoor(name, def)
^ name: "Trapdoor name"
^ name: "mod_door"
^ def: See [#Trapdoor definition]
-> Registers new trapdoor

doors.get(pos)
^ pos = { x = .., y = .., z = ..}
-> Returns an ObjecRef to a door, or nil if the pos did not contain a door

Methods:
:open(player) -- Open the door object, returns if door was opened
:close(player) -- Close the door object, returns if door was closed
:toggle(player) -- Toggle the door state, returns if state was toggled
:state() -- returns the door state, true = open, false = closed

the "player" parameter can be omitted in all methods. If passed then
the usual permission checks will be performed to make sure the player
has the permissions needed to open this door. If omitted then no
permission checks are performed.

#Door definition
----------------
{
description = "Door description",
inventory_image = "mod_door_inv.png",
groups = {group = 1},
tiles_bottom: [Tile definition],
^ the tiles of the bottom part of the door {front, side}
tiles_top: [Tile definition],
^ the tiles of the bottom part of the door {front, side}
node_box_bottom = regular nodebox, see [Node boxes], OPTIONAL,
node_box_top = regular nodebox, see [Node boxes], OPTIONAL,
selection_box_bottom = regular nodebox, see [Node boxes], OPTIONAL,
selection_box_top = regular nodebox, see [Node boxes], OPTIONAL,
sound_open_door = sound play for open door, OPTIONAL,
sound_close_door = sound play for close door, OPTIONAL,
only_placer_can_open = true/false,
groups = {choppy = 1},
tiles = { "mod_door.png" },
material = "default:wood", -- used to make a craft recipe
sounds = default.node_sound_wood_defaults(), -- optional
sound_open = sound play for open door, -- optional
sound_close = sound play for close door, -- optional
protected = false,
^ If true, only placer can open the door (locked for others)
}

#Trapdoor definition
----------------
{
description = "Trapdoor description",
inventory_image = "mod_trapdoor_inv.png",
groups = {choppy = 1},
tile_front = "doors_trapdoor.png",
^ the texture for the front and back of the trapdoor
tile_side: "doors_trapdoor_side.png",
^ the tiles of the four side parts of the trapdoor
sound_open = sound to play when opening the trapdoor, OPTIONAL,
sound_close = sound to play when closing the trapdoor, OPTIONAL,
-> You can add any other node definition properties for minetest.register_node,
such as wield_image, inventory_image, sounds, groups, description, ...
Only node_box, selection_box, tiles, drop, drawtype, paramtype, paramtype2, on_rightclick
will be overwritten by the trapdoor registration function
sounds = default.node_sound_wood_defaults(), -- optional
sound_open = sound play for open door, -- optional
sound_close = sound play for close door, -- optional
protected = false,
^ If true, only placer can open the door (locked for others)
}

Fence API
Expand Down
17 changes: 16 additions & 1 deletion mods/doors/README.txt
@@ -1,12 +1,15 @@
Minetest Game mod: doors
========================
version: 1.3
version: 2.0

License of source code:
-----------------------
Copyright (C) 2012 PilzAdam
modified by BlockMen (added sounds, glassdoors[glass, obsidian glass], trapdoor)
Steel trapdoor added by sofar.
Copyright (C) 2015 sofar@foo-projects.org
Re-implemented most of the door algorithms, added meshes, UV wrapped texture
Added doors API to facilitate coding mods accessing and operating doors.

This program is free software. It comes without any warranty, to
the extent permitted by applicable law. You can redistribute it
Expand Down Expand Up @@ -40,8 +43,20 @@ following textures created by sofar (CC-BY-SA-3.0)
doors_trapdoor_steel_side.png
door_trapdoor_side.png

Door 3d models by sofar (CC-BY-SA-3.0)
door_a.obj
door_b.obj

Obsidian door textures by red-001 based on textures by Pilzadam and BlockMen: WTFPL
door_obsidian_glass.png

Glass door textures by red-001 based on textures by celeron55: CC BY-SA 3.0
door_glass.png
All other textures (created by PilzAdam): WTFPL

Door textures were converted to the new texture map by sofar, paramat and
red-001, under the same license as the originals.


License of sounds
--------------------------------------
Expand Down

2 comments on commit f600a9f

@JurajVajda
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's a great update, only if it wouldn't break all other mods what are using doors, will be there some solution for it ? (protector, messecon door, mydoors) Messecon doors where complaining also about some textures missing/renamed.

2016-02-14 00:13:02: ERROR[main]: ========== ERROR FROM LUA =========== 2016-02-14 00:13:02: ERROR[main]: Failed to load and run script from 2016-02-14 00:13:02: ERROR[main]: /root/.minetest/mods/protector/init.lua: 2016-02-14 00:13:02: ERROR[main]: /root/.minetest/mods/protector/doors_chest.lua:45: attempt to call field 'register_door' (a nil value) 2016-02-14 00:13:02: ERROR[main]: stack traceback: 2016-02-14 00:13:02: ERROR[main]: /root/.minetest/mods/protector/doors_chest.lua:45: in main chunk 2016-02-14 00:13:02: ERROR[main]: [C]: in function 'dofile' 2016-02-14 00:13:02: ERROR[main]: /root/.minetest/mods/protector/init.lua:532: in main chunk 2016-02-14 00:13:02: ERROR[main]: ======= END OF ERROR FROM LUA ======== 2016-02-14 00:13:02: ERROR[main]: Server: Failed to load and run /root/.minetest/mods/protector/init.lua

@JurajVajda
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i fixed mydoor mod and i found your commit in messecon mod - thanks a lot ;)

Please sign in to comment.