TheNextLvlTheNextLvl

Configuration

Configure Portals behavior, teleportation, and performance settings

GitHub Edit on GitHub

Configuration

Portals provides configuration options to customize plugin behavior, teleportation mechanics, and performance settings.

Configuration File Location

The main configuration file is located at: plugins/Portals/config.json
Translation files for customizing messages are located in: plugins/Portals/translations/

Configuration files are auto-generated with default values on first run.
New options are automatically added when updating to newer versions.

Configuration Options

SettingDescriptionDefault
allowCaveSpawnsAllow random teleports to consider caves as safe locationsfalse
entryCostsEnable or disable portal entry costs globallytrue
ignoreEntityMovementPrevent non-player entities from interacting with portalsfalse
pushbackSpeedSpeed of the pushback effect0.3

Setting entryCosts to false will disable ALL portal costs, regardless of individual portal settings.

Entity Interaction Settings

When enabled, only players can trigger portals. Mobs, minecarts, and other entities will not be able to interact with or teleport through portals.

Performance Optimization: Enable this option on servers with many entities to improve performance.
The performance gain depends on the number of entities on your server.

Pushback Speed

When an entity is denied portal entry (due to lack of permission, insufficient funds, or active cooldown), this setting controls the pushback behavior.

Speed Values:

  • 0.3 - Slow pushback (default, recommended)
  • 0.5 - Slight pushback
  • 1.0 - Relatively fast pushback
  • Higher values - Faster pushback
  • 0 or below - Disables pushback entirely

Disabling pushback may cause entities to get stuck at portal boundaries.
It's recommended to use a low value like 0.3 or 0.5 for a better user experience.

Last updated on