<img alt="scriptedeventslogo.png" height="300" src="scriptedeventslogo.png"/>

What is Scripted Events Reloaded?

Scripted Events Reloaded (SER) is an SCP:SL plugin that adds a custom scripting language for server-side events.

Main goal

Making plugins with C# is NOT an easy thing, especially for beginners. If you want to get started with SCP:SL server-side scripting, SER is a great way to begin.

SER simplifies the most essential plugin features into a friendly package. All you need to get started is a text editor and a server!

Nice-to-Haves of SER

• Simplification of the most essential features like commands, events and player management.
• No compilation required, while C# plugins require a full development environment, compilation, and DLL management.
• Lots of built-in features like AudioPlayer, Databases, Discord webhooks, HTTP and more!
• Extendable with frameworks like UCR, EXILED or Callvote, but without any dependencies!
• Plugin docs are available directly on the server using the serhelp command.
• Helpful community available to help you with any questions you may have.

SER Tutorials

https://scriptedeventsreloaded.gitbook.io/docs/tutorial

Examples

(these scripts may be outdated, check the Example Scripts folder for the latest example scripts)

Welcome message

!-- OnEvent Joined

Broadcast @evPlayer 10s "Welcome to the server {@evPlayer -> name}!"

Coin on kill

!-- OnEvent Death

# check if player died without an attacker
if {VarExists @evAttacker} is false
    stop
end

# give the attacker a coin
GiveItem @evAttacker Coin

VIP broadcast command

# define the command with custom attributes
!-- CustomCommand vipbc
-- description "broadcasts a message to all players - VIP only"
-- neededRank vip svip mvip
-- arguments message
-- availableFor Player
-- cooldown 2m

# send the broadcast to all players
Broadcast @all 10s "{@sender -> name} used VIP broadcast<br>{$message}"

Heal random SCP

!-- CustomCommand healscp
-- description "heals a random SCP"
-- availableFor Player
-- cooldown 10s

# dont allow SCPs to use this command
if {@sender -> team} is "SCPs"
    stop
end

@randomScp = LimitPlayers @scpPlayers 1
Heal @randomScp 50
Broadcast @randomScp 4s "You were healed by {@sender -> name}!"

Hot Potato event

!-- OnEvent RoundStarted

forever
    Wait 1m

    # Get a random player from the alive players
    @potatoCarrier = LimitPlayers @alivePlayers 1

    # if no player is alive, continue to next attempt
    if {AmountOf @potatoCarrier} is 0
        continue
    end
    
    Hint @potatoCarrier 3s "YOU HAVE THE HOT POTATO! DROP IT OR DIE!"
    GiveItem @potatoCarrier GunA7

    Wait 3s

    # Check if they still have the item (GunA7) in their inventory
    over {@potatoCarrier inventory} with *item
    
        if {*item -> type} isnt "GunA7"
            continue
        end

        AdvDestroyItem *item
        Explode @potatoCarrier
        Broadcast @all 5s "{@potatoCarrier -> name} failed the Hot Potato!"
        stop
    end
        
    Broadcast @all 5s "The Hot Potato has been neutralized... for now."
end