Merge branch 'main' of https://github.com/multitheftauto/wiki.multitheftauto.com

Author: FileEX

functions/Vehicle/createVehicle.yaml

@@ -72,5 +72,12 @@ shared: &shared
 server:
   <<: *shared
 
+  examples:
+    - path: 'examples/createVehicle-oop-1.lua'
+      description: |
+        Creates a vehicle using the OOP syntax. This example creates a vehicle at the specified position and with the specified rotation.
+      oop: true
+      title: 'Create Vehicle using Constructor Class'
+
 client:
   <<: *shared

functions/Vehicle/examples/createVehicle-oop-1.lua

@@ -0,0 +1,13 @@
+function makeVehicle(model, x, y, z, rx, ry, rz)
+    assert(type(model)=="number", "Model must be a number")
+    assert(type(x)=="number", "X coordinate must be a number")
+    assert(type(y)=="number", "Y coordinate must be a number")
+    assert(type(z)=="number", "Z coordinate must be a number")
+    if not rx then rx = 0 end
+    if not ry then ry = 0 end
+    if not rz then rz = 0 end
+    assert(type(rx)=="number", "Rotation X must be a number")
+    assert(type(ry)=="number", "Rotation Y must be a number")
+    assert(type(rz)=="number", "Rotation Z must be a number")
+    return Vehicle(model, x, y, z, rx, ry, rz)
+end

schemas/common-defs.yaml

@@ -118,6 +118,10 @@ $defs:
           type: boolean
           default: false
           description: If set to true, this example will be appended to the previous example.
+        oop:
+          type: boolean
+          default: false
+          description: If set to true, this example will be marked as an OOP example.
         title:
           type: string
           description: Optional title displayed in the frame around the example.

web/src/components/CodeExamplesSection.astro

@@ -8,6 +8,7 @@ export interface CodeExample {
   luaCode: string;
   side: string;
   title?: string;
+  oop?: boolean;
 }
 
 export interface Props {
@@ -56,6 +57,11 @@ if (codeExamples.length === 0 && !examplesRequired) {
         >
           <div class={`tab-header side-${example.side} active`}>
             <strong>{example.side}</strong> {example.title && ` - ${example.title}`}
+            {example.oop && (
+              <div class="oop-indicator">
+                <a href="/OOP_Introduction">OOP</a> Required
+              </div>
+            )}
           </div>
           <div class="tab-body">
             {example.description && <EnhancedMarkdown content={example.description} />}
@@ -70,6 +76,15 @@ if (codeExamples.length === 0 && !examplesRequired) {
 </div>
 
 <style>
+.oop-indicator {
+  display: inline-block;
+  padding: 0.2rem 0.5rem;
+  background-color: var(--sl-color-accent-low);
+  border-radius: 0.5rem;
+  font-size: 0.8rem;
+  margin-left: 0.2rem;
+}
+
 .tab-buttons {
   display: flex;
   gap: 1rem;