Skip to content

Silorak/TF2-Dodgeball

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

224 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 TF2 Dodgeball Modified

GitHub release GitHub issues License

The definitive TF2 Dodgeball experience for SourceMod.

A modern, stable, and highly extensible version of the classic gamemode,
built on the shoulders of community giants.

📖 Wiki📦 Download🐛 Report Bug


✨ Features

🎮 Gameplay

  • Steal & Delay Prevention — Anti-grief mechanics built-in
  • Dual Homing Modes — Smooth homing or classic legacy homing
  • Bouncing Rockets — With player-controlled force bouncing
  • "Keep Direction" — Popular Redux feature included

🔧 Customization

  • Custom Rocket Classes — Models, sounds, speeds, damage
  • Event Commands@rocket, @owner, @target placeholders
  • Per-Map Configs — Override settings for specific maps
  • Music System — Round start/end music with web player support

🧩 Modular Architecture

  • 11 Optional Subplugins — Enable only what you need
  • Powerful API — 130+ natives for addon developers
  • Rich Forward System — Hook into every game event

📊 Technical

  • SourceMod 1.12 Ready — Modern syntax and memory safe
  • 10Hz Logic Timer — Architected for SourceMod accuracy
  • Smooth Frame Homing — High-precision tracking
  • Full Documentation — Comprehensive wiki & code docs

🚀 Quick Start

# 1. Download the latest release
# 2. Extract to your server's tf/ directory
# 3. (Optional) Add subplugins from Subplugins/ folder
# 4. Restart server or change to a tfdb_, db_, or dbs_ map
📋 Detailed Installation Steps
  1. Download the latest release from the Releases Page
  2. Extract the addons folder into your server's tf/ directory
  3. Add Subplugins (optional): Copy desired modules from Subplugins/ to tf/addons/sourcemod/plugins/
  4. Verify Dependencies: See Dependencies section
  5. Restart your server or change to any tfdb_, db_, or dbs_ prefixed map

📖 See the Installation Wiki for a complete guide.


📦 Subplugins

Module Description
AirblastPrevention Prevents airblast griefing
AntiSnipe Blocks long-distance rocket interference
AntiSwitch Prevents weapon switching exploits
ExtraEvents Additional event hooks for customization
FFA Free-for-all mode support
Menu In-game admin menu for settings
NoBlock Player collision toggle
Print Enhanced chat messages
Speedometer Real-time rocket speed display
Trails Visual rocket trail effects
Votes Player voting system

🔧 Dependencies

Dependency Required For Download
CollisionHook Anti Snipe Module AlliedModders
Nuke Model Nuke explosion effects AlliedModders

⚠️ Both dependencies are optional — only install if using the feature.


⚙️ Configuration

📁 addons/sourcemod/configs/dodgeball/
├── general.cfg          # Main configuration
└── tfdb_mapname.cfg     # Per-map overrides (optional)

The gamemode activates automatically on maps with the tfdb_, db_, or dbs_ prefix (including Workshop maps).

🎯 Example Rocket Class
"normal"
{
    "name"                "Normal Rocket"
    "behaviour"           "homing"
    "damage"              "50"
    "speed"               "800"
    "speed increment"     "50"
    "turn rate"           "0.260"
    "turn rate increment" "0.018"
    "max bounces"         "2"
    "on kill"             "sm_beacon @target"
}

📖 See the Configuration Wiki for all options.


🛠️ For Developers

📚 API Overview

Include File

#include <tfdb>

Key Natives

// Check if dodgeball is active
TFDB_IsDodgeballEnabled()

// Rocket manipulation
TFDB_GetRocketSpeed(int iIndex)
TFDB_SetRocketTarget(int iIndex, int iTarget)
TFDB_CreateRocket(int spawner, int spawnerClass, int team)

// Game state
TFDB_GetRocketCount()
TFDB_GetRoundStarted()

Forwards

TFDB_OnRocketCreated(int iIndex, int iEntity)
TFDB_OnRocketDeflect(int iIndex, int iEntity, int iOwner)
TFDB_OnRocketSteal(int iIndex, int iOwner, int iTarget, int iStealCount)

📖 Full API documentation available in tfdb.inc


❤️ Credits

Damizean
Original YADB
bloody & lizzy
Updated YADB
ClassicGuzzi
Dodgeball Redux
BloodyNightmare & Mitchell
Airblast Prevention
x07x08
Major Advancements
Silorak
Current Maintainer

And the entire SourceMod community for their continued support.


Made with ❤️ for the TF2 Dodgeball Community

About

A modern, stable, and highly extensible version of the classic TF2 Dodgeball gamemode for SourceMod, featuring advanced mechanics, optional modules, and extensive customization.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors