Version 0.16.0 - Experimental 2

Version 0.16 is a landmark release that fundamentally transforms how you write SER scripts. We've overhauled the syntax to make your code cleaner, more intuitive, and more powerful than ever before. Say goodbye to excessive brackets and hello to modern, readable scripting.

Warmly welcome @RetroReul - newest SER contributor!

Retro is behind most of the new methods and properties in version 0.16! Glad to have you on our team :)

The Arrow Operator (->)

The most significant change in v0.16 replaces clunky method calls with the elegant arrow operator. This single character revolutionizes how you access data throughout your scripts.

Cleaner Variable Definitions

No more wrapping properties in curly braces just to assign them to variables:

• Old Syntax: $name = {@plr name}
• New Syntax: $name = @plr -> name

Goodbye Redundant Info Methods

Specialized methods like ItemInfo, DamageInfo, and PickupInfo are now history:

• Old (Item): $type = ItemInfo *item type
• New (Item): $type = *item -> type
• Old (Pickup): @owner = PickupInfo *pickup lastOwner
• New (Pickup): @owner = *pickup -> lastOwner

Direct Property Access Revolution

SER now automatically scans game objects and exposes all their properties directly. No more waiting for developers to add specific properties-if it exists in the game's source code, you can access it:

# Access any property of any game object
$customProp = *reference -> somePropertyFromGameCode

All available properties are also searchable via serhelp properties command - use e.g. serhelp properties room and see for yourself!

SER Values Get Superpowers

Methods like DurationInfo and TextLength are now built-in properties:

• Old: $seconds = DurationInfo $duration totalSeconds
• New: $seconds = $duration -> totalSeconds
• Old: $length = TextLength $text
• New: $length = $text -> length

Property Chaining Mastery

Drill through multiple objects in a single, readable line:

• New: $nameLengthOdd = @sender -> name -> length -> isOdd
• New: $roomName = @plr -> roomRef -> name

Enhanced Player Control

Stamina System

Full control over player stamina with regeneration delay options:

Stamina set @plr 50% true  # Set to 50%, delay regeneration
Stamina add @plr 30%  # Add 30% stamina
Stamina remove @plr 20%  # Remove 20% stamina

Enhanced Movement

Jump @plr 2.5  # Make player jump with 2.5x strength

Visual Feedback

ShowHitMarker @plr 3.5 false  # Critical hit marker, no audio

New Player Properties

Access comprehensive player state information:

if {@plr -> isSpeaking} is true
    Print "Player is talking"
end

$unit = @plr -> unit  # Returns e.g. "FOXTROT-03" for NTF
$color = @plr -> roleColor  # Hex value of role color

New Properties Added:

• isSpeaking - Whether player is using voice chat
• isSpectatable - Whether player can be spectated
• isJumping - Whether player is currently jumping
• isGrounded - Whether player is on the ground
• movementState - Current movement state
• lifeId - Unique life identifier
• unitId - Unit identifier (e.g., 03)
• unit - Full unit name (e.g., "FOXTROT-03")

New Methods & Game Integration

Environmental Interactions

SetElevatorText "EMERGENCY ONLY"  # Custom elevator panel text
PryGate GateA true  # Pry gate with button effects

Player Management

ForceEquip @plr KeycardO5  # Force equip item like RA command

World Objects

CreateRagdoll ClassD "Victim" 10 5 2  # Spawn ragdoll at coordinates

Utility Methods

if {ContainsText $text "secret"} is true
    Print "Found secret!"
end

if {SpeakerExists "AnnouncementSystem"} is true
    PlayAudio "AnnouncementSystem" "alarm"
end

if {ScriptExists "myScript"} is false
    Print "Script not found!"
end

Streamlined Syntax & Flow Control

Math Without Parentheses

The bracket tax on math expressions is gone:

• Old: $five = (2 + 3)
• New: $five = 2 + 3

Inline with Statements

Keep your loops and functions clean and compact:

# Loop with player iteration
over @all with @plr
    Print {@plr -> name}
end

# Function with parameters
func $Add with $a $b
    return $a + $b
end

# Repeat with iteration counter
repeat 5 with $i
    Print "Iteration {$i}"
end

Keywords Replace Methods

Yield commands are now proper keywords for better flow control:

• Old: Wait 5s
• New: wait 5s
• Old: WaitUntil ({AmountOf @all} is 0)
• New: wait_until {AmountOf @all} is 0

Inline Comments

Document your code as you write it:

Print "Hello"  # Greet the player
if $hp < 20  # Critical health check
    Heal @sender 100  # Heal player
end

Built-in Effect System

Base-game status effects are now natively supported! No more EXILED dependency for basic effect management:

# Apply base-game effects
GiveEffect @plr Bleeding 5s  # Apply bleeding for 5 seconds
RemoveEffect @plr Bleeding  # Remove bleeding effect

Effect Properties

&effects = @plr -> effects  # Collection of active effect names
&effectRefs = @plr -> effectReferences  # Collection of effect references

Enhanced Door Properties

if {*door -> isGate} is true
    Print "This is a gate!"
end

if {*door -> isBreakable} is true
    Print "This door can be broken!"
end

if {*door -> isCheckpoint} is true
    Print "This is a part of a checkpoint!"
end

Other Notable Changes

Spawn Wave Control

SpawnWave ntfSpawnWave  # Spawn NTF wave

Interactable Toy Management

SetInteractableProperties *toy Box 5s true  # Modify interactable toy behavior

Improved Audio System

Improved LoadAudio method with better file handling and clearer documentation.

Enhanced Event Information

serhelp now shows whether events are cancellable for better event handling.

Updated Examples

All example scripts updated to use new syntax and moved to a custom folder for easy GitHub access.

Complete Documentation

Added llms-full.md with the entire SER language specification for AI-assisted development.

Version 0.16.0 - Experimental

SER v0.16: The Syntax Update

Version 0.16 is a major quality-of-life overhaul designed to make your scripts look more like modern code and less like a sea of brackets. We’ve focused on "syntactic sugar" to reduce typing and improve readability across the board.

---

💎 The Property Revolution (->)

The most significant change in v0.16 is how you access data. We are moving away from clunky method calls and bracketed properties in favor of the arrow operator.

Property Access in Variables

You no longer need to wrap properties in curly braces when defining variables.

• Old Syntax: $name = {@plr name}
• New Syntax: $name = @plr -> name

Replacing <Type>Info Methods for References

Specialized info methods (like ItemInfo, DamageInfo, or PickupInfo) have been deprecated or removed in favor of the more intuitive arrow syntax.

• Old (Item): $type = ItemInfo *item type
• New (Item): $type = *item -> type
• Old (Pickup): @owner = PickupInfo *pickup lastOwner
• New (Pickup): @owner = *pickup -> lastOwner

Direct Property Access

SER now scans references to give you direct access to their underlying properties. You are no longer limited to properties manually added by developers—if it exists in the source code, you can grab it with the -> operator. This opens up deep script customization for almost any game object.

SER Values have Properties

Methods like DurationInfo have been removed in favor of having direct properties of SER values.

• Old: $seconds = DurationInfo $duration totalSeconds
• New: $seconds = $duration -> totalSeconds
• Old: $length = TextLength $text
• New: $length = $text -> length

Property Chaining

You can now drill down through multiple objects in a single line of code.

• New Capability: $nameLengthOdd = @sender -> name -> length -> isOdd

---

⏳ Keyword Rework: wait and wait_until

We have transitioned yielding commands from Methods to Keywords. This better represents their role in controlling the script's internal execution flow. Note the shift to lowercase.

• Old Syntax: Wait 5s
• New Syntax: wait 5s
• Old Syntax: WaitUntil ({AmountOf @all} is 0)
• New Syntax: wait_until {AmountOf @all} is 0

---

🧹 Streamlined Logic & Expressions

Math Without the "Bracket Tax"

Math expressions in variable definitions are now much cleaner. The engine is now smart enough to parse these without requiring parentheses.

• Old Syntax: $five = (2 + 3)
• New Syntax: $five = 2 + 3

Inline with Statements

To keep your loops and functions compact, the with keyword can now reside on the same line as the header.

• Old (Loop):

  over @all
      with @plr
      ...
  end
  

• New (Loop):

  over @all with @plr
      ...
  end
  

• Old (Function):

  func $Add
      with $a $b
      ...
  end
  

• New (Function):

  func $Add with $a $b
      ...
  end
  

---

📝 Modern Scripting Comforts

Inline Comments

You can finally document your code as you write it. Inline comments are now fully supported using the # symbol.

• Example: Print "Hello" # This method prints "Hello"
• Example: if $x > $y # Check if $x is bigger than $y

---

The VSCode color extension

The extension will soon be recieving an update to properly handle the new syntax, but it is not ready yet.

Version 0.15.1

Fixes

• Fixed return and break keywords not terminating functions until a yield
• Fixed Exiled being requried to load the plugin (again)
• Fixed SetToyRotation and SetToyScale operating on Exiled toys instead of LabApi toys
• FIxed addDurationIfActive argument in GiveEffectMethod method not being applied correctly
• Fixed invalid database storing of text values (@Tosoks67)

Additions

• Added the ability to get the type of error and stack trace of the error in on_error statement (@Tosoks67)

  attempt
      ...
  on_error
      #              👇       👇
      with $message $type $stackTrace
      ...
  end
  

• Added color value type (part of literal values)

  # this creates a red color value
  $color = ff0000
  

• Added SetSpectatability method
• Added RemoveDBKey method (@Tosoks67)

Improvements

• Improved the serhelp methods command to list methods that can be added by frameworks, even if a given framework is not present

Version 0.15

CustomCommand flag additions

• *command local variable
• ResetGlobalCommandCooldown method
• ResetPlayerCommandCooldown method
• -- invalidRankMessage argument
• -- neededPermission argument
• -- noPermissionMessage argument
• -- onCooldownMessage argument
• -- globalCooldown argument
• -- onGlobalCooldownMessage argument
• Optional arguments for -- arguments option

Enum flag changes

(not to be confused with script flags)

• Added new syntax to define multiple enum values for the same argument using | syntax
  Instead of using ToFlags method, use the Val1|Val2|Val3 system instead.
  Example: SetPrimitiveObjectProperties *toy _ _ Collidable|Visible
  Be sure to NOT put a space there! Doing so will result in SER viewing them as different arguments.
• Removed ToFlags method

Fixes

• Fixed damage option of DamageInfo method returning text instead of a number
• Fixed the description in text arguments saying that text can be provided without quotes when not
• Fixed Chance method having inverted chance of returning true
• Fixed stop keyword crashing the server if used in specific circumstances
• Fixed RespawnWaveInfo not being compatible with all wave references (@Tosoks67)
• Fixed EXILED being required for SER to load (@Tosoks67)
• Fixed some enums not being searchable using serhelp command
• Fixed obsolete enum values being listed as available to use
• Fixed events tring to create invalid variables
• Fixed TPRoom method erroring when not providing optional arguments
• Fixed incorrect tracking of running scripts resulting in "ghost scripts"
• Fixed OnEvent flag not erroring when provided with an incorrect event name

Additions

• Added default value of RemoteAdmin for lock reason argument in LockElevator method
• Added more example scripts
• Added attempt and on_error statements (@Tosoks67)
• Added Overlapping method
• Added FriendlyFire method

Improvements

• Checking if script is attempting to use a yielding method inside {} brackets
• Better checking of inputs in enum arguments
• Printing of StaticTextValue and DynamicTextValue types in method help
• If script has multiple errors, all of them will be provided in a list, instead of only the first one
• Added hint to use serhelp <enum name> in enum argument
• Better error message formatting for invalid tokens
• Custom error for when an invalid method is used inside {} brackets

Version 0.14.1 - Experimental 3

Fixes

• Fixed incorrect tracking of running scripts resulting in "ghost scripts"
• Fixed OnEvent flag not erroring when provided with an incorrect event name

Improvements

• Better error message formatting for invalid tokens
• Custom error for when an invalid method is used inside {} brackets

Removed

• ToFlags method

Enum flag rework

(not to be confused with script flags)

Instead of using ToFlags to include multiple enum values, you can now use the | (pipe) operator like so:
SetPrimitiveObjectProperties *toy _ _ Collidable|Visible

---

Changes from version 0.14.1 - experimental 2

Fixes

• Fixed error when trying to get a friendly name of a value
• Fixed error when some events tried to create invalid variables
• Fixed TPRoom method erroring when not providing optional arguments

Added

• FriendlyFire method

---

Changes from version 0.14.1 - experimental 1

Fixes

• damage option of DamageInfo method returning text instead of a number
• Description in text arguments saying that text can be provided without quotes when not
• Chance method having inverted chance of returning true
• stop keyword crashing the server if used in specific circumstances
• RespawnWaveInfo not being compatible with all wave references (@Tosoks67)
• EXILED being required for SER to load (@Tosoks67)
• Some enums not being searchable using serhelp command
• Obsolete enum values wont be listed as available to use

Additions

• Default value of RemoteAdmin for lock reason argument in LockElevator method
• More example scripts
• attempt and on_error statements (@Tosoks67)
• -- invalidRankMessage argument for CustomCommand flag
• Overlapping method

Improvements

• Checking if script is attempting to use a yielding method inside {} brackets
• Better checking of inputs in enum arguments
• Printing of StaticTextValue and DynamicTextValue types in method help
• If script has multiple errors, all of them will be provided in a list, instead of only the first one
• Added hint to use serhelp <enum name> in enum argument

Version 0.14.1 - Experimental 2

Fixes

• Fixed error when trying to get a friendly name of a value
• Fixed error when some events tried to create invalid variables
• Fixed TPRoom method erroring when not providing optional arguments

Added

• FriendlyFire method

---

Changes from version 0.14.1 - experimental 1

Fixes

• damage option of DamageInfo method returning text instead of a number
• Description in text arguments saying that text can be provided without quotes when not
• Chance method having inverted chance of returning true
• stop keyword crashing the server if used in specific circumstances
• RespawnWaveInfo not being compatible with all wave references (@Tosoks67)
• EXILED being required for SER to load (@Tosoks67)
• Some enums not being searchable using serhelp command
• Obsolete enum values wont be listed as available to use

Additions

• Default value of RemoteAdmin for lock reason argument in LockElevator method
• More example scripts
• attempt and on_error statements (@Tosoks67)
• -- invalidRankMessage argument for CustomCommand flag
• Overlapping method

Improvements

• Checking if script is attempting to use a yielding method inside {} brackets
• Better checking of inputs in enum arguments
• Printing of StaticTextValue and DynamicTextValue types in method help
• If script has multiple errors, all of them will be provided in a list, instead of only the first one
• Added hint to use serhelp <enum name> in enum argument

Version 0.14.1 - Experimental

Fixes

• damage option of DamageInfo method returning text instead of a number
• Description in text arguments saying that text can be provided without quotes when not
• Chance method having inverted chance of returning true
• stop keyword crashing the server if used in specific circumstances
• RespawnWaveInfo not being compatible with all wave references (@Tosoks67)
• EXILED being required for SER to load (@Tosoks67)
• Some enums not being searchable using serhelp command
• Obsolete enum values wont be listed as available to use

Additions

• Default value of RemoteAdmin for lock reason argument in LockElevator method
• More example scripts
• attempt and on_error statements (@Tosoks67)
• -- invalidRankMessage argument for CustomCommand flag
• Overlapping method

Improvements

• Checking if script is attempting to use a yielding method inside {} brackets
• Better checking of inputs in enum arguments
• Printing of StaticTextValue and DynamicTextValue types in method help
• If script has multiple errors, all of them will be provided in a list, instead of only the first one
• Added hint to use serhelp <enum name> in enum argument

Version 0.14

UCR and Voting via plugin integrations

These are methods that are loaded when other plugins are detected, adding more features!

Callvote plugin methods

• StartVote
• StartVoteAndWait
• VoteOption

Uncomplicated Custom Roles plugin methods

• GetUCRRole
• SetUCRRole
• UCRRoleInfo
• GetPlayersWithUCRRole

Admin Toy methods

Used for handling admin toys, like spawning, modifying, teleporting etc.

• CreateToy (@Tosoks67)
• DestroyToy (@Tosoks67)
• MoveToy (@Tosoks67)
• SetToyParent (@Tosoks67)
• SetToyRotation
• SetToyScale
• TPToyPlayer (@Tosoks67)
• TPToyPos (@Tosoks67)
• TPToyRoom (@Tosoks67)
• ToyInfo (@Tosoks67)
• SetCameraProperties (@Tosoks67)
• SetLightSourceProperties (@Tosoks67)
• SetPrimitiveObjectProperties (@Tosoks67)
• SetShootingTargetProperties (@Tosoks67)
• SetTextProperties (@Tosoks67)
• InteractableToyEvent flag (@Tosoks67)

Better global variables

• Added verifications for name collisions with other variables.
• Replaced GlobalVariable method with global keyword. (@Tosoks67)

# This will create a global variable
global $myGlobalVar = "hello!"

foreach -> over keyword change

Changed the name of the foreach loop to over loop for better readability.
No functionality was changed.

# This is how it looks
over @all
    Print "found player!"
end

over @all
    with @plr

    Print "found player {@plr name}!"
end

Stricter checks for running scripts

When a script uses !-- OnEvent or !-- CustomCommand, running it by any other mean will not be possible.

Other additions:

• more example scripts
• ToFlags method
• IsLiteral method
• SetAppearance method (EXILED must be installed)
• PlayWaveEffect method
• GetVariableByName method
• fixed minor bugs

New contributor: @Unbistrackted

Fixed plugin bridge error.

Version 0.13.1

Added 2 new arguments for CustomCommand flag:

1. cooldown - players will have to wait until the cooldown finishes before running the command again
2. neededRank - only players with the provided rank(s) can run the command

Example:

!-- CustomCommand vipbroadcast 
-- arguments text
-- availableFor player
-- neededRank vip
-- cooldown 2m

# sends a simple broadcast to everyone - VIP benefit
Broadcast * 10s "* VIP BROADCAST *<br>[{@sender name}]<br>{$text}"

Other changes:

• Fixed the example script for discord webhook having an active webhook URL

Version 0.13.0

Version 0.13.0 adds Discord methods, HTTP methods, and a lot more!
Check out the new example script discordServerInfo to see how you can use the new Discord integration!

Added:

Discord methods:

• SendDiscordMessage
• EditDiscordMessage (@Tosoks67)
• SendDiscordMessageAndWait
• DeleteDiscordMessage (@Tosoks67)
• DiscordMessage
• DiscordEmbed
• EmbedAuthor
• EmbedField
• EnbedFooter

HTTP methods:

• HTTPGet
• HTTPPost
• HTTPPatch (@Tosoks67)
• CreateJSON
• AppendJSON
• FormatToReadableJSON
• JSONInfo
• ParseJSON

Text methods:

• TextLength
• SubText
• TrimText
• PadText (@Tosoks67)

Other:

• Get096Targets method (@Tosoks67)
• ServerInfo method (@Tosoks67)
• ReplaceTextInVariable method (@Tosoks67)
• HexToInt method (@Tosoks67)
• IntToHex method (@Tosoks67)
• isDummy player property (@Tosoks67)
• isNpc player property (@Tosoks67)
• syntax for skipping not required arguments
• Chance method
• GetWaveTimer method
• FormatDuration method
• more options for TimeInfo method (@Tosoks67)
• discordServerInfo example script

Fixed:

• Example scripts being outdated
• Flags sometimes not being registered
• RespawnWave method not being compatible with NW wave objects
• literal variables sometimes formatting with debug metadata (@Tosoks67)
• text escape characters being removed on manipulation

Removed:

• @scp173Observers variable (Get173Observers method now fully replaces the @scp173Observers variable) (@Tosoks67)
• Eval method (the parentheses system works the exact same way)
• ParseResultInfo method (renamed to ResultInfo)
• RespawnWaveInfo "secondsLeft" (changed to "timeLeft" and now returns a Duration value)