Skip to main content
Towny Ports

Towny Ports and how to use it!

TownyPorts 🌊

TownyPorts unlocks the economic and geopolitical power of waterways by letting non-capital towns set port plots that visitors can teleport to—for a configurable fee. Perfect for boosting trade, tourism, and strategic depth in your Towny world.

note

Port plots are only valid in Ocean, River, and Beach biomes. Players must stand on a port plot to initiate travel.

👩‍💻 Quick Start​

/plot set port

Mark your current plot as the town’s official port plot.

/t port price <town>

View the Port Fee of that Town.

/t set port price <amount>

Set the fee of your own Port.

/t set port spawn

Set the spawn location of your Port.

⚙️ Configuration​

Default settings.yml
uses-economy: true
minimum-port-fee: 10
maximum-port-fee: 100
currency-sign: "$"
maximum-port-distance-in-chunks: 2750
port-travel-cooldown-in-seconds: 60
port-travel-warmup-in-ticks: 100
port-travel-denies-for-enemies: true

🔒 Permissions​

PermissionDescription
townyports.port.setAllow the resident to adjust port settings.
townyports.port.priceAllows the resident to see port prices of other towns.
townyports.bypass.wildernessAllows the resident to use ports from the wilderness.
townyports.bypass.distanceAllows the resident to use ports from any distance.
townyports.bypass.biomeAllows the resident to set a port in any biome.

🛠️ Behind the Scenes​

  1. Port Plot Creation
    Use /plot set port in an eligible biome to claim your town’s port.

  2. Spawn Point
    Town mayors can call /t set port spawn to record their exact location as the teleport target.

  3. Teleportation
    Visitors standing on a port plot use /t port <town> to pay the configured fee and teleport directly to the saved spawn location.

  4. Enforcement

    • Biome checks (oceans, rivers, beaches)
    • Nation relations (enemy nations are blocked)
    • Distance limits (configurable maximum chunk range)
    • Cooldown & Warmup (prevent spam and allow dramatic departures)