Tunnelmaker 2.0 Beta ==================== A Minetest Mod to easily create arbitrarily curved tunnels, pathways, and bridges. ![Tunnelmaker Screenshot](screenshot.png "Tunnelmaker") By David G (kestral246@gmail.com), with significant contributions by Mikola. Features -------- - Create paths, bridges, and tunnels in all sixteen possible advtrains track directions with one click. - Also digs up or down in the eight possible advtrains slope track directions. - Digging mode and options can be set using new User Options menu. - Supports Advanced trains mod with gravel embankment, arched and optionally lined tunnels, and two widths of bridges. - Supports Bike mod with two widths of cobblestone pathways and bridges, along with unlined tunnels. - Supports general excavation with unlined and lined tunnels. - Adds reference nodes to help digging and laying advtrains track—now easy to remove when done. - Adds glass enclosure when in water to create water tunnels. - Requires "tunneling" privilege, and checks protections before digging. - No crafting recipe, so needs to be given to player. - Works in both creative and survival modes, but tunneling does not place any nodes into user's inventory. ![Bike path up mountain](images/bike_path.png "Bike path up mountain") Controls -------- - **Left-click:** Super dig one node. One click digs any node (non-repeating) and places it in player's inventory. However, it can't be used to pick up dropped items. - **Shift-left-click:** Bring up User Options menu (see below). Can also use Aux-right-click, which is needed for Android. - **Right-click:** Dig tunnel in direction player pointed. Note that this won't place any of the dug nodes in player's inventory. - **Shift-right-click:** Cycle through vertical digging modes, up, down, and horizontal. How to enable ------------- - Install tunnelmaker mod, requires default and stairs. For much smoother bike path ramps, I recommend that the angledstairs mod also be installed, but it's not required. - Grant player "tunneling" privilege (/grant <player> tunneling). - To give player a tunnelmaker tool use (/give <player> tunnelmaker:tool1). How to dig ---------- *See diagram below that shows track configurations supported by advtrains.* - Move to digging location and highlight node at ground level. (Gray node in diagrams marked with an '×'.) - Point player in desired digging direction. (Inventory icon will change to show current direction.) - Right-click mouse to dig tunnel. Digging for slopes ------------------ *Note that advtrains only supports sloped track for orthogonal and diagonal track directions.* - Move to digging location and highlight node at ground level. - Point player in desired digging direction. - Hold sneak key (shift on pc) and right-click mouse to select digging mode. Inventory icon will cycle through possible modes with each click: 'U' for digging up, 'D' for digging down, and no letter for default horizontal. - Release sneak key and right-click mouse to dig tunnel. - User option whether to reset each time or not. ![Tunnelmaker Icons](images/icons.png "Tunnelmaker Icons") User Options menu ---------------- Use shift-left-click to bring up this menu. ![Tunnelmaker User Options](images/user_options.gif "Tunnelmaker User Options") Descriptions of all the options: - **Digging mode** Select one of the three digging mode. - **Wide paths / lined tunnels** Select between narrow and wide paths, and whether tunnels are lined with stone or not. - **Continuous up/down digging** Don't reset up/down after each dig. - **Clear tree cover above** Remove all plant material above dig up to 30 nodes above ground. CPU intensive, so shuts off after two minutes. - **Remove reference nodes** Easily remove reference nodes by walking over them. Also shuts off after two minutes. - **Lock desert mode to: either "Desert" or "Not desert"** Option only available when using Minetest 5.0 and when "add_desert_material = true" has been added to minetest.conf. Overrides use of desert materials in desert biomes. Advtrains digging reference --------------------------- The following diagrams show how to make curved tunnels that support the different track configurations used by advtrains. There are three basic directions that are supported: 0° (orthogonal, rook moves), 45° (diagonal, bishop moves), and 26.6° (knight moves, two blocks forward and one block to the side). - *Note that it's always possible to dig in any direction, but turns with angles other than those shown won't be supported by advtrains track.* - *Also note that there are other limitations to advtrains slope track. Documentation TBD.* ![Turns from 0°](images/dir0.png "Turns from 0") ![Turns from 26.6°](images/dir26.png "Turns from 26.6") ![Turns from 45°](images/dir45.png "Turns from 45") License ------- - **textures:** License CC0-1.0 - **code:** My changes to original code are CC0-1.0 - **original compassgps license:** Original code by Echo, PilzAdam, and TeTpaAka is WTFPL. Kilarin (Donald Hines) changes are CC0 (No rights reserved) Thanks ------ - [advtrains](https://github.com/orwell96/advtrains/) / orwell96, et. al. - For providing the amazing advtrains mod that this mod tries to make just a little easier to use. - [compassgps](https://github.com/Kilarin/compassgps) / Kilarin (Donald Hines), et. al. - Top level code to change icon based on direction player is pointing.