SoapsTeleporter Wiki

Last updated Jul 6, 2026

SoapsTeleporter is a portal system for Paper servers running Minecraft 1.21+. Create linked portals, random teleports, paid gates, and custom effects without building redstone contraptions.

Version 1.0.5

Quick Links

Page	Description
Introduction	What the plugin does and key features
Getting Started	Install and create your first portal pair
Configuration	Every `config.yml` option explained
Portal Creation	Wand workflow, connect, move, and routing
Portal Types	Standard, one-way, and RTP portals
Particles and Effects	Particles, sounds, warmup, and cooldown
Conditions	Restrict who can use a portal
Economy	Money, item, and XP costs
Interactive Management	GUI and chat management interfaces
Commands and Permissions	Full command and permission reference
Integrations	Vault, WorldGuard, Lands, and PlaceholderAPI
Placeholders	PlaceholderAPI tokens
Default Config Files	Full shipped YAML defaults
Examples	Ready-to-use portal setups
FAQ	Common questions
Changelog	Version history

Requirements

Requirement	Details
Server	Paper 1.21+
Java	21 or newer
Required	SoapsCommon (listed in `plugin.yml` as `depend`)
Optional	Vault + economy plugin, PlaceholderAPI, WorldGuard, Lands

Command: /st (aliases: /soapsteleporter, /teleporter)