Skip to main content
The Timed Portals addon makes a portal self-destruct a set number of milliseconds after it is ignited. You can also choreograph particle effects that play at specific moments during the countdown, creating a dramatic visual buildup before the portal disappears. This makes it perfect for event portals that open for a brief window, time-limited challenge gates, or any scenario where urgency is part of the experience.

​
Configuration

Add the TimedPortals block under the Addon: section in your portal’s .yml file. 
Addon:
  TimedPortals:
    DestroyAfterMillis: <input1>
    Action: '<input2>'
    Effects:
      - '[millis]->[particle pack]'

​
Fields

DestroyAfterMillis — Any integer greater than zero. This is the number of milliseconds the portal stays active after being ignited before the action triggers. For example, 5000 keeps the portal open for exactly 5 seconds. Action — Controls how the portal is removed when the timer expires. Two base values are available:
  • Close — Breaks the portal interior only, leaving the frame blocks in place. Equivalent to attacking the inside of the portal.
  • Destroy — Removes both the portal interior and all frame blocks.
Append {explode%<0-100>} to either action to add an explosion chance at destruction time. The integer is the percentage probability. Effects — An optional list of particle pack events to fire during the countdown. Each entry maps a millisecond offset (measured from ignition) to a particle pack name defined in the Particles addon. List entries fire in the order they are defined.

​
Example: 5-Second Portal with Countdown Effects

Addon:
  TimedPortals:
    DestroyAfterMillis: 5500
    Action: 'Destroy{explode%75}'
    Effects:
      # '[milliseconds after ignite]->[particle pack name]'
      - '1000->timer1'
      - '2000->timer1'
      - '3000->timer1'
      - '4000->timer1'
      - '5000->timer2'
      - '5500->timer3'
In this example the portal fires the timer1 particle pack each second for the first four seconds, switches to timer2 at the five-second mark, plays a final timer3 effect as the portal destroys itself, and has a 75 % chance of exploding on destruction.

​
Example: Simple 30-Second Portal

Addon:
  TimedPortals:
    DestroyAfterMillis: 30000
    Action: 'Close'
The Effects section requires the Particles addon to be installed. If the Particles addon is not present, omit the Effects key entirely to avoid configuration errors.
Use the Timed Portals addon for scheduled server events. Ignite the portal at the start of the event window — it stays open for exactly as long as you configure and then seals itself automatically, with no admin intervention required to close it.