update scripts and llms-full

Author: Elektryk-Andrzej

Example Scripts/chaosCoin.ser

@@ -10,12 +10,10 @@ $afterText = "<color=white><size=25><b>"
 # "coin locked" is a property of this player, storing whether a coin can be used.
 # this is because some effects of the coin take time, and we DO NOT want to
 # have the coin be used again WHILE a different effect is still ongoing
-if {HasPlayerData @evPlayer "coin locked"}
-    if {GetPlayerData @evPlayer "coin locked"}
-        Hint @evPlayer 5s "{$hintInfo}You can't use the coin for now!<br><size=20>Come back when the current effect has finished."
-        IsAllowed false
-        stop
-    end
+if {GetPlayerData @evPlayer "coin locked"} is true
+    Hint @evPlayer 5s "{$hintInfo}You can't use the coin for now!<br><size=20>Come back when the current effect has finished."
+    IsAllowed false
+    stop
 end
 
 # 50% chance to lose the coin

Example Scripts/killStreak.ser

@@ -1,31 +1,33 @@
 # this script adds a custom kill streak counter
 
 !-- OnEvent Death
+-- require @evPlayer
 
-if {VarExists @evAttacker} is true
-    # increment killer's streak
-    if {HasPlayerData @evAttacker "streak"}
-        $new = {GetPlayerData @evAttacker "streak"} + 1
-    else
-        $new = 1
-    end
-
-    # save the new kill streak
-    SetPlayerData @evAttacker "streak" $new
-
-    # inform attacker of kill
-    Broadcast @evAttacker 5s "Killstreak: {$new}"
-
-    # announce milestone
-    if $new is 5
-        Broadcast @all 5s "{@evAttacker -> name} is on a KILLING SPREE (5 Kills)!"
-    elif $new is 10
-        Broadcast @all 5s "{@evAttacker -> name} is UNSTOPPABLE (10 Kills)!"
-    end
+SetPlayerData @evPlayer "streak" 0
+Broadcast @evPlayer 5s "Your killstreak has been reset!"
+
+if {VarExists @evAttacker} is false
+    stop
+end
+
+# increment killer's streak
+$streak = GetPlayerData @evAttacker "streak"
+
+if $streak isnt invalid
+    $streak = $streak + 1
+else
+    $streak = 1
 end
 
-if {VarExists @evPlayer} is true
-    # reset the victim's streak
-    SetPlayerData @evPlayer "streak" 0
-    Broadcast @evPlayer 5s "Your killstreak has been reset!"
+# save the new kill streak
+SetPlayerData @evAttacker "streak" $streak
+
+# inform attacker of kill
+Broadcast @evAttacker 5s "Killstreak: {$streak}"
+
+# announce milestone
+if $streak is 5
+    Broadcast @all 5s "{@evAttacker -> name} is on a KILLING SPREE (5 Kills)!"
+elif $streak is 10
+    Broadcast @all 5s "{@evAttacker -> name} is UNSTOPPABLE (10 Kills)!"
 end

Example Scripts/zombie infection/onChangedRole.ser

@@ -0,0 +1,7 @@
+# if a player changes their role, their infection status should be reset 
+# e.g. role is changed by admin, death, other plugin etc.
+
+!-- OnEvent ChangedRole
+-- require @evPlayer
+
+ClearPlayerData @evPlayer date_of_death_by_infection

Example Scripts/zombie infection/onUsedItem.ser

@@ -0,0 +1,12 @@
+# if a player uses a medkit or SCP-500, 
+# his infection will be cleared
+
+!-- OnEvent UsedItem
+-- require @evPlayer *evUsableItem
+
+$type = *evUsableItem -> type
+if $type isnt "Medkit" and $type isnt "SCP500"
+    stop
+end
+
+ClearPlayerData @evPlayer date_of_death_by_infection

Example Scripts/zombie infection/onZombieBit.ser

@@ -0,0 +1,38 @@
+# this script is responsible for registering bites of zombies
+# and setting the time of death by infection for victims
+
+!-- OnEvent Hurt
+-- require @evPlayer @evAttacker
+
+@attacker = @evAttacker
+@victim = @evPlayer
+
+# if attacking player is not a zombie -> no infection
+if {@attacker -> role} isnt "Scp0492"
+    stop
+end
+
+# cant infect an SCP
+if {@victim -> team} is "SCPs"
+    stop
+end
+
+# 50% chance for the victim to get infected
+if {Chance 50%}
+    stop
+end
+
+*date = GetPlayerData @victim date_of_death_by_infection
+
+if *date is invalid
+    # set the date of death to 1 minute in the future
+    *date = Date.Offset {Date.Current} add 1m
+else
+    # when was bit before, remove 20 seconds from the date
+    # so the infection happens faster
+    *date = Date.Offset *date subtract 20s
+end
+
+SetPlayerData @victim date_of_death_by_infection *date
+
+Broadcast @victim 7s "You are infected by a zombie - use a medkit or SCP-500 to not turn into a zombie!"

Example Scripts/zombie infection/zombieInfectionHandler.ser

@@ -0,0 +1,39 @@
+# this script handles infections done by zombie players
+# and turning infected players into other zombies
+
+!-- OnEvent RoundStarted
+
+forever
+    wait 1s
+    
+    over @all with @plr
+        wait 1ms
+
+        *dateOfDeath = GetPlayerData @plr date_of_death_by_infection
+
+        # invalid -> infection date not set -> not infected
+        if *dateOfDeath is invalid
+            continue
+        end
+
+        # if the current date is "lower" than the date of death
+        # it means that the player is not fully infected
+        if {Date.Current} < *dateOfDeath
+            continue
+        end
+
+        # now, we initiate the changing into a zombie
+
+        # 1) clear the infection status
+        ClearPlayerData @plr date_of_death_by_infection
+
+        # 2) drop inventory so the items dont get lost
+        ClearInventory @plr drop
+
+        # 3) change player to zombie
+        SetRole @plr Scp0492
+    end
+end
+
+
+

llms-full.md

@@ -127,7 +127,7 @@ Always validate references before using them:
 ```
 *room = @plr -> roomRef
 
-if {*room -> isInvalid}
+if *room is invalid
     Print "Player is not in a room"
     stop
 end
@@ -216,22 +216,13 @@ run Func
 Print $x  # does NOT print 1, as $x was specific to `Func`
 ```
 
-Preferred way:
+Using `with` in loops and functions:
 ```
 over @all with @plr
     # @plr only exists here
 end
 ```
 
-Another valid way: (carried over from previous versions)
-```
-over @all 
-    with @plr
-
-    # @plr only exists here
-end
-```
-
 ### Important: Always Verify Global Variables Exist
 
 Never assume a global variable exists. Always check first:
@@ -261,7 +252,7 @@ Negative values don't require parentheses in methods:
 $num = -21
 TPPosition @fighter -37 313 -140
 ```
-This is because the whitespace seperates these values into different arguments.
+This is because the whitespace separates these values into different arguments.
 
 ### Percent Sign
 
@@ -350,9 +341,9 @@ You can use natural language or symbols:
 - `<` - less than
 - `and` / `&&` - logical AND
 - `or` / `||` - logical OR
-- `not` / `!` - ILLEGAL, DO NOT USE
-> `!` is illegal because SER relies heavily on spaces, providing `!$var` would break the compiler
-> `not` is illegal because it could confuse `x isnt y` with `x is not y`
+- `not` / `!` - ILLEGAL
+> `!` is illegal because heavy relience on spaces
+> `not` is illegal because could confuse `x isnt y` with `x is not y`
 
 ### Using Properties in Conditions
 
@@ -636,14 +627,6 @@ end
 `OnEvent` flags add variables associated with a given event. (done by reflecting on C#)
 But event variables might not always be provided by the C# event:
 
-```
-!-- OnEvent Dying
-
-if {VarExists @evAttacker} is false
-    stop
-end
-```
-or define which are required:
 ```
 !-- OnEvent Dying
 -- require @evAttacker
@@ -762,7 +745,7 @@ SER includes several advanced systems you should explore:
 - **Use:** Welcome messages, initial setup, tutorial hints
 - **Variables:** `@evPlayer` (joining player)
 
-**5. ChangedRole** - `!-- OnEvent ChangedRole` - Triggers when role changes
+**5. ChangedRole** - `!-- OnEvent ChangedRole` - Triggers when player's role changes
 - **Use:** Role-specific setups, class transitions, spawn effects
 - **Variables:** `@evPlayer`, `$evOldRole`, `$evNewRole`