Configuration

config.yml holds server-wide defaults: general, GUI toggle, performance, particle defaults, portal limits, permissions, safety, RTP, protection, economy, and integration switches.

Concern	Guide
Particles / sounds / warmup	Particles and Effects
Money / item / XP costs	Economy
Vault hook	Vault Economy Setup
WorldGuard / Lands	WorldGuard Setup · Lands Setup
Soft-dep overview	Integrations
Menu layout	Admin GUI · Default gui.yml
Player messages	Default messages.yml
Live portal data	Portal Creation · Default portals.yml

Full shipped file: Default config.yml · All files: Config Reference

Reload / restart: see Getting Started.

---

General and GUI

general:
  debug: false
  auto-save-interval: 5
  message-cooldown: 3000

gui:
  enabled: true

Key	Default	Effect
debug	false	Extra logging; also /st debug
auto-save-interval	5	Minutes between portal data auto-saves (0 disables)
message-cooldown	3000	Milliseconds between repeated player messages
gui.enabled	true	Chest manage menus vs interactive chat

---

Performance and particles

performance:
  max-particles-per-tick: 200
  max-particles-per-portal: 500
  nearby-player-radius: 30.0
  adaptive-density: true
  adaptive-density-player-threshold: 15
  adaptive-density-reduction-factor: 0.5
  adaptive-tick-interval: 4

Portal/teleport/selection particle defaults live under particles (default portal particle DUST, count fallback 24, color #7C4DFF). Per-portal overrides: Particles and Effects.

---

Portal limits and teleportation

portals:
  limits:
    max-portals-per-player: 0
    max-portals-per-world: 0
    max-portals-per-chunk: 4
    max-size: 50
    min-size: 3
  shape-preview:
    default-frame-material: OBSIDIAN
  teleportation:
    preserve-orientation: true
    auto-adjust-destination: true

Key	Default	Effect
max-*-*	0 / 4	Creation caps (0 = unlimited where noted); bypass st.portal.limit.bypass
max-size / min-size	50 / 3	Longest-axis span bounds
preserve-orientation	true	Keep relative approach when exit direction is DEFAULT
auto-adjust-destination	true	Search for a safe landing nearby

---

Permissions, safety, protection

players:
  permissions:
    per-portal-permissions: true
    permission-format: "st.portal.%portal%.use"

safety:
  safe-teleport: true
  cross-world: true
  enhanced-safety: true
  safe-search-radius: 10

protection:
  enabled: true
  radius: 2
  protect-frame: true
  bypass-permission: "st.protection.bypass"

Per-portal access: Want restrict portal. Disable safety per portal with /st setdisablesafecheck.

---

RTP, economy, integrations

RTP preload/retry defaults (rtp.retry.max-attempts: 50) and economy keys are documented on Portal Types and Economy. Integration toggles start disabled except economy (Vault still required for money).

Next: Portal Creation · Admin GUI