setAccountSerial

Author: FileEX

functions/Account/examples/setAccountSerial-1.lua

@@ -0,0 +1,35 @@
+-- Advanced example: Administrative command system
+local function changePlayerSerial(player, newSerial)
+    local account = getPlayerAccount(player)
+    if (account and not isGuestAccount(account)) then
+        if (setAccountSerial(account, newSerial)) then
+            outputChatBox("Serial number updated successfully!", player, 0, 255, 0)
+            return true
+        else
+            outputChatBox("Failed to update serial number. Invalid format!", player, 255, 0, 0)
+            return false
+        end
+    else
+        outputChatBox("You must be logged into a registered account.", player, 255, 0, 0)
+        return false
+    end
+end
+
+-- Command to set a player's account serial
+addCommandHandler("setserial", function(player, cmd, targetPlayer, newSerial)
+    if (not targetPlayer or not newSerial) then
+        outputChatBox("Usage: /setserial <player> <32-char-hex-serial>", player)
+        return
+    end
+    
+    local target = getPlayerFromName(targetPlayer)
+    if (target) then
+        if (string.len(newSerial) == 32 and string.match(newSerial, "^[A-Fa-f0-9]+$")) then
+            changePlayerSerial(target, newSerial)
+        else
+            outputChatBox("Serial must be 32 hexadecimal characters!", player, 255, 0, 0)
+        end
+    else
+        outputChatBox("Player not found!", player, 255, 0, 0)
+    end
+end)

functions/Account/examples/setAccountSerial_OOP-1.lua

@@ -0,0 +1,35 @@
+-- Advanced example: Administrative command system
+local function changePlayerSerial(player, newSerial)
+    local account = player.account
+    if (account and not account.guest) then
+        if (account:setSerial(newSerial)) then
+            player:outputChat("Serial number updated successfully!", 0, 255, 0)
+            return true
+        else
+            player:outputChat("Failed to update serial number. Invalid format!", 255, 0, 0)
+            return false
+        end
+    else
+        player:outputChat("You must be logged into a registered account.", 255, 0, 0)
+        return false
+    end
+end
+
+-- Command to set a player's account serial
+addCommandHandler("setserial", function(player, cmd, targetPlayer, newSerial)
+    if (not targetPlayer or not newSerial) then
+        player:outputChat("Usage: /setserial <player> <32-char-hex-serial>")
+        return
+    end
+    
+    local target = Player(targetPlayer)
+    if (target) then
+        if (newSerial:len() == 32 and newSerial:match("^[A-Fa-f0-9]+$")) then
+            changePlayerSerial(target, newSerial)
+        else
+            player:outputChat("Serial must be 32 hexadecimal characters!", 255, 0, 0)
+        end
+    else
+        player:outputChat("Player not found!", 255, 0, 0)
+    end
+end)

functions/Account/setAccountSerial.yaml

@@ -0,0 +1,25 @@
+server:
+  name: setAccountSerial
+  version:
+    added: 1.6.0 r23232
+  description: This function sets the serial number for a specified player account. It allows administrators to update or assign a new [[serial]] to registered accounts.
+  oop:
+    element: account
+    method: setSerial
+    variable: serial
+  parameters:
+    - name: theAccount
+      type: account
+      description: The account element to set the serial for.
+    - name: serial
+      type: string
+      description: A valid 32-character hexadecimal string representing the new serial number.
+  returns:
+    values:
+      - type: bool
+        name: result
+    description: Returns true if the serial was successfully set, false otherwise.
+  examples:
+    - path: examples/setAccountSerial-1.lua
+    - path: examples/setAccountSerial_OOP-1.lua
+      oop: true

web/src/pages/reference/[func].astro

@@ -251,7 +251,7 @@ let funcSyntaxes = parseFunctionSyntaxes(func.id, func.data);
                     <>
                         <h5>Optional Arguments</h5>
                         <p><strong>NOTE</strong>: When using <a href="/reference/Optional_Arguments">optional arguments</a>, you might need to supply all arguments before the one you wish to use.</p>
-                        <ul style="margin-top: 0;">
+                        <ul>
                         {syntax.parameters
                             .filter((param: any) => param.default)
                             .map((param: any) => (