> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Troubleshoot Pylon Network Issues in Terraria

> Resolve common fast-travel failures. Learn how to fix Pylon biome errors, NPC housing discrepancies, and regional protection conflicts on your Terraria server.

## Managing Global Fast-Travel: Pylon Logic

Pylons represent an essential technical infrastructure for any large-scale Terraria community, providing a smooth "Fast-Travel" network across diverse world biomes. However, on dedicated servers, participants frequently encounter logic failures such as **"The Pylon is not in the correct biome"** or **"You are not close enough to a Pylon."** These errors are typically triggered by NPC status discrepancies, environmental world-evil spread, or conflicts with server-side protection frameworks. This guide ensures your Pylon network remains operational and efficient.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Intermediate
  </Card>

  <Card title="Time" icon="clock">
    5 Minutes
  </Card>
</CardGroup>

***

## Core Operational Requirements

For a Pylon entity to function as a valid teleportation node, the engine enforces three primary technical conditions.

<Tabs>
  <Tab title="Geographic Integrity">
    The Pylon must remain situated within its native biome. A **Jungle Pylon** will programmatically cease operation if the surrounding tiles exceed the "Corruption" or "Crimson" density thresholds. Administrators should use the Clentaminator to maintain biome purity around Pylon hubs.
  </Tab>

  <Tab title="NPC Synchronization">
    At least **two living NPCs** must possess valid, assigned housing within the Pylon's immediate interaction radius. If an NPC is killed during an event or relocated, the link is instantly severed.
  </Tab>

  <Tab title="Combat Restrictions">
    The Pylon network is programmatically disabled during active **Boss Encounters** or **Global Invasions** (e.g., Blood Moon or Pirate Invasion) to prevent players from bypassing combat mechanics through teleportation.
  </Tab>
</Tabs>

***

## Technical Server Troubleshooting

Review these common backend hurdles if your community reports persistent Pylon failures.

<AccordionGroup>
  <Accordion title="TShock Region Flag Conflicts">
    If you use [TShock Regions](/games/terraria/managing-bans-and-guests-in-terraria) to protect your community hubs, verify that the region allows for **"Living"** entities. If a region flag prevents NPC pathfinding or "Housing" logic, the Pylon will fail to recognize the nearby NPCs and remain inactive.
  </Accordion>

  <Accordion title="Addressing NPC Position Desync">
    Occasionally, the server node may believe an NPC has drifted out of range while the client renders them locally. To resolve this, we recommend using the TShock command **`/kill *`** (target NPCs only) to force a global respawn and technical coordinate reset.
  </Accordion>

  <Accordion title="Technical Fix: PylonOverride">
    For large-scale public servers, the 2-NPC requirement can be difficult to maintain. We recommend installing the **PylonOverride** plugin. This allows you to configure the engine to ignore NPC requirements entirely, providing a 100% reliable teleportation experience for your community.
  </Accordion>
</AccordionGroup>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Terraria:** Pylon network audited.
</div>