ProSewers

[HR][/HR]

What is ProSewers?

ProSewers is a procedural underground sewer network generator designed for Minecraft roleplay, city and survival servers.

Instead of manually building underground tunnels block by block, administrators can place nodes throughout roads, sidewalks, intersections and important city locations, then connect those nodes to automatically generate a complete underground sewer network.

The plugin creates large walkable tunnels, underground chambers, access shafts, manholes, drainage canals, pipes, leaks, maintenance areas, dirty walls, aged structures and interconnected routes beneath your city.

ProSewers 2.0.0 introduces a redesigned generation engine, a graphical node editor, private debug holograms, safer world modification, optional WorldGuard integration and improved tools for managing large sewer networks.

It is perfect for:

• Modern roleplay cities
• Police chases
• Criminal escapes
• Hidden city routes
• Rat / monster areas
• Secret bases
• Underground missions
• Urban exploration
• Maintenance worker roleplay
• Event zones
• Horror areas
• Smuggling routes
• Hidden entrances

[HR][/HR]

Main Features

• Procedural sewer network generation
• Surface node system
• Graphical node management GUI
• Editable node display names
• Stable internal node IDs
• Private administrator debug holograms
• Default depth of 30 blocks below the surface
• Large walkable tunnels
• Up to 4 directional connections per node by default
• North / South / East / West connection slots
• Manual node connections
• Automatic nearby node connection
• Underground chambers below each node
• Manhole covers on the road surface
• Vertical access shafts with ladders
• Central drainage canals
• Side pipes connected to sewer walls
• Water outlets and leaks
• Maintenance alcoves and hiding areas
• Dirty, broken and aged block palettes
• Tunnel supports and structural decorations
• Configurable lighting
• Configurable grime and floor details
• MANHATTAN and DIRECT routing modes
• Tunnels can automatically change height between nodes
• Slope safety validation
• Maximum tunnel distance validation
• Generation status and progress information
• Cancelable generation tasks
• Incremental generation system
• Reduced RAM usage for large networks
• Configurable blocks-per-tick
• Protected material system
• TileEntity protection
• Optional WorldGuard protection
• Admin teleport to surface or sewer position
• Persistent node storage in nodes.yml
• Generation history
• Undo and Redo commands
• English and Spanish language files
• Configurable materials, tunnel size, water, lighting, pipes and decorations

[HR][/HR]

Designed for Roleplay

ProSewers is not just a tunnel generator.

It is designed to create usable underground gameplay areas beneath your existing city.

Players can:

• Escape from police through underground routes.
• Use manholes to enter or leave the sewer network.
• Hide inside maintenance alcoves.
• Move between important city districts underground.
• Explore abandoned sewer sections.
• Encounter rats, monsters or NPCs.
• Discover secret bases and hidden rooms.
• Use underground routes during missions and events.
• Create criminal smuggling routes.
• Use sewer chambers as meeting or combat locations.

Administrators can build an entire underground network beneath a large city using commands or the new graphical management interface.

[HR][/HR]

Node Management GUI

ProSewers 2.0.0 includes a complete graphical interface for managing sewer nodes.

Open it using:

The GUI allows administrators to:

• View all sewer nodes
• Browse large networks using pages
• See node coordinates
• See sewer depth
• See connections
• Teleport to the surface
• Teleport directly into the sewer
• Increase or decrease node depth
• Regenerate a node chamber
• Rename nodes
• Toggle debug mode
• Delete nodes using Shift + Click protection

Node names can contain readable names such as:

while keeping a stable internal ID.

Example:

Changing the visible name does not break connections or stored node references.

[HR][/HR]

Visual Debug Mode

Administrators can visually inspect the sewer network using private debug holograms.

Enable them with:

Nearby nodes display information such as:

Markers can appear:

• Above the surface node
• Inside the underground sewer chamber

Debug displays use Minecraft TextDisplay entities and are only visible to the administrator who enabled them.

Commands:

[HR][/HR]

How it Works

Create a node on the surface:

The plugin stores the surface position and calculates the underground level:

By default:

You can give the node a readable name:

Create another node:

Connect them:

ProSewers validates the connection and generates the underground route.

If the nodes have different underground Y levels, the generator distributes the height difference through the tunnel instead of creating disconnected sections.

[HR][/HR]

Directional Node Connections

Nodes support up to four connections by default.

ProSewers 2.0.0 can enforce directional connection slots:

This prevents a node from consuming all four connections in the same direction and produces cleaner city-style sewer networks.

The system is configurable from:

[HR][/HR]

Default Visual Style

The default generation uses an old underground urban infrastructure style.

Default palettes use blocks such as:

• Deepslate Bricks
• Cracked Deepslate Bricks
• Deepslate Tiles
• Cracked Deepslate Tiles
• Polished Deepslate
• Stone Bricks
• Cracked Stone Bricks
• Mossy Stone Bricks
• Cobblestone
• Mossy Cobblestone
• Tuff Bricks
• Mud Bricks
• Mud
• Packed Mud
• Gravel
• Coarse Dirt
• Moss
• Iron Bars
• Copper
• Water
• Sea Lanterns
• Ladders
• Iron Trapdoors

Everything can be customized from config.yml.

You can create:

• Old abandoned sewers
• Modern maintenance tunnels
• Underground caves
• Industrial drainage systems
• Metro-style service tunnels
• Post-apocalyptic underground networks

[HR][/HR]

Performance

ProSewers 2.0.0 includes a redesigned incremental generation engine.

Older versions could prepare very large amounts of block operations before generation began.

The new system processes the network progressively:

This helps reduce large RAM spikes when generating big city networks.

The main performance settings are:

Administrators can check an active generation using:

And cancel it using:

For very large networks, Generate All can optionally require confirmation:

[HR][/HR]

World Safety

ProSewers includes multiple protections designed to reduce accidental damage to important server builds.

• Protected materials
• TileEntity protection
• Allowed-world restrictions
• Optional WorldGuard integration
• Tunnel distance validation
• Slope validation

TileEntity protection can prevent the generator from replacing blocks such as:

• Chests
• Barrels
• Signs
• Spawners
• Other special TileState blocks

WorldGuard is optional.

If installed and enabled, ProSewers can respect protected regions while generating tunnels.

Trusted administrators can optionally receive safety bypass permissions.

[HR][/HR]

Commands

Aliases:

[HR][/HR]

Permissions

Main administrator permission:

Important individual permissions include:

Optional safety bypass permissions:

Safety bypass permissions are intended only for trusted administrators.

[HR][/HR]

Undo / Redo

ProSewers keeps generation history in memory.

Undo:

Redo:

Version 2.0.0 improves history handling and adds a configurable maximum amount of stored block changes.

Example:

Very large operations can continue generating even if they are too large to safely retain in Undo history.

This prevents a huge generation from consuming excessive server memory.

Undo / Redo history resets after a server restart.

World backups are still recommended before major network generation.

[HR][/HR]

Installation

1. Download ProSewers.
2. Stop your server.
3. Place the JAR inside the /plugins folder.
4. Start the server.
5. Edit:
   
   Code (Text):

   
   plugins/ProSewers/config.yml
    
6. Use:
   
   Code (Text):

   
   /prosewers reload
    
7. Create your first sewer node.

Do not use PlugMan / PlugManX to update ProSewers.

For updates, stop the server and replace the JAR normally.

[HR][/HR]

Compatibility

• Minecraft: Paper 1.21.x
• Java: Java 21
• Required dependencies: None
• Optional integration: WorldGuard
• Languages: English & Spanish

[HR][/HR]