Tunnel Cart

A self-driving minecart that digs a 3x3 tunnel, lays powered rails, lines the walls with cobbled deepslate and collects ores. Compatible with High-Speed Rail.

Tunnel Cart

Tunnel Cart is an automated mining and tunnel-construction mod for Minecraft 1.20.1 (Fabric). It adds a specialized mining minecart that can automatically dig tunnels, collect valuable resources, build railway tracks, reinforce tunnel walls, navigate to coordinates, and bypass existing railway lines.

Let your mining cart do the hard work while you focus on exploration and building your railway network!

Features

Automated Tunnel Construction

  • Automatically digs tunnels with a 3×3 passage.
  • Places powered rails as it moves forward.
  • Reinforces the surrounding tunnel structure with Cobbled Deepslate.
  • Eligible surrounding blocks are replaced with Cobbled Deepslate, while natural Deepslate is preserved.
  • Seals openings around slope transitions to help prevent water and cave openings from entering the tunnel.
  • Provides up to 5 blocks of headroom around slopes.

Mining and Resource Collection

  • Mines ores, gravel, and clay within a 5×5 area.
  • Collects valuable resources and Cobbled Deepslate in its inventory.
  • Unwanted drops are left on the ground instead of filling the cart.
  • Supports Shulker Boxes: the cart can take construction materials from inside them and place collected resources into them.
  • Uses its own inventory and available Shulker Box contents to obtain the materials needed for construction.

Automatic Railway Construction

The Tunnel Cart builds its own railway as it travels.

  • Places powered rails along the tunnel.
  • Uses regular rails to construct turns in coordinate navigation mode.
  • Places acceleration points using Redstone Torches or Redstone Blocks.
  • Automatically adds acceleration points around turns and slopes.
  • Builds special braking sections to control speed before dangerous turns and slopes.

Coordinate-Based Navigation

Send the Tunnel Cart to a specific destination using X, Y, and Z coordinates.

  • Enter the target coordinates in the dedicated menu.
  • Leave the Y field empty to maintain the current altitude.
  • The route can include a straight section, one turn, another straight section, and a final climb or descent.
  • The cart automatically determines the required direction and constructs the route.
  • It detects existing powered-rail tracks and attempts to bypass them by building over or under the obstruction.

Automatic Obstacle Bypass

The cart can detect existing powered-rail tracks that interfere with its planned tunnel.

  • Automatically searches for a way around the obstruction.
  • Can build a bypass above or below existing tracks.
  • Can extend the bypass platform when an existing railway continues further.
  • Checks terrain and available chunks before treating an area as clear.
  • Waits for unloaded chunks instead of blindly continuing through unverified terrain.

Extension Cart — Passenger Seat and Extra Storage

The optional Extension Cart attaches behind the Tunnel Cart when placed on a rail within 16 blocks of it.

It provides two important functions:

  • Passenger Seat: Right-click the Extension Cart to ride along with the mining cart.
  • Additional Storage: Sneak + right-click to open the shared inventory.

The Extension Cart has 27 additional slots. Combined with the Tunnel Cart's own 27 slots, the system provides 54 shared storage slots.

The extension automatically follows the mining cart, including through turns.

Controls:

  • Right-click — sit in the Extension Cart.
  • Shift + Right-click — open the shared 54-slot inventory.

Crafting Recipes

All recipes are shapeless, so the ingredients can be placed in any arrangement in the crafting grid.

Item Ingredients
Tunnel Cart Minecart with Chest + Diamond Pickaxe + Blast Furnace + Redstone Block
Extension Cart Minecart + Chest + Oak Stairs

How to Use

Starting the Tunnel Cart

  1. Place the Tunnel Cart on a straight, horizontal rail.
  2. Its initial travel direction is determined by the direction you are facing when placing it.
  3. Right-click the cart to open its inventory and control menu.
  4. Put the required construction materials into its inventory.
  5. Press Lay Track to start automatic tunneling.
  6. Press Stop to stop the cart.

Required Materials

The cart uses the following materials during construction:

  • Powered Rails — for the railway.
  • Cobbled Deepslate — for tunnel reinforcement and regular track support.
  • Regular Rails — for turns in coordinate mode.
  • Cobblestone — for braking sections.
  • Redstone Torches or Redstone Blocks — for track acceleration.

The cart can also use materials stored inside Shulker Boxes carried in its inventory.

Torch Control

The menu includes a Torches: On/Off button.

It controls additional torch placement along the railway. Some acceleration points around turns and slopes are placed automatically regardless of this setting.

Using the Extension Cart

  1. Place the Extension Cart on a rail within 16 blocks of a Tunnel Cart that does not already have an extension.
  2. It automatically attaches behind the Tunnel Cart.
  3. Right-click it to sit and travel with the cart.
  4. Sneak + right-click it to access the shared storage.

Coordinate Navigation: Route Rules

Coordinate mode has specific route requirements:

  • The route starts in the direction the Tunnel Cart was originally facing.
  • Only one turn is supported.
  • A turn is built using a regular rail.
  • The final climb or descent is built at the end of the route.
  • Each straight section before and after a turn must be at least 16 blocks long.
  • The final section before a climb or descent must be at least the height change + 26 blocks.
  • Braking sections are 15 blocks long.

Cobblestone is used for braking. Do not include it among the accelerated blocks in the High-Speed Rail configuration.

Speed and Railway Optimization

The Tunnel Cart includes speed restrictions to make railway construction safer and more reliable.

  • Maximum speed around turns and their braking sections: 7.5 blocks/second.
  • Maximum speed on and immediately before slopes: approximately 10 blocks/second.
  • Speed restrictions apply regardless of powered-rail strength or High-Speed Rail settings.
  • Eleven additional straight rails with braking blocks are built after the final climb or descent.

The mod is compatible with High-Speed Rail, which is optional.

Resource and Inventory Management

  • The Tunnel Cart has 27 inventory slots.
  • The Extension Cart provides another 27 slots.
  • Together, they offer 54 shared slots.
  • Mined ores, gravel, clay, and Cobbled Deepslate are collected.
  • Other drops are left on the ground.
  • Shulker Boxes can be used both as material storage and as additional space for collected resources.

The cart stops and displays a notification when it runs out of required materials, encounters an unbreakable obstacle, or needs an unloaded chunk to become available.

Notifications

The mod includes a central-screen notification system with colored titles, explanatory messages, and sound effects.

Notifications cover:

  • Missing construction materials.
  • Blocked or impossible routes.
  • Unloaded chunks.
  • Coordinate navigation errors.
  • Successful route creation.
  • Reaching the destination.

Notifications stay on screen for 5 seconds. If a problem persists, it is announced again after 30 seconds. Resolved problems are cleared immediately.

Limitations and Requirements

  • Minecraft 1.20.1.
  • Fabric Loader 0.15 or newer.
  • Fabric API 0.92.2+1.20.1.
  • A straight, horizontal starting rail is required.
  • Coordinate navigation supports only one turn.
  • Chests, spawners, and Bedrock are not broken or replaced.
  • Natural Deepslate is not replaced by the tunnel reinforcement.
  • Make sure enough materials are available for long routes.
  • Required chunks must be loaded for construction to continue.

Compatibility

  • Minecraft: 1.20.1
  • Mod Loader: Fabric
  • Fabric API: Required
  • High-Speed Rail: Optional compatibility

Updates

New versions are released on GitHub first. Modrinth releases may follow later…

GitHub Repository · GitHub Releases · Report a Bug

Tunnel Cart Team

profile avatar
  • 1
    Projects
  • 3
    Downloads