SoapsUniverse
SoapsTeleporter
SoapsTeleporter

Getting Started

HomeIntroductionGetting Started

Configuration

ConfigurationDefault Config Files

Guides

Portal CreationPortal TypesParticles and EffectsConditionsEconomyInteractive Management

Reference

Commands and PermissionsIntegrationsPlaceholdersExamples

Support

FAQChangelog

FAQ

Last updated Jul 6, 2026

FAQ

Common questions from server owners running SoapsTeleporter 1.0.5.

General

How do I update the plugin?

Replace the JAR in plugins/ and restart. Config and portals.yml are preserved. Review Changelog for breaking changes.

What server software is supported?

Paper 26.1+ (Paper 1.21.x also works). Spigot 1.21.x is supported (secondary). Folia is not supported.

What Java version is required?

Java 25+ on Paper 26.1+. Java 21+ on Paper 1.21.x.

Do I need SoapsCommon?

Yes. SoapsTeleporter lists SoapsCommon under depend in plugin.yml.

Where is portal data stored?

plugins/SoapsTeleporter/portals.yml. Auto-save interval is set in config.yml (general.auto-save-interval, default 5 minutes).

Portals

Players are not teleporting. What should I check?

  1. /st info <portal>: is it enabled and connected (or RTP configured)?
  2. Permissions: st.portal.use and st.portal.use.<name> if per-portal permissions are on.
  3. Conditions and costs blocking the player.
  4. /st debug issues for automated checks.
  5. /st reload runs a self-test with config, messages, portal, particle, permission, and file checks.

Can portals link across worlds?

Yes when safety.cross-world is true (default).

Can portals overlap?

No. Creation fails if regions overlap.

How large can a portal be?

Default 1 to 50 blocks per side (portals.limits in config). Adjust min-size and max-size as needed.

Can players break blocks inside a portal?

Not when protection.enabled is true, unless they have st.protection.bypass.

Particles

Particles are not visible.

  1. Confirm particles.enabled is true.
  2. Stand within performance.nearby-player-radius (default 30 blocks).
  3. Check client particle settings (Minimal particles hide some effects).

How do I change portal color?

Use /st setcolor only on portals with the DUST particle.

Economy

Money costs do not work.

You need economy.enabled: true, Vault, and an economy plugin. Run /st debug economy for status.

What is the difference between cost and money condition?

/st setcost charges the player. /st setcondition ... money only checks balance.

Permissions

How do I restrict one portal?

Enable players.permissions.per-portal-permissions and grant st.portal.use.<portalname>.

Can regular players create portals?

Not by default. Grant st.command.add, st.command.wand, and related nodes to trusted builders.

Management and GUI

/st manage opens a chest menu. Can I use chat instead?

Set gui.enabled: false in config.yml and /st reload.

Where do I edit menu text?

gui.yml for inventory labels. messages.yml for chat messages.

Performance

Many portals are causing lag.

  • Lower performance.max-particles-per-tick
  • Keep performance.adaptive-density enabled
  • Raise per-portal /st setinterval values
  • Reduce max-particles-per-portal

Does teleport use async work?

Chunk preload and parts of the teleport pipeline run asynchronously where Paper allows.

Troubleshooting

Config errors after an update.

Run /st reload and read console output. Compare your files to Default Config Files. Delete a broken file and restart to regenerate it (back up portals.yml first).

Where do I report bugs?

Discord: discord.gg/mawAzwFq

Next Steps

Discord