Skip to content

About

a CTFd Plugin to manage waves in a ctf

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

WaveManager — CTFd Plugin

A CTFd plugin that allows administrators to organize challenges into scheduled waves and release them automatically — or manually with a single click.


Features

  • Scheduled Release — Define a release time and the plugin reveals challenges automatically when it's due.
  • Instant Release — One-click Release Now button to push a wave live immediately during an event.
  • Live Countdown — Real-time countdown timers on all pending waves so you always know what's next.
  • Challenge Grouping — Assign any combination of existing challenges to a wave via searchable checkboxes.
  • Global Notifications — Optionally broadcast an alert to all participants the moment a wave drops.
  • Local Timezone Support — Times are displayed and entered in the admin's local timezone; stored as UTC on the server.
  • Admin-Only Access — Every route is protected behind CTFd's admins_only decorator.
  • Seamless Integration — Registers in the admin navbar, uses CTFd/Bootstrap 4 styling, and relies on CTFd's built-in CSRF protection.

Installation

  1. Copy the WaveManager/ directory into your CTFd plugins folder:

    CTFd/
    └── plugins/
        └── WaveManager/
    
  2. Restart CTFd. Database tables are created automatically on first load.

No additional Python packages are required.


Usage

Accessing the Plugin

After installation, a Wave Manager link appears in the admin navbar under the Plugins dropdown. Alternatively, navigate directly to /admin/waves.

Creating a Wave

  1. Click Create Wave.
  2. Fill in the form:
    Field Description
    Wave Name A descriptive label (e.g. "Wave 2 — Crypto").
    Release Time Displayed in your local timezone; converted to UTC automatically.
    Notification Text (Optional) Message broadcast to all users on release.
    Challenges Searchable checklist of all challenges in the database.
  3. Click Create Wave.

Managing Waves

Action Description
Release Now Immediately reveals all linked challenges and sends the notification.
Edit Update the wave name, time, notification text, or challenge selection.
Delete Remove a wave entirely. Challenges themselves are not affected.

Automatic Release

On every incoming request, the plugin checks for unprocessed waves whose release time has passed:

  1. All linked challenges are set to state = "visible".
  2. If notification text is present, a global notification is created in CTFd.
  3. The wave is marked as processed to ensure it only triggers once.

File Structure

WaveManager/
├── __init__.py            # Plugin entry point, blueprint, routes, and release logic
├── models.py              # Wave and WaveChallenges SQLAlchemy models
├── requirements.txt       # Dependencies (none beyond CTFd)
├── README.md
└── templates/
    └── waves/
        ├── waves.html     # Admin list view with countdown & release controls
        └── wave_form.html # Create / Edit form with timezone handling

Contributing

Contributions, bug reports, and feature requests are welcome. Feel free to open an issue or submit a pull request.

Author

Created by surakhii

About

a CTFd Plugin to manage waves in a ctf

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages