ParticlePortal – Usage Documentation
Setup

1. Drop ParticlePortal.jar into your server’s /plugins folder.
2. Restart or reload your server.
3. Edit config.yml (if desired) for defaults like particle, density, or wand item.
4. (Optional) Set up permissions if you want non-ops to use portal commands.

Portal Creation Workflow

1. Get your wand:
   /ppwand
   (Default: Wooden Pickaxe, can be changed in config)
2. Select portal region:
   • Left-click a block to set pos1 (first corner).
   • Right-click a block to set pos2 (opposite corner).
3. Create a portal:
   /ppadd <name> [particle] [density]
   • Example: /ppadd MagicGate ENCHANTMENT_TABLE 80
   • particle and density are optional.

Commands Cheat Sheet
/ppwand Get the portal selection wand
/ppadd <name> [particle] [density] Create a new portal region
/ppremove <name> Remove a portal region
/ppmod <name> <particle> [density] Modify portal effect/density
/ppparticles List all supported particle types
/pplist List all portal regions
/ppreload Reload config and regions
/pphelp Show in-game help
Advanced Tips

• Any Shape: Portals can be tall, flat, diagonal, or even big multi-block doors. Just select any two corners!
• Animated Effects: All portals swirl with animated particle movement.
• Works with Glass: Particles will appear inside both air and stained glass panes for even cooler effects.
• Particle Types: See /ppparticles for the full list. Try experimenting for the best look!

Permissions

• particleportal.create: Allows creation, modification, and removal of portals. (Default: OP only)
• Give to trusted players for creative builds!

Editing Config

• Change defaults for particle, density, or wand item in config.yml (reload with /ppreload).
• Back up or view all portals in portal_regions.csv (if enabled).
  

Compatibility

• Tested on Paper and Spigot for Minecraft 1.20, 1.21+
• No other plugins required.
  

Need Help?

• Use /pphelp in-game for quick info.
• See /ppparticles for a live list of all supported particle types.
• DM JessPi42 (author) on Spigot if you need more help or want new features.