Magic Balls

Magic Balls

Cast spells and hurl elemental magic at your friends or foes! Launch fire, water, or earth-based projectiles with visual flair and status effects.

Features

• 3 spell types: Fireball, Waterball, and Earthball
• Each spell has unique VFX and damage types
• Configurable damage, cooldowns, and UI position
• Applies status effects: burning, freezing, radiation
• Animal damage multiplier
• Spell cycling system
• Permission-based spell access

Commands

• /cast - Toggle casting mode
• /mbc - Open UI control menu to reposition spell display text

Permissions

• magicballs.fireball - Grants use of Fireball
• magicballs.waterball - Grants use of Waterball
• magicballs.earthball - Grants use of Earthball
• magicballs.bypass.cooldown - Bypass spell cooldowns

Control Systems

Improved Mouse Controls (default)

• Left Click - Cast selected spell
• Right Click - Cycle spells
• Must be in casting mode (/cast)
• Empty hands required

Legacy Controls (if set to false in config)

• Left Click - Cast selected spell
• R Key - Cycle spells
• Must be in casting mode (/cast)
• Empty hands required

Caveats & Disclaimers

Magic balls do NOT collide with:

• Ground terrain
• Rocks
• Water
• Monument buildings
• Power poles

Magic balls DO collide with:

• NPCs (animals, scientists, heli)
• Players
• Trees
• Loot & terrain decor
• Building blocks
• Above-ground entities

Default Configuration

{
  "Despawn Timer": 5.0,
"Velocity": 100.0,
"Cooldown": 1.0,
"Use Improved Mouse Controls": true,
"Base Damage": {
"fireball": 100000.0,
"waterball": 100000.0,
"earthball": 100000.0
},
"Effect Duration": {
"fireball": 3.0,
"waterball": 4.0,
"earthball": 15.0
},
"Heat Amount": 100.0,
"Cold Amount": 100.0,
"Radiation Amount": 100.0,
"Animal Damage Multiplier": 10.0,
"Magic Ball Chat Messages": true,
"Show Spell UI": true,
"Default UI Position": {
"x": 0.0,
"y": 0.014
}
}

Default Data

{
  "76561198022999999": {
     "x": 0.0,
     "y": 0.014
   }
 }

Default Language

{
  "NoPermission": "<color=#FFA500>[Magic Balls]</color> You don't have permission to cast {0}!",
  "Cooldown": "<color=#FFA500>[Magic Balls]</color> You must wait {0} seconds between casting spells!",
  "FireballCast": "<color=#FFA500>[Magic Balls]</color> You cast a <color=#FF0000>fireball</color>!",
  "WaterBallCast": "<color=#FFA500>[Magic Balls]</color> You cast a <color=#00BFFF>water ball</color>!",
  "EarthBallCast": "<color=#FFA500>[Magic Balls]</color> You cast a <color=#00FF00>earth ball</color>!",
  "CastingEnabled": "<color=#FFA500>[Magic Balls]</color> Casting Mode: <color=green>ENABLED</color>",
  "CastingDisabled": "<color=#FFA500>[Magic Balls]</color> Casting Mode: <color=red>DISABLED</color>",
  "SpellSelected": "<color=#FFA500>[Magic Balls]</color> Selected spell: <color={0}>{1}</color>"
}

[/HR]

Support

Fear not, fellow spell-slinger. The Dark Side Development Discord is your arcane sanctuary. Whether you’re looking for support, balance suggestions, or just want to brag about your fireball kill streak, we’re here.

Ko-Fi
Like what we do? Support us over at Ko-Fi

Compatible with the following modding frameworks:

Oxide ✅
Carbon ✅

[/HR]

Legal

Copyright © 2025 Lincoln

This plugin, Magic Balls, is the intellectual property of Lincoln. The plugin may not be copied, modified, merged, published, or redistributed without the explicit permission of the creator, Lincoln. Permission is granted solely for personal use on a Rust server that you own or manage. Commercial use, sharing with third parties, or distribution on multiple servers is strictly prohibited without prior consent from the creator.

Disclaimer of Warranty and Liability:

This plugin is provided "as is" without any express or implied warranties. The creator disclaims any liability for damages, including but not limited to server malfunctions, data loss, or other issues arising from the use of this software. Use of the plugin is at your own risk.