From 45591cbe7bef4c54c241a286ece07bc4ade4489e Mon Sep 17 00:00:00 2001
From: Tiger Wang <ziwei.tiger@outlook.com>
Date: Mon, 15 Mar 2021 02:28:18 +0000
Subject: Properly deprecate more XYZ parameter'd functions (#5147)

* Fixes #5144
---
 Server/Plugins/APIDump/Classes/World.lua | 76 +++++---------------------------
 1 file changed, 12 insertions(+), 64 deletions(-)

(limited to 'Server/Plugins/APIDump/Classes')

diff --git a/Server/Plugins/APIDump/Classes/World.lua b/Server/Plugins/APIDump/Classes/World.lua
index 8792e7651..149c70423 100644
--- a/Server/Plugins/APIDump/Classes/World.lua
+++ b/Server/Plugins/APIDump/Classes/World.lua
@@ -1198,7 +1198,7 @@ function OnAllChunksAvailable()</pre> All return values from the callbacks are i
 							Type = "number",
 						},
 					},
-					Notes = "Sets the block at the specified coords, without waking up the simulators or replacing the block entities for the previous block type. Do not use if the block being replaced has a block entity tied to it!",
+					Notes = "Sets the block at the specified coords, without waking up the simulators or replacing the block entities for the previous block type. Do not use if the block being replaced has a block entity tied to it! <b>OBSOLETE</b>, use the vector-based overload instead.",
 				},
 				{
 					Params =
@@ -1499,7 +1499,7 @@ function OnAllChunksAvailable()</pre> All return values from the callbacks are i
 							Type = "number",
 						},
 					},
-					Notes = "Returns the block type of the block at the specified coords, or 0 if the appropriate chunk is not loaded.",
+					Notes = "Returns the block type of the block at the specified coords, or 0 if the appropriate chunk is not loaded. <b>OBSOLETE</b>, use the vector-based overload instead.",
 				},
 				{
 					Params =
@@ -1543,7 +1543,7 @@ function OnAllChunksAvailable()</pre> All return values from the callbacks are i
 							Type = "number",
 						},
 					},
-					Notes = "Returns the amount of block light at the specified coords, or 0 if the appropriate chunk is not loaded.",
+					Notes = "Returns the amount of block light at the specified coords, or 0 if the appropriate chunk is not loaded. <b>OBSOLETE</b>, use the vector-based overload instead.",
 				},
 				{
 					Params =
@@ -1628,7 +1628,7 @@ function OnAllChunksAvailable()</pre> All return values from the callbacks are i
 							Type = "number",
 						},
 					},
-					Notes = "Returns the block metadata of the block at the specified coords, or 0 if the appropriate chunk is not loaded.",
+					Notes = "Returns the block metadata of the block at the specified coords, or 0 if the appropriate chunk is not loaded. <b>OBSOLETE</b>, use the vector-based overload instead.",
 				},
 				{
 					Params =
@@ -3743,77 +3743,25 @@ function OnAllChunksAvailable()</pre> All return values from the callbacks are i
 			},
 			WakeUpSimulators =
 			{
+				Params =
 				{
-					Params =
-					{
-						{
-							Name = "Block",
-							Type = "Vector3i",
-						},
-					},
-					Notes = "Wakes up the simulators for the specified block.",
-				},
-				{
-					Params =
 					{
-						{
-							Name = "BlockX",
-							Type = "number",
-						},
-						{
-							Name = "BlockY",
-							Type = "number",
-						},
-						{
-							Name = "BlockZ",
-							Type = "number",
-						},
+						Name = "Block",
+						Type = "Vector3i",
 					},
-					Notes = "Wakes up the simulators for the specified block. (DEPRECATED, use vector-parametered version)",
 				},
+				Notes = "Wakes up the simulators for the specified block.",
 			},
 			WakeUpSimulatorsInArea =
 			{
+				Params =
 				{
-					Params =
-					{
-						{
-							Name = "Area",
-							Type = "cCuboid",
-						},
-					},
-					Notes = "Wakes up the simulators for all the blocks in the specified area (edges inclusive).",
-				},
-				{
-					Params =
 					{
-						{
-							Name = "MinBlockX",
-							Type = "number",
-						},
-						{
-							Name = "MaxBlockX",
-							Type = "number",
-						},
-						{
-							Name = "MinBlockY",
-							Type = "number",
-						},
-						{
-							Name = "MaxBlockY",
-							Type = "number",
-						},
-						{
-							Name = "MinBlockZ",
-							Type = "number",
-						},
-						{
-							Name = "MaxBlockZ",
-							Type = "number",
-						},
+						Name = "Area",
+						Type = "cCuboid",
 					},
-					Notes = "Wakes up the simulators for all the blocks in the specified area (edges inclusive). (DEPRECATED, use vector-parametered version)",
 				},
+				Notes = "Wakes up the simulators for all the blocks in the specified area (edges inclusive).",
 			},
 		},
 		AdditionalInfo =
-- 
cgit v1.2.3