From de18c6ff00a7654973f6b30387f7a58ae1370e94 Mon Sep 17 00:00:00 2001
From: Nico <122193236+Nico8340@users.noreply.github.com>
Date: Fri, 24 May 2024 01:58:11 +0200
Subject: [PATCH] Add resource 'dialogs' to replace old 'msgbox' resource
 (#467)

---
 [editor]/editor_gui/client/buttonclicked.lua  |  17 +-
 [editor]/editor_gui/client/interface.lua      |   2 +-
 [editor]/editor_gui/client/load.lua           |   9 +-
 [editor]/editor_gui/client/locations.lua      |  10 +-
 .../editor_gui/client/mapsettings_gui.lua     |  12 +-
 [editor]/editor_gui/client/me_gui.lua         |   6 -
 [editor]/editor_gui/client/save.lua           |  31 +-
 [editor]/editor_gui/meta.xml                  |   8 +-
 .../client/saveloadtest_client.lua            |   8 +-
 [editor]/msgbox/script.lua                    |   6 +
 [gameplay]/dialogs/files/error.png            | Bin 0 -> 2165 bytes
 [gameplay]/dialogs/files/info.png             | Bin 0 -> 2225 bytes
 [gameplay]/dialogs/files/question.png         | Bin 0 -> 2221 bytes
 [gameplay]/dialogs/files/warning.png          | Bin 0 -> 1884 bytes
 [gameplay]/dialogs/meta.xml                   |  16 +
 [gameplay]/dialogs/readme.md                  | 230 +++++++++++++
 [gameplay]/dialogs/sourceC.lua                | 310 ++++++++++++++++++
 [gameplay]/dialogs/sourceG.lua                |  77 +++++
 [gameplay]/webbrowser/WebBrowserGUI.lua       |   2 +-
 [gameplay]/webbrowser/meta.xml                |   2 +-
 20 files changed, 688 insertions(+), 58 deletions(-)
 create mode 100644 [gameplay]/dialogs/files/error.png
 create mode 100644 [gameplay]/dialogs/files/info.png
 create mode 100644 [gameplay]/dialogs/files/question.png
 create mode 100644 [gameplay]/dialogs/files/warning.png
 create mode 100644 [gameplay]/dialogs/meta.xml
 create mode 100644 [gameplay]/dialogs/readme.md
 create mode 100644 [gameplay]/dialogs/sourceC.lua
 create mode 100644 [gameplay]/dialogs/sourceG.lua

diff --git a/[editor]/editor_gui/client/buttonclicked.lua b/[editor]/editor_gui/client/buttonclicked.lua
index 5a6d6e81c..c6880752d 100644
--- a/[editor]/editor_gui/client/buttonclicked.lua
+++ b/[editor]/editor_gui/client/buttonclicked.lua
@@ -55,18 +55,19 @@ function elementIcons_Clicked ( source, mouseButton )
 	end
 end
 
+function newCallback(callbackResult)
+	if callbackResult == "YES" then
+		editor_main.newResource()
+	end
+
+	guiSetInputEnabled(false)
+end
+
 --These are individual functions for each topmenu button
 function topMenuClicked.new ()
 	editor_main.dropElement ()
 	guiSetInputEnabled(true)
-	local yes,no = guiShowMessageBox ( "Are you sure you want to create a new map?\nAny unsaved data will be lost.", "info", "New", true, "Yes", "No" )
-	addEventHandler ( "onClientGUIClick",yes,function()
-		editor_main.newResource()
-		guiSetInputEnabled(false)
-	end,false )
-	addEventHandler ( "onClientGUIClick",no,function()
-		guiSetInputEnabled(false)
-	end,false )
+	exports.dialogs:messageBox("New", "Are you sure you want to create a new map? Any unsaved data will be lost.", "newCallback", "QUESTION", "YESNO")
 end
 
 function topMenuClicked.open ()
diff --git a/[editor]/editor_gui/client/interface.lua b/[editor]/editor_gui/client/interface.lua
index f7eee626d..ea459fbe0 100644
--- a/[editor]/editor_gui/client/interface.lua
+++ b/[editor]/editor_gui/client/interface.lua
@@ -7,7 +7,7 @@ local interface = {
 	move_cursor = NOT_REQUIRED,
 	move_freecam = NOT_REQUIRED,
 	move_keyboard = NOT_REQUIRED,
-	msgbox = NOT_REQUIRED,
+	dialogs = NOT_REQUIRED,
 	tooltip = NOT_REQUIRED,
 	freeroam = NOT_REQUIRED,
 }
diff --git a/[editor]/editor_gui/client/load.lua b/[editor]/editor_gui/client/load.lua
index 5898a29fd..f5756e2ac 100644
--- a/[editor]/editor_gui/client/load.lua
+++ b/[editor]/editor_gui/client/load.lua
@@ -34,12 +34,13 @@ function openMap()
 	local row = guiGridListGetSelectedItem ( loadDialog.mapsList )
 	if row == -1 then return end
 	mapName = guiGridListGetItemText ( loadDialog.mapsList, row, 1 )
-	open = guiShowMessageBox ( "Are you sure you want to load map \""..mapName.."\"?\nAny unsaved changes will be lost.", "info", "Are you sure?", true, "Open", "Cancel" )
-	addEventHandler ( "onClientGUIClick", open, openButton, false )
+	exports.dialogs:messageBox("Are you sure?", "Are you sure you want to load map \""..mapName.."\"?\nAny unsaved changes will be lost.", "openCallback", "QUESTION", "YESNO")
 end
 
-function openButton ()
-	editor_main.openResource ( mapName )
+function openCallback(callbackResult)
+	if callbackResult == "YES" then
+		editor_main.openResource ( mapName )
+	end
 end
 
 addEvent ( "openShowDialog",true )
diff --git a/[editor]/editor_gui/client/locations.lua b/[editor]/editor_gui/client/locations.lua
index 4061b407d..ac085aa8e 100644
--- a/[editor]/editor_gui/client/locations.lua
+++ b/[editor]/editor_gui/client/locations.lua
@@ -102,11 +102,11 @@ function addBookmark ()
 	local z = locations.z:getValue()
 	local world = locations.world:getValue()
 	if name == "" then
-		guiShowMessageBox ( 'No location name was specified!', "error", "Bad value", true )
+		exports.dialogs:messageBox("Bad value", "No location name was specified!", false, "ERROR", "OK")
 		return
 	end
 	if bookmarksTable[name] then
-		guiShowMessageBox ( 'A location of name "'..name..'" already exists!', "error", "Conflict", true )
+		exports.dialogs:messageBox("Bad value", "A location of name \"" .. name .."\" already exists!", false, "ERROR", "OK")
 		return
 	end
 	bookmarksTable[name] = {}
@@ -192,15 +192,15 @@ end
 
 function setLocation ( x,y,z,world )
 	if not x then
-		local button = guiShowMessageBox ( "Invalid \"x position\" specified", "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid \"x position\" specified", false, "ERROR", "OK")
 		return
 	end
 	if not y then
-		local button = guiShowMessageBox ( "Invalid \"y position\" specified", "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid \"y position\" specified", false, "ERROR", "OK")
 		return
 	end
 	if not z then
-		local button = guiShowMessageBox ( "Invalid \"z position\" specified", "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid \"z position\" specified", false, "ERROR", "OK")
 		return
 	end
 	if not world then
diff --git a/[editor]/editor_gui/client/mapsettings_gui.lua b/[editor]/editor_gui/client/mapsettings_gui.lua
index 8d520e1a9..f25aba5e7 100644
--- a/[editor]/editor_gui/client/mapsettings_gui.lua
+++ b/[editor]/editor_gui/client/mapsettings_gui.lua
@@ -170,29 +170,29 @@ end
 function confirmMapSettings ()
 	local versionText = mapsettings.metaVersion:getValue()
 	if not versionText or not (( string.match (versionText, "^%d+$") ) or ( string.match (versionText, "^%d+%.%d+$") ) or ( string.match (versionText, "^%d+%.%d+%.%d+$") )) then
-		guiShowMessageBox ( "Invalid META \"Version\" specified", "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid META \"Version\" specified", false, "ERROR", "OK")
 		return
 	end
 	if not mapsettings.timeHour:getValue() or not mapsettings.timeMinute:getValue()
 		or mapsettings.timeHour:getValue() > 23 or mapsettings.timeMinute:getValue() > 59 then
-		guiShowMessageBox ( "Invalid Time specified", "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid time specified", false, "ERROR", "OK")
 		return
 	end
 
 	-- if mapsettings.metaAuthor:getValue() == "" then
-		-- guiShowMessageBox ( "Invalid META \"Author\" specified", "error", "Bad Value", true )
+		-- exports.dialogs:messageBox("Bad value", "Invalid META \"Author\" specified", false, "ERROR", "OK")
 		-- return
 	-- end
 	if not tonumber(mapsettings.maxplayers:getValue()) then
-		guiShowMessageBox ( 'Invalid "Maximum Players" specified', "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid \"Maximum Players\" specified", false, "ERROR", "OK")
 		return
 	end
 	if not tonumber(mapsettings.minplayers:getValue()) then
-		guiShowMessageBox ( 'Invalid "Minimum Players" specified', "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid \"Maximum Players\" specified", false, "ERROR", "OK")
 		return
 	end
 	if mapsettings.minplayers:getValue() >=  mapsettings.maxplayers:getValue() then
-		guiShowMessageBox ( 'Invalid "Minimum Players" specified', "error", "Bad Value", true )
+		exports.dialogs:messageBox("Bad value", "Invalid \"Maximum Players\" specified", false, "ERROR", "OK")
 		return
 	end
 	if not tonumber(mapsettings.gamespeed:getValue()) then
diff --git a/[editor]/editor_gui/client/me_gui.lua b/[editor]/editor_gui/client/me_gui.lua
index e7477c8f3..92626c09e 100644
--- a/[editor]/editor_gui/client/me_gui.lua
+++ b/[editor]/editor_gui/client/me_gui.lua
@@ -370,12 +370,6 @@ function playSoundFrontEnd ( sound )
 	return returnValue
 end
 
-function guiShowMessageBox ( message, boxType, title, forced, button1, button2, button3 )
-	playSoundFrontEnd ( 5 )
-	local a1,a2,a3 = msgbox.guiShowMessageBox ( message, boxType, title, forced, button1, button2, button3 )
-	return a1,a2,a3
-end
-
 function clearNonCreatableElements(elementTable)
 	for elementName,data in pairs(elementTable) do
 		if not data.createable then
diff --git a/[editor]/editor_gui/client/save.lua b/[editor]/editor_gui/client/save.lua
index b82508a9d..8fb6a2d62 100644
--- a/[editor]/editor_gui/client/save.lua
+++ b/[editor]/editor_gui/client/save.lua
@@ -54,33 +54,24 @@ function saveMap()
 	mapName = guiGetText ( saveDialog.mapName )
 	if mapName == "" then return end
 	if mapsInfo[string.lower(mapName)] then
-		local save,cancel = guiShowMessageBox ( "Are you sure you want to overwrite map \""..mapName.."\"?\n" ..
-		                                        "This will cause original map data to be lost.",
-						        "info", "Are you sure?", true, "Save", "Cancel" )
-		addEventHandler ( "onClientGUIClick", save,   saveButton,   false )
-		addEventHandler ( "onClientGUIClick", cancel, restoreSaveDialog, false )
+		exports.dialogs:messageBox("Are you sure?", "Are you sure you want to overwrite map \""..mapName.."\"? This will cause original map data to be lost.", "saveCallback", "QUESTION", "YESNO")
 		guiSetProperty(saveDialog.window, "Disabled", "True")
 	elseif resourcesInfo[string.lower(mapName)] then
-		guiShowMessageBox ( "Unable to save to \""..mapName.."\".  \n" ..
-		                    "You cannot overwrite non-map resources.",
-				    "error", "Cannot save", true )
+		exports.dialogs:messageBox("Cannot save", "Unable to save to \""..mapName.."\" You cannot overwrite non-map resources.", false, "ERROR", "OK")
 	else
-		local save,cancel = guiShowMessageBox ( "Are you sure you want to save to \""..mapName.."\"?",
-		                                        "info", "Are you sure?", true, "Save", "Cancel" )
-		addEventHandler ( "onClientGUIClick", save,   saveButton,   false )
-		addEventHandler ( "onClientGUIClick", cancel, restoreSaveDialog, false )
+		exports.dialogs:messageBox("Are you sure?", "Are you sure you want to save to \""..mapName.."\"?", "saveCallback", "QUESTION", "YESNO")
 		guiSetProperty(saveDialog.window, "Disabled", "True")
 	end
 end
 
-function saveButton()
-	local resourceName = guiGetText ( saveDialog.mapName )
-	local directory = guiGetText ( saveDialog.directory )
-	editor_main.saveResource ( resourceName, directory )
-end
-
-function restoreSaveDialog()
-  guiSetProperty(saveDialog.window, "Disabled", "False")
+function saveCallback(callbackResult)
+	if callbackResult == "YES" then
+		local resourceName = guiGetText ( saveDialog.mapName )
+		local directory = guiGetText ( saveDialog.directory )
+		editor_main.saveResource ( resourceName, directory )
+	else
+		guiSetProperty(saveDialog.window, "Disabled", "False")
+	end
 end
 
 addEvent ( "saveAsShowDialog", true )
diff --git a/[editor]/editor_gui/meta.xml b/[editor]/editor_gui/meta.xml
index 1397a1888..3d9269496 100644
--- a/[editor]/editor_gui/meta.xml
+++ b/[editor]/editor_gui/meta.xml
@@ -2,7 +2,7 @@
 	<info author="Talidan, jbeta" description="Map editor GUI" version="1.0.0" />
 
 	<!-- Required resources -->
-	<include resource="msgbox" />
+	<include resource="dialogs" />
 	<include resource="tooltip" />
 
 	<!-- Client-side logic -->
@@ -53,12 +53,16 @@
 	<export function="closeSaveDialog" type="client" />
 	<export function="closeLoadDialog" type="client" />
 	<export function="guiGetMouseOverElement" type="client" />
-	<export function="guiShowMessageBox" type="client" />
 	<export function="openPropertiesBox" type="client" />
 	<export function="restoreSaveDialog" type="client" />
 	<export function="stopTest" type="client" />
 	<export function="restoreSelectedElement" type="client" />
 
+	<!-- MessageBox exports -->
+	<export function="newCallback" type="client" />
+	<export function="openCallback" type="client" />
+	<export function="saveCallback" type="client" />
+
 	<!-- Browser -->
 	<script src="client/browser/browserList.lua" type="client" />
 	<script src="client/browser/browser.lua" type="client" />
diff --git a/[editor]/editor_main/client/saveloadtest_client.lua b/[editor]/editor_main/client/saveloadtest_client.lua
index 028c158da..88f043768 100644
--- a/[editor]/editor_main/client/saveloadtest_client.lua
+++ b/[editor]/editor_main/client/saveloadtest_client.lua
@@ -17,22 +17,22 @@ addEventHandler ( "saveloadtest_return", root,
 				end
 				editor_gui.closeLoadDialog()
 			else
-				editor_gui.guiShowMessageBox ( "Map resource could not be started!", "error", "Error", true )
+				exports.dialogs:messageBox("Error", "Map resource could not be started!", false, "ERROR", "OK")
 			end
 		elseif ( command ) == "save" then
 			if ( returnValue ) then
 				editor_gui.closeSaveDialog()
 			else
-				editor_gui.guiShowMessageBox ( "Map resource could not be saved! "..reason, "error", "Error", true )
+				exports.dialogs:messageBox("Error", "Map resource could not be saved! " .. reason, false, "ERROR", "OK")
 				editor_gui.restoreSaveDialog()
 			end
 		elseif ( command ) == "quickSave" then
 			reason = reason or "The target resource may be in .zip format or corrupted."
-			editor_gui.guiShowMessageBox ( "Map resource could not be saved! "..reason, "error", "Error", true )
+			exports.dialogs:messageBox("Error", "Map resource could not be saved! " .. reason, false, "ERROR", "OK")
 			editor_gui.restoreSaveDialog()
 		elseif ( command ) == "test" then
 			reason = reason or ""
-			editor_gui.guiShowMessageBox ( "Test could not be started! "..reason, "error", "Error", true )
+			exports.dialogs:messageBox("Error", "Test resource could not be started! " .. reason, false, "ERROR", "OK")
 			editor_gui.stopTest()
 		elseif ( command == "close" ) then
 			editor_gui.closeSaveDialog()
diff --git a/[editor]/msgbox/script.lua b/[editor]/msgbox/script.lua
index 72f364870..17c15da53 100644
--- a/[editor]/msgbox/script.lua
+++ b/[editor]/msgbox/script.lua
@@ -1,4 +1,7 @@
 --[[-----------DOCUMENTATION---------------
+WARNING:
+This resource is deprecated as the new 'dialogs' resource replaces it.
+
 SYNTAX:
 guibutton,guibutton,guibutton = guiShowMessageBox ( string message, string boxType, string title [, string button1, string button2, stringbutton3] )
 REQUIRED ARGUMENTS
@@ -111,6 +114,9 @@ function guiShowMessageBox ( message, boxType, title, forceShowing, button1, but
 	if ( forceShowing ) then
 		guiAttached[cover] = aMessage.Form
 	end
+
+	outputDebugString("This resource is deprecated as the new 'dialogs' resource replaces it.", 2)
+
 	return guiButton1, guiButton2, guiButton3
 end
 
diff --git a/[gameplay]/dialogs/files/error.png b/[gameplay]/dialogs/files/error.png
new file mode 100644
index 0000000000000000000000000000000000000000..18e83882412c746f20799d5e1e23c023e1213b22
GIT binary patch
literal 2165
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

literal 0
HcmV?d00001

diff --git a/[gameplay]/dialogs/files/info.png b/[gameplay]/dialogs/files/info.png
new file mode 100644
index 0000000000000000000000000000000000000000..6524cba600b113eb11927ac9ff7b9752d75b2ccf
GIT binary patch
literal 2225
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

literal 0
HcmV?d00001

diff --git a/[gameplay]/dialogs/files/question.png b/[gameplay]/dialogs/files/question.png
new file mode 100644
index 0000000000000000000000000000000000000000..85c6f44cba32fc0126b11e3a4a0ea44f6237d9df
GIT binary patch
literal 2221
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

literal 0
HcmV?d00001

diff --git a/[gameplay]/dialogs/files/warning.png b/[gameplay]/dialogs/files/warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..46aaa5384a0a2b4fc06a983d2cd1b60c61177993
GIT binary patch
literal 1884
zcmV-i2c!6jP)<h;3K|Lk000e1NJLTq001fg001fo0{{R3@*O#800093P)t-s&d$!%
z)YRkS<9~mDjEs!0udi2ES2{X6uCA^d8ym#L#3v^w(b3V;($Z&VXKih5h=_=AaBzl(
zhOn@()YR08iHW$lxWK@`fq{Xot*xM-pwQ6Je}8|)#l^0!t~E6^$H&J30RaI40RaI4
zS65fU!otwd(7(UGX=!Q3#>Tn1xu&M3dU|?;gM-4t!k?d?n3$MHM@JD65kNpdH8nL<
zR8)e3f(#4{85tQ&OiUOU7>kRG5fKpu1qA^C0RaI4i;If^0RaI40RR910002x<>S-S
z)7910($do6;^E=p;o#ul)YHAy)z!_-&En$W<mBSy<m1Q2wYskcyRZPdwOrED$K}~0
z$-`5@yIsY;Owq;?-`&Q&vj))1ZO_L~+R!uD)vE8~D%H<w#=u(6!xh-g5W%`T+|ew~
z$6V6SozBHJ)zX^E#eBD~D$Bz_%*cwux<|{v7|_qQ$i<Djv`Edu2+qy8(ZvQ76cl-O
zM@L3E%D^C~p*DklE|ZQmYiKKHWkBQFK|4A)vZ)THoeqC_B1uU{VqFZPoImX0FS4sM
zGcXLsy9;=756jBGz`l*o&cUyzBI(^C)zhcJy?fr&Dbmb&*Umz`wpGl_tJTg{;Na2U
z(;V8^xX8tv%fAJ`v=Yz8GPtf0>)<Ti(je#DF~GPh`Ry>*%MA+)3o$V<BqSs&D=Sh_
zMORile0Vk7(mFyyK*_)|(an##vNyi89oW~#!@X(o<tF9YDbB<s+|U-z!wulpGTG2N
zI5;;yKRr`ZQ&m+}MMXtTO-!DdLBh8I?BFKf-`wWf8dz9Z4-XAcP*C;hDGUq@>fRp6
zya4RrApP+$>)#*m<0IwS8B0q_^5!S*;vx3xD);Lv@#Q4g%nbDCC+XcC-qI4>&=B3x
z5!uZR*UJmm$_n}IEc@>+=i3|A$qCfR2++g?;?@<@#|P2H1=7X_;M5b#zX03M4(;vj
z&%*=c*cayJ=GfTS;NalR!2!;~0@Tyb%Dw>A(1*;x0L{(Kt4TJ>0000*bW%=J{{8-i
ztnYnS`%2<mv&*Hi+eu)j_};v^YM7SyYW}Y$+95hJM$+oSSLw>1VR`Y6h(8W3B~5V)
z8#Wc_5e5SS={*Sn0LeBEYXATP#z{m$RCwBr(`QiIW*o<H^}6@oC3{cyw4~Ng!6Lr%
zm9BJ;bnm@)ldg0mWUpqHBxDbk!wL-qM8F1v!2=IG<%O|jOJ{I=eI$oAG{)xp`g6bg
zzjz+x{&5$J0#t~Pi-NRk3h8Ta#1m7HBc{1-0tspAB$}*xypkr<K>~_r()44C7w>$4
zz8Q^ALG~^5niDEj%X*rb2I5lePC9>sUL(`5dy1Yej7LEZNuOP!wP`g=Hq*=<cpQq(
zWVY04?RJ|@cH((vMlKkW;<Fg$1&!U#S=EMoW+65v70h6^?%vx4v)eQ+Wel4J#-R9o
zCV#Wm-nDn<@#QwH>bWh<?PzQY(l27({L5zVI?~&FxK1l;d4?&>05K^xw}`Bl+3dS}
zPn~N2N~4#q+gdb95Q~BowrG8eOlv#Zbmq+8r)7HS>SqfJGw~QyIA>Ait5Us2ThCLy
zs!v_=dg0yK-~x)z6EAvgwN$T{)i=QdPOJKq3hE6~d>3{B&7Cb?Q=(8xRr;epwYN9@
z(x+5+8~%Jt%;tdqQ7oAx-=VtI%0B7xW4*nNzpA06g4LDeOyOt>CKBYkHB?8pTCG$b
zYHU1qTmfZIu;xXQoQ02~=mfU1I@n4XI=U5#?;0AG)^$)&x{WVwVrL7^r(haOR@JzJ
zJrrdybR0Rkw822NLOE!B`4yI(kDo`grn4WsZyIz5gFUSj_09hMhau!-zq$59mPiNx
zQv4p4eXq3NIOui<VXF=v{FZ}*rhdQ9S~1Md#YQN|UBGUu)%p8P#zCmvdk!4<8bYJV
z@7GxzA6K!W6mX7W3q`|woEDv*!%&wTI$3Ts!b!8v>TrI#;}g-GtSAL(glO${kHcy)
z`=RbPnd-iW4nm97;qkh*e<Tvk!+DC{R#3dd<@Gor)|nwMUG_t*nTJk~cOVdI-d3<c
z03Zb!M8U>zV8H9)vBgsQb6eYQzgwfw6&MPI-ySBCF-TLdA~ro8849=tyl~m+aO`T6
z%jJJKImpY1uX!yYnFtU(lOW1FBcUM<bJ|nUwoktANAEcpibQ<jUB$!%3=t#|E1P|h
zNQlQS$UUEbCja6~mn#q$f|Fdn&PNC$2g#5~R)rzuG1RappV(N<yC~#lA9_%djATky
zJj~0eh91T-9*)@Nm6A)i)$-2pfBB+?M^~{zaxs#9spQeJvk59ImL#PhS(jfS8AnN%
z2@ovz%Ij{(%eyyDd3m>9e|0vB04#O#)G7DHZOYWi0u&(dwPL6+K`4rYkq?s~9{mIP
WZ-npVUnZdd0000<MNUMnLSTX^^|^om

literal 0
HcmV?d00001

diff --git a/[gameplay]/dialogs/meta.xml b/[gameplay]/dialogs/meta.xml
new file mode 100644
index 000000000..b4b3e3a94
--- /dev/null
+++ b/[gameplay]/dialogs/meta.xml
@@ -0,0 +1,16 @@
+<meta>
+    <info author="Nico834" type="script" name="Dialogs" description="Create and manage dialogs with callbacks." version="1.0.0" />
+    <min_mta_version client="1.6.0" />
+
+    <script src="sourceG.lua" type="shared" />
+    <script src="sourceC.lua" type="client" />
+
+    <export function="messageBeep" type="client" />
+    <export function="messageBox" type="client" />
+    <export function="messageBoxEx" type="client" />
+
+    <file src="files/info.png" />
+    <file src="files/question.png" />
+    <file src="files/warning.png" />
+    <file src="files/error.png" />
+</meta>
\ No newline at end of file
diff --git a/[gameplay]/dialogs/readme.md b/[gameplay]/dialogs/readme.md
new file mode 100644
index 000000000..1a94dbb38
--- /dev/null
+++ b/[gameplay]/dialogs/readme.md
@@ -0,0 +1,230 @@
+# Dialogs
+
+## Description
+Create and manage dialogs with callbacks.
+
+## Pictures
+![img](https://i.imgur.com/yawOkA6.png)
+
+## Functions
+
+###  MessageBeep
+
+**Description**<br>
+This function plays a sound from the **messageSounds** table.
+
+**Syntax**
+```lua
+messageBeep( string soundType, [ int soundVolume ] )
+```
+
+**Example**
+> This example plays an info sound with the default volume (1)
+```lua
+messageBeep("INFO")
+```
+
+<br>
+
+> This example plays a question sound with specified volume (0.5)
+```lua
+messageBeep("QUESTION", 0.5)
+```
+
+**Arguments**
+> - soundType: A string specifying the sound data, which is in the **messageSounds** table.
+> - soundVolume: An integer between 1 and 0 that specifies the volume. (optional)
+
+<br>
+
+**Returns**<br>
+Returns the sound element.
+
+###  MessageBox
+
+**Description**<br>
+This function creates a dialog box with a callback function.
+
+**Syntax**
+```lua
+messageBox( string messageTitle, string messageContent, string messageCallback, [ string messageIcon, string messageButton, int messageButtonDefault, string messageSound, int messageSoundVolume] )
+```
+
+**Example**
+> This example creates a dialog containing an information.
+```lua
+messageBox("Welcome", "Multi Theft Auto provides the best online Grand Theft Auto experience there is.", "callbackFunction", "INFO", "OK")
+```
+
+```lua
+function callbackFunction(callbackResult)
+    if callbackResult == "OK" then
+        print("Read")
+    end
+end
+```
+
+<br>
+
+> This example creates a dialog containing a question.
+```lua
+messageBox("Save", "Are you sure you want to save your changes? This action will overwrite your previous saves.", "callbackFunction", "QUESTION", "YESNOCANCEL")
+```
+
+```lua
+function callbackFunction(callbackResult)
+    if callbackResult == "YES" then
+        print("Save")
+    elseif callbackResult == "NO" then
+        print("Undo")
+    else
+        print("Cancel")
+    end
+end
+```
+
+<br>
+
+> This example creates a dialog containing a warning.
+```lua
+messageBox("Mismatch", "The selected file does not exist. Would you like to try the download again?", "callbackFunction", "WARNING", "ABORTRETRYIGNORE")
+```
+
+```lua
+function callbackFunction(callbackResult)
+    if callbackResult == "ABORT" then
+        print("Abort")
+    elseif callbackResult == "RETRY" then
+        print("Retry")
+    else
+        print("Ignore")
+    end
+end
+```
+
+<br>
+
+> This example creates a dialog containing an error.
+```lua
+messageBox("Your wallet is empty", "You do not have enough money to purchase the selected vehicle.", "callbackFunction", "ERROR", "OK")
+```
+
+```lua
+function callbackFunction(callbackResult)
+    if callbackResult == "OK" then
+        print("Read")
+    end
+end
+```
+
+**Arguments**
+> - messageTitle: A string specifing the title of the message (note that it will be always uppercase)
+> - messageContent: A string specifing the content of the message
+> - messageCallback: A string specifying the name of the function that will be exported when a button is pressed. (Note that you must specify the function name as a string and specify the function as exportable in the meta.xml of the source.)
+> - messageIcon: A string specifing the icon of the message, which is in the **messageIcons** table.
+> - messageButton: A string specifing the button(s) of the message, which is in the **messageButtons** table.
+> - messageButtonDefault: An integer specifing the default button (note that it will receive a bolder font)
+> - messageSound: A string specifing the sound of the message, which is in the **messageSounds** table.
+> - messageSoundVolume: An integer between 1 and 0 specifing the volume of the sound.
+<br>
+
+**Returns**<br>
+This function does not contain returns because it uses a callback function.
+
+###  MessageBoxEx
+
+**Description**<br>
+This function creates a dialog box without a callback function.
+
+**Syntax**
+```lua
+messageBoxEx( string messageTitle, string messageContent, [ string messageIcon, string messageButton, int messageButtonDefault, string messageSound, int messageSoundVolume] )
+```
+
+**Example**
+> This example creates a dialog containing an information.
+```lua
+local buttonOK = messageBoxEx("Welcome", "Multi Theft Auto provides the best online Grand Theft Auto experience there is.", "INFO", "OK")
+
+addEventHandler("onClientGUIClick", buttonOK,
+    function()
+        print("Read")
+    end
+)
+```
+
+<br>
+
+> This example creates a dialog containing a question.
+```lua
+local buttonYes, buttonNo, buttonCancel = messageBoxEx("Save", "Are you sure you want to save your changes? This action will overwrite your previous saves.", "QUESTION", "YESNOCANCEL")
+
+addEventHandler("onClientGUIClick", buttonYes,
+    function()
+        print("Save")
+    end
+)
+
+addEventHandler("onClientGUIClick", buttonNo,
+    function()
+        print("Undo")
+    end
+)
+
+addEventHandler("onClientGUIClick", buttonCancel,
+    function()
+        print("Cancel")
+    end
+)
+```
+
+<br>
+
+> This example creates a dialog containing a warning.
+```lua
+local buttonAbort, buttonRetry, buttonIgnore = messageBoxEx("Save", "Are you sure you want to save your changes? This action will overwrite your previous saves.", "QUESTION", "YESNOCANCEL")
+
+addEventHandler("onClientGUIClick", buttonAbort,
+    function()
+        print("Abort")
+    end
+)
+
+addEventHandler("onClientGUIClick", buttonRetry,
+    function()
+        print("Retry")
+    end
+)
+
+addEventHandler("onClientGUIClick", buttonIgnore,
+    function()
+        print("Ignore")
+    end
+)
+```
+
+<br>
+
+> This example creates a dialog containing an error.
+```lua
+local buttonOK = messageBoxEx("Your wallet is empty", "You do not have enough money to purchase the selected vehicle.", "ERROR", "OK")
+
+addEventHandler("onClientGUIClick", buttonOK,
+    function()
+        print("Read")
+    end
+)
+```
+
+**Arguments**
+> - messageTitle: A string specifing the title of the message (note that it will be always uppercase)
+> - messageContent: A string specifing the content of the message
+> - messageIcon: A string specifing the icon of the message, which is in the **messageIcons** table.
+> - messageButton: A string specifing the button(s) of the message, which is in the **messageButtons** table.
+> - messageButtonDefault: An integer specifing the default button (note that it will receive a bolder font)
+> - messageSound: A string specifing the sound of the message, which is in the **messageSounds** table.
+> - messageSoundVolume: An integer between 1 and 0 specifing the volume of the sound.
+<br>
+
+**Returns**<br>
+Returns as many buttons in order as specified in the messageButton argument.
\ No newline at end of file
diff --git a/[gameplay]/dialogs/sourceC.lua b/[gameplay]/dialogs/sourceC.lua
new file mode 100644
index 000000000..d59c6b6f2
--- /dev/null
+++ b/[gameplay]/dialogs/sourceC.lua
@@ -0,0 +1,310 @@
+local screenX, screenY = guiGetScreenSize()
+
+local messageBoxWindows = {}
+local messageBoxCallbacks = {}
+
+function messageBeep(soundType, soundVolume)
+    if not soundType or type(soundType) ~= "string" then
+        error("Bad argument @ 'messageBeep' [Expected string at argument 1, got " .. type(soundType) .. "]")
+    end
+
+    soundType = utf8.upper(soundType)
+
+    if not messageSounds[soundType] then
+        error("Bad argument @ 'messageBeep' [Invalid type at argument 1, got '" .. tostring(soundType) .. "']")
+    end
+
+    if not soundVolume or soundVolume > 1 or type(soundVolume) ~= "number" then
+        soundVolume = 1
+    end
+
+    local soundID = messageSounds[soundType].soundID
+    local soundElement = playSoundFrontEnd(soundID)
+
+    if soundElement and isElement(soundElement) then
+        setSoundVolume(soundElement, soundVolume)
+    end
+
+    return soundElement
+end
+
+function messageClick()
+    local elementParent = getElementParent(source)
+
+    if elementParent then
+        local elementBox = messageBoxWindows[elementParent]
+        
+        if elementBox then
+            local elementCallback = messageBoxCallbacks[elementParent][1]
+            local elementCallbackSource = messageBoxCallbacks[elementParent][2]
+            local elementCallbackResult = guiGetText(source)
+
+            elementCallbackResult = utf8.upper(elementCallbackResult)
+
+            if elementCallback and type(elementCallback) == "string" then
+                if elementCallbackSource and getResourceState(elementCallbackSource) == "running" then
+                    call(elementCallbackSource, elementCallback, elementCallbackResult)
+                end
+            end
+
+            destroyElement(elementParent)
+
+            messageBoxWindows[elementParent] = nil
+            messageBoxCallbacks[elementParent] = nil
+        end
+    end
+end
+
+function messageClickEx()
+    local elementParent = getElementParent(source)
+
+    if elementParent then
+        local elementBox = messageBoxWindows[elementParent]
+
+        if elementBox then
+            destroyElement(elementParent)
+            messageBoxWindows[elementParent] = nil
+        end
+    end
+end
+
+function messageBox(messageTitle, messageContent, messageCallback, messageIcon, messageButton, messageButtonDefault, messageSound, messageSoundVolume)
+    if not messageTitle or type(messageTitle) ~= "string" then
+        error("Bad argument @ 'messageBox' [Expected string at argument 1, got " .. type(messageTitle) .. "]")
+    end
+
+    messageTitle = utf8.upper(messageTitle)
+
+    if not messageContent or type(messageContent) ~= "string" then
+        error("Bad argument @ 'messageBox' [Expected string at argument 2, got " .. type(messageContent) .. "]")
+    end
+
+    if not messageIcon or type(messageIcon) ~= "string" then
+        messageIcon = "INFO"
+    end
+
+    messageIcon = utf8.upper(messageIcon)
+
+    if not messageIcons[messageIcon] then
+        error("Bad argument @ 'messageBox' [Invalid type at argument 4, got '" .. tostring(messageIcon) .. "']")
+    end
+
+    if not messageButton or type(messageButton) ~= "string" then
+       messageButton = "OK"
+    end
+
+    messageButton = utf8.upper(messageButton)
+
+    if not messageButtons[messageButton] then
+        error("Bad argument @ 'messageBox' [Invalid type at argument 5, got '" .. tostring(messageButton) .. "']")
+    end
+
+    if messageButtonDefault then
+        if type(messageButtonDefault) ~= "number" then
+            error("Bad argument @ 'messageBox' [Expected number at argument 6, got " .. type(messageButtonDefault) .. "]")
+        elseif #messageButtons[messageButton] < messageButtonDefault then
+            error("Bad argument @ 'messageBox' [Invalid default at argument 6, " .. messageButton .. " only have " .. tostring(#messageButtons[messageButon]) .. " buttons.]")
+        end
+    else
+        messageButtonDefault = 1
+    end
+
+    if messageSound then
+        if type(messageSound) ~= "string" then
+            error("Bad argument @ 'messageBox' [Expected string at argument 7, got " .. type(messageSound) .. "]")
+        elseif not messageSounds[messageSound] then
+            error("Bad argument @ 'messageBox' [Invalid type at argument 7, got '" .. messageSound .. "']")
+        end
+    else
+        messageSound = messageIcon
+    end
+
+    if messageSoundVolume then
+        if type(messageSoundVolume) ~= "number" then
+            error("Bad argument @ 'messageBox' [Expected number at argument 8, got " .. type(messageSoundVolume) .. "]")
+        elseif messageSoundVolume > 1 or messageSoundVolume < 1 then
+            error("Bad argument @ 'messageBox' [Invalid volume at argument 8, got '" .. tostring(messageSoundVolume) .. "']")
+        end
+    else
+        messageSoundVolume = 1
+    end
+
+    messageBeep(messageSound, messageSoundVolume)
+
+    local messageWindowWidth = 400
+    local messageWindowHeight = 200
+
+    local messageWindowPosX = (screenX - messageWindowWidth) / 2
+    local messageWindowPosY = (screenY - messageWindowHeight) / 2
+    local messageWindowElement = guiCreateWindow(messageWindowPosX, messageWindowPosY, messageWindowWidth, messageWindowHeight, messageTitle)
+
+    guiWindowSetSizable(messageWindowElement, false)
+
+    local messageIconWidth = 42
+    local messageIconHeight = 42
+    
+    local messageIconPosX = (messageWindowWidth - messageIconWidth) / 8
+    local messageIconPosY = (messageWindowHeight - messageIconHeight) / 2
+
+    guiCreateStaticImage(messageIconPosX, messageIconPosY, messageIconWidth, messageIconHeight, messageIcons[messageIcon].iconPath, false, messageWindowElement)
+
+    local messageCaptionWidth = messageWindowWidth - (messageIconPosX + messageIconWidth + 10 + 5)
+    local messageCaptionHeight = 16
+
+    local messageContentWidth = messageWindowWidth - (messageIconPosX + messageIconWidth + 10 + 5)
+    local messageContentHeight = 18
+
+    local messageCaptionPosX = messageIconPosX + messageIconWidth + 10
+    local messageCaptionPosY = messageIconPosY + (messageIconHeight - messageCaptionHeight - messageContentHeight) / 2
+    local messageCaptionElement = guiCreateLabel(messageCaptionPosX, messageCaptionPosY, messageCaptionWidth, messageCaptionHeight, messageIcons[messageIcon].iconCaption, false, messageWindowElement)
+
+    guiSetFont(messageCaptionElement, "default-bold-small")
+
+    local messageContentPosX = messageIconPosX + messageIconWidth + 10
+    local messageContentPosY = messageIconPosY + (messageIconHeight - messageContentHeight) - 5
+    local messageContentElement = guiCreateLabel(messageContentPosX, messageContentPosY, messageContentWidth, messageContentHeight * 4  , messageContent, false, messageWindowElement)
+
+    guiLabelSetHorizontalAlign(messageContentElement, "left", true)
+
+    local messageButtonWidth = 50
+    local messageButtonHeight = 30
+
+    local messageButtonPosX = (messageWindowWidth - 5) - (messageButtonWidth + 5) * #messageButtons[messageButton]
+    local messageButtonPosY = (messageWindowHeight - 10) - messageButtonHeight
+
+    for i, v in ipairs(messageButtons[messageButton]) do
+        local messageButtonElement = guiCreateButton(messageButtonPosX, messageButtonPosY, messageButtonWidth, messageButtonHeight, v, false, messageWindowElement)
+
+        if i == messageButtonDefault then
+            guiSetFont(messageButtonElement, "default-bold-small")
+        end
+
+        addEventHandler("onClientGUIClick", messageButtonElement, messageClick, false)
+        messageButtonPosX = messageButtonPosX + messageButtonWidth + 5
+    end
+
+    messageBoxWindows[messageWindowElement] = {messageTitle, messageContent, messageIcon, messageButton}
+    messageBoxCallbacks[messageWindowElement] = {messageCallback, sourceResource}
+end
+
+function messageBoxEx(messageTitle, messageContent, messageIcon, messageButton, messageButtonDefault, messageSound, messageSoundVolume)
+    if not messageTitle or type(messageTitle) ~= "string" then
+        error("Bad argument @ 'messageBoxEx' [Expected string at argument 1, got " .. type(messageTitle) .. "]")
+    end
+
+    messageTitle = utf8.upper(messageTitle)
+
+    if not messageContent or type(messageContent) ~= "string" then
+        error("Bad argument @ 'messageBoxEx' [Expected string at argument 2, got " .. type(messageContent) .. "]")
+    end
+
+    if not messageIcon or type(messageIcon) ~= "string" then
+        messageIcon = "INFO"
+    end
+
+    messageIcon = utf8.upper(messageIcon)
+
+    if not messageIcons[messageIcon] then
+        error("Bad argument @ 'messageBoxEx' [Invalid type at argument 3, got '" .. tostring(messageIcon) .. "']")
+    end
+
+    if not messageButton or type(messageButton) ~= "string" then
+       messageButton = "OK"
+    end
+
+    messageButton = utf8.upper(messageButton)
+
+    if not messageButtons[messageButton] then
+        error("Bad argument @ 'messageBoxEx' [Invalid type at argument 4, got '" .. tostring(messageButton) .. "']")
+    end
+
+    if messageButtonDefault then
+        if type(messageButtonDefault) ~= "number" then
+            error("Bad argument @ 'messageBoxEx' [Expected number at argument 5, got " .. type(messageButtonDefault) .. "]")
+        elseif #messageButtons[messageButton] < messageButtonDefault then
+            error("Bad argument @ 'messageBoxEx' [Invalid default at argument 5, " .. messageButton .. " only have " .. tostring(#messageButtons[messageButon]) .. " buttons.]")
+        end
+    else
+        messageButtonDefault = 1
+    end
+
+    if messageSound then
+        if type(messageSound) ~= "string" then
+            error("Bad argument @ 'messageBoxEx' [Expected string at argument 6, got " .. type(messageSound) .. "]")
+        elseif not messageSounds[messageSound] then
+            error("Bad argument @ 'messageBoxEx' [Invalid type at argument 6, got '" .. messageSound .. "']")
+        end
+    else
+        messageSound = messageIcon
+    end
+
+    if messageSoundVolume then
+        if type(messageSoundVolume) ~= "number" then
+            error("Bad argument @ 'messageBoxEx' [Expected number at argument 7, got " .. type(messageSoundVolume) .. "]")
+        elseif messageSoundVolume > 1 or messageSoundVolume < 1 then
+            error("Bad argument @ 'messageBoxEx' [Invalid volume at argument 7, got '" .. tostring(messageSoundVolume) .. "']")
+        end
+    else
+        messageSoundVolume = 1
+    end
+
+    messageBeep(messageSound, messageSoundVolume)
+
+    local messageWindowWidth = 400
+    local messageWindowHeight = 200
+
+    local messageWindowPosX = (screenX - messageWindowWidth) / 2
+    local messageWindowPosY = (screenY - messageWindowHeight) / 2
+    local messageWindowElement = guiCreateWindow(messageWindowPosX, messageWindowPosY, messageWindowWidth, messageWindowHeight, messageTitle)
+
+    guiWindowSetSizable(messageWindowElement, false)
+
+    local messageIconWidth = 42
+    local messageIconHeight = 42
+    
+    local messageIconPosX = (messageWindowWidth - messageIconWidth) / 8
+    local messageIconPosY = (messageWindowHeight - messageIconHeight) / 2
+
+    guiCreateStaticImage(messageIconPosX, messageIconPosY, messageIconWidth, messageIconHeight, messageIcons[messageIcon].iconPath, false, messageWindowElement)
+
+    local messageCaptionWidth = messageWindowWidth - (messageIconPosX + messageIconWidth + 10 + 5)
+    local messageCaptionHeight = 16
+
+    local messageContentWidth = messageWindowWidth - (messageIconPosX + messageIconWidth + 10 + 5)
+    local messageContentHeight = 18
+
+    local messageCaptionPosX = messageIconPosX + messageIconWidth + 10
+    local messageCaptionPosY = messageIconPosY + (messageIconHeight - messageCaptionHeight - messageContentHeight) / 2
+    local messageCaptionElement = guiCreateLabel(messageCaptionPosX, messageCaptionPosY, messageCaptionWidth, messageCaptionHeight, messageIcons[messageIcon].iconCaption, false, messageWindowElement)
+
+    guiSetFont(messageCaptionElement, "default-bold-small")
+
+    local messageContentPosX = messageIconPosX + messageIconWidth + 10
+    local messageContentPosY = messageIconPosY + (messageIconHeight - messageContentHeight) - 5
+    local messageContentElement = guiCreateLabel(messageContentPosX, messageContentPosY, messageContentWidth, messageContentHeight * 4  , messageContent, false, messageWindowElement)
+
+    guiLabelSetHorizontalAlign(messageContentElement, "left", true)
+
+    local messageButtonWidth = 50
+    local messageButtonHeight = 30
+
+    local messageButtonPosX = (messageWindowWidth - 5) - (messageButtonWidth + 5) * #messageButtons[messageButton]
+    local messageButtonPosY = (messageWindowHeight - 10) - messageButtonHeight
+    local messageButtonElements = {}
+
+    for i, v in ipairs(messageButtons[messageButton]) do
+        local messageButtonElement = guiCreateButton(messageButtonPosX, messageButtonPosY, messageButtonWidth, messageButtonHeight, v, false, messageWindowElement)
+
+        if i == messageButtonDefault then
+            guiSetFont(messageButtonElement, "default-bold-small")
+        end
+
+        addEventHandler("onClientGUIClick", messageButtonElement, messageClickEx, false)
+        messageButtonElements[i] = messageButtonElement
+        messageButtonPosX = messageButtonPosX + messageButtonWidth + 5
+    end
+
+    messageBoxWindows[messageWindowElement] = {messageTitle, messageContent, messageIcon, messageButton}
+
+    return messageButtonElements[1], messageButtonElements[2], messageButtonElements[3]
+end
\ No newline at end of file
diff --git a/[gameplay]/dialogs/sourceG.lua b/[gameplay]/dialogs/sourceG.lua
new file mode 100644
index 000000000..68332177d
--- /dev/null
+++ b/[gameplay]/dialogs/sourceG.lua
@@ -0,0 +1,77 @@
+messageButtons = {
+    ["ABORTRETRYIGNORE"] = {
+        [1] = "Abort",
+        [2] = "Retry",
+        [3] = "Ignore"
+    },
+    ["CANCELTRYCONTINUE"] = {
+        [1] = "Cancel",
+        [2] = "Try",
+        [3] = "Continue"
+    },
+    ["HELP"] = {
+        [1] = "Help"
+    },
+    ["OK"] = {
+        [1] = "OK"
+    },
+    ["OKCANCEL"] = {
+        [1] = "OK",
+        [2] = "Cancel"
+    },
+    ["RETRYCANCEL"] = {
+        [1] = "Retry",
+        [2] = "Cancel"
+    },
+    ["YESNO"] = {
+        [1] = "Yes",
+        [2] = "No"
+    },
+    ["YESNOCANCEL"] = {
+        [1] = "Yes",
+        [2] = "No",
+        [3] = "Cancel"
+    }
+}
+
+messageSounds = {
+    ["INFO"] = {
+        soundID = 20,
+        soundName = "Information",
+    },
+    ["QUESTION"] = {
+        soundID = 10,
+        soundName = "Question",
+    },
+    ["WARNING"] = {
+        soundID = 17,
+        soundName = "Warning",
+    },
+    ["ERROR"] = {
+        soundID = 4,
+        soundName = "Error",
+    },
+}
+
+messageIcons = {
+    ["INFO"] = {
+        iconCaption = "Information",
+        iconSound = "INFO",
+        iconPath = "files/info.png"
+    },
+    ["QUESTION"] = {
+        iconCaption = "Question",
+        iconSound = "QUESTION",
+        iconPath = "files/question.png"
+    },
+    ["WARNING"] = {
+        iconCaption = "Warning",
+        iconSound = "WARNING",
+        iconPath = "files/warning.png"
+    },
+    ["ERROR"] = {
+        iconCaption = "Error",
+        iconSound = "ERROR",
+        iconPath = "files/error.png"
+    }
+}
\ No newline at end of file
diff --git a/[gameplay]/webbrowser/WebBrowserGUI.lua b/[gameplay]/webbrowser/WebBrowserGUI.lua
index 6e82888a3..92e879f5b 100644
--- a/[gameplay]/webbrowser/WebBrowserGUI.lua
+++ b/[gameplay]/webbrowser/WebBrowserGUI.lua
@@ -107,7 +107,7 @@ end
 function WebBrowserGUI:DevButton_Click(button, state)
 	if button == "left" and state == "up" then
 		if not getDevelopmentMode() then
-			exports.msgbox:guiShowMessageBox("You have to enable the development using setDevelopmentMode", "error", "Development mode required", false)
+			exports.dialogs:messageBox("Development mode required", "You have to enable the development mode using setDevelopmentMode()", false, "ERROR", "OK")
 			return
 		end
 
diff --git a/[gameplay]/webbrowser/meta.xml b/[gameplay]/webbrowser/meta.xml
index a18dd2bc6..9909af87d 100644
--- a/[gameplay]/webbrowser/meta.xml
+++ b/[gameplay]/webbrowser/meta.xml
@@ -2,7 +2,7 @@
 	<info author="Jusonex, Audifire" type="misc" version="1.0.0" name="webbrowser"/>
 	<min_mta_version client="1.5.1"/>
 	<oop>true</oop>
-	<include resource="msgbox"/>
+	<include resource="dialogs"/>
 
 	<script src="client.lua" type="client"/>
 	<script src="WebBrowserGUI.lua" type="client"/>