Update dev/feature branch nightly docs to SkriptLang/Skript@b0be357

docs/nightly/dev/feature/docs.json

@@ -1,5 +1,5 @@
 {
-  "skriptVersion": "2.9.5-nightly-f56a854",
+  "skriptVersion": "2.9.5-nightly-b0be357",
   "conditions": [
     {
       "id": "CondAlphanumeric",
@@ -7830,6 +7830,27 @@
         "%livingentities%'[s] [elapsed|:remaining] (item|tool) us[ag]e time"
       ]
     },
+    {
+      "id": "ExprEntitySnapshot",
+      "name": "Entity Snapshot",
+      "since": "INSERT VERSION",
+      "description": [
+        "Returns the entity snapshot of a provided entity, which includes all the data associated with it (name, health, attributes, etc.) at the time this expression is used.",
+        "Individual attributes of a snapshot cannot be modified or retrieved."
+      ],
+      "examples": [
+        "spawn a pig at location(0, 0, 0):",
+        "\tset the max health of entity to 20",
+        "\tset the health of entity to 20",
+        "\tset {_snapshot} to the entity snapshot of entity",
+        "\tclear entity",
+        "spawn {_snapshot} at location(0, 0, 0)"
+      ],
+      "patterns": [
+        "[the] entity snapshot of %entities/entitydatas%",
+        "%entities/entitydatas%'[s] entity snapshot"
+      ]
+    },
     {
       "id": "ExprEntityTamer",
       "name": "Entity Owner",
@@ -9491,6 +9512,34 @@
         "%worlds%'[s] spawn[s] [(point|location)[s]]"
       ]
     },
+    {
+      "id": "ExprSpawnEggEntity",
+      "name": "Spawn Egg Entity",
+      "since": "INSERT VERSION",
+      "description": [
+        "Gets or sets the entity snapshot that the provided spawn eggs will spawn when used."
+      ],
+      "examples": [
+        "set {_item} to a zombie spawn egg",
+        "broadcast the spawn egg entity of {_item}",
+        "",
+        "spawn a pig at location(0,0,0):",
+        "\tset the max health of entity to 20",
+        "\tset the health of entity to 20",
+        "\tset {_snapshot} to the entity snapshot of entity",
+        "\tclear entity",
+        "set the spawn egg entity of {_item} to {_snapshot}",
+        "if the spawn egg entity of {_item} is {_snapshot}: # Minecraft 1.20.5+",
+        "",
+        "set the spawn egg entity of {_item} to (random element out of all entities)",
+        "",
+        "set the spawn egg entity of {_item} to a zombie"
+      ],
+      "patterns": [
+        "[the] spawn egg entity of %itemstacks/itemtypes/slots%",
+        "%itemstacks/itemtypes/slots%'[s] spawn egg entity"
+      ]
+    },
     {
       "id": "ExprSpawnerType",
       "name": "Spawner Type",
@@ -13941,6 +13990,16 @@
         "plugin, pickup orb, orb pickup"
       ]
     },
+    {
+      "id": "entitysnapshot",
+      "name": "Entity Snapshot",
+      "since": "INSERT VERSION",
+      "description": [
+        "Represents a snapshot of an entity's data.",
+        "This includes all of the data associated with an entity (its name, health, attributes, etc.), at the time this expression is used. Essentially, these are a way to create templates for entities.",
+        "Individual attributes of a snapshot cannot be modified or retrieved."
+      ]
+    },
     {
       "id": "display",
       "name": "Display Entity",
@@ -14444,15 +14503,17 @@
     {
       "id": "EffSecSpawn",
       "name": "Spawn",
-      "since": "1.0, 2.6.1 (with section), 2.8.6 (dropped items)",
+      "since": "1.0, 2.6.1 (with section), 2.8.6 (dropped items), INSERT VERSION (entity snapshots)",
       "description": [
         "Spawns entities. This can be used as an effect and as a section.",
         "",
         "If it is used as a section, the section is run before the entity is added to the world.",
         "You can modify the entity in this section, using for example 'event-entity' or 'cow'. ",
         "Do note that other event values, such as 'player', won't work in this section.",
         "",
-        "If you're spawning a display and want it to be empty on initialization, like not having a block display be stone, set hidden config node 'spawn empty displays' to true."
+        "If you're spawning a display and want it to be empty on initialization, like not having a block display be stone, set hidden config node 'spawn empty displays' to true.",
+        "",
+        "Note that when spawning an entity via entity snapshots, the code within the section will not run instantaneously as compared to spawning normally (via 'a zombie')."
       ],
       "examples": [
         "spawn 3 creepers at the targeted block",
@@ -14464,8 +14525,8 @@
         "\tset billboard of event-display to center # allows the display to rotate around the center axis"
       ],
       "patterns": [
-        "(spawn|summon) %entitytypes% [%directions% %locations%]",
-        "(spawn|summon) %number% of %entitytypes% [%directions% %locations%]"
+        "(spawn|summon) %entitytypes/entitysnapshots% [%directions% %locations%]",
+        "(spawn|summon) %number% of %entitytypes/entitysnapshots% [%directions% %locations%]"
       ]
     },
     {

docs/nightly/dev/feature/index.html

@@ -1,4 +1,4 @@
-<!doctype html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=0.8, maximum-scale=1.0"> <meta name="description" content="Skript is a Bukkit plugin which allows server admins to customize their server easily, but without the hassle of programming a plugin or asking/paying someone to program a plugin for them. - SkriptLang/Skript"> <link rel="icon" type="image/png" href="./assets/icon.png"> <meta property="og:type" content="website"> <meta property="og:title" content="Skript Documentation"> <meta property="og:site_name" content="Skript Documentation"> <meta property="og:description" content="Skript is a Bukkit plugin which allows server admins to customize their server easily, but without the hassle of programming a plugin or asking/paying someone to program a plugin for them."> <meta property="og:image" content="https://docs.skriptlang.org/assets/icon.png"> <meta property="og:url" content="https://docs.skriptlang.org/"> <meta name="theme-color" content="#ff9800"> <title>Skript Documentation - 2.9.5-nightly-f56a854</title> <link href="css/styles.css" rel="stylesheet"> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js" defer></script> <script src="./js/functions.js"></script> <script src="./js/main.js" defer></script> <link rel="preconnect" href="https://fonts.gstatic.com"> <link href="https://fonts.googleapis.com/css2?family=Source+Code+Pro:ital,wght@0,200;0,300;0,400;0,500;0,600;0,700;0,900;1,200;1,300;1,400;1,500;1,600;1,700;1,900&display=swap" rel="stylesheet"> <link rel="preconnect" href="https://fonts.gstatic.com"> <link href="https://fonts.googleapis.com/css2?family=Poppins:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap" rel="stylesheet"> <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.15.4/css/all.css" integrity="sha384-DyZ88mC6Up2uqS4h/KRgHuoeGwBcD4Ng9SiP4dIRy0EXTlnuz47vAwmeGwVChigm" crossorigin="anonymous"> </head> <body> <div id="docs-body"> <!-- loaded inside body without defer to fix theme flicker --> <script src="./js/theme-switcher.js"></script> <ul id="global-navigation"> <li><a href="index.html">Home</a></li> <div class="menu-tab"> <li><a class="menu-tab-item" href="docs.html">Docs <i class="fas fa-caret-down"></i></a></li> <div class="menu-subtabs"> <a href="events.html">Events</a> <a href="conditions.html">Conditions</a> <a href="sections.html">Sections</a> <a href="effects.html">Effects</a> <a href="expressions.html">Expressions</a> <a href="classes.html">Types</a> <a href="structures.html">Structures</a> <a href="functions.html">Functions</a> </div> </div> <li><a href="docs.html?isNew" class="new-tab">New</a></li> <div class="menu-tab"> <li><a class="menu-tab-item" href="tutorials.html">Tutorials <i class="fas fa-caret-down"></i></a></li> <div class="menu-subtabs"> <a href="text.html">Text</a> </div> </div> <div class="menu-tab"> <li><a class="menu-tab-item" href="#">Dev Tools <i class="fas fa-caret-down"></i></a></li> <div class="menu-subtabs"> <a href="javadocs/" target="_blank">Javadocs</a> </div> </div> <li><a href="https://github.com/SkriptLang/Skript/" target="_blank" style="font-weight: bold;">GitHub</a></li> <li style="margin-left: auto;"><a style="font-weight: bold; color: #ff9800" href="https://github.com/SkriptLang/Skript/releases/tag/2.9.5-nightly-f56a854" target="_blank">v2.9.5-nightly-f56a854</a></li> </ul> <nav id="side-nav"> <div id="nav-contents"> </div> </nav> <h1 id="nav-title">Documentation</h1> <div id="content-no-docs" class="no-left-panel" style="display: inline-block;"> <div style="height: 32px;"></div> <!-- Space --> <p> <span style="font-size: 60px; font-weight: bold;">Skript</span> is (surprise, surprise) a scripting plugin for the Bukkit platform. It is easy to use for simple tasks, but you can also create really complex things with it. The syntax of Skript is close to English, but it is still not magic. While you might succeed with experimentation for simple tasks, for anything more complex you will need some guidance. </p> <p> This is Skript's documentation. You will find all supported features of the plugin here, along with some useful examples. We don't have tutorials yet, but you can find good ones using whatever search engine you prefer. </p> <p class="box-title">Quick Look</p> <pre class="box code" style="height: 460px; overflow: auto;"><code class="bash"> command /sethome:
+<!doctype html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=0.8, maximum-scale=1.0"> <meta name="description" content="Skript is a Bukkit plugin which allows server admins to customize their server easily, but without the hassle of programming a plugin or asking/paying someone to program a plugin for them. - SkriptLang/Skript"> <link rel="icon" type="image/png" href="./assets/icon.png"> <meta property="og:type" content="website"> <meta property="og:title" content="Skript Documentation"> <meta property="og:site_name" content="Skript Documentation"> <meta property="og:description" content="Skript is a Bukkit plugin which allows server admins to customize their server easily, but without the hassle of programming a plugin or asking/paying someone to program a plugin for them."> <meta property="og:image" content="https://docs.skriptlang.org/assets/icon.png"> <meta property="og:url" content="https://docs.skriptlang.org/"> <meta name="theme-color" content="#ff9800"> <title>Skript Documentation - 2.9.5-nightly-b0be357</title> <link href="css/styles.css" rel="stylesheet"> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js" defer></script> <script src="./js/functions.js"></script> <script src="./js/main.js" defer></script> <link rel="preconnect" href="https://fonts.gstatic.com"> <link href="https://fonts.googleapis.com/css2?family=Source+Code+Pro:ital,wght@0,200;0,300;0,400;0,500;0,600;0,700;0,900;1,200;1,300;1,400;1,500;1,600;1,700;1,900&display=swap" rel="stylesheet"> <link rel="preconnect" href="https://fonts.gstatic.com"> <link href="https://fonts.googleapis.com/css2?family=Poppins:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,100;1,200;1,300;1,400;1,500;1,600;1,700;1,800;1,900&display=swap" rel="stylesheet"> <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.15.4/css/all.css" integrity="sha384-DyZ88mC6Up2uqS4h/KRgHuoeGwBcD4Ng9SiP4dIRy0EXTlnuz47vAwmeGwVChigm" crossorigin="anonymous"> </head> <body> <div id="docs-body"> <!-- loaded inside body without defer to fix theme flicker --> <script src="./js/theme-switcher.js"></script> <ul id="global-navigation"> <li><a href="index.html">Home</a></li> <div class="menu-tab"> <li><a class="menu-tab-item" href="docs.html">Docs <i class="fas fa-caret-down"></i></a></li> <div class="menu-subtabs"> <a href="events.html">Events</a> <a href="conditions.html">Conditions</a> <a href="sections.html">Sections</a> <a href="effects.html">Effects</a> <a href="expressions.html">Expressions</a> <a href="classes.html">Types</a> <a href="structures.html">Structures</a> <a href="functions.html">Functions</a> </div> </div> <li><a href="docs.html?isNew" class="new-tab">New</a></li> <div class="menu-tab"> <li><a class="menu-tab-item" href="tutorials.html">Tutorials <i class="fas fa-caret-down"></i></a></li> <div class="menu-subtabs"> <a href="text.html">Text</a> </div> </div> <div class="menu-tab"> <li><a class="menu-tab-item" href="#">Dev Tools <i class="fas fa-caret-down"></i></a></li> <div class="menu-subtabs"> <a href="javadocs/" target="_blank">Javadocs</a> </div> </div> <li><a href="https://github.com/SkriptLang/Skript/" target="_blank" style="font-weight: bold;">GitHub</a></li> <li style="margin-left: auto;"><a style="font-weight: bold; color: #ff9800" href="https://github.com/SkriptLang/Skript/releases/tag/2.9.5-nightly-b0be357" target="_blank">v2.9.5-nightly-b0be357</a></li> </ul> <nav id="side-nav"> <div id="nav-contents"> </div> </nav> <h1 id="nav-title">Documentation</h1> <div id="content-no-docs" class="no-left-panel" style="display: inline-block;"> <div style="height: 32px;"></div> <!-- Space --> <p> <span style="font-size: 60px; font-weight: bold;">Skript</span> is (surprise, surprise) a scripting plugin for the Bukkit platform. It is easy to use for simple tasks, but you can also create really complex things with it. The syntax of Skript is close to English, but it is still not magic. While you might succeed with experimentation for simple tasks, for anything more complex you will need some guidance. </p> <p> This is Skript's documentation. You will find all supported features of the plugin here, along with some useful examples. We don't have tutorials yet, but you can find good ones using whatever search engine you prefer. </p> <p class="box-title">Quick Look</p> <pre class="box code" style="height: 460px; overflow: auto;"><code class="bash"> command /sethome:
  &nbsp;&nbsp;&nbsp;&nbsp;permission: skript.home # Permission required for this command
  &nbsp;&nbsp;&nbsp;&nbsp;description: Set your home # Description of this command
  &nbsp;&nbsp;&nbsp;&nbsp;executable by: players # Console won't be able to run this command