StickyGrenades 1.0.3

Sticky Grenades Plugin for Rust

Unleash an explosive twist on Rust gameplay with the Sticky Grenades plugin! Designed for intense combat scenarios, this highly customizable plugin introduces grenades that can stick to surfaces, detonate on impact, and feature unique incendiary and flash effects.

With complete control over each grenade’s behavior, server admins can define custom grenade types, set permissions, adjust inventory caps, and configure special effects, allowing them to create a fully personalized arsenal.

WORK IN PROGRESS - UPCOMING FEATURES

• RadiationGrenade
• HealingGrenade
• WaterGrenade
• RepairGrenade
• StructureUpgradeGrenade
• VisualEffectSetting - On Explosion Trigger Visual Effects That Can Be Defined in Config

Key Features:

1. Create Custom Grenades

• Total Control: Define each grenade’s properties, such as damage, blast radius, throw force, and stickiness.
• Flexible Permissions: Assign unique permissions to each grenade type, allowing for restricted access based on player groups. The plugin will automatically create these permissions, so admins only need to specify them in the configuration.
• Inventory Cap and Costs: Limit the number of each grenade type players can hold, and specify costs to balance their availability.

2. Sticky and Impact Grenades

• Surface Adhesion: Make grenades stick to surfaces, ideal for tactical ambushes and traps.
• Impact Detonation: Configure grenades to explode on impact for fast-paced combat.

3. Grenade Effects

• Sticky Effect (CanStick)
• Grenade sticks to surfaces on impact.

• Impact Explosion (ExplodeOnImpact)
• Grenade explodes upon hitting a surface.

• Flash Effect (Flash)
• Temporarily blinds players within the radius.
• Configurable flash duration.

• Incendiary Effect (Incendiary)
• Creates a fire effect on impact, dealing burn damage over time.

• EMP Effect (EMP)
• Disables nearby turrets and SAM sites for a specified duration.
• Configurable EMP duration.

• Demolition Effect (Demolition)
• Destroys all non-player entities within a specified radius.

• Sleep Effect (SleepEffect)
• Puts players within the explosion radius to sleep.
• Players cannot manually wake up until the sleep duration ends.
• Configurable sleep duration.

• Cluster Effect (ClusterGrenade)
• Upon explosion, releases multiple smaller grenade fragments.
• Configurable number of fragments (ClusterGrenadeAmount) and throw force (ClusterThrowForce).

4. User-Friendly Commands

• /getgrenade <name> [quantity]: Players can obtain grenades based on permissions, inventory caps, and resource requirements.
• /grenadelist: Displays available grenades with detailed properties, costs, caps, and permissions.

Generated Configuration

Below is the generated configuration file for the Sticky Grenades plugin. Admins can edit or add entries to define each grenade's properties.

UseCUIGrenadeList = true,

{
    ["HighDamage"] = new GrenadeConfig
    {
        Permission = "stickygrenades.vip1",
        SkinID = 813059006,
        Damage = 300f,
        ThrowForce = 15f,
        FuseLength = 5f,
        BlastRadius = 10f,
        CanStick = true,
        ExplodeOnImpact = false,
        SplashRadius = 12f,
        SplashDamage = 150f,
        MaxInventoryCap = 10,
        RequireCost = true,
        CostItems = new List<CostItem> { new CostItem { ItemShortname = "scrap", Amount = 30 } },
        Incendiary = false,
    },
    ["PowerfulBlast"] = new GrenadeConfig
    {
        Permission = "stickygrenades.vip2",
        SkinID = 810239244,
        Damage = 450f, 
        ThrowForce = 14f,
        FuseLength = 4f,
        BlastRadius = 12f,
        CanStick = false,
        ExplodeOnImpact = true,
        SplashRadius = 10f,
        SplashDamage = 200f,
        MaxInventoryCap = 20,
        RequireCost = true,
        CostItems = new List<CostItem>
        {
            new CostItem { ItemShortname = "gunpowder", Amount = 120 },
            new CostItem { ItemShortname = "metal.fragments", Amount = 40 }
        },
        Incendiary = true,
        Flash = false 
    },
    ["EMPGrenade"] = new GrenadeConfig
    {
        Permission = "stickygrenades.empgrenade",
        SkinID = 2388066931, 
        Damage = 0f, 
        ThrowForce = 10f,
        FuseLength = 3f, 
        BlastRadius = 8f,
        CanStick = false,
        ExplodeOnImpact = false,
        SplashRadius = 10f,
        SplashDamage = 0f, 
        MaxInventoryCap = 5,
        RequireCost = true,
        CostItems = new List<CostItem>
        {
            new CostItem { ItemShortname = "techparts", Amount = 20 },
            new CostItem { ItemShortname = "metal.fragments", Amount = 50 }
        },
        EMP = true, 
        EMPDuration = 15f 
    },
    ["Flashbang"] = new GrenadeConfig
    {
        Permission = "stickygrenades.flashbang", 
        SkinID = 2435780631, 
        Damage = 0f, 
        ThrowForce = 12f, 
        FuseLength = 2.5f,
        BlastRadius = 10f,
        CanStick = false, 
        ExplodeOnImpact = false,
        SplashRadius = 10f, 
        SplashDamage = 0f, 
        MaxInventoryCap = 5, 
        RequireCost = true,
        CostItems = new List<CostItem>
        {
            new CostItem { ItemShortname = "gunpowder", Amount = 30 },
            new CostItem { ItemShortname = "metal.fragments", Amount = 20 }
        },
        Flash = true,
        FlashDuration = 5f,
        Incendiary = false,
        EMP = false 
    },
    ["DemolitionGrenade"] = new GrenadeConfig
    {
        Permission = "stickygrenades.demolition",
        SkinID = 1052763402, 
        Damage = 1000f,
        ThrowForce = 10f,
        FuseLength = 2f,
        BlastRadius = 15f,
        CanStick = false,
        ExplodeOnImpact = true,
        SplashRadius = 10f, 
        SplashDamage = 500f,
        MaxInventoryCap = 3,
        RequireCost = true,
        CostItems = new List<CostItem>
        {
            new CostItem { ItemShortname = "explosives", Amount = 50 },
            new CostItem { ItemShortname = "gunpowder", Amount = 200 }
        },
        Demolition = true, 
    },
    ["SleepGrenade"] = new GrenadeConfig
    {
        Permission = "stickygrenades.sleepgrenade",
        SkinID = 817317634, 
        Damage = 0f, 
        ThrowForce = 10f, 
        FuseLength = 3f, 
        BlastRadius = 8f, 
        CanStick = false, 
        ExplodeOnImpact = false, 
        SplashRadius = 10f,
        SplashDamage = 0f, 
        MaxInventoryCap = 5, 
        RequireCost = true,
        CostItems = new List<CostItem>
        {
            new CostItem { ItemShortname = "gunpowder", Amount = 20 },
            new CostItem { ItemShortname = "metal.fragments", Amount = 30 }
        },
        SleepEffect = true, 
        SleepDuration = 5f, 
        Incendiary = false, 
        Flash = false,
        EMP = false 
    },
    ["ImpactExplosion"] = new GrenadeConfig
    {
        SkinID = 809918262,
        Damage = 500f,
        ThrowForce = 12f,
        FuseLength = 3f,
        BlastRadius = 15f,
        CanStick = false,
        ExplodeOnImpact = true,
        SplashRadius = 8f,
        SplashDamage = 80f,
        MaxInventoryCap = null,
        Flash = false,
        FlashDuration = 3f,
        RequireCost = false
    }
};

How to Create Your Own Grenade:

Creating a custom grenade is simple! Follow this example to add your unique grenade to the plugin configuration:

• Open the Configuration File for the Sticky Grenades plugin.
• Add a New Grenade Definition under "Grenades" with the desired properties.

Example Custom Grenade

• This example adds a grenade called "FlashBang" that blinds enemies, has an inventory cap of 5, requires scrap to craft, and is available only to players with the "stickygrenades.vip3" permission.

{
    "Grenades": {
        "FlashBang": {
            "Permission": "stickygrenades.YourDesiredPermissionName",
            "SkinID": YourDesiredSkinID,
            "Damage": 50.0,
            "ThrowForce": 10.0,
            "FuseLength": 3.0,
            "BlastRadius": 5.0,
            "CanStick": false,
            "ExplodeOnImpact": true,
            "SplashRadius": 7.0,
            "SplashDamage": 50.0,
            "MaxInventoryCap": 5,
            "RequireCost": true,
            "CostItems": [
                { "ItemShortname": "scrap", "Amount": 20 }
            ],
            "Incendiary": false,
            "ExplodeOnImpactEffects": true,
            "Flash": true,
            "FlashDuration": 3.0
        }
    }
}

With Sticky Grenades, server admins can create an arsenal of unique grenades tailored to their server’s needs. Define special permissions, add tactical effects, and bring explosive customization to your Rust world.