Update libraries and make it build on windows.

Still gets some warnings because compilers have changed. But should work.

CMakeLists.txt

@@ -1,14 +1,13 @@
-cmake_minimum_required(VERSION 3.7)
+cmake_minimum_required(VERSION 3.21)
 project(SqMod)
 
 # This plug-in only works on 64-bit
 if(CMAKE_SIZEOF_VOID_P EQUAL 4)
-    message(FATAL_ERROR "SqMod does not support 32-but platforms anymore.")
+    message(FATAL_ERROR "SqMod does not support 32-bit platforms anymore.")
 endif()
 
 # Tell CMake where to find our scripts
-set(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
-set(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/vendor/POCO/cmake)
+set(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake ${PROJECT_SOURCE_DIR}/vendor/POCO/cmake)
 
 # Several plugin options
 option(ENABLE_API21 "Build for 2.1 API." OFF)
@@ -18,87 +17,14 @@ option(ENABLE_BUILTIN_MYSQL_C "Enable built-in MySQL connector library" OFF)
 #option(FORCE_32BIT_BIN "Create a 32-bit executable binary if the compiler defaults to 64-bit." OFF)
 # This option should only be available in certain conditions
 if(WIN32 AND MINGW)
-    option(COPY_DEPENDENCIES "Copy deppendent DLLs into the deps folder." OFF)
+    option(COPY_DEPENDENCIES "Copy dependent DLLs into the deps folder." OFF)
 endif()
+# Discord suppport
+option(ENABLE_DISCORD "Enable built-in Discord support." ON)
 
-# C++14 is mandatory
-set(CPP_STD_NUMBER 14)
-
-include(CheckCXXCompilerFlag)
-# C++ standard availability check
-if(${CMAKE_CXX_COMPILER_ID} MATCHES "(GNU)+")
-    # Specific flags
-    set(CPP_STD_COMPILER_FLAG "-std=c++14")
-    # Don't even bother with previous version
-    if(CPP_STD_NUMBER LESS 20 AND NOT CMAKE_CXX_COMPILER_VERSION VERSION_LESS 8.0)
-        check_cxx_compiler_flag(-std=c++20 HAVE_FLAG_STD_CXX20)
-        check_cxx_compiler_flag(-std=c++2a HAVE_FLAG_STD_CXX2A)
-        if(HAVE_FLAG_STD_CXX20 OR HAVE_FLAG_STD_CXX2A)
-            # We can use C++20
-            set(CPP_STD_NUMBER 20)
-            # Specific flags
-            if (HAVE_FLAG_STD_CXX2A AND NOT HAVE_FLAG_STD_CXX20)
-                set(CPP_STD_COMPILER_FLAG "-std=c++2a")
-            else()
-                set(CPP_STD_COMPILER_FLAG "-std=c++20")
-            endif()
-            # Need these workarounds for older CMake
-            if(${CMAKE_VERSION} VERSION_LESS "3.8.0")
-                if (NOT CMAKE_CXX_COMPILER_VERSION VERSION_LESS 10.0)
-                    set(CMAKE_CXX20_STANDARD_COMPILE_OPTION "-std=c++20")
-                    set(CMAKE_CXX20_EXTENSION_COMPILE_OPTION "-std=gnu++20")
-                elseif (NOT CMAKE_CXX_COMPILER_VERSION VERSION_LESS 8.0)
-                    set(CMAKE_CXX20_STANDARD_COMPILE_OPTION "-std=c++2a")
-                    set(CMAKE_CXX20_EXTENSION_COMPILE_OPTION "-std=gnu++2a")
-                endif()
-            endif()
-        endif()
-    endif()
-    # Don't even bother with previous version
-    if(CPP_STD_NUMBER LESS 17 AND NOT CMAKE_CXX_COMPILER_VERSION VERSION_LESS 7.0)
-        check_cxx_compiler_flag(-std=c++17 HAVE_FLAG_STD_CXX17)
-        check_cxx_compiler_flag(-std=c++1z HAVE_FLAG_STD_CXX1Z)
-        if(HAVE_FLAG_STD_CXX17 OR HAVE_FLAG_STD_CXX1Z)
-            # We can use C++17
-            set(CPP_STD_NUMBER 17)
-            # Specific flags
-            if (HAVE_FLAG_STD_CXX1Z AND NOT HAVE_FLAG_STD_CXX17)
-                set(CPP_STD_COMPILER_FLAG "-std=c++1z")
-            else()
-                set(CPP_STD_COMPILER_FLAG "-std=c++17")
-            endif()
-            # Need these workarounds for older CMake
-            if(${CMAKE_VERSION} VERSION_LESS "3.8.0")
-                if (NOT CMAKE_CXX_COMPILER_VERSION VERSION_LESS 8.0)
-                    set(CMAKE_CXX17_STANDARD_COMPILE_OPTION "-std=c++17")
-                    set(CMAKE_CXX17_EXTENSION_COMPILE_OPTION "-std=gnu++17")
-                elseif (NOT CMAKE_CXX_COMPILER_VERSION VERSION_LESS 5.1)
-                    set(CMAKE_CXX17_STANDARD_COMPILE_OPTION "-std=c++1z")
-                    set(CMAKE_CXX17_EXTENSION_COMPILE_OPTION "-std=gnu++1z")
-                endif()
-            endif()
-        endif()
-    endif()
-else()
-    # C++14 is mandatory
-    set(CPP_STD_NUMBER 14)
-endif()
-
-message(STATUS "SqMod: Using C++${CPP_STD_NUMBER} standard.")
-
-# Default to the identified standard
-if(CMAKE_VERSION VERSION_LESS "3.1")
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${CPP_STD_COMPILER_FLAG}")
-else()
-    # Apparently the above does not work with cmake from on debian 8
-    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${CPP_STD_COMPILER_FLAG}")
-    # F* you too Debian. What can I say.
-    if(CMAKE_VERSION VERSION_LESS "3.8.0" AND CPP_STD_NUMBER LESS 17)
-        # Try the standard method as well
-        set(CMAKE_CXX_STANDARD ${CPP_STD_NUMBER})
+# C++17 is mandatory (globally)
+set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
-    endif()
-endif()
 
 # Strip binary
 set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS_RELEASE} -s -g")

cmake/FindFFmpeg.cmake

@@ -0,0 +1,152 @@
+# vim: ts=2 sw=2
+# - Try to find the required ffmpeg components(default: AVFORMAT, AVUTIL, AVCODEC)
+#
+# Once done this will define
+#  FFMPEG_FOUND         - System has the all required components.
+#  FFMPEG_INCLUDE_DIRS  - Include directory necessary for using the required components headers.
+#  FFMPEG_LIBRARIES     - Link these to use the required ffmpeg components.
+#  FFMPEG_DEFINITIONS   - Compiler switches required for using the required ffmpeg components.
+#
+# For each of the components it will additionally set.
+#   - AVCODEC
+#   - AVDEVICE
+#   - AVFORMAT
+#   - AVFILTER
+#   - AVUTIL
+#   - POSTPROC
+#   - SWSCALE
+#   - SWRESAMPLE
+# the following variables will be defined
+#  <component>_FOUND        - System has <component>
+#  <component>_INCLUDE_DIRS - Include directory necessary for using the <component> headers
+#  <component>_LIBRARIES    - Link these to use <component>
+#  <component>_DEFINITIONS  - Compiler switches required for using <component>
+#  <component>_VERSION      - The components version
+#
+# Copyright (c) 2006, Matthias Kretz, <kretz@kde.org>
+# Copyright (c) 2008, Alexander Neundorf, <neundorf@kde.org>
+# Copyright (c) 2011, Michael Jansen, <kde@michael-jansen.biz>
+#
+# Redistribution and use is allowed according to the terms of the BSD license.
+# For details see the accompanying COPYING-CMAKE-SCRIPTS file.
+
+include(FindPackageHandleStandardArgs)
+
+# The default components were taken from a survey over other FindFFMPEG.cmake files
+if (NOT FFmpeg_FIND_COMPONENTS)
+  set(FFmpeg_FIND_COMPONENTS AVCODEC AVFORMAT AVUTIL)
+endif ()
+
+#
+### Macro: set_component_found
+#
+# Marks the given component as found if both *_LIBRARIES AND *_INCLUDE_DIRS is present.
+#
+macro(set_component_found _component )
+  if (${_component}_LIBRARIES AND ${_component}_INCLUDE_DIRS)
+    # message(STATUS "  - ${_component} found.")
+    set(${_component}_FOUND TRUE)
+  else ()
+    # message(STATUS "  - ${_component} not found.")
+  endif ()
+endmacro()
+
+#
+### Macro: find_component
+#
+# Checks for the given component by invoking pkgconfig and then looking up the libraries and
+# include directories.
+#
+macro(find_component _component _pkgconfig _library _header)
+
+  if (NOT WIN32)
+     # use pkg-config to get the directories and then use these values
+     # in the FIND_PATH() and FIND_LIBRARY() calls
+     find_package(PkgConfig)
+     if (PKG_CONFIG_FOUND)
+       pkg_check_modules(PC_${_component} ${_pkgconfig})
+     endif ()
+  endif (NOT WIN32)
+
+  find_path(${_component}_INCLUDE_DIRS ${_header}
+    HINTS
+      ${PC_${_component}_INCLUDEDIR}
+      ${PC_${_component}_INCLUDE_DIRS}
+    PATH_SUFFIXES
+      ffmpeg
+  )
+
+  find_library(${_component}_LIBRARIES NAMES ${_library}
+      HINTS
+      ${PC_${_component}_LIBDIR}
+      ${PC_${_component}_LIBRARY_DIRS}
+  )
+
+  set(${_component}_DEFINITIONS  ${PC_${_component}_CFLAGS_OTHER} CACHE STRING "The ${_component} CFLAGS.")
+  set(${_component}_VERSION      ${PC_${_component}_VERSION}      CACHE STRING "The ${_component} version number.")
+
+  set_component_found(${_component})
+
+  mark_as_advanced(
+    ${_component}_INCLUDE_DIRS
+    ${_component}_LIBRARIES
+    ${_component}_DEFINITIONS
+    ${_component}_VERSION)
+
+endmacro()
+
+
+# Check for cached results. If there are skip the costly part.
+if (NOT FFMPEG_LIBRARIES)
+
+  # Check for all possible component.
+  find_component(AVCODEC    libavcodec    avcodec  libavcodec/avcodec.h)
+  find_component(AVFORMAT   libavformat   avformat libavformat/avformat.h)
+  find_component(AVDEVICE   libavdevice   avdevice libavdevice/avdevice.h)
+  find_component(AVUTIL     libavutil     avutil   libavutil/avutil.h)
+  find_component(AVFILTER   libavfilter   avfilter libavfilter/avfilter.h)
+  find_component(SWSCALE    libswscale    swscale  libswscale/swscale.h)
+  find_component(POSTPROC   libpostproc   postproc libpostproc/postprocess.h)
+  find_component(SWRESAMPLE libswresample swresample libswresample/swresample.h)
+
+  # Check if the required components were found and add their stuff to the FFMPEG_* vars.
+  foreach (_component ${FFmpeg_FIND_COMPONENTS})
+    if (${_component}_FOUND)
+      # message(STATUS "Required component ${_component} present.")
+      set(FFMPEG_LIBRARIES   ${FFMPEG_LIBRARIES}   ${${_component}_LIBRARIES})
+      set(FFMPEG_DEFINITIONS ${FFMPEG_DEFINITIONS} ${${_component}_DEFINITIONS})
+      list(APPEND FFMPEG_INCLUDE_DIRS ${${_component}_INCLUDE_DIRS})
+    else ()
+      # message(STATUS "Required component ${_component} missing.")
+    endif ()
+  endforeach ()
+
+  # Build the include path with duplicates removed.
+  if (FFMPEG_INCLUDE_DIRS)
+    list(REMOVE_DUPLICATES FFMPEG_INCLUDE_DIRS)
+  endif ()
+
+  # cache the vars.
+  set(FFMPEG_INCLUDE_DIRS ${FFMPEG_INCLUDE_DIRS} CACHE STRING "The FFmpeg include directories." FORCE)
+  set(FFMPEG_LIBRARIES    ${FFMPEG_LIBRARIES}    CACHE STRING "The FFmpeg libraries." FORCE)
+  set(FFMPEG_DEFINITIONS  ${FFMPEG_DEFINITIONS}  CACHE STRING "The FFmpeg cflags." FORCE)
+
+  mark_as_advanced(FFMPEG_INCLUDE_DIRS
+                   FFMPEG_LIBRARIES
+                   FFMPEG_DEFINITIONS)
+
+endif ()
+
+# Now set the noncached _FOUND vars for the components.
+foreach (_component AVCODEC AVDEVICE AVFORMAT AVUTIL POSTPROCESS SWSCALE)
+  set_component_found(${_component})
+endforeach ()
+
+# Compile the list of required vars
+set(_FFmpeg_REQUIRED_VARS FFMPEG_LIBRARIES FFMPEG_INCLUDE_DIRS)
+foreach (_component ${FFmpeg_FIND_COMPONENTS})
+  list(APPEND _FFmpeg_REQUIRED_VARS ${_component}_LIBRARIES ${_component}_INCLUDE_DIRS)
+endforeach ()
+
+# Give a nice error message if some of the required vars are missing.
+find_package_handle_standard_args(FFmpeg DEFAULT_MSG ${_FFmpeg_REQUIRED_VARS})

cmake/FindOpus.cmake

@@ -0,0 +1,36 @@
+#  OPUS_FOUND - system has opus
+#  OPUS_INCLUDE_DIRS - the opus include directory
+#  OPUS_LIBRARIES - The libraries needed to use opus
+
+find_path(OPUS_INCLUDE_DIRS
+	NAMES opus/opus.h
+	PATH_SUFFIXES include
+)
+if(OPUS_INCLUDE_DIRS)
+	set(HAVE_OPUS_OPUS_H 1)
+endif()
+
+if(OPUS_USE_STATIC_LIBS)
+	find_library(OPUS_LIBRARIES NAMES "libopus.a")
+else()
+	find_library(OPUS_LIBRARIES NAMES opus)
+endif()
+
+if(OPUS_LIBRARIES)
+	if(OPUS_USE_STATIC_LIBS)
+		find_library(LIBM NAMES "libm.a" "libm.tbd")
+	else()
+		find_library(LIBM NAMES m)
+	endif()
+	if(LIBM)
+		list(APPEND OPUS_LIBRARIES ${LIBM})
+	endif()
+endif()
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(Opus
+	DEFAULT_MSG
+	OPUS_INCLUDE_DIRS OPUS_LIBRARIES HAVE_OPUS_OPUS_H
+)
+
+mark_as_advanced(OPUS_INCLUDE_DIRS OPUS_LIBRARIES HAVE_OPUS_OPUS_H)

cmake/FindSodium.cmake

@@ -0,0 +1,293 @@
+# Written in 2016 by Henrik Steffen Gaßmann <henrik@gassmann.onl>
+#
+# To the extent possible under law, the author(s) have dedicated all copyright
+# and related and neighboring rights to this software to the public domain
+# worldwide. This software is distributed without any warranty.
+#
+# You should have received a copy of the CC0 Public Domain Dedication along with
+# this software. If not, see
+#
+# http://creativecommons.org/publicdomain/zero/1.0/
+#
+# ##############################################################################
+# Tries to find the local libsodium installation.
+#
+# On Windows the sodium_DIR environment variable is used as a default hint which
+# can be overridden by setting the corresponding cmake variable.
+#
+# Once done the following variables will be defined:
+#
+# sodium_FOUND sodium_INCLUDE_DIR sodium_LIBRARY_DEBUG sodium_LIBRARY_RELEASE
+# sodium_VERSION_STRING
+#
+# Furthermore an imported "sodium" target is created.
+#
+
+if(CMAKE_C_COMPILER_ID STREQUAL "GNU" OR CMAKE_C_COMPILER_ID STREQUAL "Clang")
+  set(_GCC_COMPATIBLE 1)
+endif()
+
+# static library option
+if(NOT DEFINED sodium_USE_STATIC_LIBS)
+  option(sodium_USE_STATIC_LIBS "enable to statically link against sodium" OFF)
+endif()
+if(NOT (sodium_USE_STATIC_LIBS EQUAL sodium_USE_STATIC_LIBS_LAST))
+  unset(sodium_LIBRARY CACHE)
+  unset(sodium_LIBRARY_DEBUG CACHE)
+  unset(sodium_LIBRARY_RELEASE CACHE)
+  unset(sodium_DLL_DEBUG CACHE)
+  unset(sodium_DLL_RELEASE CACHE)
+  set(sodium_USE_STATIC_LIBS_LAST
+      ${sodium_USE_STATIC_LIBS}
+      CACHE INTERNAL "internal change tracking variable")
+endif()
+
+# ##############################################################################
+# UNIX
+if(UNIX)
+  # import pkg-config
+  find_package(PkgConfig)
+  if(PKG_CONFIG_FOUND)
+    pkg_check_modules(sodium_PKG QUIET libsodium)
+  endif()
+
+  if(sodium_USE_STATIC_LIBS)
+    if(sodium_PKG_STATIC_LIBRARIES)
+      foreach(_libname ${sodium_PKG_STATIC_LIBRARIES})
+        if(NOT _libname MATCHES "^lib.*\\.a$") # ignore strings already ending
+                                               # with .a
+          list(INSERT sodium_PKG_STATIC_LIBRARIES 0 "lib${_libname}.a")
+        endif()
+      endforeach()
+      list(REMOVE_DUPLICATES sodium_PKG_STATIC_LIBRARIES)
+    else()
+      # if pkgconfig for libsodium doesn't provide static lib info, then
+      # override PKG_STATIC here..
+      set(sodium_PKG_STATIC_LIBRARIES libsodium.a)
+    endif()
+
+    set(XPREFIX sodium_PKG_STATIC)
+  else()
+    if(sodium_PKG_LIBRARIES STREQUAL "")
+      set(sodium_PKG_LIBRARIES sodium)
+    endif()
+
+    set(XPREFIX sodium_PKG)
+  endif()
+
+  find_path(sodium_INCLUDE_DIR sodium.h HINTS ${${XPREFIX}_INCLUDE_DIRS})
+  find_library(sodium_LIBRARY_DEBUG
+               NAMES ${${XPREFIX}_LIBRARIES}
+               HINTS ${${XPREFIX}_LIBRARY_DIRS})
+  find_library(sodium_LIBRARY_RELEASE
+               NAMES ${${XPREFIX}_LIBRARIES}
+               HINTS ${${XPREFIX}_LIBRARY_DIRS})
+
+  # ############################################################################
+  # Windows
+elseif(WIN32)
+  set(sodium_DIR "$ENV{sodium_DIR}" CACHE FILEPATH "sodium install directory")
+  mark_as_advanced(sodium_DIR)
+
+  find_path(sodium_INCLUDE_DIR sodium.h
+            HINTS ${sodium_DIR}
+            PATH_SUFFIXES include)
+
+  if(MSVC)
+    # detect target architecture
+    file(WRITE "${CMAKE_CURRENT_BINARY_DIR}/arch.cpp" [=[
+            #if defined _M_IX86
+            #error ARCH_VALUE x86_32
+            #elif defined _M_X64
+            #error ARCH_VALUE x86_64
+            #endif
+            #error ARCH_VALUE unknown
+        ]=])
+    try_compile(_UNUSED_VAR "${CMAKE_CURRENT_BINARY_DIR}"
+                "${CMAKE_CURRENT_BINARY_DIR}/arch.cpp"
+                OUTPUT_VARIABLE _COMPILATION_LOG)
+    string(REGEX
+           REPLACE ".*ARCH_VALUE ([a-zA-Z0-9_]+).*"
+                   "\\1"
+                   _TARGET_ARCH
+                   "${_COMPILATION_LOG}")
+
+    # construct library path
+    if(_TARGET_ARCH STREQUAL "x86_32")
+      string(APPEND _PLATFORM_PATH "Win32")
+    elseif(_TARGET_ARCH STREQUAL "x86_64")
+      string(APPEND _PLATFORM_PATH "x64")
+    else()
+      message(
+        FATAL_ERROR
+          "the ${_TARGET_ARCH} architecture is not supported by Findsodium.cmake."
+        )
+    endif()
+    string(APPEND _PLATFORM_PATH "/$$CONFIG$$")
+
+    if(MSVC_VERSION LESS 1900)
+      math(EXPR _VS_VERSION "${MSVC_VERSION} / 10 - 60")
+    else()
+      math(EXPR _VS_VERSION "${MSVC_VERSION} / 10 - 50")
+    endif()
+    string(APPEND _PLATFORM_PATH "/v${_VS_VERSION}")
+
+    if(sodium_USE_STATIC_LIBS)
+      string(APPEND _PLATFORM_PATH "/static")
+    else()
+      string(APPEND _PLATFORM_PATH "/dynamic")
+    endif()
+
+    string(REPLACE "$$CONFIG$$"
+                   "Debug"
+                   _DEBUG_PATH_SUFFIX
+                   "${_PLATFORM_PATH}")
+    string(REPLACE "$$CONFIG$$"
+                   "Release"
+                   _RELEASE_PATH_SUFFIX
+                   "${_PLATFORM_PATH}")
+
+    find_library(sodium_LIBRARY_DEBUG libsodium.lib
+                 HINTS ${sodium_DIR}
+                 PATH_SUFFIXES ${_DEBUG_PATH_SUFFIX})
+    find_library(sodium_LIBRARY_RELEASE libsodium.lib
+                 HINTS ${sodium_DIR}
+                 PATH_SUFFIXES ${_RELEASE_PATH_SUFFIX})
+    if(NOT sodium_USE_STATIC_LIBS)
+      set(CMAKE_FIND_LIBRARY_SUFFIXES_BCK ${CMAKE_FIND_LIBRARY_SUFFIXES})
+      set(CMAKE_FIND_LIBRARY_SUFFIXES ".dll")
+      find_library(sodium_DLL_DEBUG libsodium
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES ${_DEBUG_PATH_SUFFIX})
+      find_library(sodium_DLL_RELEASE libsodium
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES ${_RELEASE_PATH_SUFFIX})
+      set(CMAKE_FIND_LIBRARY_SUFFIXES ${CMAKE_FIND_LIBRARY_SUFFIXES_BCK})
+    endif()
+
+  elseif(_GCC_COMPATIBLE)
+    if(sodium_USE_STATIC_LIBS)
+      find_library(sodium_LIBRARY_DEBUG libsodium.a
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES lib)
+      find_library(sodium_LIBRARY_RELEASE libsodium.a
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES lib)
+    else()
+      find_library(sodium_LIBRARY_DEBUG libsodium.dll.a
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES lib)
+      find_library(sodium_LIBRARY_RELEASE libsodium.dll.a
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES lib)
+
+      file(GLOB _DLL
+           LIST_DIRECTORIES false
+           RELATIVE "${sodium_DIR}/bin"
+           "${sodium_DIR}/bin/libsodium*.dll")
+      find_library(sodium_DLL_DEBUG ${_DLL} libsodium
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES bin)
+      find_library(sodium_DLL_RELEASE ${_DLL} libsodium
+                   HINTS ${sodium_DIR}
+                   PATH_SUFFIXES bin)
+    endif()
+  else()
+    message(FATAL_ERROR "this platform is not supported by FindSodium.cmake")
+  endif()
+
+  # ############################################################################
+  # unsupported
+else()
+  message(FATAL_ERROR "this platform is not supported by FindSodium.cmake")
+endif()
+
+# ##############################################################################
+# common stuff
+
+# extract sodium version
+if(sodium_INCLUDE_DIR)
+  set(_VERSION_HEADER "${sodium_INCLUDE_DIR}/sodium/version.h")
+  if(EXISTS "${_VERSION_HEADER}")
+    file(READ "${_VERSION_HEADER}" _VERSION_HEADER_CONTENT)
+    string(
+      REGEX
+      REPLACE
+      ".*#define[ \t]*SODIUM_VERSION_STRING[ \t]*\"([^\n]*)\".*"
+        "\\1"
+        sodium_VERSION_STRING
+        "${_VERSION_HEADER_CONTENT}")
+    set(sodium_VERSION_STRING "${sodium_VERSION_STRING}")
+  endif()
+endif()
+
+# communicate results
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(sodium
+                                  REQUIRED_VARS
+                                  sodium_LIBRARY_RELEASE
+                                  sodium_LIBRARY_DEBUG
+                                  sodium_INCLUDE_DIR
+                                  VERSION_VAR
+                                  sodium_VERSION_STRING)
+
+# mark file paths as advanced
+mark_as_advanced(sodium_INCLUDE_DIR)
+mark_as_advanced(sodium_LIBRARY_DEBUG)
+mark_as_advanced(sodium_LIBRARY_RELEASE)
+if(WIN32)
+  mark_as_advanced(sodium_DLL_DEBUG)
+  mark_as_advanced(sodium_DLL_RELEASE)
+endif()
+
+# create imported target
+if(sodium_USE_STATIC_LIBS)
+  set(_LIB_TYPE STATIC)
+else()
+  set(_LIB_TYPE SHARED)
+endif()
+add_library(sodium ${_LIB_TYPE} IMPORTED)
+
+set_target_properties(sodium
+                      PROPERTIES INTERFACE_INCLUDE_DIRECTORIES
+                                 "${sodium_INCLUDE_DIR}"
+                                 IMPORTED_LINK_INTERFACE_LANGUAGES
+                                 "C")
+
+if(sodium_USE_STATIC_LIBS)
+  set_target_properties(sodium
+                        PROPERTIES INTERFACE_COMPILE_DEFINITIONS
+                                   "SODIUM_STATIC"
+                                   IMPORTED_LOCATION
+                                   "${sodium_LIBRARY_RELEASE}"
+                                   IMPORTED_LOCATION_DEBUG
+                                   "${sodium_LIBRARY_DEBUG}")
+else()
+  if(UNIX)
+    set_target_properties(sodium
+                          PROPERTIES IMPORTED_LOCATION
+                                     "${sodium_LIBRARY_RELEASE}"
+                                     IMPORTED_LOCATION_DEBUG
+                                     "${sodium_LIBRARY_DEBUG}")
+  elseif(WIN32)
+    set_target_properties(sodium
+                          PROPERTIES IMPORTED_IMPLIB
+                                     "${sodium_LIBRARY_RELEASE}"
+                                     IMPORTED_IMPLIB_DEBUG
+                                     "${sodium_LIBRARY_DEBUG}")
+    if(NOT (sodium_DLL_DEBUG MATCHES ".*-NOTFOUND"))
+      set_target_properties(sodium
+                            PROPERTIES IMPORTED_LOCATION_DEBUG
+                                       "${sodium_DLL_DEBUG}")
+    endif()
+    if(NOT (sodium_DLL_RELEASE MATCHES ".*-NOTFOUND"))
+      set_target_properties(sodium
+                            PROPERTIES IMPORTED_LOCATION_RELWITHDEBINFO
+                                       "${sodium_DLL_RELEASE}"
+                                       IMPORTED_LOCATION_MINSIZEREL
+                                       "${sodium_DLL_RELEASE}"
+                                       IMPORTED_LOCATION_RELEASE
+                                       "${sodium_DLL_RELEASE}")
+    endif()
+  endif()
+endif()

cmake/FindWinSock.cmake

@@ -0,0 +1,35 @@
+# Try to find WinSock library and include path.
+# Once done this will define
+#
+# WINSOCK_FOUND
+# WINSOCK_INCLUDE_DIR
+# WINSOCK_LIBRARIES
+
+find_path(WINSOCK_INCLUDE_DIR WinSock2.h)
+if(MSVC)
+  find_library(WINSOCK_LIBRARY mswsock.lib)
+  find_library(WINSOCK2_LIBRARY ws2_32.lib)
+  find_library(WINSOCK2_LIBRARY bcrypt.lib)
+else()
+  find_library(WINSOCK_LIBRARY mswsock)
+  find_library(WINSOCK2_LIBRARY ws2_32)
+  find_library(WINSOCK2_LIBRARY bcrypt)
+endif()
+
+# Handle the REQUIRED argument and set WINSOCK_FOUND
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(WinSock DEFAULT_MSG WINSOCK_LIBRARY WINSOCK2_LIBRARY WINSOCK_INCLUDE_DIR)
+
+mark_as_advanced(WINSOCK_INCLUDE_DIR)
+mark_as_advanced(WINSOCK_LIBRARY)
+mark_as_advanced(WINSOCK2_LIBRARY)
+
+if(WINSOCK_FOUND)
+  add_definitions(-DWINSOCK_SUPPORT)
+  set(WINSOCK_LIBRARIES ${WINSOCK_LIBRARY} ${WINSOCK2_LIBRARY})
+endif()
+
+if(MINGW)
+  set(CMAKE_C_STANDARD_LIBRARIES "${CMAKE_C_STANDARD_LIBRARIES} -lwsock32 -lws2_32 -lbcrypt")
+  set(CMAKE_CXX_STANDARD_LIBRARIES "${CMAKE_CXX_STANDARD_LIBRARIES} -lwsock32 -lws2_32 -lbcrypt")
+endif()

cmake/_FindOpus.cmake

@@ -0,0 +1,92 @@
+############################################################################
+# FindOpus.cmake
+# Copyright (C) 2014-2023  Belledonne Communications, Grenoble France
+#
+############################################################################
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License
+# as published by the Free Software Foundation; either version 2
+# of the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+#
+############################################################################
+#
+# Find the opus library.
+#
+# Targets
+# ^^^^^^^
+#
+# The following targets may be defined:
+#
+#  opus - If the opus library has been found
+#
+#
+# Result variables
+# ^^^^^^^^^^^^^^^^
+#
+# This module will set the following variables in your project:
+#
+#  Opus_FOUND - The opus library has been found
+#  Opus_TARGET - The name of the CMake target for the opus library
+#
+# This module may set the following variable:
+#
+#  Opus_USE_BUILD_INTERFACE - If the opus library is used from its build directory
+
+
+include(FindPackageHandleStandardArgs)
+
+set(_Opus_REQUIRED_VARS Opus_TARGET)
+set(_Opus_CACHE_VARS ${_Opus_REQUIRED_VARS})
+
+if(TARGET opus)
+
+	set(Opus_TARGET opus)
+	set(Opus_USE_BUILD_INTERFACE TRUE)
+
+else()
+
+	find_path(_Opus_INCLUDE_DIRS
+		NAMES opus/opus.h
+		PATH_SUFFIXES include
+	)
+
+	find_library(_Opus_LIBRARY NAMES opus)
+	if(_Opus_LIBRARY)
+		find_library(_m_LIBRARY NAMES m)
+	endif()
+
+	if(_Opus_INCLUDE_DIRS AND _Opus_LIBRARY)
+		add_library(opus UNKNOWN IMPORTED)
+		if(WIN32)
+			set_target_properties(opus PROPERTIES
+				INTERFACE_INCLUDE_DIRECTORIES "${_Opus_INCLUDE_DIRS}"
+				IMPORTED_IMPLIB "${_Opus_LIBRARY}"
+				IMPORTED_LINK_INTERFACE_LIBRARIES "${_m_LIBRARY}"
+			)
+		else()
+			set_target_properties(opus PROPERTIES
+				INTERFACE_INCLUDE_DIRECTORIES "${_Opus_INCLUDE_DIRS}"
+				IMPORTED_LOCATION "${_Opus_LIBRARY}"
+				IMPORTED_LINK_INTERFACE_LIBRARIES "${_m_LIBRARY}"
+			)
+		endif()
+
+		set(Opus_TARGET opus)
+	endif()
+
+endif()
+
+find_package_handle_standard_args(Opus
+	REQUIRED_VARS ${_Opus_REQUIRED_VARS}
+)
+mark_as_advanced(${_Opus_CACHE_VARS})

module/Base/AABB.cpp

@@ -4,6 +4,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 
 // ------------------------------------------------------------------------------------------------
 namespace SqMod {
@@ -300,6 +301,21 @@ String AABB::ToString() const
     return fmt::format("{},{},{},{},{},{}", min.x, min.y, min.z, max.x, max.y, max.z);
 }
 
+// ------------------------------------------------------------------------------------------------
+void AABB::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{min:{{x:{},y:{},z:{}}},max:{{x:{},y:{},z:{}}},",
+            min.x, min.y, min.z, max.x, max.y, max.z);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{min:[{},{},{}],max:[{},{},{}]}},",
+            min.x, min.y, min.z, max.x, max.y, max.z);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void AABB::SetStr(SQChar delim, StackStrF & values)
 {
@@ -793,6 +809,7 @@ void Register_AABB(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< AABB >, SQFloat, SQInteger, bool, std::nullptr_t, AABB >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &AABB::ToString)
+        .Func(_SC("_tojson"), &AABB::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< AABB >, SQFloat, SQInteger, bool, std::nullptr_t, AABB >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< AABB >, SQFloat, SQInteger, bool, std::nullptr_t, AABB >)

module/Base/AABB.hpp

@@ -304,6 +304,11 @@ struct AABB
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set the values extracted from the specified string using the specified delimiter.
     */

module/Base/Circle.cpp

@@ -3,6 +3,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -360,6 +361,19 @@ String Circle::ToString() const
     return fmt::format("{},{},{}", pos.x, pos.y, rad);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Circle::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{},r:{}}},", pos.x, pos.y, rad);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{}],", pos.x, pos.y, rad);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Circle::SetRadius(Value nr)
 {
@@ -552,6 +566,7 @@ void Register_Circle(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Circle >, SQFloat, SQInteger, bool, std::nullptr_t, Circle >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Circle::ToString)
+        .Func(_SC("_toJSON"), &Circle::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Circle >, SQFloat, SQInteger, bool, std::nullptr_t, Circle >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Circle >, SQFloat, SQInteger, bool, std::nullptr_t, Circle >)

module/Base/Circle.hpp

@@ -341,6 +341,11 @@ struct Circle
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set the specified radius.
     */

module/Base/Color3.cpp

@@ -4,6 +4,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -481,6 +482,19 @@ String Color3::ToString() const
     return fmt::format("{},{},{}", r, g, b);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Color3::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{r:{},g:{},b:{}}},", r, g, b);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{}],", r, g, b);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Color3::SetScalar(Value ns)
 {
@@ -741,6 +755,7 @@ void Register_Color3(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Color3::ToString)
+        .Func(_SC("_tojson"), &Color3::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Color3 >, SQFloat, SQInteger, bool, std::nullptr_t, Color3 >)

module/Base/Color3.hpp

@@ -405,6 +405,11 @@ struct Color3
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/Base/Color4.cpp

@@ -4,6 +4,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -506,6 +507,19 @@ String Color4::ToString() const
     return fmt::format("{},{},{},{}", r, g, b, a);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Color4::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{r:{},g:{},b:{},a:{}}},", r, g, b, a);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{},{}],", r, g, b, a);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Color4::SetScalar(Value ns)
 {
@@ -781,6 +795,7 @@ void Register_Color4(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Color4 >, SQFloat, SQInteger, bool, std::nullptr_t, Color4 >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Color4::ToString)
+        .Func(_SC("_tojson"), &Color4::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Color4 >, SQFloat, SQInteger, bool, std::nullptr_t, Color4 >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Color4 >, SQFloat, SQInteger, bool, std::nullptr_t, Color4 >)

module/Base/Color4.hpp

@@ -405,6 +405,11 @@ struct Color4
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/Base/Quaternion.cpp

@@ -5,6 +5,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -349,6 +350,19 @@ String Quaternion::ToString() const
     return fmt::format("{},{},{},{}", x, y, z, w);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Quaternion::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{},z:{},w:{}}},", x, y, z, w);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{},{}],", x, y, z, w);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Quaternion::SetScalar(Value ns)
 {
@@ -479,7 +493,11 @@ Quaternion Quaternion::Abs() const
 // ------------------------------------------------------------------------------------------------
 bool Quaternion::IsNaN() const
 {
+    #if defined (__MINGW32__) || defined (__MINGW64__)
+        return _isnanf(w) || _isnanf(x) || _isnanf(y) || _isnanf(z);
+    #else
         return isnanf(w) || isnanf(x) || isnanf(y) || isnanf(z);
+    #endif
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -775,6 +793,7 @@ void Register_Quaternion(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Quaternion >, SQFloat, SQInteger, bool, std::nullptr_t, Quaternion >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Quaternion::ToString)
+        .Func(_SC("_tojson"), &Quaternion::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Quaternion >, SQFloat, SQInteger, bool, std::nullptr_t, Quaternion >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Quaternion >, SQFloat, SQInteger, bool, std::nullptr_t, Quaternion >)

module/Base/Quaternion.hpp

@@ -296,6 +296,11 @@ struct Quaternion
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/Base/Shared.hpp

@@ -6,6 +6,9 @@
 // ------------------------------------------------------------------------------------------------
 namespace SqMod {
 
+// ------------------------------------------------------------------------------------------------
+struct CtxJSON;
+
 /* ------------------------------------------------------------------------------------------------
  * Helper constants used by the bas types.
 */

module/Base/Sphere.cpp

@@ -3,6 +3,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -360,6 +361,19 @@ String Sphere::ToString() const
     return fmt::format("{},{},{},{}", pos.x, pos.y, pos.z, rad);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Sphere::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{},z:{},r:{}}},", pos.x, pos.y, pos.z, rad);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{},{}],", pos.x, pos.y, pos.z, rad);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Sphere::SetRadius(Value nr)
 {
@@ -527,6 +541,7 @@ void Register_Sphere(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Sphere >, SQFloat, SQInteger, bool, std::nullptr_t, Sphere >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Sphere::ToString)
+        .Func(_SC("_tojson"), &Sphere::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Sphere >, SQFloat, SQInteger, bool, std::nullptr_t, Sphere >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Sphere >, SQFloat, SQInteger, bool, std::nullptr_t, Sphere >)

module/Base/Sphere.hpp

@@ -341,6 +341,11 @@ struct Sphere
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set the specified radius.
     */

module/Base/Vector2.cpp

@@ -4,6 +4,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -295,6 +296,19 @@ String Vector2::ToString() const
     return fmt::format("{},{}", x, y);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Vector2::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{}}},", x, y);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{}],", x, y);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Vector2::SetScalar(Value ns)
 {
@@ -428,6 +442,7 @@ void Register_Vector2(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Vector2 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector2 >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Vector2::ToString)
+        .Func(_SC("_tojson"), &Vector2::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Vector2 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector2 >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Vector2 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector2 >)

module/Base/Vector2.hpp

@@ -285,6 +285,11 @@ struct Vector2
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/Base/Vector2i.cpp

@@ -4,6 +4,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -441,6 +442,19 @@ String Vector2i::ToString() const
     return fmt::format("{},{}", x, y);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Vector2i::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{}}},", x, y);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{}],", x, y);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Vector2i::SetScalar(Value ns)
 {
@@ -574,6 +588,7 @@ void Register_Vector2i(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Vector2i >, SQFloat, SQInteger, bool, std::nullptr_t, Vector2i >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Vector2i::ToString)
+        .Func(_SC("_tojson"), &Vector2i::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Vector2i >, SQFloat, SQInteger, bool, std::nullptr_t, Vector2i >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Vector2i >, SQFloat, SQInteger, bool, std::nullptr_t, Vector2i >)

module/Base/Vector2i.hpp

@@ -390,6 +390,11 @@ struct Vector2i
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/Base/Vector3.cpp

@@ -5,6 +5,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -331,6 +332,19 @@ String Vector3::ToString() const
     return fmt::format("{},{},{}", x, y, z);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Vector3::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{},z:{}}},", x, y, z);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{}],", x, y, z);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Vector3::SetScalar(Value ns)
 {
@@ -460,7 +474,11 @@ Vector3 Vector3::Abs() const
 // ------------------------------------------------------------------------------------------------
 bool Vector3::IsNaN() const
 {
+    #if defined (__MINGW32__) || defined (__MINGW64__)
+        return _isnanf(x) || _isnanf(y) || _isnanf(z);
+    #else
     return isnanf(x) || isnanf(y) || isnanf(z);
+    #endif
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -696,6 +714,7 @@ void Register_Vector3(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Vector3 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector3 >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Vector3::ToString)
+        .Func(_SC("_tojson"), &Vector3::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Vector3 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector3 >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Vector3 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector3 >)

module/Base/Vector3.hpp

@@ -297,6 +297,11 @@ struct Vector3
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/Base/Vector4.cpp

@@ -5,6 +5,7 @@
 #include "Base/DynArg.hpp"
 #include "Core/Buffer.hpp"
 #include "Core/Utility.hpp"
+#include "Library/JSON.hpp"
 #include "Library/Numeric/Random.hpp"
 
 // ------------------------------------------------------------------------------------------------
@@ -344,6 +345,19 @@ String Vector4::ToString() const
     return fmt::format("{},{},{},{}", x, y, z, w);
 }
 
+// ------------------------------------------------------------------------------------------------
+void Vector4::ToJSON(CtxJSON & ctx) const
+{
+    if (ctx.mObjectOverArray)
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "{{x:{},y:{},z:{},w:{}}},", x, y, z, w);
+    }
+    else
+    {
+        fmt::format_to(std::back_inserter(ctx.mOutput), "[{},{},{},{}],", x, y, z, w);
+    }
+}
+
 // ------------------------------------------------------------------------------------------------
 void Vector4::SetScalar(Value ns)
 {
@@ -526,6 +540,7 @@ void Register_Vector4(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("cmp"), &SqDynArgFwd< SqDynArgCmpFn< Vector4 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector4 >)
         .SquirrelFunc(_SC("_typename"), &Typename::Fn)
         .Func(_SC("_tostring"), &Vector4::ToString)
+        .Func(_SC("_tojson"), &Vector4::ToJSON)
         // Meta-methods
         .SquirrelFunc(_SC("_add"), &SqDynArgFwd< SqDynArgAddFn< Vector4 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector4 >)
         .SquirrelFunc(_SC("_sub"), &SqDynArgFwd< SqDynArgSubFn< Vector4 >, SQFloat, SQInteger, bool, std::nullptr_t, Vector4 >)

module/Base/Vector4.hpp

@@ -295,6 +295,11 @@ struct Vector4
     */
     SQMOD_NODISCARD String ToString() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Used by the script engine to convert an instance of this type to a JSON string.
+    */
+    void ToJSON(CtxJSON & ctx) const;
+
     /* --------------------------------------------------------------------------------------------
      * Set all components to the specified scalar value.
     */

module/CMakeLists.txt

@@ -1,5 +1,7 @@
 # Create the Squirrel module
 add_library(SqModule MODULE SqBase.hpp Main.cpp
+    # SDK
+    SDK/sqmod.h
     # VCMP
     VCMP/vcmp.h
     VCMP/vcmp20.h
@@ -80,6 +82,7 @@ add_library(SqModule MODULE SqBase.hpp Main.cpp
     Library/Numeric.cpp Library/Numeric.hpp
     Library/Numeric/Math.cpp Library/Numeric/Math.hpp
     Library/Numeric/Random.cpp Library/Numeric/Random.hpp
+    Library/RegEx.cpp Library/RegEx.hpp
     Library/String.cpp Library/String.hpp
     Library/System.cpp Library/System.hpp
     Library/System/Dir.cpp Library/System/Dir.hpp
@@ -89,6 +92,7 @@ add_library(SqModule MODULE SqBase.hpp Main.cpp
     Library/Utils.cpp Library/Utils.hpp
     Library/Utils/Announce.cpp Library/Utils/Announce.hpp
     Library/Utils/String.cpp Library/Utils/String.hpp
+    Library/Utils/Template.cpp Library/Utils/Template.hpp
     Library/Utils/Vector.cpp Library/Utils/Vector.hpp
     Library/XML.cpp Library/XML.hpp
     Library/ZMQ.cpp Library/ZMQ.hpp
@@ -106,7 +110,6 @@ add_library(SqModule MODULE SqBase.hpp Main.cpp
     PocoLib/Crypto.cpp PocoLib/Crypto.hpp
     PocoLib/Data.cpp PocoLib/Data.hpp
     PocoLib/Net.cpp PocoLib/Net.hpp
-    PocoLib/RegEx.cpp PocoLib/RegEx.hpp
     PocoLib/Register.cpp PocoLib/Register.hpp
     PocoLib/Time.cpp PocoLib/Time.hpp
     PocoLib/Util.cpp PocoLib/Util.hpp
@@ -114,7 +117,10 @@ add_library(SqModule MODULE SqBase.hpp Main.cpp
     Core.cpp Core.hpp
     Logger.cpp Logger.hpp
     Register.cpp
+    Exports.cpp
 )
+# The module requires C++ 17
+set_property(TARGET SqModule PROPERTY CXX_STANDARD 17)
 # Various definitions required by the plug-in
 target_compile_definitions(SqModule PRIVATE SCRAT_USE_EXCEPTIONS=1)
 # SDK targeting
@@ -132,7 +138,7 @@ if(WIN32 OR MINGW)
     target_link_libraries(SqModule wsock32 ws2_32 shlwapi)
 endif()
 # Link to base libraries
-target_link_libraries(SqModule Squirrel fmt::fmt SimpleINI TinyDir xxHash ConcurrentQueue SAJSON CPR UTF8Lib PUGIXML CivetWeb maxminddb libzmq-static)
+target_link_libraries(SqModule Squirrel fmt::fmt SimpleINI TinyDir xxHash ConcurrentQueue SAJSON CPR UTF8Lib PUGIXML CivetWeb inja maxminddb libzmq-static)
 # Link to POCO libraries
 target_link_libraries(SqModule Poco::Foundation Poco::Crypto Poco::Data Poco::Net)
 # Does POCO have SQLite support?
@@ -171,6 +177,31 @@ if(POSTGRESQL_FOUND)
     # Inform the plug-in that it can make use of this library
     target_compile_definitions(SqModule PRIVATE SQMOD_POCO_HAS_POSTGRESQL=1)
 endif()
+# Is Discord support enabled?
+if(ENABLE_DISCORD)
+target_link_libraries(SqModule dpp)
+target_sources(SqModule PRIVATE
+    Library/Discord.cpp Library/Discord.hpp
+    Library/Discord/Application.hpp Library/Discord/Application.cpp
+    Library/Discord/Automod.hpp Library/Discord/Automod.cpp
+    Library/Discord/Channel.hpp Library/Discord/Channel.cpp
+    Library/Discord/Client.hpp Library/Discord/Client.cpp
+    Library/Discord/Cluster.hpp Library/Discord/Cluster.cpp
+    Library/Discord/Command.hpp Library/Discord/Command.cpp
+    Library/Discord/Constants.hpp Library/Discord/Constants.cpp
+    Library/Discord/Events.hpp Library/Discord/Events.cpp
+    Library/Discord/Guild.hpp Library/Discord/Guild.cpp
+    Library/Discord/Integration.hpp Library/Discord/Integration.cpp
+    Library/Discord/Message.hpp Library/Discord/Message.cpp
+    Library/Discord/Misc.hpp Library/Discord/Misc.cpp
+    Library/Discord/Presence.hpp Library/Discord/Presence.cpp
+    Library/Discord/Role.hpp Library/Discord/Role.cpp
+    Library/Discord/User.hpp Library/Discord/User.cpp
+    Library/Discord/Utilities.hpp Library/Discord/Utilities.cpp
+)
+# Inform the plug-in that discord is enabled
+target_compile_definitions(SqModule PRIVATE SQMOD_DISCORD=1)
+endif()
 # Determine if build mode
 if(${CMAKE_BUILD_TYPE} MATCHES "(Release)+")
     target_compile_definitions(SqModule PRIVATE NDEBUG=1)
@@ -201,10 +232,26 @@ else(WIN32)
 endif(WIN32)
 # Include current directory in the search path
 target_include_directories(SqModule PRIVATE ${CMAKE_CURRENT_LIST_DIR})
+target_include_directories(SqModule PRIVATE ${CMAKE_CURRENT_LIST_DIR}/SDK)
 target_include_directories(SqModule PRIVATE ${CMAKE_CURRENT_LIST_DIR}/VCMP)
 target_include_directories(SqModule PRIVATE ${CMAKE_CURRENT_LIST_DIR}/Sqrat)
+# Include PCRE directory in the header search path
+if (POCO_UNBUNDLED)
+    find_package(PCRE REQUIRED)
+    target_link_libraries(SqModule PRIVATE Pcre::Pcre)
+else()
+    # Get the foundation source folder path
+    get_target_property(POCO_FOUNDATION_SOURCE_DIR Foundation SOURCE_DIR)
+    target_include_directories(SqModule PRIVATE "${POCO_FOUNDATION_SOURCE_DIR}/src")
+endif()
 # Copy module into the plug-ins folder
 add_custom_command(TARGET SqModule POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different $<TARGET_FILE:SqModule> "${PROJECT_SOURCE_DIR}/bin/plugins")
+# Copy DPP into the bin folder
+if (ENABLE_DISCORD)
+    if (WIN32 OR MINGW)
+        add_custom_command(TARGET SqModule POST_BUILD COMMAND ${CMAKE_COMMAND} -E copy_if_different $<TARGET_FILE:dpp> "${PROJECT_SOURCE_DIR}/bin")
+    endif()
+endif()
 # Copy several dependent DLLs on windows to make distribution easier (used mainly by people that distribute builds)
 if(WIN32 AND MINGW AND COPY_DEPENDENCIES)
     get_filename_component(MINGW_BIN_PATH ${CMAKE_C_COMPILER} DIRECTORY REALPATH)
@@ -213,12 +260,12 @@ if(WIN32 AND MINGW AND COPY_DEPENDENCIES)
     endif()
     # Make sure the deps folder exists
     file(MAKE_DIRECTORY "${PROJECT_SOURCE_DIR}/bin/deps")
-    # Copy dependencies into the plug-ins folder (only so it can be distributed with the DLL)
+    # Copy dependencies into the deps folder (only so it can be distributed with the DLL)
     file(COPY "${MINGW_BIN_PATH}/zlib1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libpq.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libzstd.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libpsl-5.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
-    file(COPY "${MINGW_BIN_PATH}/libffi-7.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
+    file(COPY "${MINGW_BIN_PATH}/libffi-8.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libcurl-4.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libssh2-1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libidn2-0.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
@@ -236,17 +283,17 @@ if(WIN32 AND MINGW AND COPY_DEPENDENCIES)
     file(COPY "${MINGW_BIN_PATH}/libp11-kit-0.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libbrotlidec.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libbrotlicommon.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
-    file(COPY "${MINGW_BIN_PATH}/libunistring-2.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
+    file(COPY "${MINGW_BIN_PATH}/libunistring-5.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libnghttp2-14.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libwinpthread-1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     file(COPY "${MINGW_BIN_PATH}/libstdc++-6.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     if(CMAKE_SIZEOF_VOID_P EQUAL 8 AND NOT FORCE_32BIT_BIN)
         file(COPY "${MINGW_BIN_PATH}/libgcc_s_seh-1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
-        file(COPY "${MINGW_BIN_PATH}/libssl-1_1-x64.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
-        file(COPY "${MINGW_BIN_PATH}/libcrypto-1_1-x64.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
+        file(COPY "${MINGW_BIN_PATH}/libssl-3-x64.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
+        file(COPY "${MINGW_BIN_PATH}/libcrypto-3-x64.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     else()
-        file(COPY "${MINGW_BIN_PATH}/libssl-1_1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
-        file(COPY "${MINGW_BIN_PATH}/libcrypto-1_1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
+        file(COPY "${MINGW_BIN_PATH}/libssl-3.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
+        file(COPY "${MINGW_BIN_PATH}/libcrypto-3.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")
     endif()
     if(POCO_UNBUNDLED)
         file(COPY "${MINGW_BIN_PATH}/libexpat-1.dll" DESTINATION "${PROJECT_SOURCE_DIR}/bin/deps")

module/Core.cpp

@@ -49,6 +49,9 @@ extern void TerminateRoutines();
 extern void TerminateCommands();
 extern void TerminateSignals();
 extern void TerminateNet();
+#ifdef SQMOD_DISCORD
+    extern void TerminateDiscord();
+#endif
 extern void TerminatePocoNet();
 extern void TerminatePocoData();
 
@@ -161,6 +164,7 @@ Core::Core() noexcept
     , m_Scripts()
     , m_PendingScripts()
     , m_Options()
+    , m_ExtCommands{nullptr, nullptr, nullptr, nullptr}
     , m_Blips()
     , m_Checkpoints()
     , m_KeyBinds()
@@ -441,9 +445,9 @@ bool Core::Execute()
     m_LockPostLoadSignal = false;
     m_LockUnloadSignal = false;
 
-    //cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins to register their API");
+    cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins that the API is being registered");
     // Tell modules to do their monkey business
-    //_Func->SendPluginCommand(0xDEADBABE, "");
+    _Func->SendPluginCommand(SQMOD_LOAD_CMD, SQMOD_HOST_NAME);
 
     // Load pending scripts while we're in the bounds of the allowed recursiveness
     for (unsigned levels = 0; !m_PendingScripts.empty() && (levels < 8); ++levels)
@@ -511,9 +515,9 @@ void Core::Terminate(bool shutdown)
         // Clear the callbacks
         ResetSignalPair(mOnUnload);
 
-        //cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins to release their resources");
+        cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins to release their resources");
         // Tell modules to do their monkey business
-        //_Func->SendPluginCommand(0xDEADC0DE, "");
+        _Func->SendPluginCommand(SQMOD_TERMINATE_CMD, SQMOD_HOST_NAME);
     }
 
     cLogDbg(m_Verbosity >= 1, "Clearing the entity containers");
@@ -552,6 +556,11 @@ void Core::Terminate(bool shutdown)
     // Release network
     TerminateNet();
     cLogDbg(m_Verbosity >= 1, "Network terminated");
+    // Release DPP
+#ifdef SQMOD_DISCORD
+    TerminateDiscord();
+    cLogDbg(m_Verbosity >= 1, "Discord terminated");
+#endif
     // Release Poco statement results
     TerminatePocoNet();
     TerminatePocoData();
@@ -596,9 +605,9 @@ void Core::Terminate(bool shutdown)
         HSQUIRRELVM sq_vm = m_VM;
         m_VM = nullptr;
 
-        //cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins the virtual machine is closing");
+        cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins the virtual machine is closing");
         // Tell modules to do their monkey business
-        //_Func->SendPluginCommand(0xBAAAAAAD, "");
+        _Func->SendPluginCommand(SQMOD_CLOSING_CMD, SQMOD_HOST_NAME);
         // Release any callbacks from the logger
         Logger::Get().Release();
         cLogDbg(m_Verbosity >= 2, "Closing Virtual Machine");
@@ -629,9 +638,9 @@ void Core::Terminate(bool shutdown)
         // Destroy the VM context, if any
         delete ctx;
 
-        //cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins to release the virtual machine");
+        cLogDbg(m_Verbosity >= 1, "Signaling outside plug-ins the virtual machine was closed");
         // Tell modules to do their monkey business
-        //_Func->SendPluginCommand(0xDEADBEAF, "");
+        _Func->SendPluginCommand(SQMOD_RELEASED_CMD, SQMOD_HOST_NAME);
     }
 
     OutputMessage("Squirrel plug-in was successfully terminated");
@@ -904,6 +913,81 @@ String Core::FetchCodeLine(const SQChar * src, SQInteger line, bool trim)
     return script->FetchLine(line, trim);
 }
 
+// ------------------------------------------------------------------------------------------------
+int32_t Core::RegisterExtCommand(ExtPluginCommand_t fn)
+{
+    ExtPluginCommand_t * slot = nullptr;
+    // Find a free slot or matching function pointer in the pool
+    for (size_t i = 0; i < m_ExtCommands.max_size(); ++i)
+    {
+        // Is this slot available and are we still looking for a slot?
+        if (m_ExtCommands[i] == nullptr && slot == nullptr)
+        {
+            slot = &m_ExtCommands[i]; // Found a slot
+        }
+        // We keep looking for duplicates even if we found the slot
+        else if (m_ExtCommands[i] == fn)
+        {
+            return 0; // Already registered
+        }
+    }
+    // Do we have a free slot?
+    if (slot != nullptr)
+    {
+        *slot = fn; // Use this slot
+        return 1; // Successfully registered
+    }
+    // No space in the pool
+    return -1;
+}
+
+// ------------------------------------------------------------------------------------------------
+int32_t Core::UnregisterExtCommand(ExtPluginCommand_t fn)
+{
+    // Find the matching function pointer
+    for (size_t i = 0; i < m_ExtCommands.max_size(); ++i)
+    {
+        // Is this the same pointer?
+        if (m_ExtCommands[i] != nullptr && m_ExtCommands[i] == fn)
+        {
+            // Forget about it
+            m_ExtCommands[i] = nullptr;
+            return 1; // Successfully unregistered
+        }
+    }
+    // No space
+    return -1;
+}
+
+// ------------------------------------------------------------------------------------------------
+int32_t Core::SendExtCommand(int32_t target, int32_t req, int32_t tag, const uint8_t * data, size_t size)
+{
+    int32_t count = 0;
+    // Send the command to all registered function pointers
+    for (size_t i = 0; i < m_ExtCommands.max_size(); ++i)
+    {
+        if (m_ExtCommands[i] != nullptr)
+        {
+            const int32_t r = m_ExtCommands[i](target, req, tag, data, size);
+            // Command processed
+            ++count;
+            // Command failed?
+            if (r < 0)
+            {
+                LogErr("External command failed (%i): target(%i), req(%i), tag(%i), data(%p), size (%zu)",
+                        r, target, req, tag, data, size);
+            }
+            // Command consumed?
+            else if (r > 0)
+            {
+                break; // This function pointer requested exclusive access over this command
+            }
+        }
+    }
+    // Return how many function pointers received this command
+    return count;
+}
+
 // ------------------------------------------------------------------------------------------------
 bool Core::DoScripts(Scripts::iterator itr, Scripts::iterator end)
 {
@@ -2371,6 +2455,8 @@ void Core::InitEvents()
     InitSignalPair(mOnServerOption, m_Events, "ServerOption");
     InitSignalPair(mOnScriptReload, m_Events, "ScriptReload");
     InitSignalPair(mOnScriptLoaded, m_Events, "ScriptLoaded");
+    InitSignalPair(mOnExtCommandReply, m_Events, "ExtCommandReply");
+    InitSignalPair(mOnExtCommandEvent, m_Events, "ExtCommandEvent");
 }
 // ------------------------------------------------------------------------------------------------
 void Core::DropEvents()
@@ -2516,6 +2602,8 @@ void Core::DropEvents()
     ResetSignalPair(mOnServerOption);
     ResetSignalPair(mOnScriptReload);
     ResetSignalPair(mOnScriptLoaded);
+    ResetSignalPair(mOnExtCommandReply);
+    ResetSignalPair(mOnExtCommandEvent);
     m_Events.Release();
 }
 
@@ -2861,6 +2949,31 @@ static LightObj & SqGetClientDataBuffer()
     return Core::Get().GetClientDataBuffer();
 }
 
+// ------------------------------------------------------------------------------------------------
+static SQInteger SqSendExtCommand(int32_t target, int32_t req, int32_t tag, SqBuffer & buffer)
+{
+    // Default to an empty/null buffer
+    const uint8_t * data = nullptr;
+    size_t size = 0;
+    // Does the buffer actually point to anything?
+    if (buffer.GetRef())
+    {
+        data = buffer.GetRef()->Begin< uint8_t >();
+        size = buffer.GetRef()->PositionAs< size_t >();
+    }
+    // Forward the request
+    return Core::Get().SendExtCommand(target, req, tag, data, size);
+}
+
+// ------------------------------------------------------------------------------------------------
+static SQInteger SqSendExtCommandStr(int32_t target, int32_t req, int32_t tag, StackStrF & str)
+{
+    // Forward the request
+    return Core::Get().SendExtCommand(target, req, tag,
+                                        reinterpret_cast< const uint8_t * >(str.mPtr),
+                                        str.mLen <= 0 ? 0 : static_cast< size_t >(str.mLen));
+}
+
 // ================================================================================================
 void Register_Core(HSQUIRRELVM vm)
 {
@@ -2910,6 +3023,8 @@ void Register_Core(HSQUIRRELVM vm)
         .Func(_SC("DestroyPickup"), &SqDelPickup)
         .Func(_SC("DestroyVehicle"), &SqDelVehicle)
         .Func(_SC("ClientDataBuffer"), &SqGetClientDataBuffer)
+        .Func(_SC("SendExtCommand"), &SqSendExtCommand)
+        .FmtFunc(_SC("SendExtCommandStr"), &SqSendExtCommandStr)
         .Func(_SC("OnPreLoad"), &SqGetPreLoadEvent)
         .Func(_SC("OnPostLoad"), &SqGetPostLoadEvent)
         .Func(_SC("OnUnload"), &SqGetUnloadEvent)

module/Core.hpp

@@ -9,6 +9,9 @@
 // ------------------------------------------------------------------------------------------------
 #include <unordered_map>
 
+// ------------------------------------------------------------------------------------------------
+#include "SDK/sqmod.h"
+
 // ------------------------------------------------------------------------------------------------
 namespace SqMod {
 
@@ -56,6 +59,8 @@ public:
     typedef std::vector< ScriptSrc >                Scripts; // List of loaded scripts.
     // --------------------------------------------------------------------------------------------
     typedef std::unordered_map< String, String >    Options; // List of custom options.
+    // --------------------------------------------------------------------------------------------
+    typedef std::array< ExtPluginCommand_t, 4 > ExtCommands; // 4 external command parsers should be enough.
 
 private:
 
@@ -68,6 +73,7 @@ private:
     Scripts                         m_Scripts; // Loaded scripts objects.
     Scripts                         m_PendingScripts; // Pending scripts objects.
     Options                         m_Options; // Custom configuration options.
+    ExtCommands                     m_ExtCommands; // External command parsers pointers.
 
     // --------------------------------------------------------------------------------------------
     Blips                           m_Blips; // Blips pool.
@@ -399,6 +405,23 @@ public:
     */
     SQMOD_NODISCARD String FetchCodeLine(const SQChar * src, SQInteger line, bool trim = true);
 
+    /* --------------------------------------------------------------------------------------------
+     * Register a pointer to a function used to processes commands from script.
+     * Returns -1 it failed (no free slot), 0 if it was already registered and 1 if it succeeded.
+    */
+    int32_t RegisterExtCommand(ExtPluginCommand_t fn);
+
+    /* --------------------------------------------------------------------------------------------
+     * Remove a pointer to a function used to processes commands from script.
+     * Returns -1 it failed (no free slot) and 1 if it succeeded.
+    */
+    int32_t UnregisterExtCommand(ExtPluginCommand_t fn);
+
+    /* --------------------------------------------------------------------------------------------
+     * Send a command to all functions currently registered to receive them.
+    */
+    int32_t SendExtCommand(int32_t target, int32_t req, int32_t tag, const uint8_t * data, size_t size);
+
 protected:
 
     /* --------------------------------------------------------------------------------------------
@@ -710,6 +733,16 @@ public:
     */
     void EmitClientScriptData(int32_t player_id, const uint8_t * data, size_t size);
 
+    /* --------------------------------------------------------------------------------------------
+     * Send a response to the script that may have resulted from a previous command.
+    */
+    void EmitExtCommandReply(int32_t sender, int32_t tag, const uint8_t * data, size_t size);
+
+    /* --------------------------------------------------------------------------------------------
+     * Forward an event to the script from an external plug-in.
+    */
+    void EmitExtCommandEvent(int32_t sender, int32_t tag, const uint8_t * data, size_t size);
+
 public:
 
     /* --------------------------------------------------------------------------------------------
@@ -864,6 +897,8 @@ public:
     SignalPair  mOnServerOption{};
     SignalPair  mOnScriptReload{};
     SignalPair  mOnScriptLoaded{};
+    SignalPair  mOnExtCommandReply{};
+    SignalPair  mOnExtCommandEvent{};
 };
 
 /* ------------------------------------------------------------------------------------------------
@@ -993,28 +1028,93 @@ template < class F > inline void ForeachActivePickup(F f) { ForeachActiveEntity(
 template < class F > inline void ForeachActivePlayer(F f) { ForeachActiveEntity(Core::Get().GetPlayers(), std::forward< F >(f)); }
 template < class F > inline void ForeachActiveVehicle(F f) { ForeachActiveEntity(Core::Get().GetVehicles(), std::forward< F >(f)); }
 
+/* ------------------------------------------------------------------------------------------------
+ * Process the identifier of each player slot.
+*/
+template < class F > inline void ForeachPlayerSlot(F f) {
+    for (int32_t i = 0, n = static_cast< int32_t >(_Func->GetMaxPlayers()); i < n; ++i) {
+        f(i);
+    }
+}
+/* ------------------------------------------------------------------------------------------------
+ * Process the identifier of each player slot and count processed players.
+*/
+template < class F > SQMOD_NODISCARD inline int32_t ForeachPlayerSlotCount(F f) {
+    int32_t c = 0;
+    for (int32_t i = 0, n = static_cast< int32_t >(_Func->GetMaxPlayers()); i < n; ++i) {
+        if (f(i)) ++c;
+    }
+    return c;
+}
+/* ------------------------------------------------------------------------------------------------
+ * Process the identifier of each player slot until a certain criteria is met.
+*/
+template < class F > SQMOD_NODISCARD inline int32_t ForeachPlayerSlotUntil(F f) {
+    for (int32_t i = 0, n = static_cast< int32_t >(_Func->GetMaxPlayers()); i < n; ++i) {
+        if (f(i)) return i;
+    }
+    return -1;
+}
+
 /* ------------------------------------------------------------------------------------------------
  * Process the identifier of each connected player.
 */
 template < class F > inline void ForeachConnectedPlayer(F f) {
-    for (int32_t i = 0, n = _Func->GetMaxPlayers(); i < n; ++i) f(i);
+    for (int32_t i = 0, n = static_cast< int32_t >(_Func->GetMaxPlayers()); i < n; ++i) {
+        if (_Func->IsPlayerConnected(i) != 0) f(i);
+    }
 }
 /* ------------------------------------------------------------------------------------------------
  * Process the identifier of each connected player and count processed players.
 */
 template < class F > SQMOD_NODISCARD inline int32_t ForeachConnectedPlayerCount(F f) {
     int32_t c = 0;
-    for (int32_t i = 0, n = _Func->GetMaxPlayers(); i < n; ++i)
-        if (f(i)) ++c;
+    for (int32_t i = 0, n = static_cast< int32_t >(_Func->GetMaxPlayers()); i < n; ++i) {
+        if (_Func->IsPlayerConnected(i) != 0 && f(i)) ++c;
+    }
     return c;
 }
 /* ------------------------------------------------------------------------------------------------
  * Process the identifier of each connected player until a certain criteria is met.
 */
 template < class F > SQMOD_NODISCARD inline int32_t ForeachConnectedPlayerUntil(F f) {
-    for (int32_t i = 0, n = _Func->GetMaxPlayers(); i < n; ++i)
-        if (f(i)) return i;
+    for (int32_t i = 0, n = static_cast< int32_t >(_Func->GetMaxPlayers()); i < n; ++i) {
+        if (_Func->IsPlayerConnected(i) != 0 && f(i)) return i;
+    }
     return -1;
 }
 
+/* ------------------------------------------------------------------------------------------------
+ * Used to select entity instances based on type.
+*/
+template < class > struct EntityInstSelect;
+// Specialization for blips.
+template < > struct EntityInstSelect< CBlip > {
+    static BlipInst & Get(int32_t id) { return Core::Get().GetBlip(id); }
+};
+// Specialization for checkpoints.
+template < > struct EntityInstSelect< CCheckpoint > {
+    static CheckpointInst & Get(int32_t id) { return Core::Get().GetCheckpoint(id); }
+};
+// Specialization for keybinds.
+template < > struct EntityInstSelect< CKeyBind > {
+    static KeyBindInst & Get(int32_t id) { return Core::Get().GetKeyBind(id); }
+};
+// Specialization for objects.
+template < > struct EntityInstSelect< CObject > {
+    static ObjectInst & Get(int32_t id) { return Core::Get().GetObj(id); }
+};
+// Specialization for pickups.
+template < > struct EntityInstSelect< CPickup > {
+    static PickupInst & Get(int32_t id) { return Core::Get().GetPickup(id); }
+};
+// Specialization for players.
+template < > struct EntityInstSelect< CPlayer > {
+    static PlayerInst & Get(int32_t id) { return Core::Get().GetPlayer(id); }
+};
+// Specialization for vehicles.
+template < > struct EntityInstSelect< CVehicle > {
+    static VehicleInst & Get(int32_t id) { return Core::Get().GetVehicle(id); }
+};
+
 } // Namespace:: SqMod

module/Core/Areas.cpp

@@ -161,7 +161,7 @@ bool Area::IsInside(float x, float y) const
 
 // ------------------------------------------------------------------------------------------------
 AreaManager::AreaManager(size_t sz) noexcept
-    : m_Queue(), m_ProcList(), m_Grid{}
+    : m_Queue(), m_ProcList(), m_Grid{}, m_Cells{}
 {
     // Negative half grid size (left)
     int l = (-GRIDH * CELLD);
@@ -171,21 +171,30 @@ AreaManager::AreaManager(size_t sz) noexcept
     int r = (l + CELLD);
     // Positive half grid size (top)
     int t = abs(l);
+    // Row/Column of the grid
+    int row = 0, col = 0;
     // Initialize the grid cells
     for (auto & a : m_Grid)
     {
+        // Reset the column
+        col = 0;
+        // Process row
         for (auto & c : a)
         {
+            auto & cx = m_Cells[row][col];
             // Grab a reference to the cell
             // Configure the range of the cell
-            c.mL = static_cast< float >(l);
-            c.mB = static_cast< float >(b);
-            c.mR = static_cast< float >(r);
-            c.mT = static_cast< float >(t);
+            c.mL = cx.mL = static_cast< float >(l);
+            c.mB = cx.mB = static_cast< float >(b);
+            c.mR = cx.mR = static_cast< float >(r);
+            c.mT = cx.mT = static_cast< float >(t);
             // Reserve area memory if requested
             c.mAreas.reserve(sz);
             // Reset the locks on this area
             c.mLocks = 0;
+            // Set the row and column
+            c.mRow = row;
+            c.mCol = col++;
             // Advance the left side
             l = r;
             // Advance the right side
@@ -203,6 +212,8 @@ AreaManager::AreaManager(size_t sz) noexcept
                 t -= CELLD;
             }
         }
+        // Advance row
+        ++row;
     }
     // Reserve some space in the queue
     m_Queue.reserve(128);
@@ -340,6 +351,21 @@ void AreaManager::RemoveArea(Area & a)
 // ------------------------------------------------------------------------------------------------
 Vector2i AreaManager::LocateCell(float x, float y)
 {
+    for (int r = 0; r < GRIDN; ++r)
+    {
+        for (int c = 0; c < GRIDN; ++c)
+        {
+            auto & bb = m_Cells[r][c];
+            // Check whether point is inside cell
+            if (bb.mL <= x && bb.mR >= x && bb.mB <= y && bb.mT >= y)
+            {
+                return {r, c}; // Is inside
+            }
+        }
+    }
+    // Point is out of bounds
+    return {NOCELL, NOCELL};
+/*
     // Transform the world coordinates into a cell coordinates
     // and cast to integral after rounding the value
     int xc = static_cast< int >(std::round(x / CELLD));
@@ -364,6 +390,7 @@ Vector2i AreaManager::LocateCell(float x, float y)
     }
     // Return the identified cell row and column
     return {GRIDH+xc, GRIDH-yc};
+*/
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -469,6 +496,7 @@ void Register_Areas(HSQUIRRELVM vm)
         .Func(_SC("TestEx"), &Area::TestEx)
         .Func(_SC("Manage"), &Area::Manage)
         .Func(_SC("Unmanage"), &Area::Unmanage)
+        .CbFunc(_SC("EachCell"), &Area::EachCell)
         // Static Functions
         .StaticFunc(_SC("GlobalTest"), &Areas_TestPoint)
         .StaticFunc(_SC("GlobalTestEx"), &Areas_TestPointEx)

module/Core/Areas.hpp

@@ -29,15 +29,25 @@ struct AreaCell
     Areas   mAreas; // Areas that intersect with the cell.
     // --------------------------------------------------------------------------------------------
     int     mLocks; // The amount of locks on the cell.
+    int     mRow; // Row location in the grid.
+    int     mCol; // Column location in the grid.
 
     /* --------------------------------------------------------------------------------------------
      * Default constructor.
     */
     AreaCell()
-        : mL(0), mB(0), mR(0), mT(0), mAreas(0), mLocks(0)
+        : mL(0), mB(0), mR(0), mT(0), mAreas(0), mLocks(0), mRow(0), mCol(0)
     {
         //...
     }
+
+    /* --------------------------------------------------------------------------------------------
+     * Show information (mainly for debug purposes).
+    */
+    String Dump()
+    {
+        return fmt::format("({} : {} | {} : {}) {} : {}", mL, mB, mR, mT, mRow, mCol);
+    }
 };
 
 /* ------------------------------------------------------------------------------------------------
@@ -454,6 +464,17 @@ struct Area
     */
     bool Unmanage();
 
+    /* --------------------------------------------------------------------------------------------
+     * Iterate all managed cells through a functor.
+    */
+    void EachCell(Function & fn) const
+    {
+        for (const auto & e : mCells)
+        {
+            fn.Execute(static_cast< SQInteger >(e->mRow), static_cast< SQInteger >(e->mCol));
+        }
+    }
+
 protected:
 
     /* --------------------------------------------------------------------------------------------
@@ -610,7 +631,10 @@ private:
     ProcList    m_ProcList; // Actions ready to be completed.
     // --------------------------------------------------------------------------------------------
     AreaCell    m_Grid[GRIDN][GRIDN]; // A grid of area lists.
-
+    // --------------------------------------------------------------------------------------------
+    struct {
+        float   mL, mB, mR, mT;
+    } m_Cells[GRIDN][GRIDN];
 public:
 
     /* --------------------------------------------------------------------------------------------
@@ -664,7 +688,7 @@ public:
     /* --------------------------------------------------------------------------------------------
      * Clear all cell lists and release any script references.
     */
-    static Vector2i LocateCell(float x, float y);
+    Vector2i LocateCell(float x, float y);
 
     /* --------------------------------------------------------------------------------------------
      * Test a point to see whether it intersects with any areas
@@ -679,7 +703,7 @@ public:
             return; // Not our problem
         }
         // Retrieve a reference to the identified cell
-        AreaCell & c = m_Grid[cc.y][cc.x];
+        AreaCell & c = m_Grid[cc.x][cc.y];
         // Is this cell empty?
         if (c.mAreas.empty())
         {

module/Core/Buffer.hpp

@@ -285,13 +285,13 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Make sure that the specified element is withing buffer range
         else if (n > (m_Cap - sizeof(T)))
         {
-            ThrowMemExcept(fmt::runtime("Element of size (%d) at index (%u) is out of buffer capacity (%u)"),
+            ThrowMemExcept(fmt::runtime("Element of size ({}) at index ({}) is out of buffer capacity ({})"),
                             sizeof(T), n, m_Cap);
         }
         // Return the requested element
@@ -306,13 +306,13 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Make sure that the specified element is withing buffer range
         else if (n > (m_Cap - sizeof(T)))
         {
-            ThrowMemExcept(fmt::runtime("Element of size (%d) at index (%u) is out of buffer capacity (%u)"),
+            ThrowMemExcept(fmt::runtime("Element of size ({}) at index ({}) is out of buffer capacity ({})"),
                             sizeof(T), n, m_Cap);
         }
         // Return the requested element
@@ -359,7 +359,7 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -374,7 +374,7 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -389,7 +389,7 @@ public:
         // Make sure that the buffer can host at least two elements of this type
         if (m_Cap < (sizeof(T) * 2))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host two elements of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host two elements of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -404,7 +404,7 @@ public:
         // Make sure that the buffer can host at least two elements of this type
         if (m_Cap < (sizeof(T) * 2))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host two elements of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host two elements of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -419,7 +419,7 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -434,7 +434,7 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -449,7 +449,7 @@ public:
         // Make sure that the buffer can host at least two elements of this type
         if (m_Cap < (sizeof(T) * 2))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host two elements of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host two elements of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -464,7 +464,7 @@ public:
         // Make sure that the buffer can host at least two elements of this type
         if (m_Cap < (sizeof(T) * 2))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host two elements of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host two elements of size ({})"),
                             m_Cap, sizeof(T));
         }
         // Return the requested element
@@ -540,7 +540,7 @@ public:
         // Make sure that at least one element of this type exists after the cursor
         if ((m_Cur + sizeof(T)) > m_Cap)
         {
-            ThrowMemExcept(fmt::runtime("Element of size (%u) starting at (%u) exceeds buffer capacity (%u)"),
+            ThrowMemExcept(fmt::runtime("Element of size ({}) starting at ({}) exceeds buffer capacity ({})"),
                             sizeof(T), m_Cur, m_Cap);
         }
         // Return the requested element
@@ -555,7 +555,7 @@ public:
         // Make sure that at least one element of this type exists after the cursor
         if ((m_Cur + sizeof(T)) > m_Cap)
         {
-            ThrowMemExcept(fmt::runtime("Element of size (%u) starting at (%u) exceeds buffer capacity (%u)"),
+            ThrowMemExcept(fmt::runtime("Element of size ({}) starting at ({}) exceeds buffer capacity ({})"),
                             sizeof(T), m_Cur, m_Cap);
         }
         // Return the requested element
@@ -570,7 +570,7 @@ public:
         // The cursor must have at least one element of this type behind
         if (m_Cur < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Cannot read an element of size (%u) before the cursor at (%u)"),
+            ThrowMemExcept(fmt::runtime("Cannot read an element of size ({}) before the cursor at ({})"),
                             sizeof(T), m_Cur);
         }
         // Return the requested element
@@ -585,7 +585,7 @@ public:
         // The cursor must have at least one element of this type behind
         if (m_Cur < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Cannot read an element of size (%u) before the cursor at (%u)"),
+            ThrowMemExcept(fmt::runtime("Cannot read an element of size ({}) before the cursor at ({})"),
                             sizeof(T), m_Cur);
         }
         // Return the requested element
@@ -600,13 +600,13 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // There must be buffer left for at least two elements of this type after the cursor
         else if ((m_Cur + (sizeof(T) * 2)) > m_Cap)
         {
-            ThrowMemExcept(fmt::runtime("Element of size (%u) starting at (%u) exceeds buffer capacity (%u)"),
+            ThrowMemExcept(fmt::runtime("Element of size ({}) starting at ({}) exceeds buffer capacity ({})"),
                             sizeof(T), m_Cur + sizeof(T), m_Cap);
         }
         // Return the requested element
@@ -621,13 +621,13 @@ public:
         // Make sure that the buffer can host at least one element of this type
         if (m_Cap < sizeof(T))
         {
-            ThrowMemExcept(fmt::runtime("Buffer capacity of (%u) is unable to host an element of size (%u)"),
+            ThrowMemExcept(fmt::runtime("Buffer capacity of ({}) is unable to host an element of size ({})"),
                             m_Cap, sizeof(T));
         }
         // There must be buffer left for at least two elements of this type after the cursor
         else if ((m_Cur + (sizeof(T) * 2)) > m_Cap)
         {
-            ThrowMemExcept(fmt::runtime("Element of size (%u) starting at (%u) exceeds buffer capacity (%u)"),
+            ThrowMemExcept(fmt::runtime("Element of size ({}) starting at ({}) exceeds buffer capacity ({})"),
                             sizeof(T), m_Cur + sizeof(T), m_Cap);
         }
         // Return the requested element
@@ -708,7 +708,7 @@ public:
         // See if the requested capacity doesn't exceed the limit
         if (n > Max< T >())
         {
-            ThrowMemExcept(fmt::runtime("Requested buffer of (%u) elements exceeds the (%u) limit"), n, Max< T >());
+            ThrowMemExcept(fmt::runtime("Requested buffer of ({}) elements exceeds the ({}) limit"), n, Max< T >());
         }
         // Is there an existing buffer?
         else if (n && !m_Cap)

module/Core/Common.cpp

@@ -248,6 +248,14 @@ String SqTypeName(HSQUIRRELVM vm, SQInteger idx)
     return String(val.mPtr, static_cast< size_t >(val.mLen));
 }
 
+// ------------------------------------------------------------------------------------------------
+String SqTypeName(HSQUIRRELVM vm, LightObj & obj)
+{
+    const StackGuard sg(vm);
+    sq_pushobject(vm, obj);
+    return SqTypeName(vm, -1);
+}
+
 // ------------------------------------------------------------------------------------------------
 LightObj BufferToStrObj(const Buffer & b)
 {

module/Core/Common.hpp

@@ -173,7 +173,7 @@ void OutputError(const char * msg, ...);
 /* ------------------------------------------------------------------------------------------------
  * Generate a formatted string and throw it as a Sqrat exception.
 */
-template < class... Args > void SqThrowF(Args &&... args)
+template < class... Args > inline void SqThrowF(Args &&... args)
 {
     throw Sqrat::Exception(fmt::format(std::forward< Args >(args)...));
 }
@@ -181,7 +181,7 @@ template < class... Args > void SqThrowF(Args &&... args)
 /* ------------------------------------------------------------------------------------------------
  * Generate a formatted string and throw it as a squirrel exception.
 */
-template < class... Args > SQRESULT SqThrowErrorF(HSQUIRRELVM vm, Args &&... args)
+template < class... Args > inline SQRESULT SqThrowErrorF(HSQUIRRELVM vm, Args &&... args)
 {
     String msg;
     try
@@ -241,6 +241,11 @@ SQMOD_NODISCARD const SQChar * SqTypeName(SQObjectType type);
 */
 SQMOD_NODISCARD String SqTypeName(HSQUIRRELVM vm, SQInteger idx);
 
+/* ------------------------------------------------------------------------------------------------
+ * Retrieve the string representation of a certain type from a script object.
+*/
+SQMOD_NODISCARD String SqTypeName(HSQUIRRELVM vm, LightObj & obj);
+
 /* ------------------------------------------------------------------------------------------------
  * Create a script string instance from a buffer.
 */

module/Core/Events.inc

@@ -347,7 +347,7 @@ void Core::EmitIncomingConnection(char * player_name, size_t name_buffer_size, c
         // Release any stored buffer information
         m_IncomingNameBuffer = nullptr;
         m_IncomingNameCapacity = 0;
-        // We catched the exception so we can release the assigned buffer
+        // We caught the exception so we can release the assigned buffer
         throw; // re-throw it
     }
     // Release any stored buffer information
@@ -392,7 +392,8 @@ void Core::EmitPlayerRequestSpawn(int32_t player_id)
 #ifdef VCMP_ENABLE_OFFICIAL
     if (IsOfficial())
     {
-        ExecuteLegacyEvent(m_VM, _SC("onPlayerRequestSpawn"), _player.mLgObj);
+        LightObj r = EvaluateLegacyEvent(m_VM, _SC("onPlayerRequestSpawn"), _player.mLgObj);
+        SetState(r.IsNull() ? 1 : r.Cast< int32_t >());
     }
 #endif
 }
@@ -2245,6 +2246,44 @@ void Core::EmitClientScriptData(int32_t player_id, const uint8_t * data, size_t
     m_ClientData.Release();
 }
 
+// ------------------------------------------------------------------------------------------------
+void Core::EmitExtCommandReply(int32_t sender, int32_t tag, const uint8_t * data, size_t size)
+{
+    SQMOD_CO_EV_TRACEBACK("[TRACE<] Core::ExtCommandReply(%i, %i, %p, %zu)", sender, tag, data, size)
+    // Don't even bother if there's no one listening
+    if (!(mOnExtCommandReply.first->IsEmpty()))
+    {
+        // Allocate a buffer with the received size
+        Buffer b(static_cast< Buffer::SzType >(size));
+        // Replicate the data to the allocated buffer
+        b.Write(0, reinterpret_cast< Buffer::ConstPtr >(data), static_cast< Buffer::SzType >(size));
+        // Prepare an object for the obtained buffer
+        LightObj obj(SqTypeIdentity< SqBuffer >{}, m_VM, std::move(b));
+        // Forward the event call
+        (*mOnExtCommandReply.first)(sender, tag, obj, size);
+    }
+    SQMOD_CO_EV_TRACEBACK("[TRACE>] Core::ExtCommandReply")
+}
+
+// ------------------------------------------------------------------------------------------------
+void Core::EmitExtCommandEvent(int32_t sender, int32_t tag, const uint8_t * data, size_t size)
+{
+    SQMOD_CO_EV_TRACEBACK("[TRACE<] Core::ExtCommandEvent(%i, %i, %p, %zu)", sender, tag, data, size)
+    // Don't even bother if there's no one listening
+    if (!(mOnExtCommandEvent.first->IsEmpty()))
+    {
+        // Allocate a buffer with the received size
+        Buffer b(static_cast< Buffer::SzType >(size));
+        // Replicate the data to the allocated buffer
+        b.Write(0, reinterpret_cast< Buffer::ConstPtr >(data), static_cast< Buffer::SzType >(size));
+        // Prepare an object for the obtained buffer
+        LightObj obj(SqTypeIdentity< SqBuffer >{}, m_VM, std::move(b));
+        // Forward the event call
+        (*mOnExtCommandEvent.first)(sender, tag, obj, size);
+    }
+    SQMOD_CO_EV_TRACEBACK("[TRACE>] Core::ExtCommandEvent")
+}
+
 #undef NULL_SQOBJ_ // don't need this anymore
 
 } // Namespace:: SqMod

module/Core/Routine.cpp

@@ -549,6 +549,8 @@ void Register_Routine(HSQUIRRELVM vm)
         .Prop(_SC("Inactive"), &Routine::GetInactive)
         .Prop(_SC("Persistent"), &Routine::GetPersistent, &Routine::SetPersistent)
         .Prop(_SC("Yields"), &Routine::GetYields, &Routine::SetYields)
+        .Prop(_SC("Elapsed"), &Routine::GetElapsed)
+        .Prop(_SC("Remaining"), &Routine::GetRemaining)
         .Prop(_SC("Terminated"), &Routine::GetTerminated)
         .Prop(_SC("Arguments"), &Routine::GetArguments)
         // Member Methods

module/Core/Routine.hpp

@@ -408,7 +408,6 @@ public:
         }
         // Unable to find such routine
         STHROWF("Unable to fetch a routine with tag ({}). No such routine", tag.mPtr);
-        SQ_UNREACHABLE
         // Should not reach this point but if it did, we have to return something
 #ifdef __clang__
     #pragma clang diagnostic push
@@ -418,6 +417,7 @@ public:
 #ifdef __clang__
     #pragma clang diagnostic pop
 #endif
+        SQ_UNREACHABLE
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -804,6 +804,32 @@ public:
         return (m_Slot == SQMOD_MAX_ROUTINES);
     }
 
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the time elapsed since the routine was created or invoked.
+    */
+    SQMOD_NODISCARD SQInteger GetElapsed() const
+    {
+        if (m_Slot >= SQMOD_MAX_ROUTINES)
+        {
+            STHROWF("This instance does not reference a valid routine");
+        }
+        // We know it's valid so let's return it
+        return s_Instances[m_Slot].mInterval - s_Intervals[m_Slot];
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the time remaining until the routine is invoked.
+    */
+    SQMOD_NODISCARD SQInteger GetRemaining() const
+    {
+        if (m_Slot >= SQMOD_MAX_ROUTINES)
+        {
+            STHROWF("This instance does not reference a valid routine");
+        }
+        // We know it's valid so let's return it
+        return s_Intervals[m_Slot];
+    }
+
     /* --------------------------------------------------------------------------------------------
      * Retrieve the number of arguments to be forwarded.
     */

module/Core/Signal.cpp

@@ -1723,6 +1723,7 @@ void Register_Signal(HSQUIRRELVM vm)
         .SquirrelFunc(_SC("Eliminate"), &Signal::SqEliminate)
         .SquirrelFunc(_SC("EliminateThis"), &Signal::SqEliminateThis)
         .SquirrelFunc(_SC("EliminateFunc"), &Signal::SqEliminateFunc)
+        .SquirrelFunc(_SC("Broadcast"), &Signal::SqEmit)
         .SquirrelFunc(_SC("Emit"), &Signal::SqEmit)
         .SquirrelFunc(_SC("Query"), &Signal::SqQuery)
         .SquirrelFunc(_SC("Consume"), &Signal::SqConsume)

module/Core/Tasks.cpp

@@ -328,17 +328,40 @@ SQInteger Tasks::Find(int32_t id, int32_t type, SQInteger & pos, HSQUIRRELVM vm)
 {
     // Grab the top of the stack
     const SQInteger top = sq_gettop(vm);
-    // Was there a callback specified?
+    // Was there a callback or tag specified?
     if (top <= 1)
     {
-        return sq_throwerror(vm, "Missing task callback");
+        return sq_throwerror(vm, "Missing task callback or tag");
     }
-
     SQRESULT res = SQ_OK;
-    // Grab the hash of the callback object
-    const SQHash chash = sq_gethash(vm, 2);
+    // Fetch the task identifier type
+    const SQObjectType ot = sq_gettype(vm, 2);
+    // Are we looking for a task with a specific tag?
+    if (ot == OT_STRING)
+    {
+        // Attempt to retrieve the value from the stack as a string
+        StackStrF tag(vm, 2);
+        // Have we failed to retrieve the string?
+        if (SQ_FAILED(tag.Proc(true)))
+        {
+            return tag.mRes; // Propagate the error!
+        }
+        // Attempt to find the requested task
+        for (const auto & t : s_Tasks)
+        {
+            if (t.mEntity == id && t.mType == type && t.mTag.compare(0, String::npos, tag.mPtr) == 0)
+            {
+                pos = static_cast< SQInteger >(&t - s_Tasks); // Store the index of this element
+            }
+        }
+    }
+    // Validate the callback type
+    else if (ot != OT_CLOSURE && ot != OT_NATIVECLOSURE)
+    {
+        return sq_throwerror(vm, "Invalid callback type");
+    }
     // Should we include the iterations in the criteria?
-    if (top > 3)
+    else if (top > 3)
     {
         SQInteger intrv = 0;
         // Grab the interval from the stack
@@ -348,6 +371,8 @@ SQInteger Tasks::Find(int32_t id, int32_t type, SQInteger & pos, HSQUIRRELVM vm)
         {
             return res; // Propagate the error
         }
+        // Grab the hash of the callback object
+        const SQHash chash = sq_gethash(vm, 2);
         // Attempt to find the requested task
         for (const auto & t : s_Tasks)
         {
@@ -375,6 +400,8 @@ SQInteger Tasks::Find(int32_t id, int32_t type, SQInteger & pos, HSQUIRRELVM vm)
         {
             return res; // Propagate the error
         }
+        // Grab the hash of the callback object
+        const SQHash chash = sq_gethash(vm, 2);
         // Cast iterations to the right type
         const Iterator itr = ConvTo< Iterator >::From(sqitr);
         // Attempt to find the requested task
@@ -388,6 +415,8 @@ SQInteger Tasks::Find(int32_t id, int32_t type, SQInteger & pos, HSQUIRRELVM vm)
     }
     else
     {
+        // Grab the hash of the callback object
+        const SQHash chash = sq_gethash(vm, 2);
         // Attempt to find the requested task
         for (const auto & t : s_Tasks)
         {
@@ -416,7 +445,7 @@ SQInteger Tasks::Remove(int32_t id, int32_t type, HSQUIRRELVM vm)
     // Did we find anything?
     else if (pos < 0)
     {
-        return sq_throwerror(vm, "Unable to locate such task");
+        sq_pushbool(vm, SQFalse); // Unable to locate such task
     }
     else
     {
@@ -424,9 +453,11 @@ SQInteger Tasks::Remove(int32_t id, int32_t type, HSQUIRRELVM vm)
         s_Tasks[pos].Terminate();
         // Reset the timer
         s_Intervals[pos] = 0;
+        // A task was successfully removed
+        sq_pushbool(vm, SQTrue);
     }
-    // Specify that we don't return anything
-    return 0;
+    // Specify that we return a value
+    return 1;
 }
 
 // ------------------------------------------------------------------------------------------------

module/Core/ThreadPool.cpp

@@ -103,7 +103,7 @@ void ThreadPool::Terminate(bool SQ_UNUSED_ARG(shutdown))
         // Is the item valid?
         if (item)
         {
-            item->OnCompleted(); // Allow the item to finish itself
+            [[maybe_unused]] auto _ = item->OnCompleted(true); // Allow the item to finish itself
         }
         // Item processed
         item.reset();
@@ -125,7 +125,15 @@ void ThreadPool::Process()
             // Is the item valid?
             if (item)
             {
-                item->OnCompleted(); // Allow the item to finish itself
+                try {
+                    // Allow the item to finish itself
+                    if (item->OnCompleted(false))
+                    {
+                        Enqueue(std::move(item)); // Queue again
+                    }
+                } catch (const std::exception & e) {
+                    LogErr("Exception occured in %s completion stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+                }
             }
         }
     }
@@ -147,7 +155,11 @@ void ThreadPool::WorkerProc()
             // Is there an item that requested to try again?
             if (item)
             {
+                try {
                     item->OnAborted(true); // NOLINT(bugprone-use-after-move) There's an `if` condition above idiot!
+                } catch (const std::exception & e) {
+                    LogErr("Exception occured in %s cancelation stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+                }
             }
             // Exit the loop
             break;
@@ -173,15 +185,30 @@ void ThreadPool::WorkerProc()
             // Is there an item to be processed?
             if (item)
             {
+                try {
                     item->OnAborted(false); // It should mark itself as aborted somehow!
+                } catch (const std::exception & e) {
+                    LogErr("Exception occured in %s forced cancelation stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+                }
             }
             // Exit the loop
             break;
         }
+        bool r;
+        // Attempt preparation
+        try {
+            r = item->OnPrepare();
+        } catch (const std::exception & e) {
+            LogErr("Exception occured in %s preparation stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+        }
         // Perform the task
-        if (item->OnPrepare())
+        if (r)
         {
+            try {
                 retry = item->OnProcess();
+            } catch (const std::exception & e) {
+                LogErr("Exception occured in %s processing stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+            }
         }
         // The task was performed
         if (!retry)

module/Core/ThreadPool.hpp

@@ -55,6 +55,16 @@ struct ThreadPoolItem
     */
     ThreadPoolItem & operator = (ThreadPoolItem && o) = delete;
 
+    /* --------------------------------------------------------------------------------------------
+     * Provide a name to what type of task this is. Mainly for debugging purposes.
+    */
+    SQMOD_NODISCARD virtual const char * TypeName() noexcept { return "worker item"; }
+
+    /* --------------------------------------------------------------------------------------------
+     * Provide unique information that may help identify the task. Mainly for debugging purposes.
+    */
+    SQMOD_NODISCARD virtual const char * IdentifiableInfo() noexcept { return ""; }
+
     /* --------------------------------------------------------------------------------------------
      * Invoked in worker thread by the thread pool after obtaining the task from the queue.
      * Must return true to indicate that the task can be performed. False indicates failure.
@@ -69,8 +79,10 @@ struct ThreadPoolItem
 
     /* --------------------------------------------------------------------------------------------
      * Invoked in main thread by the thread pool after the task was completed.
+     * If it returns true then it will be put back into the queue to be processed again.
+     * If the boolean parameter is true then the thread-pool is in the process of shutting down.
     */
-    virtual void OnCompleted() { }
+    SQMOD_NODISCARD virtual bool OnCompleted(bool SQ_UNUSED_ARG(stop)) { return false; }
 
     /* --------------------------------------------------------------------------------------------
      * Called in worker by the thread pool to let the task know that it will be aborted.
@@ -98,13 +110,13 @@ private:
      * Destructor.
     */
     ~ThreadPool();
-
+public:
+    // --------------------------------------------------------------------------------------------
+    using Item = std::unique_ptr< ThreadPoolItem >; // Owning pointer of an item.
 private:
 
     // --------------------------------------------------------------------------------------------
     using Pool = std::vector< std::thread >; // Worker container.
-    using Item = std::unique_ptr< ThreadPoolItem >; // Owning pointer of an item.
-    // --------------------------------------------------------------------------------------------
     using Finished = moodycamel::ConcurrentQueue< Item >; // Finished items.
 
     // --------------------------------------------------------------------------------------------
@@ -171,9 +183,25 @@ public:
     void Process();
 
     /* --------------------------------------------------------------------------------------------
-     * Queue an item to be processed.
+     * Queue an item to be processed. Will take ownership of the given pointer!
     */
     void Enqueue(ThreadPoolItem * item)
+    {
+        Enqueue(Item{item});
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Queue an item to be processed. Will take ownership of the given pointer!
+    */
+    template < class T > void CastEnqueue(std::unique_ptr< T > && item)
+    {
+        Enqueue(Item{std::forward< std::unique_ptr< T > >(item)});
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Queue an item to be processed. Will take ownership of the given pointer!
+    */
+    void Enqueue(Item && item)
     {
         // Only queue valid items
         if (!item || !m_Running) return;
@@ -183,7 +211,7 @@ public:
             // Acquire a lock on the mutex
             std::unique_lock< std::mutex > lock(m_Mutex);
             // Push the item in the queue
-            m_Queue.push(Item(item));
+            m_Queue.push(std::forward< Item >(item));
             // Release the mutex before notifying
             lock.unlock();
             // Notify one thread that there's work
@@ -191,16 +219,32 @@ public:
         }
         else
         {
+            bool r;
+            // Attempt preparation
+            try {
+                r = item->OnPrepare();
+            } catch (const std::exception & e) {
+                LogErr("Exception occured in %s preparation stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+            }
             // Perform the task in-place
-            if (item->OnPrepare())
+            if (r)
             {
-                if (item->OnProcess())
+                try {
+                    r = item->OnProcess();
+                } catch (const std::exception & e) {
+                    LogErr("Exception occured in %s processing stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
+                }
+                if (r)
                 {
+                    try {
                         item->OnAborted(true); // Not accepted in single thread
+                    } catch (const std::exception & e) {
+                        LogErr("Exception occured in %s cancelation stage [%s] for [%s]", item->TypeName(), e.what(), item->IdentifiableInfo());
                     }
                 }
-            // Item was finished in main thread
-            item->OnCompleted();
+            }
+            // Task is completed in processing stage
+            m_Finished.enqueue(std::forward< Item >(item));
         }
     }
 
@@ -211,7 +255,6 @@ public:
     {
         return m_Threads.size();
     }
-
 };
 
 } // Namespace:: SqMod

module/Core/VecMap.hpp

@@ -251,6 +251,20 @@ template < class Key, class T, class Pred = std::equal_to< Key > > struct VecMap
         return m_Storage.back().second;
     }
 
+    /* --------------------------------------------------------------------------------------------
+     * Retrieves a reference to the front of the container.
+     * Available for internal use only.
+    */
+    reference front() { return m_Storage.front(); }
+    const_reference front() const { return m_Storage.front(); }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieves a reference to the back of the container.
+     * Available for internal use only.
+    */
+    reference back() { return m_Storage.back(); }
+    const_reference back() const { return m_Storage.back(); }
+
 private:
 
     /* --------------------------------------------------------------------------------------------

module/Entity/Checkpoint.cpp

@@ -468,6 +468,16 @@ void CCheckpoint::SetColorA(int32_t a) const
     // Perform the requested operation
     _Func->SetCheckPointColour(m_ID, r, g, b, a);
 }
+#ifdef VCMP_ENABLE_OFFICIAL
+// ------------------------------------------------------------------------------------------------
+LightObj & CCheckpoint::GetLegacyObject() const
+{
+    // Validate the managed identifier
+    Validate();
+    // Return the requested information
+    return Core::Get().GetCheckpoint(m_ID).mLgObj;
+}
+#endif
 
 // ------------------------------------------------------------------------------------------------
 static LightObj & Checkpoint_CreateEx1a(int32_t world, bool sphere, float x, float y, float z,
@@ -517,6 +527,9 @@ void Register_CCheckpoint(HSQUIRRELVM vm)
         .Prop(_SC("Tag"), &CCheckpoint::GetTag, &CCheckpoint::SetTag)
         .Prop(_SC("Data"), &CCheckpoint::GetData, &CCheckpoint::SetData)
         .Prop(_SC("Active"), &CCheckpoint::IsActive)
+#ifdef VCMP_ENABLE_OFFICIAL
+        .Prop(_SC("Legacy"), &CCheckpoint::GetLegacyObject)
+#endif
         // Core Methods
         .FmtFunc(_SC("SetTag"), &CCheckpoint::ApplyTag)
         .Func(_SC("CustomEvent"), &CCheckpoint::CustomEvent)

module/Entity/Checkpoint.hpp

@@ -320,6 +320,12 @@ public:
      * Modify the alpha transparency of the managed checkpoint entity.
     */
     void SetColorA(int32_t a) const;
+#ifdef VCMP_ENABLE_OFFICIAL
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve legacy object instance for this entity.
+    */
+    LightObj & GetLegacyObject() const;
+#endif
 };
 
 } // Namespace:: SqMod

module/Entity/Object.cpp

@@ -833,6 +833,16 @@ void CObject::RotateByEulerZ(float z) const
     // Perform the requested operation
     _Func->RotateObjectByEuler(m_ID, 0.0f, 0.0f, z, mRotateByEulerDuration);
 }
+#ifdef VCMP_ENABLE_OFFICIAL
+// ------------------------------------------------------------------------------------------------
+LightObj & CObject::GetLegacyObject() const
+{
+    // Validate the managed identifier
+    Validate();
+    // Return the requested information
+    return Core::Get().GetObj(m_ID).mLgObj;
+}
+#endif
 
 // ------------------------------------------------------------------------------------------------
 static LightObj & Object_CreateEx1a(int32_t model, int32_t world, float x, float y, float z,
@@ -883,6 +893,9 @@ void Register_CObject(HSQUIRRELVM vm)
         .Prop(_SC("Tag"), &CObject::GetTag, &CObject::SetTag)
         .Prop(_SC("Data"), &CObject::GetData, &CObject::SetData)
         .Prop(_SC("Active"), &CObject::IsActive)
+#ifdef VCMP_ENABLE_OFFICIAL
+        .Prop(_SC("Legacy"), &CObject::GetLegacyObject)
+#endif
         // Core Methods
         .FmtFunc(_SC("SetTag"), &CObject::ApplyTag)
         .Func(_SC("CustomEvent"), &CObject::CustomEvent)

module/Entity/Object.hpp

@@ -499,6 +499,12 @@ public:
      * Modify the rotation on the z axis of the managed object entity.
     */
     void RotateByEulerZ(float z) const;
+#ifdef VCMP_ENABLE_OFFICIAL
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve legacy object instance for this entity.
+    */
+    LightObj & GetLegacyObject() const;
+#endif
 };
 
 } // Namespace:: SqMod

module/Entity/Pickup.cpp

@@ -449,6 +449,16 @@ void CPickup::SetPositionZ(float z) const
     // Perform the requested operation
     _Func->SetPickupPosition(m_ID, z, y, z);
 }
+#ifdef VCMP_ENABLE_OFFICIAL
+// ------------------------------------------------------------------------------------------------
+LightObj & CPickup::GetLegacyObject() const
+{
+    // Validate the managed identifier
+    Validate();
+    // Return the requested information
+    return Core::Get().GetPickup(m_ID).mLgObj;
+}
+#endif
 
 // ------------------------------------------------------------------------------------------------
 static LightObj & Pickup_CreateEx1a(int32_t model, int32_t world, int32_t quantity,
@@ -496,6 +506,9 @@ void Register_CPickup(HSQUIRRELVM vm)
         .Prop(_SC("Tag"), &CPickup::GetTag, &CPickup::SetTag)
         .Prop(_SC("Data"), &CPickup::GetData, &CPickup::SetData)
         .Prop(_SC("Active"), &CPickup::IsActive)
+#ifdef VCMP_ENABLE_OFFICIAL
+        .Prop(_SC("Legacy"), &CPickup::GetLegacyObject)
+#endif
         // Core Methods
         .FmtFunc(_SC("SetTag"), &CPickup::ApplyTag)
         .Func(_SC("CustomEvent"), &CPickup::CustomEvent)

module/Entity/Pickup.hpp

@@ -298,6 +298,12 @@ public:
      * Modify the position on the z axis of the managed pickup entity.
     */
     void SetPositionZ(float z) const;
+#ifdef VCMP_ENABLE_OFFICIAL
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve legacy object instance for this entity.
+    */
+    LightObj & GetLegacyObject() const;
+#endif
 };
 
 } // Namespace:: SqMod

module/Entity/Player.cpp

@@ -2593,7 +2593,16 @@ SQInteger CPlayer::AnnounceEx(HSQUIRRELVM vm)
     // This function does not return a value
     return 0;
 }
-
+#ifdef VCMP_ENABLE_OFFICIAL
+// ------------------------------------------------------------------------------------------------
+LightObj & CPlayer::GetLegacyObject() const
+{
+    // Validate the managed identifier
+    Validate();
+    // Return the requested information
+    return Core::Get().GetPlayer(m_ID).mLgObj;
+}
+#endif
 // ------------------------------------------------------------------------------------------------
 SQInteger Player_FindAuto(HSQUIRRELVM vm)
 {
@@ -2793,6 +2802,9 @@ void Register_CPlayer(HSQUIRRELVM vm)
         .Prop(_SC("Tag"), &CPlayer::GetTag, &CPlayer::SetTag)
         .Prop(_SC("Data"), &CPlayer::GetData, &CPlayer::SetData)
         .Prop(_SC("Active"), &CPlayer::IsActive)
+#ifdef VCMP_ENABLE_OFFICIAL
+        .Prop(_SC("Legacy"), &CPlayer::GetLegacyObject)
+#endif
         // Core Methods
         .FmtFunc(_SC("SetTag"), &CPlayer::ApplyTag)
         .Func(_SC("CustomEvent"), &CPlayer::CustomEvent)

module/Entity/Player.hpp

@@ -1101,6 +1101,12 @@ public:
      * Send a formatted announcement message to the managed player entity.
     */
     static SQInteger AnnounceEx(HSQUIRRELVM vm);
+#ifdef VCMP_ENABLE_OFFICIAL
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve legacy object instance for this entity.
+    */
+    LightObj & GetLegacyObject() const;
+#endif
 };
 
 } // Namespace:: SqMod

module/Entity/Vehicle.cpp

@@ -2015,6 +2015,16 @@ void CVehicle::SetRelativeTurnSpeedZ(float z) const
     // Perform the requested operation
     _Func->SetVehicleTurnSpeed(m_ID, z, y, z, static_cast< uint8_t >(false), static_cast< uint8_t >(true));
 }
+#ifdef VCMP_ENABLE_OFFICIAL
+// ------------------------------------------------------------------------------------------------
+LightObj & CVehicle::GetLegacyObject() const
+{
+    // Validate the managed identifier
+    Validate();
+    // Return the requested information
+    return Core::Get().GetVehicle(m_ID).mLgObj;
+}
+#endif
 
 // ------------------------------------------------------------------------------------------------
 static LightObj & Vehicle_CreateEx1a(int32_t model, int32_t world, float x, float y, float z, float angle,
@@ -2061,6 +2071,9 @@ void Register_CVehicle(HSQUIRRELVM vm)
         .Prop(_SC("ID"), &CVehicle::GetID)
         .Prop(_SC("Tag"), &CVehicle::GetTag, &CVehicle::SetTag)
         .Prop(_SC("Data"), &CVehicle::GetData, &CVehicle::SetData)
+#ifdef VCMP_ENABLE_OFFICIAL
+        .Prop(_SC("Legacy"), &CVehicle::GetLegacyObject)
+#endif
         .Prop(_SC("Active"), &CVehicle::IsActive)
         // Core Methods
         .FmtFunc(_SC("SetTag"), &CVehicle::ApplyTag)

module/Entity/Vehicle.hpp

@@ -942,6 +942,12 @@ public:
      * Modify the relative turn velocity on the z axis of the managed vehicle entity.
     */
     void SetRelativeTurnSpeedZ(float z) const;
+#ifdef VCMP_ENABLE_OFFICIAL
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve legacy object instance for this entity.
+    */
+    LightObj & GetLegacyObject() const;
+#endif
 };
 
 } // Namespace:: SqMod

module/Exports.cpp

@@ -0,0 +1,73 @@
+// ------------------------------------------------------------------------------------------------
+#include "Core.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <cstring>
+
+// ------------------------------------------------------------------------------------------------
+#include <sqmod.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+static int32_t RegisterCommandFn(ExtPluginCommand_t fn)
+{
+    return Core::Get().RegisterExtCommand(fn);
+}
+
+// ------------------------------------------------------------------------------------------------
+static int32_t UnregisterCommandFn(ExtPluginCommand_t fn)
+{
+    return Core::Get().UnregisterExtCommand(fn);
+}
+
+// ------------------------------------------------------------------------------------------------
+static int32_t SendCommandFn(int32_t target, int32_t req, int32_t tag, const uint8_t * data, size_t size)
+{
+    return Core::Get().SendExtCommand(target, req, tag, data, size);
+}
+
+// ------------------------------------------------------------------------------------------------
+static int32_t SendCommandReplyFn(int32_t sender, int32_t tag, const uint8_t * data, size_t size)
+{
+    // Mark the initialization as successful by default
+    const CoreState cs(SQMOD_SUCCESS);
+    // Forward the call to the script callbacks
+    Core::Get().EmitExtCommandReply(sender, tag, data, size);
+    // Return the last known plug-in state
+    return Core::Get().GetState();
+}
+
+// ------------------------------------------------------------------------------------------------
+static int32_t SendCommandEventFn(int32_t sender, int32_t tag, const uint8_t * data, size_t size)
+{
+    // Mark the initialization as successful by default
+    const CoreState cs(SQMOD_SUCCESS);
+    // Forward the call to the script callbacks
+    Core::Get().EmitExtCommandEvent(sender, tag, data, size);
+    // Return the last known plug-in state
+    return Core::Get().GetState();
+}
+
+// ------------------------------------------------------------------------------------------------
+static const SQ_MOD_EXPORTS g_SqModExports{
+    sizeof(SQ_MOD_EXPORTS),
+    &RegisterCommandFn,
+    &UnregisterCommandFn,
+    &SendCommandFn,
+    &SendCommandReplyFn,
+    &SendCommandEventFn
+};
+
+// The server needs a pointer to a pointer, and a persistent one
+static const SQ_MOD_EXPORTS * g_SqModExportsPtr = &g_SqModExports;
+
+// ------------------------------------------------------------------------------------------------
+void InitExports()
+{
+    // Tell the server about the pointer to the exports structure
+    _Func->ExportFunctions(_Info->pluginId, reinterpret_cast< const void ** >(&g_SqModExportsPtr), sizeof(HSQ_MOD_EXPORTS));
+}
+
+} // Namespace:: SqMod

module/Library/CURL.cpp

@@ -19,6 +19,19 @@ SQMOD_DECL_TYPENAME(SqCpProxies, _SC("SqCprProxies"))
 SQMOD_DECL_TYPENAME(SqCpRedirect, _SC("SqCprRedirect"))
 SQMOD_DECL_TYPENAME(SqCpSession, _SC("SqCprSession"))
 
+// ------------------------------------------------------------------------------------------------
+struct CurlInit
+{
+    CurlInit()
+    {
+        curl_global_init(CURL_GLOBAL_ALL);
+    }
+    ~CurlInit()
+    {
+        curl_global_cleanup();
+    }
+};
+
 /* ------------------------------------------------------------------------------------------------
  * Common session action implementation.
 */
@@ -47,9 +60,11 @@ struct CpBaseAction : public ThreadPoolItem
     ~CpBaseAction() override = default;
 
     /* --------------------------------------------------------------------------------------------
-     * Task completed callback.
+     * Invoked in main thread by the thread pool after the task was completed.
+     * If it returns true then it will be put back into the queue to be processed again.
+     * If the boolean parameter is trye then the thread-pool is in the process of shutting down.
     */
-    void OnCompleted() override
+    SQMOD_NODISCARD bool OnCompleted(bool SQ_UNUSED_ARG(stop)) override
     {
         // Is there a callback?
         if (!mCallback.IsNull())
@@ -58,6 +73,8 @@ struct CpBaseAction : public ThreadPoolItem
         }
         // Unlock the session
         mInstance->mPending = nullptr;
+        // Don't re-queue
+        return false;
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -654,13 +671,11 @@ void Register_CURL(HSQUIRRELVM vm)
         .Func(_SC("SetTimeout"), &CpSession::SetTimeout_)
         .Func(_SC("SetConnectTimeout"), &CpSession::SetConnectTimeout_)
         .FmtFunc(_SC("SetAuth"), &CpSession::SetAuth_)
-        .FmtFunc(_SC("SetDigest"), &CpSession::SetDigest_)
         .FmtFunc(_SC("SetUserAgent"), &CpSession::SetUserAgent_)
         .Func(_SC("SetPayload"), &CpSession::SetPayload_)
         .Func(_SC("YieldPayload"), &CpSession::YieldPayload)
         .Func(_SC("SetProxies"), &CpSession::SetProxies_)
         .Func(_SC("YieldProxies"), &CpSession::YieldProxies)
-        .FmtFunc(_SC("SetNTLM"), &CpSession::SetNTLM_)
         .Func(_SC("SetRedirect"), &CpSession::SetRedirect_)
         .Func(_SC("SetCookies"), &CpSession::SetCookies_)
         .FmtFunc(_SC("SetBody"), &CpSession::SetBody_)

module/Library/CURL.hpp

@@ -538,7 +538,7 @@ struct CpCookies : public cpr::Cookies
     */
     SQMOD_NODISCARD SQInteger Size() const
     {
-        return static_cast< SQInteger >(cpr::Cookies::map_.size());
+        return static_cast< SQInteger >(cpr::Cookies::cookies_.size());
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -546,7 +546,7 @@ struct CpCookies : public cpr::Cookies
     */
     SQMOD_NODISCARD bool Empty() const
     {
-        return cpr::Cookies::map_.empty();
+        return cpr::Cookies::cookies_.empty();
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -554,7 +554,7 @@ struct CpCookies : public cpr::Cookies
     */
     void Clear()
     {
-        cpr::Cookies::map_.clear();
+        cpr::Cookies::cookies_.clear();
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -562,7 +562,12 @@ struct CpCookies : public cpr::Cookies
     */
     SQMOD_NODISCARD SQInteger Count(StackStrF & key) const
     {
-        return static_cast< SQInteger >(cpr::Cookies::map_.count(key.ToStr()));
+      SQInteger cnt = 0;
+      for (const auto & c : cpr::Cookies::cookies_)
+      {
+        if (c.GetName().compare(0, static_cast<size_t>(key.mLen), key.mPtr) == 0) ++cnt;
+      }
+      return cnt;
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -570,14 +575,14 @@ struct CpCookies : public cpr::Cookies
     */
     bool Erase(StackStrF & key)
     {
-        auto itr = cpr::Cookies::map_.find(key.ToStr());
-        // Does it exist?
-        if (itr == cpr::Cookies::map_.end())
-        {
-            return false; // Nope
-        }
-        // Erase it
-        cpr::Cookies::map_.erase(itr);
+        // auto itr = cpr::Cookies::cookies_.find(key.ToStr());
+        // // Does it exist?
+        // if (itr == cpr::Cookies::cookies_.end())
+        // {
+        //     return false; // Nope
+        // }
+        // // Erase it
+        // cpr::Cookies::cookies_.erase(itr);
         // Erased
         return true;
     }
@@ -587,7 +592,7 @@ struct CpCookies : public cpr::Cookies
     */
     SQMOD_NODISCARD bool Has(StackStrF & key) const
     {
-        return cpr::Cookies::map_.find(key.ToStr()) != cpr::Cookies::map_.end();
+        return false;//cpr::Cookies::cookies_.find(key.ToStr()) != cpr::Cookies::cookies_.end()
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -595,14 +600,15 @@ struct CpCookies : public cpr::Cookies
     */
     SQMOD_NODISCARD std::string & Get(StackStrF & key)
     {
-        auto itr = cpr::Cookies::map_.find(key.ToStr());
-        // Does it exist?
-        if (itr == cpr::Cookies::map_.end())
-        {
-            STHROWF("No cookie named: %s", key.mPtr);
-        }
+        // auto itr = cpr::Cookies::cookies_.find(key.ToStr());
+        // // Does it exist?
+        // if (itr == cpr::Cookies::cookies_.end())
+        // {
+        //     STHROWF("No cookie named: %s", key.mPtr);
+        // }
+        static std::string s;
         // Return it
-        return itr->second;
+        return s;// itr->second;
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -610,7 +616,7 @@ struct CpCookies : public cpr::Cookies
     */
     void Set(StackStrF & key, StackStrF & val)
     {
-        cpr::Cookies::map_[key.ToStr()] = val.ToStr();
+        //cpr::Cookies::cookies_[key.ToStr()] = val.ToStr();
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -618,9 +624,9 @@ struct CpCookies : public cpr::Cookies
     */
     void Each(Function & fn) const
     {
-        for (const auto & p : cpr::Cookies::map_)
+        for (const auto & c : cpr::Cookies::cookies_)
         {
-            fn.Execute(p.first, p.second);
+            fn.Execute(c);
         }
     }
 
@@ -629,9 +635,9 @@ struct CpCookies : public cpr::Cookies
     */
     void While(Function & fn) const
     {
-        for (const auto & p : cpr::Cookies::map_)
+        for (const auto & c : cpr::Cookies::cookies_)
         {
-            auto ret = fn.Eval(p.first, p.second);
+            auto ret = fn.Eval(c);
             // (null || true) == continue & false == break
             if (!ret.IsNull() || !ret.Cast< bool >())
             {
@@ -863,7 +869,7 @@ struct CpResponse : public cpr::Response
             STHROWF("Invalid response instance");
         }
         // Retrieve the info vector
-        auto vec = cpr::Response::GetCertInfo();
+        auto vec = cpr::Response::GetCertInfos();
         // Create a script array
         Array arr(SqVM(), static_cast< SQInteger >(vec.size()));
         // Populate the array with vector elements
@@ -1619,7 +1625,7 @@ struct CpRedirect : public cpr::Redirect
      * Explicit constructor.
     */
     explicit CpRedirect(SQInteger maximum)
-        : cpr::Redirect(static_cast< long >(maximum), true, cpr::PostRedirectFlags::POST_ALL)
+        : cpr::Redirect(static_cast< long >(maximum), true, false, cpr::PostRedirectFlags::POST_ALL)
     {
     }
 
@@ -1627,15 +1633,23 @@ struct CpRedirect : public cpr::Redirect
      * Explicit constructor.
     */
     CpRedirect(SQInteger maximum, bool follow)
-        : cpr::Redirect(static_cast< long >(maximum), follow, cpr::PostRedirectFlags::POST_ALL)
+        : cpr::Redirect(static_cast< long >(maximum), follow, false, cpr::PostRedirectFlags::POST_ALL)
     {
     }
 
     /* --------------------------------------------------------------------------------------------
      * Explicit constructor.
     */
-    CpRedirect(SQInteger maximum, bool follow, SQInteger post_flags)
-        : cpr::Redirect(static_cast< long >(maximum), follow, static_cast< cpr::PostRedirectFlags >(post_flags))
+    CpRedirect(SQInteger maximum, bool follow, bool cont_send_cred)
+        : cpr::Redirect(static_cast< long >(maximum), follow, cont_send_cred, cpr::PostRedirectFlags::POST_ALL)
+    {
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    CpRedirect(SQInteger maximum, bool follow, bool cont_send_cred, SQInteger post_flags)
+        : cpr::Redirect(static_cast< long >(maximum), follow, cont_send_cred, static_cast< cpr::PostRedirectFlags >(post_flags))
     {
     }
 
@@ -1879,20 +1893,10 @@ struct CpSession : public cpr::Session
     /* --------------------------------------------------------------------------------------------
      * Modify auth option.
     */
-    CpSession & SetAuth_(StackStrF & username, StackStrF & password)
+    CpSession & SetAuth_(StackStrF & username, StackStrF & password, SQInteger mode)
     {
         LockCheck();
-        cpr::Session::SetAuth(cpr::Authentication(username.ToStr(), password.ToStr()));
-        return *this; // Allow chaining
-    }
-
-    /* --------------------------------------------------------------------------------------------
-     * Modify digest option.
-    */
-    CpSession & SetDigest_(StackStrF & username, StackStrF & password)
-    {
-        LockCheck();
-        cpr::Session::SetAuth(cpr::Digest(username.ToStr(), password.ToStr()));
+        cpr::Session::SetAuth(cpr::Authentication(username.ToStr(), password.ToStr(), static_cast<cpr::AuthMode>(mode)));
         return *this; // Allow chaining
     }
 
@@ -1960,16 +1964,6 @@ struct CpSession : public cpr::Session
     //{
     //}
 
-    /* --------------------------------------------------------------------------------------------
-     * Modify NTLM option.
-    */
-    CpSession & SetNTLM_(StackStrF & username, StackStrF & password)
-    {
-        LockCheck();
-        cpr::Session::SetNTLM(cpr::NTLM(username.ToStr(), password.ToStr()));
-        return *this; // Allow chaining
-    }
-
     /* --------------------------------------------------------------------------------------------
      * Modify redirect option.
     */

module/Library/Discord.cpp

@@ -0,0 +1,53 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord.hpp"
+#include "Library/Discord/Cluster.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+void TerminateDiscord()
+{
+    // Go over all clusters and try to terminate them
+    for (DpCluster * inst = DpCluster::sHead; inst && inst->mNext != DpCluster::sHead; inst = inst->mNext)
+    {
+        inst->Terminate(); // Terminate the cluster
+    }
+}
+
+// ------------------------------------------------------------------------------------------------
+void ProcessDiscord()
+{
+    // Go over all clusters and allow them to process data
+    for (DpCluster * inst = DpCluster::sHead; inst && inst->mNext != DpCluster::sHead; inst = inst->mNext)
+    {
+        inst->Process();
+    }
+}
+
+// ------------------------------------------------------------------------------------------------
+extern void Register_Discord_Constants(HSQUIRRELVM vm, Table & ns);
+extern void Register_Discord_Events(HSQUIRRELVM vm, Table & ns);
+extern void Register_Discord_Misc(HSQUIRRELVM vm, Table & ns);
+extern void Register_Discord_User(HSQUIRRELVM vm, Table & ns);
+extern void Register_Discord_Cluster(HSQUIRRELVM vm, Table & ns);
+
+// ================================================================================================
+void Register_Discord(HSQUIRRELVM vm)
+{
+    Table ns(vm);
+    // --------------------------------------------------------------------------------------------
+    Register_Discord_Constants(vm, ns);
+    {
+        Table ens(vm);
+        Register_Discord_Events(vm, ens);
+        ns.Bind(_SC("Event"), ens);
+    }
+    Register_Discord_Misc(vm, ns);
+    Register_Discord_User(vm, ns);
+    Register_Discord_Cluster(vm, ns);
+    // --------------------------------------------------------------------------------------------
+    RootTable(vm).Bind(_SC("SqDiscord"), ns);
+}
+
+} // Namespace:: SqMod

module/Library/Discord.hpp

@@ -0,0 +1,17 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Library/IO/Buffer.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <atomic>
+
+// ------------------------------------------------------------------------------------------------
+#include <sqratFunction.h>
+#include <concurrentqueue.h>
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+} // Namespace:: SqMod

module/Library/Discord/Application.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Application.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Application.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Automod.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Automod.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Automod.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Channel.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Channel.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Channel.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Client.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Client.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Client.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Cluster.cpp

@@ -0,0 +1,523 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Cluster.hpp"
+#include "Library/Discord/Events.hpp"
+#include "Logger.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqDpClusterTypename, _SC("SqDiscordCluster"))
+SQMOD_DECL_TYPENAME(SqDpClusterOptionsTypename, _SC("SqDiscordClusterOptions"))
+
+// ------------------------------------------------------------------------------------------------
+DpCluster::DpCluster(DpClusterOptions & o)
+    : Base(), mQueue(4096)
+    , mC(std::make_unique< dpp::cluster >(o.mToken, o.mIntents, o.mShards, o.mClusterID, o.mMaxClusters, o.mCompressed, o.mPolicy, o.mRequestThreads, o.mRequestThreadsRaw))
+    , mSqEvents(), mEvents(), mEventsHandle()
+    , mCCList(), mCCResults(std::make_shared< CCResultQueue >(4096))
+{
+    // Make sure all event handles are not valid
+    mEventsHandle.fill(0);
+    // Initialize event signals
+    InitEvents();
+    // Proxy library logging to our logger
+    if (!o.mCustomLogging)
+    {
+        mC->on_log([](const dpp::log_t& event) {
+            switch (event.severity)
+            {
+                case dpp::ll_trace: Logger::Get().Send(LOGL_DBG, true, event.message.c_str(), event.message.size()); break;
+                case dpp::ll_debug: Logger::Get().Send(LOGL_DBG, true, event.message.c_str(), event.message.size()); break;
+                case dpp::ll_info: Logger::Get().Send(LOGL_INF, true, event.message.c_str(), event.message.size()); break;
+                case dpp::ll_warning: Logger::Get().Send(LOGL_WRN, true, event.message.c_str(), event.message.size()); break;
+                case dpp::ll_error: Logger::Get().Send(LOGL_ERR, true, event.message.c_str(), event.message.size()); break;
+                case dpp::ll_critical: Logger::Get().Send(LOGL_FTL, true, event.message.c_str(), event.message.size()); break;
+                default: break;
+            }
+        });
+    }
+    // Remember this instance
+    ChainInstance();
+}
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_NODISCARD LightObj EventToScriptObject(uint8_t type, uintptr_t data);
+void EventInvokeCleanup(uint8_t type, uintptr_t data);
+
+// ------------------------------------------------------------------------------------------------
+void DpCluster::Process(bool force)
+{
+    // Is there a valid connection?
+    if (!mC && !force)
+    {
+        return; // No point in going forward
+    }
+    EventItem event;
+    // Retrieve each event individually and process it
+    for (size_t count = mQueue.size_approx(), n = 0; n <= count; ++n)
+    {
+        // Try to get an event from the queue
+        if (mQueue.try_dequeue(event))
+        {
+            // Fetch the type of event
+            const auto id = static_cast< size_t >(event->GetEventID());
+            // Is this a valid event and is anyone listening to it?
+            if (!(event->mFrom) || !(mEvents[id].first) || mEvents[id].first->IsEmpty())
+            {
+                continue; // Move on
+            }
+            // Transform the event instance into a script object
+            LightObj obj = event->ToScriptObject();
+            // Allow the script to take ownership of the event instance now
+            [[maybe_unused]] auto p = event.release();
+            // Don't abort everything down the line for an error caused by a discord event handler
+            try {
+                (*mEvents[id].first)(obj); // Forward the call to the associated signal
+            } catch (const std::exception & e) {
+                LogErr("Squirrel exception caught in (%s) discord event", p->GetEventName().data());
+                LogSInf("Message: %s", e.what());
+            }
+            // Allow the event instance to clean itself (i.e. invalidate itself)
+            // User should not keep this event object for later use!
+            // Event data is accessible only during the event signal
+            p->Cleanup();
+        }
+    }
+    CCResultItem cc_item;
+    // Retrieve each command completion result individually and process it
+    for (size_t count = mCCResults->size_approx(), n = 0; n <= count; ++n)
+    {
+        // Try to get a result from the queue
+        if (mCCResults->try_dequeue(cc_item))
+        {
+            CCResult & r = *cc_item;
+            // Get the script callback
+            Function & cb = *(r.first);
+            // Is there still a valid callback to invoke?
+            if (!cb.IsNull())
+            {
+                // Don't abort everything down the line for an error caused by a script callback
+                try {
+                    cb.Execute(LightObj(SqTypeIdentity< DpCommandConfirmation >{}, cb.GetVM(), std::move(r.second)));
+                } catch (const std::exception & e) {
+                    LogErr("Squirrel exception caught in discord command completion event");
+                    LogSInf("Message: %s", e.what());
+                }
+            }
+            // Release the callback from the list
+            mCCList.erase(r.first);
+        }
+    }
+}
+
+// ------------------------------------------------------------------------------------------------
+void DpCluster::Terminate()
+{
+    // Stop the cluster connection
+    if (mC) mC->shutdown();
+    // Release associated script objects
+    mSqEvents.Release();
+    // Release event signal objects
+    DropEvents();
+    // Delete the cluster instance
+    mC.reset();
+}
+
+// ================================================================================================
+void Register_Discord_Cluster(HSQUIRRELVM vm, Table & ns)
+{
+    ns.Bind(_SC("ClusterOptions"),
+        Class< DpClusterOptions >(vm, SqDpClusterOptionsTypename::Str)
+        // Constructors
+        .Ctor< StackStrF & >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpClusterOptionsTypename::Fn)
+    );
+
+    ns.Bind(_SC("Cluster"),
+        Class< DpCluster, NoCopy< DpCluster > >(vm, SqDpClusterTypename::Str)
+        // Constructors
+        .Ctor< DpClusterOptions & >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpClusterTypename::Fn)
+        // Member Properties
+        .Prop(_SC("On"), &DpCluster::GetEvents)
+        // Member Methods
+        .Func(_SC("Start"), &DpCluster::Start)
+        .Func(_SC("Stop"), &DpCluster::Stop)
+        .Func(_SC("EnableEvent"), &DpCluster::EnableEvent)
+        .Func(_SC("DisableEvent"), &DpCluster::DisableEvent)
+        .CbFunc(_SC("CurrentUserGetGuilds"), &DpCluster::CurrentUserGetGuilds)
+    );
+}
+
+// ------------------------------------------------------------------------------------------------
+DpCluster & DpCluster::EnableEvent(SQInteger id)
+{
+    // Retrieve managed cluster instance
+    auto & c = Valid("enable event on a");
+    // Assigned event handle
+    dpp::event_handle eh = 0;
+    // Make sure the specified event handle is valid
+    if (id >= 0 && id < static_cast< SQInteger >(DpEventID::Max))
+    {
+        eh = mEventsHandle[static_cast< size_t >(id)]; // Get the real handle
+    }
+    // Is this event already enabled?
+    if (eh != 0)
+    {
+        return *this; // Job already done
+    }
+    // Identify event type
+    switch (id)
+    {
+        case DpEventID::VoiceStateUpdate:               eh = c.on_voice_state_update.attach([this](const dpp::voice_state_update_t & e) { OnVoiceStateUpdate(e); }); break;
+        case DpEventID::VoiceClientDisconnect:          eh = c.on_voice_client_disconnect.attach([this](const dpp::voice_client_disconnect_t & e) { OnVoiceClientDisconnect(e); }); break;
+        case DpEventID::VoiceClientSpeaking:            eh = c.on_voice_client_speaking.attach([this](const dpp::voice_client_speaking_t & e) { OnVoiceClientSpeaking(e); }); break;
+        case DpEventID::Log:                            eh = c.on_log.attach([this](const dpp::log_t & e) { OnLog(e); }); break;
+        case DpEventID::GuildJoinRequestDelete:         eh = c.on_guild_join_request_delete.attach([this](const dpp::guild_join_request_delete_t & e) { OnGuildJoinRequestDelete(e); }); break;
+        case DpEventID::InteractionCreate:              eh = c.on_interaction_create.attach([this](const dpp::interaction_create_t & e) { OnInteractionCreate(e); }); break;
+        case DpEventID::SlashCommand:                   eh = c.on_slashcommand.attach([this](const dpp::slashcommand_t & e) { OnSlashCommand(e); }); break;
+        case DpEventID::ButtonClick:                    eh = c.on_button_click.attach([this](const dpp::button_click_t & e) { OnButtonClick(e); }); break;
+        case DpEventID::AutoComplete:                   eh = c.on_autocomplete.attach([this](const dpp::autocomplete_t & e) { OnAutoComplete(e); }); break;
+        case DpEventID::SelectClick:                    eh = c.on_select_click.attach([this](const dpp::select_click_t & e) { OnSelectClick(e); }); break;
+        case DpEventID::MessageContextMenu:             eh = c.on_message_context_menu.attach([this](const dpp::message_context_menu_t & e) { OnMessageContextMenu(e); }); break;
+        case DpEventID::UserContextMenu:                eh = c.on_user_context_menu.attach([this](const dpp::user_context_menu_t & e) { OnUserContextMenu(e); }); break;
+        case DpEventID::FormSubmit:                     eh = c.on_form_submit.attach([this](const dpp::form_submit_t & e) { OnFormSubmit(e); }); break;
+        case DpEventID::GuildDelete:                    eh = c.on_guild_delete.attach([this](const dpp::guild_delete_t & e) { OnGuildDelete(e); }); break;
+        case DpEventID::ChannelDelete:                  eh = c.on_channel_delete.attach([this](const dpp::channel_delete_t & e) { OnChannelDelete(e); }); break;
+        case DpEventID::ChannelUpdate:                  eh = c.on_channel_update.attach([this](const dpp::channel_update_t & e) { OnChannelUpdate(e); }); break;
+        case DpEventID::Ready:                          eh = c.on_ready.attach([this](const dpp::ready_t & e) { OnReady(e); }); break;
+        case DpEventID::MessageDelete:                  eh = c.on_message_delete.attach([this](const dpp::message_delete_t & e) { OnMessageDelete(e); }); break;
+        case DpEventID::GuildMemberRemove:              eh = c.on_guild_member_remove.attach([this](const dpp::guild_member_remove_t & e) { OnGuildMemberRemove(e); }); break;
+        case DpEventID::Resumed:                        eh = c.on_resumed.attach([this](const dpp::resumed_t & e) { OnResumed(e); }); break;
+        case DpEventID::GuildRoleCreate:                eh = c.on_guild_role_create.attach([this](const dpp::guild_role_create_t & e) { OnGuildRoleCreate(e); }); break;
+        case DpEventID::TypingStart:                    eh = c.on_typing_start.attach([this](const dpp::typing_start_t & e) { OnTypingStart(e); }); break;
+        case DpEventID::MessageReactionAdd:             eh = c.on_message_reaction_add.attach([this](const dpp::message_reaction_add_t & e) { OnMessageReactionAdd(e); }); break;
+        case DpEventID::GuildMembersChunk:              eh = c.on_guild_members_chunk.attach([this](const dpp::guild_members_chunk_t & e) { OnGuildMembersChunk(e); }); break;
+        case DpEventID::MessageReactionRemove:          eh = c.on_message_reaction_remove.attach([this](const dpp::message_reaction_remove_t & e) { OnMessageReactionRemove(e); }); break;
+        case DpEventID::GuildCreate:                    eh = c.on_guild_create.attach([this](const dpp::guild_create_t & e) { OnGuildCreate(e); }); break;
+        case DpEventID::ChannelCreate:                  eh = c.on_channel_create.attach([this](const dpp::channel_create_t & e) { OnChannelCreate(e); }); break;
+        case DpEventID::MessageReactionRemoveEmoji:     eh = c.on_message_reaction_remove_emoji.attach([this](const dpp::message_reaction_remove_emoji_t & e) { OnMessageReactionRemoveEmoji(e); }); break;
+        case DpEventID::MessageDeleteDulk:              eh = c.on_message_delete_bulk.attach([this](const dpp::message_delete_bulk_t & e) { OnMessageDeleteDulk(e); }); break;
+        case DpEventID::GuildRoleUpdate:                eh = c.on_guild_role_update.attach([this](const dpp::guild_role_update_t & e) { OnGuildRoleUpdate(e); }); break;
+        case DpEventID::GuildRoleDelete:                eh = c.on_guild_role_delete.attach([this](const dpp::guild_role_delete_t & e) { OnGuildRoleDelete(e); }); break;
+        case DpEventID::ChannelPinsUpdate:              eh = c.on_channel_pins_update.attach([this](const dpp::channel_pins_update_t & e) { OnChannelPinsUpdate(e); }); break;
+        case DpEventID::MessageReactionRemoveAll:       eh = c.on_message_reaction_remove_all.attach([this](const dpp::message_reaction_remove_all_t & e) { OnMessageReactionRemoveAll(e); }); break;
+        case DpEventID::VoiceServerUpdate:              eh = c.on_voice_server_update.attach([this](const dpp::voice_server_update_t & e) { OnVoiceServerUpdate(e); }); break;
+        case DpEventID::GuildEmojisUpdate:              eh = c.on_guild_emojis_update.attach([this](const dpp::guild_emojis_update_t & e) { OnGuildEmojisUpdate(e); }); break;
+        case DpEventID::GuildStickersUpdate:            eh = c.on_guild_stickers_update.attach([this](const dpp::guild_stickers_update_t & e) { OnGuildStickersUpdate(e); }); break;
+        case DpEventID::PresenceUpdate:                 eh = c.on_presence_update.attach([this](const dpp::presence_update_t & e) { OnPresenceUpdate(e); }); break;
+        case DpEventID::WebhooksUpdate:                 eh = c.on_webhooks_update.attach([this](const dpp::webhooks_update_t & e) { OnWebhooksUpdate(e); }); break;
+        case DpEventID::AutomodRuleCreate:              eh = c.on_automod_rule_create.attach([this](const dpp::automod_rule_create_t & e) { OnAutomodRuleCreate(e); }); break;
+        case DpEventID::AutomodRuleUpdate:              eh = c.on_automod_rule_update.attach([this](const dpp::automod_rule_update_t & e) { OnAutomodRuleUpdate(e); }); break;
+        case DpEventID::AutomodRuleDelete:              eh = c.on_automod_rule_delete.attach([this](const dpp::automod_rule_delete_t & e) { OnAutomodRuleDelete(e); }); break;
+        case DpEventID::AutomodRuleExecute:             eh = c.on_automod_rule_execute.attach([this](const dpp::automod_rule_execute_t & e) { OnAutomodRuleExecute(e); }); break;
+        case DpEventID::GuildMemberAdd:                 eh = c.on_guild_member_add.attach([this](const dpp::guild_member_add_t & e) { OnGuildMemberAdd(e); }); break;
+        case DpEventID::InviteDelete:                   eh = c.on_invite_delete.attach([this](const dpp::invite_delete_t & e) { OnInviteDelete(e); }); break;
+        case DpEventID::GuildUpdate:                    eh = c.on_guild_update.attach([this](const dpp::guild_update_t & e) { OnGuildUpdate(e); }); break;
+        case DpEventID::GuildIntegrationsUpdate:        eh = c.on_guild_integrations_update.attach([this](const dpp::guild_integrations_update_t & e) { OnGuildIntegrationsUpdate(e); }); break;
+        case DpEventID::GuildMemberUpdate:              eh = c.on_guild_member_update.attach([this](const dpp::guild_member_update_t & e) { OnGuildMemberUpdate(e); }); break;
+        case DpEventID::InviteCreate:                   eh = c.on_invite_create.attach([this](const dpp::invite_create_t & e) { OnInviteCreate(e); }); break;
+        case DpEventID::MessageUpdate:                  eh = c.on_message_update.attach([this](const dpp::message_update_t & e) { OnMessageUpdate(e); }); break;
+        case DpEventID::UserUpdate:                     eh = c.on_user_update.attach([this](const dpp::user_update_t & e) { OnUserUpdate(e); }); break;
+        case DpEventID::MessageCreate:                  eh = c.on_message_create.attach([this](const dpp::message_create_t & e) { OnMessageCreate(e); }); break;
+        case DpEventID::GuildAuditLogEntryCreate:       eh = c.on_guild_audit_log_entry_create.attach([this](const dpp::guild_audit_log_entry_create_t & e) { OnGuildAuditLogEntryCreate(e); }); break;
+        case DpEventID::GuildBanAdd:                    eh = c.on_guild_ban_add.attach([this](const dpp::guild_ban_add_t & e) { OnGuildBanAdd(e); }); break;
+        case DpEventID::GuildBanRemove:                 eh = c.on_guild_ban_remove.attach([this](const dpp::guild_ban_remove_t & e) { OnGuildBanRemove(e); }); break;
+        case DpEventID::IntegrationCreate:              eh = c.on_integration_create.attach([this](const dpp::integration_create_t & e) { OnIntegrationCreate(e); }); break;
+        case DpEventID::IntegrationUpdate:              eh = c.on_integration_update.attach([this](const dpp::integration_update_t & e) { OnIntegrationUpdate(e); }); break;
+        case DpEventID::IntegrationDelete:              eh = c.on_integration_delete.attach([this](const dpp::integration_delete_t & e) { OnIntegrationDelete(e); }); break;
+        case DpEventID::ThreadCreate:                   eh = c.on_thread_create.attach([this](const dpp::thread_create_t & e) { OnThreadCreate(e); }); break;
+        case DpEventID::ThreadUpdate:                   eh = c.on_thread_update.attach([this](const dpp::thread_update_t & e) { OnThreadUpdate(e); }); break;
+        case DpEventID::ThreadDelete:                   eh = c.on_thread_delete.attach([this](const dpp::thread_delete_t & e) { OnThreadDelete(e); }); break;
+        case DpEventID::ThreadListSync:                 eh = c.on_thread_list_sync.attach([this](const dpp::thread_list_sync_t & e) { OnThreadListSync(e); }); break;
+        case DpEventID::ThreadMemberUpdate:             eh = c.on_thread_member_update.attach([this](const dpp::thread_member_update_t & e) { OnThreadMemberUpdate(e); }); break;
+        case DpEventID::ThreadMembersUpdate:            eh = c.on_thread_members_update.attach([this](const dpp::thread_members_update_t & e) { OnThreadMembersUpdate(e); }); break;
+        case DpEventID::GuildScheduledEventCreate:      eh = c.on_guild_scheduled_event_create.attach([this](const dpp::guild_scheduled_event_create_t & e) { OnGuildScheduledEventCreate(e); }); break;
+        case DpEventID::GuildScheduledEventUpdate:      eh = c.on_guild_scheduled_event_update.attach([this](const dpp::guild_scheduled_event_update_t & e) { OnGuildScheduledEventUpdate(e); }); break;
+        case DpEventID::GuildScheduledEventDelete:      eh = c.on_guild_scheduled_event_delete.attach([this](const dpp::guild_scheduled_event_delete_t & e) { OnGuildScheduledEventDelete(e); }); break;
+        case DpEventID::GuildScheduledEventUserAdd:     eh = c.on_guild_scheduled_event_user_add.attach([this](const dpp::guild_scheduled_event_user_add_t & e) { OnGuildScheduledEventUserAdd(e); }); break;
+        case DpEventID::GuildScheduledEventUserRemove:  eh = c.on_guild_scheduled_event_user_remove.attach([this](const dpp::guild_scheduled_event_user_remove_t & e) { OnGuildScheduledEventUserRemove(e); }); break;
+        case DpEventID::VoiceBufferSend:                eh = c.on_voice_buffer_send.attach([this](const dpp::voice_buffer_send_t & e) { OnVoiceBufferSend(e); }); break;
+        case DpEventID::VoiceUserTalking:               eh = c.on_voice_user_talking.attach([this](const dpp::voice_user_talking_t & e) { OnVoiceUserTalking(e); }); break;
+        case DpEventID::VoiceReady:                     eh = c.on_voice_ready.attach([this](const dpp::voice_ready_t & e) { OnVoiceReady(e); }); break;
+        case DpEventID::VoiceReceive:                   eh = c.on_voice_receive.attach([this](const dpp::voice_receive_t & e) { OnVoiceReceive(e); }); break;
+        case DpEventID::VoiceReceiveCombined:           eh = c.on_voice_receive_combined.attach([this](const dpp::voice_receive_t & e) { OnVoiceReceiveCombined(e); }); break;
+        case DpEventID::VoiceTrackMarker:               eh = c.on_voice_track_marker.attach([this](const dpp::voice_track_marker_t & e) { OnVoiceTrackMarker(e); }); break;
+        case DpEventID::StageInstanceCreate:            eh = c.on_stage_instance_create.attach([this](const dpp::stage_instance_create_t & e) { OnStageInstanceCreate(e); }); break;
+        case DpEventID::StageInstanceUpdate:            eh = c.on_stage_instance_update.attach([this](const dpp::stage_instance_update_t & e) { OnStageInstanceUpdate(e); }); break;
+        case DpEventID::StageInstanceDelete:            eh = c.on_stage_instance_delete.attach([this](const dpp::stage_instance_delete_t & e) { OnStageInstanceDelete(e); }); break;
+        case DpEventID::Max: // Fall through
+        default: STHROWF("Invalid discord event identifier {}", id);
+    }
+    // Remember the designated event handle
+    mEventsHandle[static_cast< size_t >(id)] = eh;
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+DpCluster & DpCluster::DisableEvent(SQInteger id)
+{
+    // Retrieve managed cluster instance
+    auto & c = Valid("disable event on a");
+    // Assigned event handle
+    dpp::event_handle eh = 0;
+    // Make sure the specified event handle is valid
+    if (id >= 0 && id < static_cast< SQInteger >(DpEventID::Max))
+    {
+        eh = mEventsHandle[static_cast< size_t >(id)]; // Get the real handle
+    }
+    // Is there anything attached to event dispatched?
+    if (eh == 0)
+    {
+        return *this; // Nothing to detach
+    }
+    // Identify event type
+    switch (id)
+    {
+        case DpEventID::VoiceStateUpdate:               c.on_voice_state_update.detach(eh); break;
+        case DpEventID::VoiceClientDisconnect:          c.on_voice_client_disconnect.detach(eh); break;
+        case DpEventID::VoiceClientSpeaking:            c.on_voice_client_speaking.detach(eh); break;
+        case DpEventID::Log:                            c.on_log.detach(eh); break;
+        case DpEventID::GuildJoinRequestDelete:         c.on_guild_join_request_delete.detach(eh); break;
+        case DpEventID::InteractionCreate:              c.on_interaction_create.detach(eh); break;
+        case DpEventID::SlashCommand:                   c.on_slashcommand.detach(eh); break;
+        case DpEventID::ButtonClick:                    c.on_button_click.detach(eh); break;
+        case DpEventID::AutoComplete:                   c.on_autocomplete.detach(eh); break;
+        case DpEventID::SelectClick:                    c.on_select_click.detach(eh); break;
+        case DpEventID::MessageContextMenu:             c.on_message_context_menu.detach(eh); break;
+        case DpEventID::UserContextMenu:                c.on_user_context_menu.detach(eh); break;
+        case DpEventID::FormSubmit:                     c.on_form_submit.detach(eh); break;
+        case DpEventID::GuildDelete:                    c.on_guild_delete.detach(eh); break;
+        case DpEventID::ChannelDelete:                  c.on_channel_delete.detach(eh); break;
+        case DpEventID::ChannelUpdate:                  c.on_channel_update.detach(eh); break;
+        case DpEventID::Ready:                          c.on_ready.detach(eh); break;
+        case DpEventID::MessageDelete:                  c.on_message_delete.detach(eh); break;
+        case DpEventID::GuildMemberRemove:              c.on_guild_member_remove.detach(eh); break;
+        case DpEventID::Resumed:                        c.on_resumed.detach(eh); break;
+        case DpEventID::GuildRoleCreate:                c.on_guild_role_create.detach(eh); break;
+        case DpEventID::TypingStart:                    c.on_typing_start.detach(eh); break;
+        case DpEventID::MessageReactionAdd:             c.on_message_reaction_add.detach(eh); break;
+        case DpEventID::GuildMembersChunk:              c.on_guild_members_chunk.detach(eh); break;
+        case DpEventID::MessageReactionRemove:          c.on_message_reaction_remove.detach(eh); break;
+        case DpEventID::GuildCreate:                    c.on_guild_create.detach(eh); break;
+        case DpEventID::ChannelCreate:                  c.on_channel_create.detach(eh); break;
+        case DpEventID::MessageReactionRemoveEmoji:     c.on_message_reaction_remove_emoji.detach(eh); break;
+        case DpEventID::MessageDeleteDulk:              c.on_message_delete_bulk.detach(eh); break;
+        case DpEventID::GuildRoleUpdate:                c.on_guild_role_update.detach(eh); break;
+        case DpEventID::GuildRoleDelete:                c.on_guild_role_delete.detach(eh); break;
+        case DpEventID::ChannelPinsUpdate:              c.on_channel_pins_update.detach(eh); break;
+        case DpEventID::MessageReactionRemoveAll:       c.on_message_reaction_remove_all.detach(eh); break;
+        case DpEventID::VoiceServerUpdate:              c.on_voice_server_update.detach(eh); break;
+        case DpEventID::GuildEmojisUpdate:              c.on_guild_emojis_update.detach(eh); break;
+        case DpEventID::GuildStickersUpdate:            c.on_guild_stickers_update.detach(eh); break;
+        case DpEventID::PresenceUpdate:                 c.on_presence_update.detach(eh); break;
+        case DpEventID::WebhooksUpdate:                 c.on_webhooks_update.detach(eh); break;
+        case DpEventID::AutomodRuleCreate:              c.on_automod_rule_create.detach(eh); break;
+        case DpEventID::AutomodRuleUpdate:              c.on_automod_rule_update.detach(eh); break;
+        case DpEventID::AutomodRuleDelete:              c.on_automod_rule_delete.detach(eh); break;
+        case DpEventID::AutomodRuleExecute:             c.on_automod_rule_execute.detach(eh); break;
+        case DpEventID::GuildMemberAdd:                 c.on_guild_member_add.detach(eh); break;
+        case DpEventID::InviteDelete:                   c.on_invite_delete.detach(eh); break;
+        case DpEventID::GuildUpdate:                    c.on_guild_update.detach(eh); break;
+        case DpEventID::GuildIntegrationsUpdate:        c.on_guild_integrations_update.detach(eh); break;
+        case DpEventID::GuildMemberUpdate:              c.on_guild_member_update.detach(eh); break;
+        case DpEventID::InviteCreate:                   c.on_invite_create.detach(eh); break;
+        case DpEventID::MessageUpdate:                  c.on_message_update.detach(eh); break;
+        case DpEventID::UserUpdate:                     c.on_user_update.detach(eh); break;
+        case DpEventID::MessageCreate:                  c.on_message_create.detach(eh); break;
+        case DpEventID::GuildAuditLogEntryCreate:       c.on_guild_audit_log_entry_create.detach(eh); break;
+        case DpEventID::GuildBanAdd:                    c.on_guild_ban_add.detach(eh); break;
+        case DpEventID::GuildBanRemove:                 c.on_guild_ban_remove.detach(eh); break;
+        case DpEventID::IntegrationCreate:              c.on_integration_create.detach(eh); break;
+        case DpEventID::IntegrationUpdate:              c.on_integration_update.detach(eh); break;
+        case DpEventID::IntegrationDelete:              c.on_integration_delete.detach(eh); break;
+        case DpEventID::ThreadCreate:                   c.on_thread_create.detach(eh); break;
+        case DpEventID::ThreadUpdate:                   c.on_thread_update.detach(eh); break;
+        case DpEventID::ThreadDelete:                   c.on_thread_delete.detach(eh); break;
+        case DpEventID::ThreadListSync:                 c.on_thread_list_sync.detach(eh); break;
+        case DpEventID::ThreadMemberUpdate:             c.on_thread_member_update.detach(eh); break;
+        case DpEventID::ThreadMembersUpdate:            c.on_thread_members_update.detach(eh); break;
+        case DpEventID::GuildScheduledEventCreate:      c.on_guild_scheduled_event_create.detach(eh); break;
+        case DpEventID::GuildScheduledEventUpdate:      c.on_guild_scheduled_event_update.detach(eh); break;
+        case DpEventID::GuildScheduledEventDelete:      c.on_guild_scheduled_event_delete.detach(eh); break;
+        case DpEventID::GuildScheduledEventUserAdd:     c.on_guild_scheduled_event_user_add.detach(eh); break;
+        case DpEventID::GuildScheduledEventUserRemove:  c.on_guild_scheduled_event_user_remove.detach(eh); break;
+        case DpEventID::VoiceBufferSend:                c.on_voice_buffer_send.detach(eh); break;
+        case DpEventID::VoiceUserTalking:               c.on_voice_user_talking.detach(eh); break;
+        case DpEventID::VoiceReady:                     c.on_voice_ready.detach(eh); break;
+        case DpEventID::VoiceReceive:                   c.on_voice_receive.detach(eh); break;
+        case DpEventID::VoiceReceiveCombined:           c.on_voice_receive_combined.detach(eh); break;
+        case DpEventID::VoiceTrackMarker:               c.on_voice_track_marker.detach(eh); break;
+        case DpEventID::StageInstanceCreate:            c.on_stage_instance_create.detach(eh); break;
+        case DpEventID::StageInstanceUpdate:            c.on_stage_instance_update.detach(eh); break;
+        case DpEventID::StageInstanceDelete:            c.on_stage_instance_delete.detach(eh); break;
+        case DpEventID::Max: // Fall through
+        default: STHROWF("Invalid discord event identifier {}", id);
+    }
+    // Forget about this event handler
+    mEventsHandle[static_cast< size_t >(id)] = 0;
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+void DpCluster::OnVoiceStateUpdate(const dpp::voice_state_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceStateUpdateEvent(ev))); }
+void DpCluster::OnVoiceClientDisconnect(const dpp::voice_client_disconnect_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceClientDisconnectEvent(ev))); }
+void DpCluster::OnVoiceClientSpeaking(const dpp::voice_client_speaking_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceClientSpeakingEvent(ev))); }
+void DpCluster::OnLog(const dpp::log_t & ev)
+{ mQueue.enqueue(EventItem(new DpLogEvent(ev))); }
+void DpCluster::OnGuildJoinRequestDelete(const dpp::guild_join_request_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildJoinRequestDeleteEvent(ev))); }
+void DpCluster::OnInteractionCreate(const dpp::interaction_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpInteractionCreateEvent(ev))); }
+void DpCluster::OnSlashCommand(const dpp::slashcommand_t & ev)
+{ mQueue.enqueue(EventItem(new DpSlashCommandEvent(ev))); }
+void DpCluster::OnButtonClick(const dpp::button_click_t & ev)
+{ mQueue.enqueue(EventItem(new DpButtonClickEvent(ev))); }
+void DpCluster::OnAutoComplete(const dpp::autocomplete_t & ev)
+{ mQueue.enqueue(EventItem(new DpAutoCompleteEvent(ev))); }
+void DpCluster::OnSelectClick(const dpp::select_click_t & ev)
+{ mQueue.enqueue(EventItem(new DpSelectClickEvent(ev))); }
+void DpCluster::OnMessageContextMenu(const dpp::message_context_menu_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageContextMenuEvent(ev))); }
+void DpCluster::OnUserContextMenu(const dpp::user_context_menu_t & ev)
+{ mQueue.enqueue(EventItem(new DpUserContextMenuEvent(ev))); }
+void DpCluster::OnFormSubmit(const dpp::form_submit_t & ev)
+{ mQueue.enqueue(EventItem(new DpFormSubmitEvent(ev))); }
+void DpCluster::OnGuildDelete(const dpp::guild_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildDeleteEvent(ev))); }
+void DpCluster::OnChannelDelete(const dpp::channel_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpChannelDeleteEvent(ev))); }
+void DpCluster::OnChannelUpdate(const dpp::channel_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpChannelUpdateEvent(ev))); }
+void DpCluster::OnReady(const dpp::ready_t & ev)
+{ mQueue.enqueue(EventItem(new DpReadyEvent(ev))); }
+void DpCluster::OnMessageDelete(const dpp::message_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageDeleteEvent(ev))); }
+void DpCluster::OnGuildMemberRemove(const dpp::guild_member_remove_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildMemberRemoveEvent(ev))); }
+void DpCluster::OnResumed(const dpp::resumed_t & ev)
+{ mQueue.enqueue(EventItem(new DpResumedEvent(ev))); }
+void DpCluster::OnGuildRoleCreate(const dpp::guild_role_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildRoleCreateEvent(ev))); }
+void DpCluster::OnTypingStart(const dpp::typing_start_t & ev)
+{ mQueue.enqueue(EventItem(new DpTypingStartEvent(ev))); }
+void DpCluster::OnMessageReactionAdd(const dpp::message_reaction_add_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageReactionAddEvent(ev))); }
+void DpCluster::OnGuildMembersChunk(const dpp::guild_members_chunk_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildMembersChunkEvent(ev))); }
+void DpCluster::OnMessageReactionRemove(const dpp::message_reaction_remove_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageReactionRemoveEvent(ev))); }
+void DpCluster::OnGuildCreate(const dpp::guild_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildCreateEvent(ev))); }
+void DpCluster::OnChannelCreate(const dpp::channel_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpChannelCreateEvent(ev))); }
+void DpCluster::OnMessageReactionRemoveEmoji(const dpp::message_reaction_remove_emoji_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageReactionRemoveEmojiEvent(ev))); }
+void DpCluster::OnMessageDeleteDulk(const dpp::message_delete_bulk_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageDeleteDulkEvent(ev))); }
+void DpCluster::OnGuildRoleUpdate(const dpp::guild_role_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildRoleUpdateEvent(ev))); }
+void DpCluster::OnGuildRoleDelete(const dpp::guild_role_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildRoleDeleteEvent(ev))); }
+void DpCluster::OnChannelPinsUpdate(const dpp::channel_pins_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpChannelPinsUpdateEvent(ev))); }
+void DpCluster::OnMessageReactionRemoveAll(const dpp::message_reaction_remove_all_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageReactionRemoveAllEvent(ev))); }
+void DpCluster::OnVoiceServerUpdate(const dpp::voice_server_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceServerUpdateEvent(ev))); }
+void DpCluster::OnGuildEmojisUpdate(const dpp::guild_emojis_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildEmojisUpdateEvent(ev))); }
+void DpCluster::OnGuildStickersUpdate(const dpp::guild_stickers_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildStickersUpdateEvent(ev))); }
+void DpCluster::OnPresenceUpdate(const dpp::presence_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpPresenceUpdateEvent(ev))); }
+void DpCluster::OnWebhooksUpdate(const dpp::webhooks_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpWebhooksUpdateEvent(ev))); }
+void DpCluster::OnAutomodRuleCreate(const dpp::automod_rule_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpAutomodRuleCreateEvent(ev))); }
+void DpCluster::OnAutomodRuleUpdate(const dpp::automod_rule_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpAutomodRuleUpdateEvent(ev))); }
+void DpCluster::OnAutomodRuleDelete(const dpp::automod_rule_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpAutomodRuleDeleteEvent(ev))); }
+void DpCluster::OnAutomodRuleExecute(const dpp::automod_rule_execute_t & ev)
+{ mQueue.enqueue(EventItem(new DpAutomodRuleExecuteEvent(ev))); }
+void DpCluster::OnGuildMemberAdd(const dpp::guild_member_add_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildMemberAddEvent(ev))); }
+void DpCluster::OnInviteDelete(const dpp::invite_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpInviteDeleteEvent(ev))); }
+void DpCluster::OnGuildUpdate(const dpp::guild_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildUpdateEvent(ev))); }
+void DpCluster::OnGuildIntegrationsUpdate(const dpp::guild_integrations_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildIntegrationsUpdateEvent(ev))); }
+void DpCluster::OnGuildMemberUpdate(const dpp::guild_member_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildMemberUpdateEvent(ev))); }
+void DpCluster::OnInviteCreate(const dpp::invite_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpInviteCreateEvent(ev))); }
+void DpCluster::OnMessageUpdate(const dpp::message_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageUpdateEvent(ev))); }
+void DpCluster::OnUserUpdate(const dpp::user_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpUserUpdateEvent(ev))); }
+void DpCluster::OnMessageCreate(const dpp::message_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpMessageCreateEvent(ev))); }
+void DpCluster::OnGuildAuditLogEntryCreate(const dpp::guild_audit_log_entry_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildAuditLogEntryCreateEvent(ev))); }
+void DpCluster::OnGuildBanAdd(const dpp::guild_ban_add_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildBanAddEvent(ev))); }
+void DpCluster::OnGuildBanRemove(const dpp::guild_ban_remove_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildBanRemoveEvent(ev))); }
+void DpCluster::OnIntegrationCreate(const dpp::integration_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpIntegrationCreateEvent(ev))); }
+void DpCluster::OnIntegrationUpdate(const dpp::integration_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpIntegrationUpdateEvent(ev))); }
+void DpCluster::OnIntegrationDelete(const dpp::integration_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpIntegrationDeleteEvent(ev))); }
+void DpCluster::OnThreadCreate(const dpp::thread_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpThreadCreateEvent(ev))); }
+void DpCluster::OnThreadUpdate(const dpp::thread_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpThreadUpdateEvent(ev))); }
+void DpCluster::OnThreadDelete(const dpp::thread_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpThreadDeleteEvent(ev))); }
+void DpCluster::OnThreadListSync(const dpp::thread_list_sync_t & ev)
+{ mQueue.enqueue(EventItem(new DpThreadListSyncEvent(ev))); }
+void DpCluster::OnThreadMemberUpdate(const dpp::thread_member_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpThreadMemberUpdateEvent(ev))); }
+void DpCluster::OnThreadMembersUpdate(const dpp::thread_members_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpThreadMembersUpdateEvent(ev))); }
+void DpCluster::OnGuildScheduledEventCreate(const dpp::guild_scheduled_event_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildScheduledEventCreateEvent(ev))); }
+void DpCluster::OnGuildScheduledEventUpdate(const dpp::guild_scheduled_event_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildScheduledEventUpdateEvent(ev))); }
+void DpCluster::OnGuildScheduledEventDelete(const dpp::guild_scheduled_event_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildScheduledEventDeleteEvent(ev))); }
+void DpCluster::OnGuildScheduledEventUserAdd(const dpp::guild_scheduled_event_user_add_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildScheduledEventUserAddEvent(ev))); }
+void DpCluster::OnGuildScheduledEventUserRemove(const dpp::guild_scheduled_event_user_remove_t & ev)
+{ mQueue.enqueue(EventItem(new DpGuildScheduledEventUserRemoveEvent(ev))); }
+void DpCluster::OnVoiceBufferSend(const dpp::voice_buffer_send_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceBufferSendEvent(ev))); }
+void DpCluster::OnVoiceUserTalking(const dpp::voice_user_talking_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceUserTalkingEvent(ev))); }
+void DpCluster::OnVoiceReady(const dpp::voice_ready_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceReadyEvent(ev))); }
+void DpCluster::OnVoiceReceive(const dpp::voice_receive_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceReceiveEvent(ev))); }
+void DpCluster::OnVoiceReceiveCombined(const dpp::voice_receive_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceReceiveCombinedEvent(ev))); }
+void DpCluster::OnVoiceTrackMarker(const dpp::voice_track_marker_t & ev)
+{ mQueue.enqueue(EventItem(new DpVoiceTrackMarkerEvent(ev))); }
+void DpCluster::OnStageInstanceCreate(const dpp::stage_instance_create_t & ev)
+{ mQueue.enqueue(EventItem(new DpStageInstanceCreateEvent(ev))); }
+void DpCluster::OnStageInstanceUpdate(const dpp::stage_instance_update_t & ev)
+{ mQueue.enqueue(EventItem(new DpStageInstanceUpdateEvent(ev))); }
+void DpCluster::OnStageInstanceDelete(const dpp::stage_instance_delete_t & ev)
+{ mQueue.enqueue(EventItem(new DpStageInstanceDeleteEvent(ev))); }
+
+} // Namespace:: SqMod

module/Library/Discord/Cluster.hpp

@@ -0,0 +1,396 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+#include "Core/Signal.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Constants.hpp"
+#include "Library/Discord/Misc.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <chrono>
+#include <memory>
+#include <functional>
+#include <string_view>
+
+// ------------------------------------------------------------------------------------------------
+#include <concurrentqueue.h>
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+struct DpEventBase;
+
+/* ------------------------------------------------------------------------------------------------
+ *
+*/
+struct DpClusterOptions
+{
+    // The bot token to use for all HTTP commands and websocket connections.
+    std::string         mToken{};
+    // A bitmask of dpd::intents values for all shards on this cluster. This is required to be sent for all bots with over 100 servers.
+    uint32_t            mIntents{dpp::i_default_intents};
+    // The total number of shards on this bot. If there are multiple clusters, then (shards / clusters) actual shards will run on this cluster.
+    // If you omit this value, the library will attempt to query the Discord API for the correct number of shards to start.
+    uint32_t            mShards{0};
+    // The ID of this cluster, should be between 0 and MAXCLUSTERS-1
+    uint32_t            mClusterID{0};
+    // The total number of clusters that are active, which may be on separate processes or even separate machines.
+    uint32_t            mMaxClusters{1};
+    // Whether or not to use compression for shards on this cluster. Saves a ton of bandwidth at the cost of some CPU
+    bool                mCompressed{true};
+    // Set the user caching policy for the cluster, either lazy (only cache users/members when they message the bot) or aggressive (request whole member lists on seeing new guilds too)
+    dpp::cache_policy_t mPolicy{dpp::cp_aggressive, dpp::cp_aggressive, dpp::cp_aggressive};
+    // The number of threads to allocate for making HTTP requests to Discord. This defaults to 12. You can increase this at runtime via the object returned from get_rest().
+    uint32_t            mRequestThreads{12};
+    // The number of threads to allocate for making HTTP requests to sites outside of Discord. This defaults to 1. You can increase this at runtime via the object returned from get_raw_rest().
+    uint32_t            mRequestThreadsRaw{1};
+    // Disable automatic forwarding of logged messages to internal logging. Allows to handle logging manually without risking duplicate output (at the cost of some performance, ofc).
+    bool                mCustomLogging{false};
+
+    /* --------------------------------------------------------------------------------------------
+     * Base constructors.
+    */
+    DpClusterOptions(StackStrF & token)
+        : mToken(token.ToStr())
+    {
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Copy/Move constructors.
+    */
+    DpClusterOptions(const DpClusterOptions &) noexcept = default;
+    DpClusterOptions(DpClusterOptions &&) noexcept = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Copy/Move assignment operators.
+    */
+    DpClusterOptions & operator = (const DpClusterOptions &) noexcept = default;
+    DpClusterOptions & operator = (DpClusterOptions &&) noexcept = default;
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Primitive implementation of a discord client with basic functionality.
+*/
+struct DpCluster : public SqChainedInstances< DpCluster >
+{
+    using Base = SqChainedInstances< DpCluster >;
+
+    /* --------------------------------------------------------------------------------------------
+     * Queue of events generated from other threads.
+    */
+    using EventItem = std::unique_ptr< DpEventBase >;
+    using EventQueue = moodycamel::ConcurrentQueue< EventItem >;
+
+    /* --------------------------------------------------------------------------------------------
+     * Type of container for cluster signals.
+    */
+    using Signals = std::array< SignalPair, static_cast< size_t >(DpEventID::Max) >;
+
+    /* --------------------------------------------------------------------------------------------
+     * Type of container for event handles.
+    */
+    using EventHandle = std::array< dpp::event_handle, static_cast< size_t >(DpEventID::Max) >;
+
+    /* --------------------------------------------------------------------------------------------
+     * Event queue.
+    */
+    EventQueue mQueue{4096};
+
+    /* --------------------------------------------------------------------------------------------
+     * Managed cluster instance.
+    */
+    std::unique_ptr< dpp::cluster > mC;
+
+    /* --------------------------------------------------------------------------------------------
+     * Table containing the emitted cluster events.
+    */
+    LightObj mSqEvents{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Cluster signals.
+    */
+    Signals mEvents{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Event handles for bound event event handlers so they can be stopped at any time.
+    */
+    EventHandle mEventsHandle{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Base constructors.
+    */
+    DpCluster(DpClusterOptions & o);
+
+    /* --------------------------------------------------------------------------------------------
+     * Copy/Move constructors (disabled).
+    */
+    DpCluster(const DpCluster &) noexcept = delete;
+    DpCluster(DpCluster &&) noexcept = delete;
+
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpCluster()
+    {
+        if (mC) Stop();
+        // Forget about this instance
+        UnchainInstance();
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Copy/Move assignment operators (disabled).
+    */
+    DpCluster & operator = (const DpCluster &) noexcept = delete;
+    DpCluster & operator = (DpCluster &&) noexcept = delete;
+
+    /* --------------------------------------------------------------------------------------------
+     * Check if the managed cluster instance is valid and throw an exception otherwise.
+    */
+    void Validate() const
+    {
+        if (!mC)
+        {
+            STHROWF("Discord cluster instance is not valid anymore.");
+        }
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Check if the managed cluster instance is valid and throw an exception otherwise.
+    */
+    void Validate(const char * m) const
+    {
+        if (!mC)
+        {
+            STHROWF("Cannot {} a cluster instance that is not valid anymore.", fmt::detail::to_string_view(m));
+        }
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Check if the managed cluster instance is valid and throw an exception otherwise.
+    */
+    dpp::cluster & Valid() const { Validate(); return *mC; }
+
+    /* --------------------------------------------------------------------------------------------
+     * Check if the managed cluster instance is valid and throw an exception otherwise.
+    */
+    dpp::cluster & Valid(const char * m) const { Validate(m); return *mC; }
+
+    /* --------------------------------------------------------------------------------------------
+     * Process the cluster. This is used internally on each server frame.
+    */
+    void Process(bool force = false);
+
+    /* --------------------------------------------------------------------------------------------
+     * Terminate the cluster. This is used internally when the VM is shutting down.
+    */
+    void Terminate();
+
+    /* --------------------------------------------------------------------------------------------
+     * Start the cluster.
+    */
+    DpCluster & Start() { Valid("start").start(dpp::st_return); return *this; }
+
+    /* --------------------------------------------------------------------------------------------
+     * Stop the cluster.
+    */
+    void Stop() { Valid("stop").shutdown(); }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the events table of this cluster.
+    */
+    SQMOD_NODISCARD LightObj & GetEvents()
+    {
+        return mSqEvents;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Enable a certain event for the cluster.
+    */
+    DpCluster & EnableEvent(SQInteger id);
+
+    /* --------------------------------------------------------------------------------------------
+     * Disable a certain event for the cluster.
+    */
+    DpCluster & DisableEvent(SQInteger id);
+
+private:
+
+    /* --------------------------------------------------------------------------------------------
+     * Signal initialization.
+    */
+    void InitEvents()
+    {
+        // Ignore the call if already initialized
+        if (!mSqEvents.IsNull())
+        {
+            return;
+        }
+        // Create a new table on the stack with enough space pre-allocated
+        sq_newtableex(SqVM(), static_cast< SQInteger >(DpEventID::Max + 1));
+        // Grab the table object from the stack
+        mSqEvents = LightObj(-1, SqVM());
+        // Pop the table object from the stack
+        sq_pop(SqVM(), 1);
+        // Proceed to initializing the events
+        for (size_t i = 0; i < mEvents.size(); ++i)
+        {
+            InitSignalPair(mEvents[i], mSqEvents, DpEventID::NAME[i]);
+        }
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Signal termination.
+    */
+    void DropEvents()
+    {
+        for (auto & e : mEvents)
+        {
+            ResetSignalPair(e);
+        }
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Event handlers.
+    */
+    void OnVoiceStateUpdate(const dpp::voice_state_update_t & ev);
+    void OnVoiceClientDisconnect(const dpp::voice_client_disconnect_t & ev);
+    void OnVoiceClientSpeaking(const dpp::voice_client_speaking_t & ev);
+    void OnLog(const dpp::log_t & ev);
+    void OnGuildJoinRequestDelete(const dpp::guild_join_request_delete_t & ev);
+    void OnInteractionCreate(const dpp::interaction_create_t & ev);
+    void OnSlashCommand(const dpp::slashcommand_t & ev);
+    void OnButtonClick(const dpp::button_click_t & ev);
+    void OnAutoComplete(const dpp::autocomplete_t & ev);
+    void OnSelectClick(const dpp::select_click_t & ev);
+    void OnMessageContextMenu(const dpp::message_context_menu_t & ev);
+    void OnUserContextMenu(const dpp::user_context_menu_t & ev);
+    void OnFormSubmit(const dpp::form_submit_t & ev);
+    void OnGuildDelete(const dpp::guild_delete_t & ev);
+    void OnChannelDelete(const dpp::channel_delete_t & ev);
+    void OnChannelUpdate(const dpp::channel_update_t & ev);
+    void OnReady(const dpp::ready_t & ev);
+    void OnMessageDelete(const dpp::message_delete_t & ev);
+    void OnGuildMemberRemove(const dpp::guild_member_remove_t & ev);
+    void OnResumed(const dpp::resumed_t & ev);
+    void OnGuildRoleCreate(const dpp::guild_role_create_t & ev);
+    void OnTypingStart(const dpp::typing_start_t & ev);
+    void OnMessageReactionAdd(const dpp::message_reaction_add_t & ev);
+    void OnGuildMembersChunk(const dpp::guild_members_chunk_t & ev);
+    void OnMessageReactionRemove(const dpp::message_reaction_remove_t & ev);
+    void OnGuildCreate(const dpp::guild_create_t & ev);
+    void OnChannelCreate(const dpp::channel_create_t & ev);
+    void OnMessageReactionRemoveEmoji(const dpp::message_reaction_remove_emoji_t & ev);
+    void OnMessageDeleteDulk(const dpp::message_delete_bulk_t & ev);
+    void OnGuildRoleUpdate(const dpp::guild_role_update_t & ev);
+    void OnGuildRoleDelete(const dpp::guild_role_delete_t & ev);
+    void OnChannelPinsUpdate(const dpp::channel_pins_update_t & ev);
+    void OnMessageReactionRemoveAll(const dpp::message_reaction_remove_all_t & ev);
+    void OnVoiceServerUpdate(const dpp::voice_server_update_t & ev);
+    void OnGuildEmojisUpdate(const dpp::guild_emojis_update_t & ev);
+    void OnGuildStickersUpdate(const dpp::guild_stickers_update_t & ev);
+    void OnPresenceUpdate(const dpp::presence_update_t & ev);
+    void OnWebhooksUpdate(const dpp::webhooks_update_t & ev);
+    void OnAutomodRuleCreate(const dpp::automod_rule_create_t & ev);
+    void OnAutomodRuleUpdate(const dpp::automod_rule_update_t & ev);
+    void OnAutomodRuleDelete(const dpp::automod_rule_delete_t & ev);
+    void OnAutomodRuleExecute(const dpp::automod_rule_execute_t & ev);
+    void OnGuildMemberAdd(const dpp::guild_member_add_t & ev);
+    void OnInviteDelete(const dpp::invite_delete_t & ev);
+    void OnGuildUpdate(const dpp::guild_update_t & ev);
+    void OnGuildIntegrationsUpdate(const dpp::guild_integrations_update_t & ev);
+    void OnGuildMemberUpdate(const dpp::guild_member_update_t & ev);
+    void OnInviteCreate(const dpp::invite_create_t & ev);
+    void OnMessageUpdate(const dpp::message_update_t & ev);
+    void OnUserUpdate(const dpp::user_update_t & ev);
+    void OnMessageCreate(const dpp::message_create_t & ev);
+    void OnGuildAuditLogEntryCreate(const dpp::guild_audit_log_entry_create_t & ev);
+    void OnGuildBanAdd(const dpp::guild_ban_add_t & ev);
+    void OnGuildBanRemove(const dpp::guild_ban_remove_t & ev);
+    void OnIntegrationCreate(const dpp::integration_create_t & ev);
+    void OnIntegrationUpdate(const dpp::integration_update_t & ev);
+    void OnIntegrationDelete(const dpp::integration_delete_t & ev);
+    void OnThreadCreate(const dpp::thread_create_t & ev);
+    void OnThreadUpdate(const dpp::thread_update_t & ev);
+    void OnThreadDelete(const dpp::thread_delete_t & ev);
+    void OnThreadListSync(const dpp::thread_list_sync_t & ev);
+    void OnThreadMemberUpdate(const dpp::thread_member_update_t & ev);
+    void OnThreadMembersUpdate(const dpp::thread_members_update_t & ev);
+    void OnGuildScheduledEventCreate(const dpp::guild_scheduled_event_create_t & ev);
+    void OnGuildScheduledEventUpdate(const dpp::guild_scheduled_event_update_t & ev);
+    void OnGuildScheduledEventDelete(const dpp::guild_scheduled_event_delete_t & ev);
+    void OnGuildScheduledEventUserAdd(const dpp::guild_scheduled_event_user_add_t & ev);
+    void OnGuildScheduledEventUserRemove(const dpp::guild_scheduled_event_user_remove_t & ev);
+    void OnVoiceBufferSend(const dpp::voice_buffer_send_t & ev);
+    void OnVoiceUserTalking(const dpp::voice_user_talking_t & ev);
+    void OnVoiceReady(const dpp::voice_ready_t & ev);
+    void OnVoiceReceive(const dpp::voice_receive_t & ev);
+    void OnVoiceReceiveCombined(const dpp::voice_receive_t & ev);
+    void OnVoiceTrackMarker(const dpp::voice_track_marker_t & ev);
+    void OnStageInstanceCreate(const dpp::stage_instance_create_t & ev);
+    void OnStageInstanceUpdate(const dpp::stage_instance_update_t & ev);
+    void OnStageInstanceDelete(const dpp::stage_instance_delete_t & ev);
+
+public:
+
+    // List type for command completion callbacks.
+    using CCList = std::list< Function >;
+    /* --------------------------------------------------------------------------------------------
+     * List of command completion callbacks.
+    */
+    CCList mCCList{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Queue of iterators pointing to results of completed commands and their associated result.
+    */
+    using CCResult = std::pair< CCList::iterator, DpCommandConfirmation::Ptr >;
+    using CCResultItem = std::unique_ptr< CCResult >;
+    using CCResultQueue = moodycamel::ConcurrentQueue< CCResultItem >;
+
+    /* --------------------------------------------------------------------------------------------
+     * Command completion links queue.
+    */
+    std::shared_ptr< CCResultQueue > mCCResults{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Maintains an iterator to the script callback associated with a completed command result.
+    */
+    struct CCLink
+    {
+        // Iterator to the element where the state can be found.
+        CCList::iterator    mItr{};
+        // Reference to the queue of iterators pointing to completed commands.
+        std::shared_ptr< CCResultQueue > mQueue{};
+        /* ----------------------------------------------------------------------------------------
+         * Base constructor.
+        */
+        CCLink(CCList::iterator && itr, std::shared_ptr< CCResultQueue > & q)
+            : mItr(std::forward< CCList::iterator >(itr)), mQueue(q)
+        { }
+        // Copy/Move constructors.
+        CCLink(const CCLink &) = default;
+        CCLink(CCLink &&) noexcept = default;
+        // Copy/Move assignment operators.
+        CCLink & operator = (const CCLink &) = default;
+        CCLink & operator = (CCLink &&) noexcept = default;
+        // Function call operator. Marks the linked callback as ready to invoke with obtained result.
+        void operator () (const dpp::confirmation_callback_t & cc) const
+        {
+            mQueue->enqueue(std::make_unique< CCResult >(std::move(mItr), std::make_unique< dpp::confirmation_callback_t >(cc.http_info)));
+        }
+    };
+
+    /* --------------------------------------------------------------------------------------------
+     * Get current (bot) user guilds.
+     * https://discord.com/developers/docs/resources/user#get-current-user-guilds
+    */
+    void CurrentUserGetGuilds(Function & cb)
+    {
+        Valid("get message").current_user_get_guilds(CCLink(mCCList.emplace(mCCList.cend(), std::move(cb)), mCCResults));
+    }
+};
+
+} // Namespace:: SqMod

module/Library/Discord/Command.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Command.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Command.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Constants.cpp

@@ -0,0 +1,321 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Constants.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <sqratConst.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+const std::array< const char *, static_cast< size_t >(DpEventID::Max) > DpEventID::NAME{
+    "VoiceStateUpdate",
+    "VoiceClientDisconnect",
+    "VoiceClientSpeaking",
+    "Log",
+    "GuildJoinRequestDelete",
+    "InteractionCreate",
+    "SlashCommand",
+    "ButtonClick",
+    "AutoComplete",
+    "SelectClick",
+    "MessageContextMenu",
+    "UserContextMenu",
+    "FormSubmit",
+    "GuildDelete",
+    "ChannelDelete",
+    "ChannelUpdate",
+    "Ready",
+    "MessageDelete",
+    "GuildMemberRemove",
+    "Resumed",
+    "GuildRoleCreate",
+    "TypingStart",
+    "MessageReactionAdd",
+    "GuildMembersChunk",
+    "MessageReactionRemove",
+    "GuildCreate",
+    "ChannelCreate",
+    "MessageReactionRemoveEmoji",
+    "MessageDeleteDulk",
+    "GuildRoleUpdate",
+    "GuildRoleDelete",
+    "ChannelPinsUpdate",
+    "MessageReactionRemoveAll",
+    "VoiceServerUpdate",
+    "GuildEmojisUpdate",
+    "GuildStickersUpdate",
+    "PresenceUpdate",
+    "WebhooksUpdate",
+    "AutomodRuleCreate",
+    "AutomodRuleUpdate",
+    "AutomodRuleDelete",
+    "AutomodRuleExecute",
+    "GuildMemberAdd",
+    "InviteDelete",
+    "GuildUpdate",
+    "GuildIntegrationsUpdate",
+    "GuildMemberUpdate",
+    "InviteCreate",
+    "MessageUpdate",
+    "UserUpdate",
+    "MessageCreate",
+    "GuildAuditLogEntryCreate",
+    "GuildBanAdd",
+    "GuildBanRemove",
+    "IntegrationCreate",
+    "IntegrationUpdate",
+    "IntegrationDelete",
+    "ThreadCreate",
+    "ThreadUpdate",
+    "ThreadDelete",
+    "ThreadListSync",
+    "ThreadMemberUpdate",
+    "ThreadMembersUpdate",
+    "GuildScheduledEventCreate",
+    "GuildScheduledEventUpdate",
+    "GuildScheduledEventDelete",
+    "GuildScheduledEventUserAdd",
+    "GuildScheduledEventUserRemove",
+    "VoiceBufferSend",
+    "VoiceUserTalking",
+    "VoiceReady",
+    "VoiceReceive",
+    "VoiceReceiveCombined",
+    "VoiceTrackMarker",
+    "StageInstanceCreate",
+    "StageInstanceUpdate",
+    "StageInstanceDelete",
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpLogLevelEnum[] = {
+    {_SC("Trace"),      static_cast< SQInteger >(dpp::ll_trace)},
+    {_SC("Debug"),      static_cast< SQInteger >(dpp::ll_debug)},
+    {_SC("Info"),       static_cast< SQInteger >(dpp::ll_info)},
+    {_SC("Warning"),    static_cast< SQInteger >(dpp::ll_warning)},
+    {_SC("Error"),      static_cast< SQInteger >(dpp::ll_error)},
+    {_SC("Critical"),   static_cast< SQInteger >(dpp::ll_critical)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpImageTypeEnum[] = {
+    {_SC("PNG"),        static_cast< SQInteger >(dpp::i_png)},
+    {_SC("JPG"),        static_cast< SQInteger >(dpp::i_jpg)},
+    {_SC("GIF"),        static_cast< SQInteger >(dpp::i_gif)},
+    {_SC("WEBP"),       static_cast< SQInteger >(dpp::i_webp)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpVoiceStateFlagsEnum[] = {
+    {_SC("Deaf"),       static_cast< SQInteger >(dpp::vs_deaf)},
+    {_SC("Mute"),       static_cast< SQInteger >(dpp::vs_mute)},
+    {_SC("SelfMute"),   static_cast< SQInteger >(dpp::vs_self_mute)},
+    {_SC("SelfDeaf"),   static_cast< SQInteger >(dpp::vs_self_deaf)},
+    {_SC("SelfStream"), static_cast< SQInteger >(dpp::vs_self_stream)},
+    {_SC("SelfVideo"),  static_cast< SQInteger >(dpp::vs_self_video)},
+    {_SC("Suppress"),   static_cast< SQInteger >(dpp::vs_suppress)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpEmojiFlagsEnum[] = {
+    {_SC("RequireColons"),      static_cast< SQInteger >(dpp::e_require_colons)},
+    {_SC("Managed"),            static_cast< SQInteger >(dpp::e_managed)},
+    {_SC("Animated"),           static_cast< SQInteger >(dpp::e_animated)},
+    {_SC("Available"),          static_cast< SQInteger >(dpp::e_available)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpPresenceFlagsEnum[] = {
+    {_SC("DesktopOnline"),      static_cast< SQInteger >(dpp::p_desktop_online)},
+    {_SC("DesktopDND"),         static_cast< SQInteger >(dpp::p_desktop_dnd)},
+    {_SC("DesktopIdle"),        static_cast< SQInteger >(dpp::p_desktop_idle)},
+    {_SC("WebOnline"),          static_cast< SQInteger >(dpp::p_web_online)},
+    {_SC("WebDND"),             static_cast< SQInteger >(dpp::p_web_dnd)},
+    {_SC("WebIdle"),            static_cast< SQInteger >(dpp::p_web_idle)},
+    {_SC("MobileOnline"),       static_cast< SQInteger >(dpp::p_mobile_online)},
+    {_SC("MobileDND"),          static_cast< SQInteger >(dpp::p_mobile_dnd)},
+    {_SC("MobileIdle"),         static_cast< SQInteger >(dpp::p_mobile_idle)},
+    {_SC("StatusOnline"),       static_cast< SQInteger >(dpp::p_status_online)},
+    {_SC("StatusDND"),          static_cast< SQInteger >(dpp::p_status_dnd)},
+    {_SC("StatusIdle"),         static_cast< SQInteger >(dpp::p_status_idle)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpPresenceStatusEnum[] = {
+    {_SC("Offline"),            static_cast< SQInteger >(dpp::ps_offline)},
+    {_SC("Online"),             static_cast< SQInteger >(dpp::ps_online)},
+    {_SC("DND"),                static_cast< SQInteger >(dpp::ps_dnd)},
+    {_SC("Idle"),               static_cast< SQInteger >(dpp::ps_idle)},
+    // Bit shift for desktop status
+    {_SC("ShiftDesktop"),       static_cast< SQInteger >(PF_SHIFT_DESKTOP)},
+    {_SC("ShiftWeb"),           static_cast< SQInteger >(PF_SHIFT_WEB)},
+    {_SC("ShiftMobile"),        static_cast< SQInteger >(PF_SHIFT_MOBILE)},
+    {_SC("ShiftMain"),          static_cast< SQInteger >(PF_SHIFT_MAIN)},
+    {_SC("StatusMask"),         static_cast< SQInteger >(PF_STATUS_MASK)},
+    {_SC("ClearDesktop"),       static_cast< SQInteger >(PF_CLEAR_DESKTOP)},
+    {_SC("ClearWeb"),           static_cast< SQInteger >(PF_CLEAR_WEB)},
+    {_SC("ClearMobile"),        static_cast< SQInteger >(PF_CLEAR_MOBILE)},
+    {_SC("ClearStatus"),        static_cast< SQInteger >(PF_CLEAR_STATUS)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpActivityTypeEnum[] = {
+    {_SC("Game"),               static_cast< SQInteger >(dpp::at_game)},
+    {_SC("Streaming"),          static_cast< SQInteger >(dpp::at_streaming)},
+    {_SC("Listening"),          static_cast< SQInteger >(dpp::at_listening)},
+    {_SC("Watching"),           static_cast< SQInteger >(dpp::at_watching)},
+    {_SC("Custom"),             static_cast< SQInteger >(dpp::at_custom)},
+    {_SC("Competing"),          static_cast< SQInteger >(dpp::at_competing)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpActivityFlagsEnum[] = {
+    {_SC("Instance"),                   static_cast< SQInteger >(dpp::af_instance)},
+    {_SC("Join"),                       static_cast< SQInteger >(dpp::af_join)},
+    {_SC("Spectate"),                   static_cast< SQInteger >(dpp::af_spectate)},
+    {_SC("JoinRequest"),                static_cast< SQInteger >(dpp::af_join_request)},
+    {_SC("Sync"),                       static_cast< SQInteger >(dpp::af_sync)},
+    {_SC("Play"),                       static_cast< SQInteger >(dpp::af_play)},
+    {_SC("PartyPrivacyFriends"),        static_cast< SQInteger >(dpp::af_party_privacy_friends)},
+    {_SC("PartyPrivacyVoiceChannel"),   static_cast< SQInteger >(dpp::af_party_privacy_voice_channel)},
+    {_SC("Embedded"),                   static_cast< SQInteger >(dpp::af_embedded)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpRegionEnum[] = {
+    {_SC("Brazil"),                     static_cast< SQInteger >(dpp::r_brazil)},
+    {_SC("CentralEurope"),              static_cast< SQInteger >(dpp::r_central_europe)},
+    {_SC("HongKong"),                   static_cast< SQInteger >(dpp::r_hong_kong)},
+    {_SC("India"),                      static_cast< SQInteger >(dpp::r_india)},
+    {_SC("Japan"),                      static_cast< SQInteger >(dpp::r_japan)},
+    {_SC("Russia"),                     static_cast< SQInteger >(dpp::r_russia)},
+    {_SC("Singapore"),                  static_cast< SQInteger >(dpp::r_singapore)},
+    {_SC("SouthAfrica"),                static_cast< SQInteger >(dpp::r_south_africa)},
+    {_SC("Sydney"),                     static_cast< SQInteger >(dpp::r_sydney)},
+    {_SC("UsCentral"),                  static_cast< SQInteger >(dpp::r_us_central)},
+    {_SC("UsEast"),                     static_cast< SQInteger >(dpp::r_us_east)},
+    {_SC("UsSouth"),                    static_cast< SQInteger >(dpp::r_us_south)},
+    {_SC("UsWest"),                     static_cast< SQInteger >(dpp::r_us_west)},
+    {_SC("WesternEurope"),              static_cast< SQInteger >(dpp::r_western_europe)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpGuildFlagsEnum[] = {
+    {_SC("Large"),                      static_cast< SQInteger >(dpp::g_large)},
+    {_SC("Unavailable"),                static_cast< SQInteger >(dpp::g_unavailable)},
+    {_SC("WidgetEnabled"),              static_cast< SQInteger >(dpp::g_widget_enabled)},
+    {_SC("InviteSplash"),               static_cast< SQInteger >(dpp::g_invite_splash)},
+    {_SC("VipRegions"),                 static_cast< SQInteger >(dpp::g_vip_regions)},
+    {_SC("VanityURL"),                  static_cast< SQInteger >(dpp::g_vanity_url)},
+    {_SC("Verified"),                   static_cast< SQInteger >(dpp::g_verified)},
+    {_SC("Partnered"),                  static_cast< SQInteger >(dpp::g_partnered)},
+    {_SC("Community"),                  static_cast< SQInteger >(dpp::g_community)},
+    {_SC("RoleSubscriptionEnabled"),    static_cast< SQInteger >(dpp::g_role_subscription_enabled)},
+    {_SC("News"),                       static_cast< SQInteger >(dpp::g_news)},
+    {_SC("Discoverable"),               static_cast< SQInteger >(dpp::g_discoverable)},
+    {_SC("Featureable"),                static_cast< SQInteger >(dpp::g_featureable)},
+    {_SC("AnimatedIcon"),               static_cast< SQInteger >(dpp::g_animated_icon)},
+    {_SC("Banner"),                     static_cast< SQInteger >(dpp::g_banner)},
+    {_SC("WelcomeScreenEnabled"),       static_cast< SQInteger >(dpp::g_welcome_screen_enabled)},
+    {_SC("MemberVerificationGate"),     static_cast< SQInteger >(dpp::g_member_verification_gate)},
+    {_SC("PreviewEnabled"),             static_cast< SQInteger >(dpp::g_preview_enabled)},
+    {_SC("NoJoinNotifications"),        static_cast< SQInteger >(dpp::g_no_join_notifications)},
+    {_SC("NoBoostNotifications"),       static_cast< SQInteger >(dpp::g_no_boost_notifications)},
+    {_SC("HasAnimatedIcon"),            static_cast< SQInteger >(dpp::g_has_animated_icon)},
+    {_SC("HasAnimatedBanner"),          static_cast< SQInteger >(dpp::g_has_animated_banner)},
+    {_SC("NoSetupTips"),                static_cast< SQInteger >(dpp::g_no_setup_tips)},
+    {_SC("NoStickerGreeting"),          static_cast< SQInteger >(dpp::g_no_sticker_greeting)},
+    {_SC("MonetizationEnabled"),        static_cast< SQInteger >(dpp::g_monetization_enabled)},
+    {_SC("MoreStickers"),               static_cast< SQInteger >(dpp::g_more_stickers)},
+    {_SC("CreatorStorePageEnabled"),    static_cast< SQInteger >(dpp::g_creator_store_page_enabled)},
+    {_SC("RoleIcons"),                  static_cast< SQInteger >(dpp::g_role_icons)},
+    {_SC("SevenDayThreadArchive"),      static_cast< SQInteger >(dpp::g_seven_day_thread_archive)},
+    {_SC("ThreeDayThreadArchive"),      static_cast< SQInteger >(dpp::g_three_day_thread_archive)},
+    {_SC("TicketedEvents"),             static_cast< SQInteger >(dpp::g_ticketed_events)},
+    {_SC("ChannelBanners"),             static_cast< SQInteger >(dpp::g_channel_banners)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpGuildFlagsExtraEnum[] = {
+    {_SC("PremiumProgressBarEnabled"),              static_cast< SQInteger >(dpp::g_premium_progress_bar_enabled)},
+    {_SC("AnimatedBanner"),                         static_cast< SQInteger >(dpp::g_animated_banner)},
+    {_SC("AutoModeration"),                         static_cast< SQInteger >(dpp::g_auto_moderation)},
+    {_SC("InvitesDisabled"),                        static_cast< SQInteger >(dpp::g_invites_disabled)},
+    {_SC("DeveloperSupportServer"),                 static_cast< SQInteger >(dpp::g_developer_support_server)},
+    {_SC("NoRoleSubscriptionNotifications"),        static_cast< SQInteger >(dpp::g_no_role_subscription_notifications)},
+    {_SC("NoRoleSubscriptionNotificationReplies"),  static_cast< SQInteger >(dpp::g_no_role_subscription_notification_replies)},
+    {_SC("RoleSubscriptionsAvailableForPurchase"),  static_cast< SQInteger >(dpp::g_role_subscriptions_available_for_purchase)},
+
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpGuildMemberFlagsEnum[] = {
+    {_SC("Deaf"),               static_cast< SQInteger >(dpp::gm_deaf)},
+    {_SC("Mute"),               static_cast< SQInteger >(dpp::gm_mute)},
+    {_SC("Pending"),            static_cast< SQInteger >(dpp::gm_pending)},
+    {_SC("AnimatedAvatar"),     static_cast< SQInteger >(dpp::gm_animated_avatar)},
+    {_SC("VoiceAction"),        static_cast< SQInteger >(dpp::gm_voice_action)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElement g_DpUserFlagsEnum[] = {
+    {_SC("Bot"),                    static_cast<SQInteger>(dpp::u_bot)},
+    {_SC("System"),                 static_cast<SQInteger>(dpp::u_system)},
+    {_SC("MfaEnabled"),             static_cast<SQInteger>(dpp::u_mfa_enabled)},
+    {_SC("Verified"),               static_cast<SQInteger>(dpp::u_verified)},
+    {_SC("NitroFull"),              static_cast<SQInteger>(dpp::u_nitro_full)},
+    {_SC("NitroClassic"),           static_cast<SQInteger>(dpp::u_nitro_classic)},
+    {_SC("DiscordEmployee"),        static_cast<SQInteger>(dpp::u_discord_employee)},
+    {_SC("PartneredOwner"),         static_cast<SQInteger>(dpp::u_partnered_owner)},
+    {_SC("HypesquadEvents"),        static_cast<SQInteger>(dpp::u_hypesquad_events)},
+    {_SC("Bughunter1"),             static_cast<SQInteger>(dpp::u_bughunter_1)},
+    {_SC("HouseBravery"),           static_cast<SQInteger>(dpp::u_house_bravery)},
+    {_SC("HouseBrilliance"),        static_cast<SQInteger>(dpp::u_house_brilliance)},
+    {_SC("HouseBalance"),           static_cast<SQInteger>(dpp::u_house_balance)},
+    {_SC("EarlySupporter"),         static_cast<SQInteger>(dpp::u_early_supporter)},
+    {_SC("TeamUser"),               static_cast<SQInteger>(dpp::u_team_user)},
+    {_SC("Bughunter2"),             static_cast<SQInteger>(dpp::u_bughunter_2)},
+    {_SC("VerifiedBot"),            static_cast<SQInteger>(dpp::u_verified_bot)},
+    {_SC("VerifiedBotDev"),         static_cast<SQInteger>(dpp::u_verified_bot_dev)},
+    {_SC("AnimatedIcon"),           static_cast<SQInteger>(dpp::u_animated_icon)},
+    {_SC("CertifiedModerator"),     static_cast<SQInteger>(dpp::u_certified_moderator)},
+    {_SC("BotHttpInteractions"),    static_cast<SQInteger>(dpp::u_bot_http_interactions)},
+    {_SC("NitroBasic"),             static_cast<SQInteger>(dpp::u_nitro_basic)},
+    {_SC("ActiveDeveloper"),        static_cast<SQInteger>(dpp::u_active_developer)},
+    {_SC("AnimatedBanner"),         static_cast<SQInteger>(dpp::u_animated_banner)},
+};
+
+// ------------------------------------------------------------------------------------------------
+static const EnumElements g_EnumList[] = {
+    {_SC("SqDiscordLogLevel"),              g_DpLogLevelEnum},
+    {_SC("SqDiscordImageType"),             g_DpImageTypeEnum},
+    {_SC("SqDiscordVoiceStateFlags"),       g_DpVoiceStateFlagsEnum},
+    {_SC("SqDiscordEmojiFlags"),            g_DpEmojiFlagsEnum},
+    {_SC("SqDiscordPresenceFlags"),         g_DpPresenceFlagsEnum},
+    {_SC("SqDiscordPresenceStatus"),        g_DpPresenceStatusEnum},
+    {_SC("SqDiscordActivityType"),          g_DpActivityTypeEnum},
+    {_SC("SqDiscordActivityFlags"),         g_DpActivityFlagsEnum},
+    {_SC("SqDiscordRegion"),                g_DpRegionEnum},
+    {_SC("SqDiscordGuildFlags"),            g_DpGuildFlagsEnum},
+    {_SC("SqDiscordGuildFlagsExtra"),       g_DpGuildFlagsExtraEnum},
+    {_SC("SqDiscordGuildMemberFlags"),      g_DpGuildMemberFlagsEnum},
+    {_SC("SqDiscordUserFlags"),             g_DpUserFlagsEnum},
+};
+
+// ------------------------------------------------------------------------------------------------
+void Register_Discord_Constants(HSQUIRRELVM vm, Table & ns)
+{
+    RegisterEnumerations(vm, g_EnumList);
+    // --------------------------------------------------------------------------------------------
+    Enumeration e(vm);
+    // Bind all events using their associated name
+    for (SQInteger i = 0; i < static_cast< SQInteger >(DpEventID::Max); ++i)
+    {
+        e.Const(DpEventID::NAME[i], i);
+    }
+    // Expose the constants
+    ConstTable(vm).Enum(_SC("SqDiscordEvent"), e);
+}
+
+} // Namespace:: SqMod

module/Library/Discord/Constants.hpp

@@ -0,0 +1,663 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+#include <array>
+#include <string_view>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+/* ------------------------------------------------------------------------------------------------
+ * Unique ID for each event.
+*/
+struct DpEventID
+{
+    /* --------------------------------------------------------------------------------------------
+     * ID enumeration.
+    */
+    enum Type
+    {
+        VoiceStateUpdate=0,
+        VoiceClientDisconnect,
+        VoiceClientSpeaking,
+        Log,
+        GuildJoinRequestDelete,
+        InteractionCreate,
+        SlashCommand,
+        ButtonClick,
+        AutoComplete,
+        SelectClick,
+        MessageContextMenu,
+        UserContextMenu,
+        FormSubmit,
+        GuildDelete,
+        ChannelDelete,
+        ChannelUpdate,
+        Ready,
+        MessageDelete,
+        GuildMemberRemove,
+        Resumed,
+        GuildRoleCreate,
+        TypingStart,
+        MessageReactionAdd,
+        GuildMembersChunk,
+        MessageReactionRemove,
+        GuildCreate,
+        ChannelCreate,
+        MessageReactionRemoveEmoji,
+        MessageDeleteDulk,
+        GuildRoleUpdate,
+        GuildRoleDelete,
+        ChannelPinsUpdate,
+        MessageReactionRemoveAll,
+        VoiceServerUpdate,
+        GuildEmojisUpdate,
+        GuildStickersUpdate,
+        PresenceUpdate,
+        WebhooksUpdate,
+        AutomodRuleCreate,
+        AutomodRuleUpdate,
+        AutomodRuleDelete,
+        AutomodRuleExecute,
+        GuildMemberAdd,
+        InviteDelete,
+        GuildUpdate,
+        GuildIntegrationsUpdate,
+        GuildMemberUpdate,
+        InviteCreate,
+        MessageUpdate,
+        UserUpdate,
+        MessageCreate,
+        GuildAuditLogEntryCreate,
+        GuildBanAdd,
+        GuildBanRemove,
+        IntegrationCreate,
+        IntegrationUpdate,
+        IntegrationDelete,
+        ThreadCreate,
+        ThreadUpdate,
+        ThreadDelete,
+        ThreadListSync,
+        ThreadMemberUpdate,
+        ThreadMembersUpdate,
+        GuildScheduledEventCreate,
+        GuildScheduledEventUpdate,
+        GuildScheduledEventDelete,
+        GuildScheduledEventUserAdd,
+        GuildScheduledEventUserRemove,
+        VoiceBufferSend,
+        VoiceUserTalking,
+        VoiceReady,
+        VoiceReceive,
+        VoiceReceiveCombined,
+        VoiceTrackMarker,
+        StageInstanceCreate,
+        StageInstanceUpdate,
+        StageInstanceDelete,
+        Max
+    };
+    /* --------------------------------------------------------------------------------------------
+     * String identification for each event ID.
+    */
+    static const std::array< const char *, static_cast< size_t >(Max) > NAME;
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Structures that hold compile-time type information for events.
+*/
+struct DpVoiceStateUpdateEventInfo
+{
+    using Type = dpp::voice_state_update_t;
+    static inline constexpr size_t ID = DpEventID::VoiceStateUpdate;
+    static inline constexpr std::string_view Name = "VoiceStateUpdate";
+};
+struct DpVoiceClientDisconnectEventInfo
+{
+    using Type = dpp::voice_client_disconnect_t;
+    static inline constexpr size_t ID = DpEventID::VoiceClientDisconnect;
+    static inline constexpr std::string_view Name = "VoiceClientDisconnect";
+};
+struct DpVoiceClientSpeakingEventInfo
+{
+    using Type = dpp::voice_client_speaking_t;
+    static inline constexpr size_t ID = DpEventID::VoiceClientSpeaking;
+    static inline constexpr std::string_view Name = "VoiceClientSpeaking";
+};
+struct DpLogEventInfo
+{
+    using Type = dpp::log_t;
+    static inline constexpr size_t ID = DpEventID::Log;
+    static inline constexpr std::string_view Name = "Log";
+};
+struct DpGuildJoinRequestDeleteEventInfo
+{
+    using Type = dpp::guild_join_request_delete_t;
+    static inline constexpr size_t ID = DpEventID::GuildJoinRequestDelete;
+    static inline constexpr std::string_view Name = "GuildJoinRequestDelete";
+};
+struct DpInteractionCreateEventInfo
+{
+    using Type = dpp::interaction_create_t;
+    static inline constexpr size_t ID = DpEventID::InteractionCreate;
+    static inline constexpr std::string_view Name = "InteractionCreate";
+};
+struct DpSlashCommandEventInfo
+{
+    using Type = dpp::slashcommand_t;
+    static inline constexpr size_t ID = DpEventID::SlashCommand;
+    static inline constexpr std::string_view Name = "SlashCommand";
+};
+struct DpButtonClickEventInfo
+{
+    using Type = dpp::button_click_t;
+    static inline constexpr size_t ID = DpEventID::ButtonClick;
+    static inline constexpr std::string_view Name = "ButtonClick";
+};
+struct DpAutoCompleteEventInfo
+{
+    using Type = dpp::autocomplete_t;
+    static inline constexpr size_t ID = DpEventID::AutoComplete;
+    static inline constexpr std::string_view Name = "AutoComplete";
+};
+struct DpSelectClickEventInfo
+{
+    using Type = dpp::select_click_t;
+    static inline constexpr size_t ID = DpEventID::SelectClick;
+    static inline constexpr std::string_view Name = "SelectClick";
+};
+struct DpMessageContextMenuEventInfo
+{
+    using Type = dpp::message_context_menu_t;
+    static inline constexpr size_t ID = DpEventID::MessageContextMenu;
+    static inline constexpr std::string_view Name = "MessageContextMenu";
+};
+struct DpUserContextMenuEventInfo
+{
+    using Type = dpp::user_context_menu_t;
+    static inline constexpr size_t ID = DpEventID::UserContextMenu;
+    static inline constexpr std::string_view Name = "UserContextMenu";
+};
+struct DpFormSubmitEventInfo
+{
+    using Type = dpp::form_submit_t;
+    static inline constexpr size_t ID = DpEventID::FormSubmit;
+    static inline constexpr std::string_view Name = "FormSubmit";
+};
+struct DpGuildDeleteEventInfo
+{
+    using Type = dpp::guild_delete_t;
+    static inline constexpr size_t ID = DpEventID::GuildDelete;
+    static inline constexpr std::string_view Name = "GuildDelete";
+};
+struct DpChannelDeleteEventInfo
+{
+    using Type = dpp::channel_delete_t;
+    static inline constexpr size_t ID = DpEventID::ChannelDelete;
+    static inline constexpr std::string_view Name = "ChannelDelete";
+};
+struct DpChannelUpdateEventInfo
+{
+    using Type = dpp::channel_update_t;
+    static inline constexpr size_t ID = DpEventID::ChannelUpdate;
+    static inline constexpr std::string_view Name = "ChannelUpdate";
+};
+struct DpReadyEventInfo
+{
+    using Type = dpp::ready_t;
+    static inline constexpr size_t ID = DpEventID::Ready;
+    static inline constexpr std::string_view Name = "Ready";
+};
+struct DpMessageDeleteEventInfo
+{
+    using Type = dpp::message_delete_t;
+    static inline constexpr size_t ID = DpEventID::MessageDelete;
+    static inline constexpr std::string_view Name = "MessageDelete";
+};
+struct DpGuildMemberRemoveEventInfo
+{
+    using Type = dpp::guild_member_remove_t;
+    static inline constexpr size_t ID = DpEventID::GuildMemberRemove;
+    static inline constexpr std::string_view Name = "GuildMemberRemove";
+};
+struct DpResumedEventInfo
+{
+    using Type = dpp::resumed_t;
+    static inline constexpr size_t ID = DpEventID::Resumed;
+    static inline constexpr std::string_view Name = "Resumed";
+};
+struct DpGuildRoleCreateEventInfo
+{
+    using Type = dpp::guild_role_create_t;
+    static inline constexpr size_t ID = DpEventID::GuildRoleCreate;
+    static inline constexpr std::string_view Name = "GuildRoleCreate";
+};
+struct DpTypingStartEventInfo
+{
+    using Type = dpp::typing_start_t;
+    static inline constexpr size_t ID = DpEventID::TypingStart;
+    static inline constexpr std::string_view Name = "TypingStart";
+};
+struct DpMessageReactionAddEventInfo
+{
+    using Type = dpp::message_reaction_add_t;
+    static inline constexpr size_t ID = DpEventID::MessageReactionAdd;
+    static inline constexpr std::string_view Name = "MessageReactionAdd";
+};
+struct DpGuildMembersChunkEventInfo
+{
+    using Type = dpp::guild_members_chunk_t;
+    static inline constexpr size_t ID = DpEventID::GuildMembersChunk;
+    static inline constexpr std::string_view Name = "GuildMembersChunk";
+};
+struct DpMessageReactionRemoveEventInfo
+{
+    using Type = dpp::message_reaction_remove_t;
+    static inline constexpr size_t ID = DpEventID::MessageReactionRemove;
+    static inline constexpr std::string_view Name = "MessageReactionRemove";
+};
+struct DpGuildCreateEventInfo
+{
+    using Type = dpp::guild_create_t;
+    static inline constexpr size_t ID = DpEventID::GuildCreate;
+    static inline constexpr std::string_view Name = "GuildCreate";
+};
+struct DpChannelCreateEventInfo
+{
+    using Type = dpp::channel_create_t;
+    static inline constexpr size_t ID = DpEventID::ChannelCreate;
+    static inline constexpr std::string_view Name = "ChannelCreate";
+};
+struct DpMessageReactionRemoveEmojiEventInfo
+{
+    using Type = dpp::message_reaction_remove_emoji_t;
+    static inline constexpr size_t ID = DpEventID::MessageReactionRemoveEmoji;
+    static inline constexpr std::string_view Name = "MessageReactionRemoveEmoji";
+};
+struct DpMessageDeleteDulkEventInfo
+{
+    using Type = dpp::message_delete_bulk_t;
+    static inline constexpr size_t ID = DpEventID::MessageDeleteDulk;
+    static inline constexpr std::string_view Name = "MessageDeleteDulk";
+};
+struct DpGuildRoleUpdateEventInfo
+{
+    using Type = dpp::guild_role_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildRoleUpdate;
+    static inline constexpr std::string_view Name = "GuildRoleUpdate";
+};
+struct DpGuildRoleDeleteEventInfo
+{
+    using Type = dpp::guild_role_delete_t;
+    static inline constexpr size_t ID = DpEventID::GuildRoleDelete;
+    static inline constexpr std::string_view Name = "GuildRoleDelete";
+};
+struct DpChannelPinsUpdateEventInfo
+{
+    using Type = dpp::channel_pins_update_t;
+    static inline constexpr size_t ID = DpEventID::ChannelPinsUpdate;
+    static inline constexpr std::string_view Name = "ChannelPinsUpdate";
+};
+struct DpMessageReactionRemoveAllEventInfo
+{
+    using Type = dpp::message_reaction_remove_all_t;
+    static inline constexpr size_t ID = DpEventID::MessageReactionRemoveAll;
+    static inline constexpr std::string_view Name = "MessageReactionRemoveAll";
+};
+struct DpVoiceServerUpdateEventInfo
+{
+    using Type = dpp::voice_server_update_t;
+    static inline constexpr size_t ID = DpEventID::VoiceServerUpdate;
+    static inline constexpr std::string_view Name = "VoiceServerUpdate";
+};
+struct DpGuildEmojisUpdateEventInfo
+{
+    using Type = dpp::guild_emojis_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildEmojisUpdate;
+    static inline constexpr std::string_view Name = "GuildEmojisUpdate";
+};
+struct DpGuildStickersUpdateEventInfo
+{
+    using Type = dpp::guild_stickers_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildStickersUpdate;
+    static inline constexpr std::string_view Name = "GuildStickersUpdate";
+};
+struct DpPresenceUpdateEventInfo
+{
+    using Type = dpp::presence_update_t;
+    static inline constexpr size_t ID = DpEventID::PresenceUpdate;
+    static inline constexpr std::string_view Name = "PresenceUpdate";
+};
+struct DpWebhooksUpdateEventInfo
+{
+    using Type = dpp::webhooks_update_t;
+    static inline constexpr size_t ID = DpEventID::WebhooksUpdate;
+    static inline constexpr std::string_view Name = "WebhooksUpdate";
+};
+struct DpAutomodRuleCreateEventInfo
+{
+    using Type = dpp::automod_rule_create_t;
+    static inline constexpr size_t ID = DpEventID::AutomodRuleCreate;
+    static inline constexpr std::string_view Name = "AutomodRuleCreate";
+};
+struct DpAutomodRuleUpdateEventInfo
+{
+    using Type = dpp::automod_rule_update_t;
+    static inline constexpr size_t ID = DpEventID::AutomodRuleUpdate;
+    static inline constexpr std::string_view Name = "AutomodRuleUpdate";
+};
+struct DpAutomodRuleDeleteEventInfo
+{
+    using Type = dpp::automod_rule_delete_t;
+    static inline constexpr size_t ID = DpEventID::AutomodRuleDelete;
+    static inline constexpr std::string_view Name = "AutomodRuleDelete";
+};
+struct DpAutomodRuleExecuteEventInfo
+{
+    using Type = dpp::automod_rule_execute_t;
+    static inline constexpr size_t ID = DpEventID::AutomodRuleExecute;
+    static inline constexpr std::string_view Name = "AutomodRuleExecute";
+};
+struct DpGuildMemberAddEventInfo
+{
+    using Type = dpp::guild_member_add_t;
+    static inline constexpr size_t ID = DpEventID::GuildMemberAdd;
+    static inline constexpr std::string_view Name = "GuildMemberAdd";
+};
+struct DpInviteDeleteEventInfo
+{
+    using Type = dpp::invite_delete_t;
+    static inline constexpr size_t ID = DpEventID::InviteDelete;
+    static inline constexpr std::string_view Name = "InviteDelete";
+};
+struct DpGuildUpdateEventInfo
+{
+    using Type = dpp::guild_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildUpdate;
+    static inline constexpr std::string_view Name = "GuildUpdate";
+};
+struct DpGuildIntegrationsUpdateEventInfo
+{
+    using Type = dpp::guild_integrations_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildIntegrationsUpdate;
+    static inline constexpr std::string_view Name = "GuildIntegrationsUpdate";
+};
+struct DpGuildMemberUpdateEventInfo
+{
+    using Type = dpp::guild_member_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildMemberUpdate;
+    static inline constexpr std::string_view Name = "GuildMemberUpdate";
+};
+struct DpInviteCreateEventInfo
+{
+    using Type = dpp::invite_create_t;
+    static inline constexpr size_t ID = DpEventID::InviteCreate;
+    static inline constexpr std::string_view Name = "InviteCreate";
+};
+struct DpMessageUpdateEventInfo
+{
+    using Type = dpp::message_update_t;
+    static inline constexpr size_t ID = DpEventID::MessageUpdate;
+    static inline constexpr std::string_view Name = "MessageUpdate";
+};
+struct DpUserUpdateEventInfo
+{
+    using Type = dpp::user_update_t;
+    static inline constexpr size_t ID = DpEventID::UserUpdate;
+    static inline constexpr std::string_view Name = "UserUpdate";
+};
+struct DpMessageCreateEventInfo
+{
+    using Type = dpp::message_create_t;
+    static inline constexpr size_t ID = DpEventID::MessageCreate;
+    static inline constexpr std::string_view Name = "MessageCreate";
+};
+struct DpGuildAuditLogEntryCreateEventInfo
+{
+    using Type = dpp::guild_audit_log_entry_create_t;
+    static inline constexpr size_t ID = DpEventID::GuildAuditLogEntryCreate;
+    static inline constexpr std::string_view Name = "GuildAuditLogEntryCreate";
+};
+struct DpGuildBanAddEventInfo
+{
+    using Type = dpp::guild_ban_add_t;
+    static inline constexpr size_t ID = DpEventID::GuildBanAdd;
+    static inline constexpr std::string_view Name = "GuildBanAdd";
+};
+struct DpGuildBanRemoveEventInfo
+{
+    using Type = dpp::guild_ban_remove_t;
+    static inline constexpr size_t ID = DpEventID::GuildBanRemove;
+    static inline constexpr std::string_view Name = "GuildBanRemove";
+};
+struct DpIntegrationCreateEventInfo
+{
+    using Type = dpp::integration_create_t;
+    static inline constexpr size_t ID = DpEventID::IntegrationCreate;
+    static inline constexpr std::string_view Name = "IntegrationCreate";
+};
+struct DpIntegrationUpdateEventInfo
+{
+    using Type = dpp::integration_update_t;
+    static inline constexpr size_t ID = DpEventID::IntegrationUpdate;
+    static inline constexpr std::string_view Name = "IntegrationUpdate";
+};
+struct DpIntegrationDeleteEventInfo
+{
+    using Type = dpp::integration_delete_t;
+    static inline constexpr size_t ID = DpEventID::IntegrationDelete;
+    static inline constexpr std::string_view Name = "IntegrationDelete";
+};
+struct DpThreadCreateEventInfo
+{
+    using Type = dpp::thread_create_t;
+    static inline constexpr size_t ID = DpEventID::ThreadCreate;
+    static inline constexpr std::string_view Name = "ThreadCreate";
+};
+struct DpThreadUpdateEventInfo
+{
+    using Type = dpp::thread_update_t;
+    static inline constexpr size_t ID = DpEventID::ThreadUpdate;
+    static inline constexpr std::string_view Name = "ThreadUpdate";
+};
+struct DpThreadDeleteEventInfo
+{
+    using Type = dpp::thread_delete_t;
+    static inline constexpr size_t ID = DpEventID::ThreadDelete;
+    static inline constexpr std::string_view Name = "ThreadDelete";
+};
+struct DpThreadListSyncEventInfo
+{
+    using Type = dpp::thread_list_sync_t;
+    static inline constexpr size_t ID = DpEventID::ThreadListSync;
+    static inline constexpr std::string_view Name = "ThreadListSync";
+};
+struct DpThreadMemberUpdateEventInfo
+{
+    using Type = dpp::thread_member_update_t;
+    static inline constexpr size_t ID = DpEventID::ThreadMemberUpdate;
+    static inline constexpr std::string_view Name = "ThreadMemberUpdate";
+};
+struct DpThreadMembersUpdateEventInfo
+{
+    using Type = dpp::thread_members_update_t;
+    static inline constexpr size_t ID = DpEventID::ThreadMembersUpdate;
+    static inline constexpr std::string_view Name = "ThreadMembersUpdate";
+};
+struct DpGuildScheduledEventCreateEventInfo
+{
+    using Type = dpp::guild_scheduled_event_create_t;
+    static inline constexpr size_t ID = DpEventID::GuildScheduledEventCreate;
+    static inline constexpr std::string_view Name = "GuildScheduledEventCreate";
+};
+struct DpGuildScheduledEventUpdateEventInfo
+{
+    using Type = dpp::guild_scheduled_event_update_t;
+    static inline constexpr size_t ID = DpEventID::GuildScheduledEventUpdate;
+    static inline constexpr std::string_view Name = "GuildScheduledEventUpdate";
+};
+struct DpGuildScheduledEventDeleteEventInfo
+{
+    using Type = dpp::guild_scheduled_event_delete_t;
+    static inline constexpr size_t ID = DpEventID::GuildScheduledEventDelete;
+    static inline constexpr std::string_view Name = "GuildScheduledEventDelete";
+};
+struct DpGuildScheduledEventUserAddEventInfo
+{
+    using Type = dpp::guild_scheduled_event_user_add_t;
+    static inline constexpr size_t ID = DpEventID::GuildScheduledEventUserAdd;
+    static inline constexpr std::string_view Name = "GuildScheduledEventUserAdd";
+};
+struct DpGuildScheduledEventUserRemoveEventInfo
+{
+    using Type = dpp::guild_scheduled_event_user_remove_t;
+    static inline constexpr size_t ID = DpEventID::GuildScheduledEventUserRemove;
+    static inline constexpr std::string_view Name = "GuildScheduledEventUserRemove";
+};
+struct DpVoiceBufferSendEventInfo
+{
+    using Type = dpp::voice_buffer_send_t;
+    static inline constexpr size_t ID = DpEventID::VoiceBufferSend;
+    static inline constexpr std::string_view Name = "VoiceBufferSend";
+};
+struct DpVoiceUserTalkingEventInfo
+{
+    using Type = dpp::voice_user_talking_t;
+    static inline constexpr size_t ID = DpEventID::VoiceUserTalking;
+    static inline constexpr std::string_view Name = "VoiceUserTalking";
+};
+struct DpVoiceReadyEventInfo
+{
+    using Type = dpp::voice_ready_t;
+    static inline constexpr size_t ID = DpEventID::VoiceReady;
+    static inline constexpr std::string_view Name = "VoiceReady";
+};
+struct DpVoiceReceiveEventInfo
+{
+    using Type = dpp::voice_receive_t;
+    static inline constexpr size_t ID = DpEventID::VoiceReceive;
+    static inline constexpr std::string_view Name = "VoiceReceive";
+};
+struct DpVoiceReceiveCombinedEventInfo
+{
+    using Type = dpp::voice_receive_t;
+    static inline constexpr size_t ID = DpEventID::VoiceReceiveCombined;
+    static inline constexpr std::string_view Name = "VoiceReceiveCombined";
+};
+struct DpVoiceTrackMarkerEventInfo
+{
+    using Type = dpp::voice_track_marker_t;
+    static inline constexpr size_t ID = DpEventID::VoiceTrackMarker;
+    static inline constexpr std::string_view Name = "VoiceTrackMarker";
+};
+struct DpStageInstanceCreateEventInfo
+{
+    using Type = dpp::stage_instance_create_t;
+    static inline constexpr size_t ID = DpEventID::StageInstanceCreate;
+    static inline constexpr std::string_view Name = "StageInstanceCreate";
+};
+struct DpStageInstanceUpdateEventInfo
+{
+    using Type = dpp::stage_instance_update_t;
+    static inline constexpr size_t ID = DpEventID::StageInstanceUpdate;
+    static inline constexpr std::string_view Name = "StageInstanceUpdate";
+};
+struct DpStageInstanceDeleteEventInfo
+{
+    using Type = dpp::stage_instance_delete_t;
+    static inline constexpr size_t ID = DpEventID::StageInstanceDelete;
+    static inline constexpr std::string_view Name = "StageInstanceDelete";
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Utility used to acquire event information at compile time.
+*/
+template < int > struct EventInfoID;
+
+/* ------------------------------------------------------------------------------------------------
+ * Implementation.
+*/
+template < > struct EventInfoID< DpEventID::VoiceStateUpdate > : public DpVoiceStateUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceClientDisconnect > : public DpVoiceClientDisconnectEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceClientSpeaking > : public DpVoiceClientSpeakingEventInfo { };
+template < > struct EventInfoID< DpEventID::Log > : public DpLogEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildJoinRequestDelete > : public DpGuildJoinRequestDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::InteractionCreate > : public DpInteractionCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::SlashCommand > : public DpSlashCommandEventInfo { };
+template < > struct EventInfoID< DpEventID::ButtonClick > : public DpButtonClickEventInfo { };
+template < > struct EventInfoID< DpEventID::AutoComplete > : public DpAutoCompleteEventInfo { };
+template < > struct EventInfoID< DpEventID::SelectClick > : public DpSelectClickEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageContextMenu > : public DpMessageContextMenuEventInfo { };
+template < > struct EventInfoID< DpEventID::UserContextMenu > : public DpUserContextMenuEventInfo { };
+template < > struct EventInfoID< DpEventID::FormSubmit > : public DpFormSubmitEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildDelete > : public DpGuildDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::ChannelDelete > : public DpChannelDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::ChannelUpdate > : public DpChannelUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::Ready > : public DpReadyEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageDelete > : public DpMessageDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildMemberRemove > : public DpGuildMemberRemoveEventInfo { };
+template < > struct EventInfoID< DpEventID::Resumed > : public DpResumedEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildRoleCreate > : public DpGuildRoleCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::TypingStart > : public DpTypingStartEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageReactionAdd > : public DpMessageReactionAddEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildMembersChunk > : public DpGuildMembersChunkEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageReactionRemove > : public DpMessageReactionRemoveEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildCreate > : public DpGuildCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::ChannelCreate > : public DpChannelCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageReactionRemoveEmoji > : public DpMessageReactionRemoveEmojiEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageDeleteDulk > : public DpMessageDeleteDulkEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildRoleUpdate > : public DpGuildRoleUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildRoleDelete > : public DpGuildRoleDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::ChannelPinsUpdate > : public DpChannelPinsUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageReactionRemoveAll > : public DpMessageReactionRemoveAllEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceServerUpdate > : public DpVoiceServerUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildEmojisUpdate > : public DpGuildEmojisUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildStickersUpdate > : public DpGuildStickersUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::PresenceUpdate > : public DpPresenceUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::WebhooksUpdate > : public DpWebhooksUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::AutomodRuleCreate > : public DpAutomodRuleCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::AutomodRuleUpdate > : public DpAutomodRuleUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::AutomodRuleDelete > : public DpAutomodRuleDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::AutomodRuleExecute > : public DpAutomodRuleExecuteEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildMemberAdd > : public DpGuildMemberAddEventInfo { };
+template < > struct EventInfoID< DpEventID::InviteDelete > : public DpInviteDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildUpdate > : public DpGuildUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildIntegrationsUpdate > : public DpGuildIntegrationsUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildMemberUpdate > : public DpGuildMemberUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::InviteCreate > : public DpInviteCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageUpdate > : public DpMessageUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::UserUpdate > : public DpUserUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::MessageCreate > : public DpMessageCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildAuditLogEntryCreate > : public DpGuildAuditLogEntryCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildBanAdd > : public DpGuildBanAddEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildBanRemove > : public DpGuildBanRemoveEventInfo { };
+template < > struct EventInfoID< DpEventID::IntegrationCreate > : public DpIntegrationCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::IntegrationUpdate > : public DpIntegrationUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::IntegrationDelete > : public DpIntegrationDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::ThreadCreate > : public DpThreadCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::ThreadUpdate > : public DpThreadUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::ThreadDelete > : public DpThreadDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::ThreadListSync > : public DpThreadListSyncEventInfo { };
+template < > struct EventInfoID< DpEventID::ThreadMemberUpdate > : public DpThreadMemberUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::ThreadMembersUpdate > : public DpThreadMembersUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildScheduledEventCreate > : public DpGuildScheduledEventCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildScheduledEventUpdate > : public DpGuildScheduledEventUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildScheduledEventDelete > : public DpGuildScheduledEventDeleteEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildScheduledEventUserAdd > : public DpGuildScheduledEventUserAddEventInfo { };
+template < > struct EventInfoID< DpEventID::GuildScheduledEventUserRemove > : public DpGuildScheduledEventUserRemoveEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceBufferSend > : public DpVoiceBufferSendEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceUserTalking > : public DpVoiceUserTalkingEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceReady > : public DpVoiceReadyEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceReceive > : public DpVoiceReceiveEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceReceiveCombined > : public DpVoiceReceiveCombinedEventInfo { };
+template < > struct EventInfoID< DpEventID::VoiceTrackMarker > : public DpVoiceTrackMarkerEventInfo { };
+template < > struct EventInfoID< DpEventID::StageInstanceCreate > : public DpStageInstanceCreateEventInfo { };
+template < > struct EventInfoID< DpEventID::StageInstanceUpdate > : public DpStageInstanceUpdateEventInfo { };
+template < > struct EventInfoID< DpEventID::StageInstanceDelete > : public DpStageInstanceDeleteEventInfo { };
+
+} // Namespace:: SqMod

module/Library/Discord/Events.cpp

@@ -0,0 +1,787 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Events.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqDpVoiceStateUpdateEvent, _SC("SqDiscordVoiceStateUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceClientDisconnectEvent, _SC("SqDiscordVoiceClientDisconnectEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceClientSpeakingEvent, _SC("SqDiscordVoiceClientSpeakingEvent"))
+SQMOD_DECL_TYPENAME(SqDpLogEvent, _SC("SqDiscordLogEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildJoinRequestDeleteEvent, _SC("SqDiscordGuildJoinRequestDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpInteractionCreateEvent, _SC("SqDiscordInteractionCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpSlashCommandEvent, _SC("SqDiscordSlashCommandEvent"))
+SQMOD_DECL_TYPENAME(SqDpButtonClickEvent, _SC("SqDiscordButtonClickEvent"))
+SQMOD_DECL_TYPENAME(SqDpAutoCompleteEvent, _SC("SqDiscordAutoCompleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpSelectClickEvent, _SC("SqDiscordSelectClickEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageContextMenuEvent, _SC("SqDiscordMessageContextMenuEvent"))
+SQMOD_DECL_TYPENAME(SqDpUserContextMenuEvent, _SC("SqDiscordUserContextMenuEvent"))
+SQMOD_DECL_TYPENAME(SqDpFormSubmitEvent, _SC("SqDiscordFormSubmitEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildDeleteEvent, _SC("SqDiscordGuildDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpChannelDeleteEvent, _SC("SqDiscordChannelDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpChannelUpdateEvent, _SC("SqDiscordChannelUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpReadyEvent, _SC("SqDiscordReadyEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageDeleteEvent, _SC("SqDiscordMessageDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildMemberRemoveEvent, _SC("SqDiscordGuildMemberRemoveEvent"))
+SQMOD_DECL_TYPENAME(SqDpResumedEvent, _SC("SqDiscordResumedEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildRoleCreateEvent, _SC("SqDiscordGuildRoleCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpTypingStartEvent, _SC("SqDiscordTypingStartEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageReactionAddEvent, _SC("SqDiscordMessageReactionAddEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildMembersChunkEvent, _SC("SqDiscordGuildMembersChunkEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageReactionRemoveEvent, _SC("SqDiscordMessageReactionRemoveEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildCreateEvent, _SC("SqDiscordGuildCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpChannelCreateEvent, _SC("SqDiscordChannelCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageReactionRemoveEmojiEvent, _SC("SqDiscordMessageReactionRemoveEmojiEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageDeleteDulkEvent, _SC("SqDiscordMessageDeleteDulkEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildRoleUpdateEvent, _SC("SqDiscordGuildRoleUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildRoleDeleteEvent, _SC("SqDiscordGuildRoleDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpChannelPinsUpdateEvent, _SC("SqDiscordChannelPinsUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageReactionRemoveAllEvent, _SC("SqDiscordMessageReactionRemoveAllEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceServerUpdateEvent, _SC("SqDiscordVoiceServerUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildEmojisUpdateEvent, _SC("SqDiscordGuildEmojisUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildStickersUpdateEvent, _SC("SqDiscordGuildStickersUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpPresenceUpdateEvent, _SC("SqDiscordPresenceUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpWebhooksUpdateEvent, _SC("SqDiscordWebhooksUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpAutomodRuleCreateEvent, _SC("SqDiscordAutomodRuleCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpAutomodRuleUpdateEvent, _SC("SqDiscordAutomodRuleUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpAutomodRuleDeleteEvent, _SC("SqDiscordAutomodRuleDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpAutomodRuleExecuteEvent, _SC("SqDiscordAutomodRuleExecuteEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildMemberAddEvent, _SC("SqDiscordGuildMemberAddEvent"))
+SQMOD_DECL_TYPENAME(SqDpInviteDeleteEvent, _SC("SqDiscordInviteDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildUpdateEvent, _SC("SqDiscordGuildUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildIntegrationsUpdateEvent, _SC("SqDiscordGuildIntegrationsUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildMemberUpdateEvent, _SC("SqDiscordGuildMemberUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpInviteCreateEvent, _SC("SqDiscordInviteCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageUpdateEvent, _SC("SqDiscordMessageUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpUserUpdateEvent, _SC("SqDiscordUserUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpMessageCreateEvent, _SC("SqDiscordMessageCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildAuditLogEntryCreateEvent, _SC("SqDiscordGuildAuditLogEntryCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildBanAddEvent, _SC("SqDiscordGuildBanAddEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildBanRemoveEvent, _SC("SqDiscordGuildBanRemoveEvent"))
+SQMOD_DECL_TYPENAME(SqDpIntegrationCreateEvent, _SC("SqDiscordIntegrationCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpIntegrationUpdateEvent, _SC("SqDiscordIntegrationUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpIntegrationDeleteEvent, _SC("SqDiscordIntegrationDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpThreadCreateEvent, _SC("SqDiscordThreadCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpThreadUpdateEvent, _SC("SqDiscordThreadUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpThreadDeleteEvent, _SC("SqDiscordThreadDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpThreadListSyncEvent, _SC("SqDiscordThreadListSyncEvent"))
+SQMOD_DECL_TYPENAME(SqDpThreadMemberUpdateEvent, _SC("SqDiscordThreadMemberUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpThreadMembersUpdateEvent, _SC("SqDiscordThreadMembersUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildScheduledEventCreateEvent, _SC("SqDiscordGuildScheduledEventCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildScheduledEventUpdateEvent, _SC("SqDiscordGuildScheduledEventUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildScheduledEventDeleteEvent, _SC("SqDiscordGuildScheduledEventDeleteEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildScheduledEventUserAddEvent, _SC("SqDiscordGuildScheduledEventUserAddEvent"))
+SQMOD_DECL_TYPENAME(SqDpGuildScheduledEventUserRemoveEvent, _SC("SqDiscordGuildScheduledEventUserRemoveEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceBufferSendEvent, _SC("SqDiscordVoiceBufferSendEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceUserTalkingEvent, _SC("SqDiscordVoiceUserTalkingEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceReadyEvent, _SC("SqDiscordVoiceReadyEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceReceiveEvent, _SC("SqDiscordVoiceReceiveEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceReceiveCombinedEvent, _SC("SqDiscordVoiceReceiveCombinedEvent"))
+SQMOD_DECL_TYPENAME(SqDpVoiceTrackMarkerEvent, _SC("SqDiscordVoiceTrackMarkerEvent"))
+SQMOD_DECL_TYPENAME(SqDpStageInstanceCreateEvent, _SC("SqDiscordStageInstanceCreateEvent"))
+SQMOD_DECL_TYPENAME(SqDpStageInstanceUpdateEvent, _SC("SqDiscordStageInstanceUpdateEvent"))
+SQMOD_DECL_TYPENAME(SqDpStageInstanceDeleteEvent, _SC("SqDiscordStageInstanceDeleteEvent"))
+
+// ------------------------------------------------------------------------------------------------
+void Register_Discord_Events(HSQUIRRELVM vm, Table & ns)
+{
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceStateUpdate"),
+        Class< DpVoiceStateUpdateEvent, NoConstructor< DpVoiceStateUpdateEvent > >(vm, SqDpVoiceStateUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceStateUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceStateUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceStateUpdateEvent::GetRawEvent)
+        .Prop(_SC("State"), &DpVoiceStateUpdateEvent::GetState)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceClientDisconnect"),
+        Class< DpVoiceClientDisconnectEvent, NoConstructor< DpVoiceClientDisconnectEvent > >(vm, SqDpVoiceClientDisconnectEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceClientDisconnectEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceClientDisconnectEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceClientDisconnectEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceClientSpeaking"),
+        Class< DpVoiceClientSpeakingEvent, NoConstructor< DpVoiceClientSpeakingEvent > >(vm, SqDpVoiceClientSpeakingEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceClientSpeakingEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceClientSpeakingEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceClientSpeakingEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Log"),
+        Class< DpLogEvent, NoConstructor< DpLogEvent > >(vm, SqDpLogEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpLogEvent::Fn)
+        .Func(_SC("_tostring"), &DpLogEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpLogEvent::GetRawEvent)
+        .Prop(_SC("Severity"), &DpLogEvent::GetSeverity)
+        .Prop(_SC("Message"), &DpLogEvent::GetMessage)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildJoinRequestDelete"),
+        Class< DpGuildJoinRequestDeleteEvent, NoConstructor< DpGuildJoinRequestDeleteEvent > >(vm, SqDpGuildJoinRequestDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildJoinRequestDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildJoinRequestDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildJoinRequestDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("InteractionCreate"),
+        Class< DpInteractionCreateEvent, NoConstructor< DpInteractionCreateEvent > >(vm, SqDpInteractionCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpInteractionCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpInteractionCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpInteractionCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("SlashCommand"),
+        Class< DpSlashCommandEvent, NoConstructor< DpSlashCommandEvent > >(vm, SqDpSlashCommandEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpSlashCommandEvent::Fn)
+        .Func(_SC("_tostring"), &DpSlashCommandEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpSlashCommandEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ButtonClick"),
+        Class< DpButtonClickEvent, NoConstructor< DpButtonClickEvent > >(vm, SqDpButtonClickEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpButtonClickEvent::Fn)
+        .Func(_SC("_tostring"), &DpButtonClickEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpButtonClickEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("AutoComplete"),
+        Class< DpAutoCompleteEvent, NoConstructor< DpAutoCompleteEvent > >(vm, SqDpAutoCompleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpAutoCompleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpAutoCompleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpAutoCompleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("SelectClick"),
+        Class< DpSelectClickEvent, NoConstructor< DpSelectClickEvent > >(vm, SqDpSelectClickEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpSelectClickEvent::Fn)
+        .Func(_SC("_tostring"), &DpSelectClickEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpSelectClickEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageContextMenu"),
+        Class< DpMessageContextMenuEvent, NoConstructor< DpMessageContextMenuEvent > >(vm, SqDpMessageContextMenuEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageContextMenuEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageContextMenuEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageContextMenuEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("UserContextMenu"),
+        Class< DpUserContextMenuEvent, NoConstructor< DpUserContextMenuEvent > >(vm, SqDpUserContextMenuEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpUserContextMenuEvent::Fn)
+        .Func(_SC("_tostring"), &DpUserContextMenuEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpUserContextMenuEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("FormSubmit"),
+        Class< DpFormSubmitEvent, NoConstructor< DpFormSubmitEvent > >(vm, SqDpFormSubmitEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpFormSubmitEvent::Fn)
+        .Func(_SC("_tostring"), &DpFormSubmitEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpFormSubmitEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildDelete"),
+        Class< DpGuildDeleteEvent, NoConstructor< DpGuildDeleteEvent > >(vm, SqDpGuildDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ChannelDelete"),
+        Class< DpChannelDeleteEvent, NoConstructor< DpChannelDeleteEvent > >(vm, SqDpChannelDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpChannelDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpChannelDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpChannelDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ChannelUpdate"),
+        Class< DpChannelUpdateEvent, NoConstructor< DpChannelUpdateEvent > >(vm, SqDpChannelUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpChannelUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpChannelUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpChannelUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Ready"),
+        Class< DpReadyEvent, NoConstructor< DpReadyEvent > >(vm, SqDpReadyEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpReadyEvent::Fn)
+        .Func(_SC("_tostring"), &DpReadyEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpReadyEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageDelete"),
+        Class< DpMessageDeleteEvent, NoConstructor< DpMessageDeleteEvent > >(vm, SqDpMessageDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildMemberRemove"),
+        Class< DpGuildMemberRemoveEvent, NoConstructor< DpGuildMemberRemoveEvent > >(vm, SqDpGuildMemberRemoveEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildMemberRemoveEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildMemberRemoveEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildMemberRemoveEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Resumed"),
+        Class< DpResumedEvent, NoConstructor< DpResumedEvent > >(vm, SqDpResumedEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpResumedEvent::Fn)
+        .Func(_SC("_tostring"), &DpResumedEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpResumedEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildRoleCreate"),
+        Class< DpGuildRoleCreateEvent, NoConstructor< DpGuildRoleCreateEvent > >(vm, SqDpGuildRoleCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildRoleCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildRoleCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildRoleCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("TypingStart"),
+        Class< DpTypingStartEvent, NoConstructor< DpTypingStartEvent > >(vm, SqDpTypingStartEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpTypingStartEvent::Fn)
+        .Func(_SC("_tostring"), &DpTypingStartEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpTypingStartEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageReactionAdd"),
+        Class< DpMessageReactionAddEvent, NoConstructor< DpMessageReactionAddEvent > >(vm, SqDpMessageReactionAddEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageReactionAddEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageReactionAddEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageReactionAddEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildMembersChunk"),
+        Class< DpGuildMembersChunkEvent, NoConstructor< DpGuildMembersChunkEvent > >(vm, SqDpGuildMembersChunkEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildMembersChunkEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildMembersChunkEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildMembersChunkEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageReactionRemove"),
+        Class< DpMessageReactionRemoveEvent, NoConstructor< DpMessageReactionRemoveEvent > >(vm, SqDpMessageReactionRemoveEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageReactionRemoveEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageReactionRemoveEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageReactionRemoveEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildCreate"),
+        Class< DpGuildCreateEvent, NoConstructor< DpGuildCreateEvent > >(vm, SqDpGuildCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ChannelCreate"),
+        Class< DpChannelCreateEvent, NoConstructor< DpChannelCreateEvent > >(vm, SqDpChannelCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpChannelCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpChannelCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpChannelCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageReactionRemoveEmoji"),
+        Class< DpMessageReactionRemoveEmojiEvent, NoConstructor< DpMessageReactionRemoveEmojiEvent > >(vm, SqDpMessageReactionRemoveEmojiEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageReactionRemoveEmojiEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageReactionRemoveEmojiEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageReactionRemoveEmojiEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageDeleteDulk"),
+        Class< DpMessageDeleteDulkEvent, NoConstructor< DpMessageDeleteDulkEvent > >(vm, SqDpMessageDeleteDulkEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageDeleteDulkEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageDeleteDulkEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageDeleteDulkEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildRoleUpdate"),
+        Class< DpGuildRoleUpdateEvent, NoConstructor< DpGuildRoleUpdateEvent > >(vm, SqDpGuildRoleUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildRoleUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildRoleUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildRoleUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildRoleDelete"),
+        Class< DpGuildRoleDeleteEvent, NoConstructor< DpGuildRoleDeleteEvent > >(vm, SqDpGuildRoleDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildRoleDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildRoleDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildRoleDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ChannelPinsUpdate"),
+        Class< DpChannelPinsUpdateEvent, NoConstructor< DpChannelPinsUpdateEvent > >(vm, SqDpChannelPinsUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpChannelPinsUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpChannelPinsUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpChannelPinsUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageReactionRemoveAll"),
+        Class< DpMessageReactionRemoveAllEvent, NoConstructor< DpMessageReactionRemoveAllEvent > >(vm, SqDpMessageReactionRemoveAllEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageReactionRemoveAllEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageReactionRemoveAllEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageReactionRemoveAllEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceServerUpdate"),
+        Class< DpVoiceServerUpdateEvent, NoConstructor< DpVoiceServerUpdateEvent > >(vm, SqDpVoiceServerUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceServerUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceServerUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceServerUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildEmojisUpdate"),
+        Class< DpGuildEmojisUpdateEvent, NoConstructor< DpGuildEmojisUpdateEvent > >(vm, SqDpGuildEmojisUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildEmojisUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildEmojisUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildEmojisUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildStickersUpdate"),
+        Class< DpGuildStickersUpdateEvent, NoConstructor< DpGuildStickersUpdateEvent > >(vm, SqDpGuildStickersUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildStickersUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildStickersUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildStickersUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("PresenceUpdate"),
+        Class< DpPresenceUpdateEvent, NoConstructor< DpPresenceUpdateEvent > >(vm, SqDpPresenceUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpPresenceUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpPresenceUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpPresenceUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("WebhooksUpdate"),
+        Class< DpWebhooksUpdateEvent, NoConstructor< DpWebhooksUpdateEvent > >(vm, SqDpWebhooksUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpWebhooksUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpWebhooksUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpWebhooksUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("AutomodRuleCreate"),
+        Class< DpAutomodRuleCreateEvent, NoConstructor< DpAutomodRuleCreateEvent > >(vm, SqDpAutomodRuleCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpAutomodRuleCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpAutomodRuleCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpAutomodRuleCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("AutomodRuleUpdate"),
+        Class< DpAutomodRuleUpdateEvent, NoConstructor< DpAutomodRuleUpdateEvent > >(vm, SqDpAutomodRuleUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpAutomodRuleUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpAutomodRuleUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpAutomodRuleUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("AutomodRuleDelete"),
+        Class< DpAutomodRuleDeleteEvent, NoConstructor< DpAutomodRuleDeleteEvent > >(vm, SqDpAutomodRuleDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpAutomodRuleDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpAutomodRuleDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpAutomodRuleDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("AutomodRuleExecute"),
+        Class< DpAutomodRuleExecuteEvent, NoConstructor< DpAutomodRuleExecuteEvent > >(vm, SqDpAutomodRuleExecuteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpAutomodRuleExecuteEvent::Fn)
+        .Func(_SC("_tostring"), &DpAutomodRuleExecuteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpAutomodRuleExecuteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildMemberAdd"),
+        Class< DpGuildMemberAddEvent, NoConstructor< DpGuildMemberAddEvent > >(vm, SqDpGuildMemberAddEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildMemberAddEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildMemberAddEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildMemberAddEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("InviteDelete"),
+        Class< DpInviteDeleteEvent, NoConstructor< DpInviteDeleteEvent > >(vm, SqDpInviteDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpInviteDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpInviteDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpInviteDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildUpdate"),
+        Class< DpGuildUpdateEvent, NoConstructor< DpGuildUpdateEvent > >(vm, SqDpGuildUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildIntegrationsUpdate"),
+        Class< DpGuildIntegrationsUpdateEvent, NoConstructor< DpGuildIntegrationsUpdateEvent > >(vm, SqDpGuildIntegrationsUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildIntegrationsUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildIntegrationsUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildIntegrationsUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildMemberUpdate"),
+        Class< DpGuildMemberUpdateEvent, NoConstructor< DpGuildMemberUpdateEvent > >(vm, SqDpGuildMemberUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildMemberUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildMemberUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildMemberUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("InviteCreate"),
+        Class< DpInviteCreateEvent, NoConstructor< DpInviteCreateEvent > >(vm, SqDpInviteCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpInviteCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpInviteCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpInviteCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageUpdate"),
+        Class< DpMessageUpdateEvent, NoConstructor< DpMessageUpdateEvent > >(vm, SqDpMessageUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("UserUpdate"),
+        Class< DpUserUpdateEvent, NoConstructor< DpUserUpdateEvent > >(vm, SqDpUserUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpUserUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpUserUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpUserUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("MessageCreate"),
+        Class< DpMessageCreateEvent, NoConstructor< DpMessageCreateEvent > >(vm, SqDpMessageCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpMessageCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpMessageCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpMessageCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildAuditLogEntryCreate"),
+        Class< DpGuildAuditLogEntryCreateEvent, NoConstructor< DpGuildAuditLogEntryCreateEvent > >(vm, SqDpGuildAuditLogEntryCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildAuditLogEntryCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildAuditLogEntryCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildAuditLogEntryCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildBanAdd"),
+        Class< DpGuildBanAddEvent, NoConstructor< DpGuildBanAddEvent > >(vm, SqDpGuildBanAddEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildBanAddEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildBanAddEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildBanAddEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildBanRemove"),
+        Class< DpGuildBanRemoveEvent, NoConstructor< DpGuildBanRemoveEvent > >(vm, SqDpGuildBanRemoveEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildBanRemoveEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildBanRemoveEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildBanRemoveEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("IntegrationCreate"),
+        Class< DpIntegrationCreateEvent, NoConstructor< DpIntegrationCreateEvent > >(vm, SqDpIntegrationCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpIntegrationCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpIntegrationCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpIntegrationCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("IntegrationUpdate"),
+        Class< DpIntegrationUpdateEvent, NoConstructor< DpIntegrationUpdateEvent > >(vm, SqDpIntegrationUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpIntegrationUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpIntegrationUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpIntegrationUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("IntegrationDelete"),
+        Class< DpIntegrationDeleteEvent, NoConstructor< DpIntegrationDeleteEvent > >(vm, SqDpIntegrationDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpIntegrationDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpIntegrationDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpIntegrationDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ThreadCreate"),
+        Class< DpThreadCreateEvent, NoConstructor< DpThreadCreateEvent > >(vm, SqDpThreadCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpThreadCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpThreadCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpThreadCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ThreadUpdate"),
+        Class< DpThreadUpdateEvent, NoConstructor< DpThreadUpdateEvent > >(vm, SqDpThreadUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpThreadUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpThreadUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpThreadUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ThreadDelete"),
+        Class< DpThreadDeleteEvent, NoConstructor< DpThreadDeleteEvent > >(vm, SqDpThreadDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpThreadDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpThreadDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpThreadDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ThreadListSync"),
+        Class< DpThreadListSyncEvent, NoConstructor< DpThreadListSyncEvent > >(vm, SqDpThreadListSyncEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpThreadListSyncEvent::Fn)
+        .Func(_SC("_tostring"), &DpThreadListSyncEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpThreadListSyncEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ThreadMemberUpdate"),
+        Class< DpThreadMemberUpdateEvent, NoConstructor< DpThreadMemberUpdateEvent > >(vm, SqDpThreadMemberUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpThreadMemberUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpThreadMemberUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpThreadMemberUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ThreadMembersUpdate"),
+        Class< DpThreadMembersUpdateEvent, NoConstructor< DpThreadMembersUpdateEvent > >(vm, SqDpThreadMembersUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpThreadMembersUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpThreadMembersUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpThreadMembersUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildScheduledEventCreate"),
+        Class< DpGuildScheduledEventCreateEvent, NoConstructor< DpGuildScheduledEventCreateEvent > >(vm, SqDpGuildScheduledEventCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildScheduledEventCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildScheduledEventCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildScheduledEventCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildScheduledEventUpdate"),
+        Class< DpGuildScheduledEventUpdateEvent, NoConstructor< DpGuildScheduledEventUpdateEvent > >(vm, SqDpGuildScheduledEventUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildScheduledEventUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildScheduledEventUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildScheduledEventUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildScheduledEventDelete"),
+        Class< DpGuildScheduledEventDeleteEvent, NoConstructor< DpGuildScheduledEventDeleteEvent > >(vm, SqDpGuildScheduledEventDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildScheduledEventDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildScheduledEventDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildScheduledEventDeleteEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildScheduledEventUserAdd"),
+        Class< DpGuildScheduledEventUserAddEvent, NoConstructor< DpGuildScheduledEventUserAddEvent > >(vm, SqDpGuildScheduledEventUserAddEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildScheduledEventUserAddEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildScheduledEventUserAddEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildScheduledEventUserAddEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("GuildScheduledEventUserRemove"),
+        Class< DpGuildScheduledEventUserRemoveEvent, NoConstructor< DpGuildScheduledEventUserRemoveEvent > >(vm, SqDpGuildScheduledEventUserRemoveEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildScheduledEventUserRemoveEvent::Fn)
+        .Func(_SC("_tostring"), &DpGuildScheduledEventUserRemoveEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpGuildScheduledEventUserRemoveEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceBufferSend"),
+        Class< DpVoiceBufferSendEvent, NoConstructor< DpVoiceBufferSendEvent > >(vm, SqDpVoiceBufferSendEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceBufferSendEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceBufferSendEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceBufferSendEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceUserTalking"),
+        Class< DpVoiceUserTalkingEvent, NoConstructor< DpVoiceUserTalkingEvent > >(vm, SqDpVoiceUserTalkingEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceUserTalkingEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceUserTalkingEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceUserTalkingEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceReady"),
+        Class< DpVoiceReadyEvent, NoConstructor< DpVoiceReadyEvent > >(vm, SqDpVoiceReadyEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceReadyEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceReadyEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceReadyEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceReceive"),
+        Class< DpVoiceReceiveEvent, NoConstructor< DpVoiceReceiveEvent > >(vm, SqDpVoiceReceiveEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceReceiveEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceReceiveEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceReceiveEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceReceive"),
+        Class< DpVoiceReceiveCombinedEvent, NoConstructor< DpVoiceReceiveCombinedEvent > >(vm, SqDpVoiceReceiveCombinedEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceReceiveCombinedEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceReceiveCombinedEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceReceiveCombinedEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceTrackMarker"),
+        Class< DpVoiceTrackMarkerEvent, NoConstructor< DpVoiceTrackMarkerEvent > >(vm, SqDpVoiceTrackMarkerEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceTrackMarkerEvent::Fn)
+        .Func(_SC("_tostring"), &DpVoiceTrackMarkerEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpVoiceTrackMarkerEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("StageInstanceCreate"),
+        Class< DpStageInstanceCreateEvent, NoConstructor< DpStageInstanceCreateEvent > >(vm, SqDpStageInstanceCreateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpStageInstanceCreateEvent::Fn)
+        .Func(_SC("_tostring"), &DpStageInstanceCreateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpStageInstanceCreateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("StageInstanceUpdate"),
+        Class< DpStageInstanceUpdateEvent, NoConstructor< DpStageInstanceUpdateEvent > >(vm, SqDpStageInstanceUpdateEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpStageInstanceUpdateEvent::Fn)
+        .Func(_SC("_tostring"), &DpStageInstanceUpdateEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpStageInstanceUpdateEvent::GetRawEvent)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("StageInstanceDelete"),
+        Class< DpStageInstanceDeleteEvent, NoConstructor< DpStageInstanceDeleteEvent > >(vm, SqDpStageInstanceDeleteEvent::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpStageInstanceDeleteEvent::Fn)
+        .Func(_SC("_tostring"), &DpStageInstanceDeleteEvent::GetRawEvent)
+        // Member Properties
+        .Prop(_SC("Raw"), &DpStageInstanceDeleteEvent::GetRawEvent)
+    );
+}
+
+} // Namespace:: SqMod

module/Library/Discord/Guild.cpp

@@ -0,0 +1,65 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Guild.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqDpGuildMember, _SC("SqDiscordGuildMember"))
+SQMOD_DECL_TYPENAME(SqDpGuild, _SC("SqDiscordGuild"))
+
+// ------------------------------------------------------------------------------------------------
+void Register_Discord_Guild(HSQUIRRELVM vm, Table & ns)
+{
+    ns.Bind(_SC("GuildMember"),
+        Class< DpGuildMember, NoConstructor< DpGuildMember > >(vm, SqDpGuildMember::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuildMember::Fn)
+        .Func(_SC("_cmp"), &DpGuildMember::SqCmp)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpGuildMember::IsValid)
+        .Prop(_SC("JSON"), &DpGuildMember::BuildJSON)
+        .Prop(_SC("Nickname"), &DpGuildMember::GetNickname, &DpGuildMember::SetNickname)
+        .Prop(_SC("Roles"), &DpGuildMember::GetRoles)
+        .Prop(_SC("RolesCount"), &DpGuildMember::RolesCount)
+        .Prop(_SC("GuildID"), &DpGuildMember::GetGuildID, &DpGuildMember::SetGuildID)
+        .Prop(_SC("UserID"), &DpGuildMember::GetUserID, &DpGuildMember::SetUserID)
+        .Prop(_SC("Avatar"), &DpGuildMember::GetAvatar, &DpGuildMember::SetAvatar)
+        .Prop(_SC("CommunicationDisabledUntil"), &DpGuildMember::GetCommunicationDisabledUntil, &DpGuildMember::SetCommunicationDisabledUntil)
+        .Prop(_SC("JoinedAt"), &DpGuildMember::GetJoinedAt)
+        .Prop(_SC("PremiumSince"), &DpGuildMember::GetPremiumSince)
+        .Prop(_SC("Flags"), &DpGuildMember::GetFlags, &DpGuildMember::SetFlags)
+        .Prop(_SC("CommunicationDisabled"), &DpGuildMember::IsCommunicationDisabled)
+        .Prop(_SC("Deaf"), &DpGuildMember::GetDeaf, &DpGuildMember::SetDeaf)
+        .Prop(_SC("Muted"), &DpGuildMember::GetMuted, &DpGuildMember::SetMuted)
+        .Prop(_SC("IsPending"), &DpGuildMember::IsPending)
+        .Prop(_SC("HasAnimatedGuildAvatar"), &DpGuildMember::HasAnimatedGuildAvatar)
+        .Prop(_SC("Mention"), &DpGuildMember::GetMention)
+        // Member Methods
+        .Func(_SC("BuildJSON"), &DpGuildMember::BuildJSON_)
+        .Func(_SC("GetNickname"), &DpGuildMember::ApplyNickname)
+        .Func(_SC("AddRole"), &DpGuildMember::AddRole)
+        .Func(_SC("EachRole"), &DpGuildMember::EachRole)
+        .Func(_SC("ClearRoles"), &DpGuildMember::ClearRoles)
+        .Func(_SC("FilterRoles"), &DpGuildMember::FilterRoles)
+        .Func(_SC("GetFlags"), &DpGuildMember::ApplyFlags)
+        .Func(_SC("GetAvatarURL"), &DpGuildMember::GetAvatarURL)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Guild"),
+        Class< DpGuild, NoConstructor< DpGuild > >(vm, SqDpGuild::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpGuild::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpGuild::IsValid)
+        .Prop(_SC("JSON"), &DpGuild::BuildJSON)
+        .Prop(_SC("Name"), &DpGuild::GetName, &DpGuild::SetName)
+        .Prop(_SC("Description"), &DpGuild::GetDescription, &DpGuild::SetDescription)
+        // Member Methods
+        .Func(_SC("BuildJSON"), &DpGuild::BuildJSON_)
+        .Func(_SC("GetName"), &DpGuild::ApplyName)
+        .Func(_SC("GetDescription"), &DpGuild::ApplyDescription)
+    );
+}
+
+} // Namespace:: SqMod

module/Library/Discord/Guild.hpp

@@ -0,0 +1,421 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+#include <chrono>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents a guild on Discord (AKA a server).
+*/
+struct DpGuildMember
+{
+    using Ptr = std::unique_ptr< dpp::guild_member >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced guild member instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpGuildMember() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpGuildMember(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpGuildMember(const Ptr::element_type & o) noexcept
+        : DpGuildMember(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpGuildMember(Ptr::element_type && o) noexcept
+        : DpGuildMember(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpGuildMember(const DpGuildMember & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpGuildMember(DpGuildMember && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpGuildMember() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpGuildMember & operator = (const DpGuildMember & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpGuildMember & operator = (DpGuildMember && o) noexcept
+    {
+        if (this != &o) {
+            // Do we own this to try delete it?
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord voice state handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Build json representation of the object.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if this member is equal to another member object.
+    */
+    SQMOD_NODISCARD SQInteger SqCmp(const DpGuildMember & o) const
+    {
+        if (Valid() == o.Valid()) {
+            return 0;
+        // Nonsense...
+        } else if (Valid().user_id > o.Valid().user_id) {
+            return 1;
+        } else {
+            return -1;
+        }
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the nickname, or empty string if they don't have a nickname on this guild.
+    */
+    SQMOD_NODISCARD const std::string & GetNickname() const { return Valid().nickname; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the nickname.
+    */
+    void SetNickname(StackStrF & name) const { Valid().set_nickname(name.ToStr()); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the nickname.
+    */
+    DpGuildMember & ApplyNickname(StackStrF & name) { SetNickname(name); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the list of roles this user has on this guild.
+    */
+    SQMOD_NODISCARD Array GetRoles() const
+    {
+        return Array(SqVM()).Reserve(static_cast< SQInteger >(Valid().roles.size()))
+                            .AppendFromVector(Valid().roles);
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the number of roles.
+    */
+    SQMOD_NODISCARD SQInteger RolesCount() const { return static_cast< SQInteger >(Valid().roles.size()); }
+    /* --------------------------------------------------------------------------------------------
+     * Add a new role.
+    */
+    DpGuildMember & AddRole(dpp::snowflake role) { Valid().roles.push_back(role); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Iterate all roles.
+    */
+    DpGuildMember & EachRole(Function & fn)
+    {
+        for (const auto & a : Valid().roles)
+        {
+            fn.Execute(a);
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the number of roles.
+    */
+    DpGuildMember & ClearRoles(dpp::snowflake role) { Valid().roles.clear(); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Filter roles.
+    */
+    DpGuildMember & FilterRoles(Function & fn)
+    {
+        std::vector< dpp::snowflake > list;
+        // Reserve memory in advance
+        list.reserve(Valid().roles.size());
+        // Process each role individually
+        for (const auto & role : Valid().roles)
+        {
+            auto ret = fn.Eval(role);
+            // (null || true) == keep & false == skip
+            if (!ret.IsNull() || !ret.template Cast< bool >())
+            {
+                list.push_back(role); // Keep this role
+            }
+        }
+        // Use filtered roles
+        Valid().roles.swap(list);
+        // Allow chaining
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the guild id.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetGuildID() const { return Valid().guild_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild id.
+    */
+    void SetGuildID(dpp::snowflake id) { Valid().guild_id = id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user id.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetUserID() const { return Valid().user_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild id.
+    */
+    void SetUserID(dpp::snowflake id) { Valid().guild_id = id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user avatar (per-server avatar is a nitro only feature).
+    */
+    SQMOD_NODISCARD const dpp::utility::iconhash & GetAvatar() const { return Valid().avatar; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the user avatar (per-server avatar is a nitro only feature).
+    */
+    void SetAvatar(const dpp::utility::iconhash & a) const { Valid().avatar = a; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the date and time when the time out will be removed; until then, they cannot interact with the guild.
+    */
+    SQMOD_NODISCARD SQInteger GetCommunicationDisabledUntil() const
+    {
+        return std::chrono::time_point_cast< std::chrono::seconds >(
+                std::chrono::system_clock::from_time_t(Valid().communication_disabled_until)
+            ).time_since_epoch().count();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Assign a timestamp until communication is disabled.
+    */
+    void SetCommunicationDisabledUntil(SQInteger ts) const
+    {
+        Valid().set_communication_disabled_until(
+            std::chrono::system_clock::to_time_t(std::chrono::time_point< std::chrono::system_clock >(std::chrono::seconds(ts)))
+        );
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the date and time the user joined the guild.
+    */
+    SQMOD_NODISCARD SQInteger GetJoinedAt() const
+    {
+        return std::chrono::time_point_cast< std::chrono::seconds >(
+                std::chrono::system_clock::from_time_t(Valid().joined_at)
+            ).time_since_epoch().count();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the date and time since the user is boosting.
+    */
+    SQMOD_NODISCARD SQInteger GetPremiumSince() const
+    {
+        return std::chrono::time_point_cast< std::chrono::seconds >(
+                std::chrono::system_clock::from_time_t(Valid().premium_since)
+            ).time_since_epoch().count();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the guild flags. Built from the bitmask defined by SqDiscordGuildMemberFlags.
+    */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return static_cast< SQInteger >(Valid().flags); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild flags.
+    */
+    void SetFlags(SQInteger f) const { Valid().flags = static_cast< uint8_t >(f); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild flags.
+    */
+    DpGuildMember & ApplyFlags(SQInteger f) { SetFlags(f); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the user is in time-out (communication disabled).
+    */
+    SQMOD_NODISCARD bool IsCommunicationDisabled() const { return Valid().is_communication_disabled(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the user is deafened.
+    */
+    SQMOD_NODISCARD bool GetDeaf() const { return Valid().is_deaf(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the user is deafened.
+    */
+    void SetDeaf(bool is_deafened) const { Valid().set_deaf(is_deafened); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the user is muted.
+    */
+    SQMOD_NODISCARD bool GetMuted() const { return Valid().is_muted(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the user is muted.
+    */
+    void SetMuted(bool is_muted) const { Valid().set_mute(is_muted); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the user is pending verification by membership screening.
+    */
+    SQMOD_NODISCARD bool IsPending() const { return Valid().is_pending(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the the user's per-guild custom avatar is animated.
+    */
+    SQMOD_NODISCARD bool HasAnimatedGuildAvatar() const { return Valid().has_animated_guild_avatar(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the the user's per-guild custom avatar is animated.
+    */
+    SQMOD_NODISCARD std::string GetAvatarURL(SQInteger size, SQInteger format, bool animated) const
+    { return Valid().get_avatar_url(static_cast< uint16_t >(size), static_cast< dpp::image_type >(format), animated); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve a ping/mention for the user by nickname.
+    */
+    SQMOD_NODISCARD std::string GetMention() const { return Valid().get_mention(); }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents a guild on Discord (AKA a server)
+*/
+struct DpGuild
+{
+    using Ptr = std::unique_ptr< dpp::guild >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced guild instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpGuild() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpGuild(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpGuild(const Ptr::element_type & o) noexcept
+        : DpGuild(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpGuild(Ptr::element_type && o) noexcept
+        : DpGuild(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpGuild(const DpGuild & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpGuild(DpGuild && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpGuild() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpGuild & operator = (const DpGuild & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpGuild & operator = (DpGuild && o) noexcept
+    {
+        if (this != &o) {
+            // Do we own this to try delete it?
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord guild handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Build json representation of the object.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the guild name. Min length: 2, Max length: 100 (not including leading/trailing spaces)
+    */
+    SQMOD_NODISCARD const std::string & GetName() const { return Valid().name; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild name. Min length: 2, Max length: 100 (not including leading/trailing spaces)
+    */
+    void SetName(StackStrF & name) const { Valid().set_name(name.ToStr()); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild name. Min length: 2, Max length: 100 (not including leading/trailing spaces)
+    */
+    DpGuild & ApplyName(StackStrF & name) { SetName(name); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the server description.
+    */
+    SQMOD_NODISCARD const std::string & GetDescription() const { return Valid().description; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the server description.
+    */
+    void SetDescription(StackStrF & description) const { Valid().description = description.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the server description.
+    */
+    DpGuild & ApplyDescription(StackStrF & description) { SetDescription(description); return *this; }
+};
+
+} // Namespace:: SqMod

module/Library/Discord/Integration.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Integration.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Integration.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Message.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Message.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Message.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/Misc.cpp

@@ -0,0 +1,129 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Misc.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqDpCachePolicy, _SC("SqDiscordCachePolicy"))
+SQMOD_DECL_TYPENAME(SqDpUptime, _SC("SqDiscordUptime"))
+SQMOD_DECL_TYPENAME(SqDpIconHash, _SC("SqDiscordIconHash"))
+SQMOD_DECL_TYPENAME(SqDpVoiceState, _SC("SqDiscordVoiceState"))
+SQMOD_DECL_TYPENAME(SqDpEmoji, _SC("SqDiscordEmoji"))
+SQMOD_DECL_TYPENAME(SqDpCommandConfirmation, _SC("SqDiscordCommandConfirmation"))
+
+// ------------------------------------------------------------------------------------------------
+void Register_Discord_Misc(HSQUIRRELVM vm, Table & ns)
+{
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Uptime"),
+        Class< dpp::utility::uptime >(vm, SqDpUptime::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< double >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpUptime::Fn)
+        .Func(_SC("_tostring"), &dpp::utility::uptime::to_string)
+        // Member Variables
+        .Var(_SC("Days"), &dpp::utility::uptime::days)
+        .Var(_SC("Hours"), &dpp::utility::uptime::hours)
+        .Var(_SC("Minutes"), &dpp::utility::uptime::mins)
+        .Var(_SC("Seconds"), &dpp::utility::uptime::secs)
+        // Member Methods
+        .Func(_SC("ToSeconds"), &dpp::utility::uptime::to_secs)
+        .Func(_SC("ToMilliseconds"), &dpp::utility::uptime::to_msecs)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("IconHash"),
+        Class< dpp::utility::iconhash >(vm, SqDpIconHash::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< const std::string & >()
+        .Ctor< uint64_t, uint64_t >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpIconHash::Fn)
+        .Func(_SC("_tostring"), &dpp::utility::iconhash::to_string)
+        // Member Variables
+        .Var(_SC("High"), &dpp::utility::iconhash::first)
+        .Var(_SC("Low"), &dpp::utility::iconhash::second)
+        // Member Methods
+        .Func(_SC("Set"), &dpp::utility::iconhash::set)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("CachePolicy"),
+        Class< DpCachePolicy >(vm, SqDpCachePolicy::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< SQInteger >()
+        .Ctor< SQInteger, SQInteger >()
+        .Ctor< SQInteger, SQInteger, SQInteger >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpCachePolicy::Fn)
+        // Member Variables
+        .Var(_SC("UserPolicy"), &DpCachePolicy::mUserPolicy)
+        .Var(_SC("EmojiPolicy"), &DpCachePolicy::mEmojiPolicy)
+        .Var(_SC("RolePolicy"), &DpCachePolicy::mRolePolicy)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("VoiceState"),
+        Class< DpVoiceState, NoConstructor< DpVoiceState > >(vm, SqDpVoiceState::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpVoiceState::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpVoiceState::IsValid)
+        .Prop(_SC("JSON"), &DpVoiceState::BuildJSON)
+        .Prop(_SC("GuildID"), &DpVoiceState::GetGuildID)
+        .Prop(_SC("ChannelID"), &DpVoiceState::GetChannelID)
+        .Prop(_SC("UserID"), &DpVoiceState::GetUserID)
+        .Prop(_SC("SessionID"), &DpVoiceState::GetSessionID)
+        .Prop(_SC("Flags"), &DpVoiceState::GetFlags, &DpVoiceState::SetFlags)
+        .Prop(_SC("RequestToSpeak"), &DpVoiceState::GetRequestToSpeak)
+        .Prop(_SC("IsDeaf"), &DpVoiceState::IsDeaf)
+        .Prop(_SC("IsMute"), &DpVoiceState::IsMute)
+        .Prop(_SC("IsSelfMute"), &DpVoiceState::IsSelfMute)
+        .Prop(_SC("IsSelfDeaf"), &DpVoiceState::IsSelfDeaf)
+        .Prop(_SC("SelfStream"), &DpVoiceState::SelfStream)
+        .Prop(_SC("SelfVideo"), &DpVoiceState::SelfVideo)
+        .Prop(_SC("IsSuppressed"), &DpVoiceState::IsSuppressed)
+        // Member Methods
+        .Func(_SC("BuildJSON"), &DpVoiceState::BuildJSON_)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Emoji"),
+        Class< DpEmoji, NoCopy< DpEmoji > >(vm, SqDpEmoji::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< StackStrF &, dpp::snowflake, SQInteger >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpEmoji::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpEmoji::IsValid)
+        .Prop(_SC("JSON"), &DpEmoji::BuildJSON)
+        .Prop(_SC("Name"), &DpEmoji::GetName, &DpEmoji::SetName)
+        .Prop(_SC("ImageData"), &DpEmoji::GetImageData)
+        .Prop(_SC("RequiresColons"), &DpEmoji::GetRequiresColons)
+        .Prop(_SC("IsManaged"), &DpEmoji::GetIsManaged)
+        .Prop(_SC("IsAnimated"), &DpEmoji::GetIsAnimated)
+        .Prop(_SC("IsAvailable"), &DpEmoji::GetIsAvailable)
+        .Prop(_SC("Format"), &DpEmoji::Format)
+        .Prop(_SC("Mention"), &DpEmoji::GetMention)
+        // Member Methods
+        .Func(_SC("SetName"), &DpEmoji::ApplyName)
+        .Func(_SC("GetMention"), &DpEmoji::GetMention_)
+        .Func(_SC("BuildJSON"), &DpEmoji::BuildJSON_)
+        .Func(_SC("LoadImage"), &DpEmoji::LoadImage)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("CommandConfirmation"),
+        Class< DpCommandConfirmation, NoConstructor< DpCommandConfirmation > >(vm, SqDpCommandConfirmation::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpCommandConfirmation::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpCommandConfirmation::IsValid)
+        .Prop(_SC("HttpBody"), &DpCommandConfirmation::GetHttpBody)
+        // Member Methods
+        //.Func(_SC("SetName"), &DpCommandConfirmation::ApplyName)
+    );
+}
+
+} // Namespace:: SqMod

module/Library/Discord/Misc.hpp

@@ -0,0 +1,492 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Utilities.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+#include <chrono>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents the caching policy of the cluster.
+*/
+struct DpCachePolicy
+{
+    SQInteger mUserPolicy{dpp::cp_aggressive};
+    SQInteger mEmojiPolicy{dpp::cp_aggressive};
+    SQInteger mRolePolicy{dpp::cp_aggressive};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpCachePolicy() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpCachePolicy(SQInteger user) noexcept
+        : mUserPolicy(user), mEmojiPolicy(dpp::cp_aggressive), mRolePolicy(dpp::cp_aggressive)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    DpCachePolicy(SQInteger user, SQInteger emoji) noexcept
+        : mUserPolicy(user), mEmojiPolicy(emoji), mRolePolicy(dpp::cp_aggressive)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    DpCachePolicy(SQInteger user, SQInteger emoji, SQInteger role) noexcept
+        : mUserPolicy(user), mEmojiPolicy(emoji), mRolePolicy(role)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    DpCachePolicy(const DpCachePolicy &) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Convert to native cache policy type.
+    */
+    SQMOD_NODISCARD dpp::cache_policy_t ToNative() const noexcept
+    {
+        return dpp::cache_policy_t{
+            static_cast< dpp::cache_policy_setting_t >(mUserPolicy),
+            static_cast< dpp::cache_policy_setting_t >(mEmojiPolicy),
+            static_cast< dpp::cache_policy_setting_t >(mRolePolicy)
+        };
+    }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents the voice state of a user on a guild.
+ * These are stored in the DpGuild object, and accessible there, or via DpChannel::GetVoiceMembers.
+*/
+struct DpVoiceState
+{
+    using Ptr = std::unique_ptr< dpp::voicestate >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced voice state instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpVoiceState() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpVoiceState(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpVoiceState(const Ptr::element_type & o) noexcept
+        : DpVoiceState(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpVoiceState(Ptr::element_type && o) noexcept
+        : DpVoiceState(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpVoiceState(const DpVoiceState & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpVoiceState(DpVoiceState && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpVoiceState() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpVoiceState & operator = (const DpVoiceState & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpVoiceState & operator = (DpVoiceState && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord voice state handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the guild id this voice state is for (optional).
+    */
+    SQMOD_NODISCARD dpp::snowflake GetGuildID() const { return Valid().guild_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the channel id this user is connected to (may be empty).
+    */
+    SQMOD_NODISCARD dpp::snowflake GetChannelID() const { return Valid().channel_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user id this voice state is for.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetUserID() const { return Valid().user_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the session id for this voice state.
+    */
+    SQMOD_NODISCARD const std::string & GetSessionID() const { return Valid().session_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the voice state flags (see SqDiscordVoiceStateFlags).
+    */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return Valid().flags; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the voice state flags (see SqDiscordVoiceStateFlags).
+    */
+    void SetFlags(SQInteger flags) const { Valid().flags = flags; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the time at which the user requested to speak, or 0.
+    */
+    SQMOD_NODISCARD SQInteger GetRequestToSpeak() const {
+        return static_cast< SQInteger >(std::chrono::duration_cast< std::chrono::seconds >(
+            std::chrono::system_clock::from_time_t(Valid().request_to_speak).time_since_epoch()
+        ).count());
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Build json representation of the object.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the user is deafened by the server.
+    */
+    SQMOD_NODISCARD bool IsDeaf() const { return Valid().is_deaf(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the user is muted by the server.
+    */
+    SQMOD_NODISCARD bool IsMute() const { return Valid().is_mute(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the user muted themselves.
+    */
+    SQMOD_NODISCARD bool IsSelfMute() const { return Valid().is_self_mute(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the user deafened themselves.
+    */
+    SQMOD_NODISCARD bool IsSelfDeaf() const { return Valid().is_self_deaf(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the user is streaming using "Go Live".
+    */
+    SQMOD_NODISCARD bool SelfStream() const { return Valid().self_stream(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the user's camera is enabled.
+    */
+    SQMOD_NODISCARD bool SelfVideo() const { return Valid().self_video(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if user is suppressed. "HELP HELP I'M BEING SUPPRESSED!"
+    */
+    SQMOD_NODISCARD bool IsSuppressed() const { return Valid().is_suppressed(); }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents the voice state of a user on a guild.
+*/
+struct DpEmoji
+{
+    using Ptr = std::unique_ptr< dpp::emoji >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced voice state instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpEmoji() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpEmoji(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpEmoji(const Ptr::element_type & o) noexcept
+        : DpEmoji(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpEmoji(Ptr::element_type && o) noexcept
+        : DpEmoji(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    DpEmoji(StackStrF & name, dpp::snowflake id, SQInteger flags)
+        : DpEmoji(new Ptr::element_type(name.ToStr(), id, static_cast< uint8_t >(flags)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpEmoji(const DpEmoji & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpEmoji(DpEmoji && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpEmoji() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpEmoji & operator = (const DpEmoji & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpEmoji & operator = (DpEmoji && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord voice state handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the name of the emoji.
+    */
+    SQMOD_NODISCARD const std::string & GetName() const { return Valid().name; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the emoji.
+    */
+    void SetName(StackStrF & name) const { Valid().name = name.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the emoji.
+    */
+    DpEmoji & ApplyName(StackStrF & name) { SetName(name); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user who uploaded the emoji.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetUserID() const { return Valid().user_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the user who uploaded the emoji.
+    */
+    void SetUserID(dpp::snowflake id) const { Valid().user_id = id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the user who uploaded the emoji.
+    */
+    DpEmoji & ApplyUserID(dpp::snowflake id) { SetUserID(id); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the flags for the emoji from SqDiscordEmojiFlags.
+    */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return Valid().flags; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the emoji from SqDiscordEmojiFlags.
+    */
+    void SetFlags(SQInteger flags) const { Valid().flags = static_cast< uint8_t >(flags); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the emoji from SqDiscordEmojiFlags.
+    */
+    DpEmoji & ApplyFlags(SQInteger flags) { SetFlags(flags); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the image data for the emoji if uploading.
+    */
+    SQMOD_NODISCARD LightObj GetImageData() const { return !Valid().image_data ? LightObj{} : LightObj(*Valid().image_data); }
+    /* --------------------------------------------------------------------------------------------
+     * Create a mentionable emoji.
+    */
+    SQMOD_NODISCARD std::string GetMention_(StackStrF & name, dpp::snowflake id, bool is_animated = false) const
+    { return Valid().get_mention(name.ToStr(), id, is_animated); }
+    /* --------------------------------------------------------------------------------------------
+     * Build json representation of the object.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether the Emoji requires colons.
+    */
+    SQMOD_NODISCARD bool GetRequiresColons() const { return Valid().requires_colons(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether the Emoji is managed.
+    */
+    SQMOD_NODISCARD bool GetIsManaged() const { return Valid().is_managed(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether the Emoji is animated.
+    */
+    SQMOD_NODISCARD bool GetIsAnimated() const { return Valid().is_animated(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether the Emoji is available.
+    */
+    SQMOD_NODISCARD bool GetIsAvailable() const { return Valid().is_available(); }
+    /* --------------------------------------------------------------------------------------------
+     * Load an image into the object as base64.
+    */
+    DpEmoji & LoadImage(StackStrF & data, SQInteger type) { Valid().load_image(data.ToStr(), static_cast< dpp::image_type >(type)); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Format to name if unicode, name:id if has id or a:name:id if animated.
+    */
+    SQMOD_NODISCARD std::string Format() const { return Valid().format(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the mention/ping for the emoji.
+    */
+    SQMOD_NODISCARD std::string GetMention() const { return Valid().get_mention(); }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * The results of a REST call wrapped in a convenient struct.
+*/
+struct DpCommandConfirmation
+{
+    using Ptr = std::unique_ptr< dpp::confirmation_callback_t >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced confirmation callback instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpCommandConfirmation() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpCommandConfirmation(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpCommandConfirmation(Ptr && ptr) noexcept
+        : mPtr(std::forward< Ptr >(ptr)), mOwned(true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpCommandConfirmation(const Ptr::element_type & o) noexcept
+        : DpCommandConfirmation(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpCommandConfirmation(Ptr::element_type && o) noexcept
+        : DpCommandConfirmation(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpCommandConfirmation(const DpCommandConfirmation & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpCommandConfirmation(DpCommandConfirmation && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpCommandConfirmation() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpCommandConfirmation & operator = (const DpCommandConfirmation & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpCommandConfirmation & operator = (DpCommandConfirmation && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord confirmation callback handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the raw body string of the HTTP result.
+    */
+    SQMOD_NODISCARD std::string & GetHttpBody() const { return Valid().http_info.body; }
+};
+
+} // Namespace:: SqMod

module/Library/Discord/Presence.cpp

@@ -0,0 +1,143 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Presence.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqDpActivityButton, _SC("SqDiscordActivityButton"))
+SQMOD_DECL_TYPENAME(SqDpActivityButtons, _SC("SqDiscordActivityButtons"))
+SQMOD_DECL_TYPENAME(SqDpActivityAssets, _SC("SqDiscordActivityAssets"))
+SQMOD_DECL_TYPENAME(SqDpActivitySecrets, _SC("SqDiscordActivitySecrets"))
+SQMOD_DECL_TYPENAME(SqDpActivity, _SC("SqDiscordActivity"))
+SQMOD_DECL_TYPENAME(SqDpActivities, _SC("SqDiscordActivities"))
+SQMOD_DECL_TYPENAME(SqDpPresence, _SC("SqDiscordPresence"))
+
+// ------------------------------------------------------------------------------------------------
+void Register_Discord_Presence(HSQUIRRELVM vm, Table & ns)
+{
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ActivityButton"),
+        Class< DpActivityButton, NoCopy< DpActivityButton > >(vm, SqDpActivityButton::Str)
+        // Constructors
+        .Ctor()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpActivityButton::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpActivityButton::IsValid)
+        .Prop(_SC("Label"), &DpActivityButton::GetLabel, &DpActivityButton::SetLabel)
+        .Prop(_SC("URL"), &DpActivityButton::GetURL, &DpActivityButton::SetURL)
+        // Member Methods
+        .Func(_SC("SetLabel"), &DpActivityButton::ApplyLabel)
+        .Func(_SC("SetURL"), &DpActivityButton::ApplyURL)
+    );
+    // --------------------------------------------------------------------------------------------
+    Register_Discord_VectorProxy< dpp::activity_button, DpActivityButton, SqDpActivityButton >(vm, ns, _SC("ActivityButtons"));
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ActivityAssets"),
+        Class< DpActivityAssets, NoCopy< DpActivityAssets > >(vm, SqDpActivityAssets::Str)
+        // Constructors
+        .Ctor()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpActivityAssets::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpActivityAssets::IsValid)
+        .Prop(_SC("LargeImage"), &DpActivityAssets::GetLargeImage, &DpActivityAssets::SetLargeImage)
+        .Prop(_SC("LargeText"), &DpActivityAssets::GetLargeText, &DpActivityAssets::SetLargeText)
+        .Prop(_SC("SmallImage"), &DpActivityAssets::GetSmallImage, &DpActivityAssets::SetSmallImage)
+        .Prop(_SC("SmallText"), &DpActivityAssets::GetSmallText, &DpActivityAssets::SetSmallText)
+        // Member Methods
+        .Func(_SC("SetLargeImage"), &DpActivityAssets::ApplyLargeImage)
+        .Func(_SC("SetLargeText"), &DpActivityAssets::ApplyLargeText)
+        .Func(_SC("SetSmallImage"), &DpActivityAssets::ApplySmallImage)
+        .Func(_SC("SetSmallText"), &DpActivityAssets::ApplySmallText)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("ActivitySecrets"),
+        Class< DpActivitySecrets, NoCopy< DpActivitySecrets > >(vm, SqDpActivitySecrets::Str)
+        // Constructors
+        .Ctor()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpActivitySecrets::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpActivitySecrets::IsValid)
+        .Prop(_SC("Join"), &DpActivitySecrets::GetJoin, &DpActivitySecrets::SetJoin)
+        .Prop(_SC("Spectate"), &DpActivitySecrets::GetSpectate, &DpActivitySecrets::SetSpectate)
+        .Prop(_SC("Match"), &DpActivitySecrets::GetMatch, &DpActivitySecrets::SetMatch)
+        // Member Methods
+        .Func(_SC("SetJoin"), &DpActivitySecrets::ApplyJoin)
+        .Func(_SC("SetSpectate"), &DpActivitySecrets::ApplySpectate)
+        .Func(_SC("SetMatch"), &DpActivitySecrets::ApplyMatch)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Activity"),
+        Class< DpActivity, NoCopy< DpActivity > >(vm, SqDpActivity::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< SQInteger, StackStrF &, StackStrF &, StackStrF & >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpActivity::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpActivity::IsValid)
+        .Prop(_SC("Name"), &DpActivity::GetName, &DpActivity::SetName)
+        .Prop(_SC("State"), &DpActivity::GetState, &DpActivity::SetState)
+        .Prop(_SC("Details"), &DpActivity::GetDetails, &DpActivity::SetDetails)
+        .Prop(_SC("Assets"), &DpActivity::GetAssets)
+        .Prop(_SC("Buttons"), &DpActivity::GetButtons)
+        .Prop(_SC("Emoji"), &DpActivity::GetEmoji)
+        .Prop(_SC("PartyID"), &DpActivity::GetPartyID)
+        .Prop(_SC("CurrentPartySize"), &DpActivity::GetCurrentPartySize)
+        .Prop(_SC("MaxPartySize"), &DpActivity::GetMaxPartySize)
+        .Prop(_SC("Secrets"), &DpActivity::GetSecrets)
+        .Prop(_SC("URL"), &DpActivity::GetURL, &DpActivity::SetURL)
+        .Prop(_SC("Type"), &DpActivity::GetType, &DpActivity::SetType)
+        .Prop(_SC("CreatedAt"), &DpActivity::GetCreatedAt, &DpActivity::SetCreatedAt)
+        .Prop(_SC("Start"), &DpActivity::GetStart, &DpActivity::SetStart)
+        .Prop(_SC("End"), &DpActivity::GetEnd, &DpActivity::SetEnd)
+        .Prop(_SC("ApplicationID"), &DpActivity::GetApplicationID)
+        .Prop(_SC("Flags"), &DpActivity::GetFlags, &DpActivity::SetFlags)
+        .Prop(_SC("Instance"), &DpActivity::IsInstance)
+        // Member Methods
+        .Func(_SC("SetName"), &DpActivity::ApplyName)
+        .Func(_SC("SetState"), &DpActivity::ApplyState)
+        .Func(_SC("SetDetails"), &DpActivity::ApplyDetails)
+        .Func(_SC("SetURL"), &DpActivity::ApplyURL)
+        .Func(_SC("SetType"), &DpActivity::ApplyType)
+        .Func(_SC("SetCreatedAt"), &DpActivity::ApplyCreatedAt)
+        .Func(_SC("SetStart"), &DpActivity::ApplyStart)
+        .Func(_SC("SetEnd"), &DpActivity::ApplyEnd)
+        .Func(_SC("SetFlags"), &DpActivity::ApplyFlags)
+        .Func(_SC("GetLargeAssetURL"), &DpActivity::GetLargeAssetURL)
+        .Func(_SC("GetSmallAssetURL"), &DpActivity::GetSmallAssetURL)
+    );
+    // --------------------------------------------------------------------------------------------
+    Register_Discord_VectorProxy< dpp::activity, DpActivity, SqDpActivities >(vm, ns, _SC("Activities"));
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("Presence"),
+        Class< DpPresence, NoCopy< DpPresence > >(vm, SqDpPresence::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< SQInteger, DpActivity & >()
+        .Ctor< SQInteger, SQInteger, StackStrF & >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpPresence::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpPresence::IsValid)
+        .Prop(_SC("JSON"), &DpPresence::BuildJSON)
+        .Prop(_SC("UserID"), &DpPresence::GetUserID, &DpPresence::SetUserID)
+        .Prop(_SC("GuildID"), &DpPresence::GetGuildID, &DpPresence::SetGuildID)
+        .Prop(_SC("Flags"), &DpPresence::GetFlags, &DpPresence::SetFlags)
+        .Prop(_SC("Activities"), &DpPresence::GetActivities)
+        .Prop(_SC("DesktopStatus"), &DpPresence::GetDesktopStatus)
+        .Prop(_SC("WebStatus"), &DpPresence::GetWebStatus)
+        .Prop(_SC("MobileStatus"), &DpPresence::GetMobileStatus)
+        .Prop(_SC("Status"), &DpPresence::GetStatus)
+        // Member Methods
+        .Func(_SC("SetUserID"), &DpPresence::ApplyUserID)
+        .Func(_SC("SetGuildID"), &DpPresence::ApplyGuildID)
+        .Func(_SC("SetFlags"), &DpPresence::ApplyFlags)
+        .Func(_SC("BuildJSON"), &DpVoiceState::BuildJSON_)
+    );
+}
+
+} // Namespace:: SqMod

module/Library/Discord/Presence.hpp

@@ -0,0 +1,928 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Misc.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+#include <chrono>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+/* ------------------------------------------------------------------------------------------------
+ * An activity button is a custom button shown in the rich presence. Can be to join a game or whatever.
+*/
+struct DpActivityButton
+{
+    using Ptr = std::unique_ptr< dpp::activity_button >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced activity instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpActivityButton() noexcept
+        : DpActivityButton(new Ptr::element_type(), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpActivityButton(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpActivityButton(const Ptr::element_type & o) noexcept
+        : DpActivityButton(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpActivityButton(Ptr::element_type && o) noexcept
+        : DpActivityButton(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpActivityButton(const DpActivityButton & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpActivityButton(DpActivityButton && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpActivityButton() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpActivityButton & operator = (const DpActivityButton & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpActivityButton & operator = (DpActivityButton && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord activity button handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the text shown on the button (1-32 characters).
+    */
+    SQMOD_NODISCARD const std::string & GetLabel() const { return Valid().label; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the text shown on the button (1-32 characters).
+    */
+    void SetLabel(StackStrF & label) const { Valid().label = label.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the text shown on the button (1-32 characters).
+    */
+    DpActivityButton & ApplyLabel(StackStrF & label) { SetLabel(label); return *this; }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the url opened when clicking the button (1-512 characters). It's may be empty.
+    */
+    SQMOD_NODISCARD const std::string & GetURL() const { return Valid().url; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the url opened when clicking the button (1-512 characters).
+    */
+    void SetURL(StackStrF & url) const { Valid().url = url.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the url opened when clicking the button (1-512 characters).
+    */
+    DpActivityButton & ApplyURL(StackStrF & url) { SetURL(url); return *this; }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * An activity asset are the images and the hover text displayed in the rich presence.
+*/
+struct DpActivityAssets
+{
+    using Ptr = std::unique_ptr< dpp::activity_assets >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced activity instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpActivityAssets() noexcept
+        : DpActivityAssets(new Ptr::element_type(), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpActivityAssets(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpActivityAssets(const Ptr::element_type & o) noexcept
+        : DpActivityAssets(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpActivityAssets(Ptr::element_type && o) noexcept
+        : DpActivityAssets(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpActivityAssets(const DpActivityAssets & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpActivityAssets(DpActivityAssets && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpActivityAssets() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpActivityAssets & operator = (const DpActivityAssets & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpActivityAssets & operator = (DpActivityAssets && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord activity assets handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the large asset image which usually contain snowflake ID or prefixed image ID.
+    */
+    SQMOD_NODISCARD const std::string & GetLargeImage() const { return Valid().large_image; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the large asset image.
+    */
+    void SetLargeImage(StackStrF & large_image) const { Valid().large_image = large_image.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the large asset image.
+    */
+    DpActivityAssets & ApplyLargeImage(StackStrF & large_image) { SetLargeImage(large_image); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the text displayed when hovering over the large image of the activity.
+    */
+    SQMOD_NODISCARD const std::string & GetLargeText() const { return Valid().large_text; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the text displayed when hovering over the large image of the activity.
+    */
+    void SetLargeText(StackStrF & large_text) const { Valid().large_text = large_text.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the text displayed when hovering over the large image of the activity.
+    */
+    DpActivityAssets & ApplyLargeText(StackStrF & large_text) { SetLargeText(large_text); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the small asset image which usually contain snowflake ID or prefixed image ID.
+    */
+    SQMOD_NODISCARD const std::string & GetSmallImage() const { return Valid().small_image; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the small asset image.
+    */
+    void SetSmallImage(StackStrF & small_image) const { Valid().small_image = small_image.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the small asset image.
+    */
+    DpActivityAssets & ApplySmallImage(StackStrF & small_image) { SetSmallImage(small_image); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the text displayed when hovering over the small image of the activity.
+    */
+    SQMOD_NODISCARD const std::string & GetSmallText() const { return Valid().small_text; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the text displayed when hovering over the small image of the activity.
+    */
+    void SetSmallText(StackStrF & small_text) const { Valid().small_text = small_text.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the text displayed when hovering over the small image of the activity.
+    */
+    DpActivityAssets & ApplySmallText(StackStrF & small_text) { SetSmallText(small_text); return *this; }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Secrets for Rich Presence joining and spectating.
+*/
+struct DpActivitySecrets
+{
+    using Ptr = std::unique_ptr< dpp::activity_secrets >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced activity instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpActivitySecrets() noexcept
+        : DpActivitySecrets(new Ptr::element_type(), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpActivitySecrets(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpActivitySecrets(const Ptr::element_type & o) noexcept
+        : DpActivitySecrets(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpActivitySecrets(Ptr::element_type && o) noexcept
+        : DpActivitySecrets(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpActivitySecrets(const DpActivitySecrets & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpActivitySecrets(DpActivitySecrets && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpActivitySecrets() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpActivitySecrets & operator = (const DpActivitySecrets & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpActivitySecrets & operator = (DpActivitySecrets && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord activity secrets handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the secret for joining a party.
+    */
+    SQMOD_NODISCARD const std::string & GetJoin() const { return Valid().join; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the secret for joining a party.
+    */
+    void SetJoin(StackStrF & join) const { Valid().join = join.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the secret for joining a party.
+    */
+    DpActivitySecrets & ApplyJoin(StackStrF & join) { SetJoin(join); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the secret for spectating a game.
+    */
+    SQMOD_NODISCARD const std::string & GetSpectate() const { return Valid().spectate; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the secret for spectating a game.
+    */
+    void SetSpectate(StackStrF & spectate) const { Valid().spectate = spectate.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the secret for spectating a game.
+    */
+    DpActivitySecrets & ApplySpectate(StackStrF & spectate) { SetSpectate(spectate); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the secret for a specific instanced match.
+    */
+    SQMOD_NODISCARD const std::string & GetMatch() const { return Valid().match; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the secret for a specific instanced match.
+    */
+    void SetMatch(StackStrF & match) const { Valid().match = match.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the secret for a specific instanced match.
+    */
+    DpActivitySecrets & ApplyMatch(StackStrF & match) { SetMatch(match); return *this; }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * An activity is a representation of what a user is doing. It might be a game, or a website, or a movie. Whatever.
+*/
+struct DpActivity
+{
+    using Ptr = std::unique_ptr< dpp::activity >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced activity instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    // --------------------------------------------------------------------------------------------
+    using Buttons = DpVectorProxy< dpp::activity_button, DpActivityButton >;
+    // --------------------------------------------------------------------------------------------
+    LightObj mSqAssets{};
+    LightObj mSqButtons{};
+    LightObj mSqEmoji{};
+    LightObj mSqSecrets{};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpActivity() noexcept
+        : DpActivity(new Ptr::element_type(), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpActivity(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpActivity(const Ptr::element_type & o) noexcept
+        : DpActivity(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpActivity(Ptr::element_type && o) noexcept
+        : DpActivity(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    DpActivity(SQInteger type, StackStrF & name, StackStrF & state, StackStrF & url)
+        : DpActivity(new Ptr::element_type(static_cast< dpp::activity_type >(type), name.ToStr(), state.ToStr(), url.ToStr()), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpActivity(const DpActivity & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpActivity(DpActivity && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpActivity() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpActivity & operator = (const DpActivity & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpActivity & operator = (DpActivity && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Cleanup activity assets, if any
+        if (!mSqAssets.IsNull())
+        {
+            mSqAssets.CastI< DpActivityAssets >()->Cleanup();
+            // Release script resources
+            mSqAssets.Release();
+        }
+        // Cleanup activity buttons, if any
+        if (!mSqButtons.IsNull())
+        {
+            mSqButtons.CastI< Buttons >()->Cleanup();
+            // Release script resources
+            mSqButtons.Release();
+        }
+        // Cleanup activity emoji, if any
+        if (!mSqEmoji.IsNull())
+        {
+            mSqEmoji.CastI< DpEmoji >()->Cleanup();
+            // Release script resources
+            mSqEmoji.Release();
+        }
+        // Cleanup activity secrets, if any
+        if (!mSqSecrets.IsNull())
+        {
+            mSqSecrets.CastI< DpActivitySecrets >()->Cleanup();
+            // Release script resources
+            mSqSecrets.Release();
+        }
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord activity handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the name of the activity. e.g. "Vice City"
+    */
+    SQMOD_NODISCARD const std::string & GetName() const { return Valid().name; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the activity.
+    */
+    void SetName(StackStrF & name) const { Valid().name = name.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the activity.
+    */
+    DpActivity & ApplyName(StackStrF & name) { SetName(name); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the state of the activity. e.g. "Waiting in lobby"
+    */
+    SQMOD_NODISCARD const std::string & GetState() const { return Valid().state; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the state of the activity.
+    */
+    void SetState(StackStrF & state) const { Valid().state = state.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the state of the activity.
+    */
+    DpActivity & ApplyState(StackStrF & state) { SetState(state); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the details of the activity. What the player is currently doing.
+    */
+    SQMOD_NODISCARD const std::string & GetDetails() const { return Valid().details; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the details of the activity.
+    */
+    void SetDetails(StackStrF & details) const { Valid().details = details.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the details of the activity.
+    */
+    DpActivity & ApplyDetails(StackStrF & details) { SetDetails(details); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the images for the presence and their hover texts.
+    */
+    SQMOD_NODISCARD LightObj & GetAssets()
+    {
+        if (mSqAssets.IsNull())
+        {
+            mSqAssets = LightObj{SqTypeIdentity< DpActivityAssets >{}, SqVM(), &Valid().assets, false};
+        }
+        // Return the associated script object
+        return mSqAssets;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the url of the activity. Only applicable for certain sites such a YouTube.
+    */
+    SQMOD_NODISCARD const std::string & GetURL() const { return Valid().url; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the url of the activity.
+    */
+    void SetURL(StackStrF & url) const { Valid().url = url.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the url of the activity.
+    */
+    DpActivity & ApplyURL(StackStrF & url) { SetURL(url); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the custom buttons shown in the Rich Presence (max 2).
+    */
+    SQMOD_NODISCARD LightObj & GetButtons()
+    {
+        if (mSqButtons.IsNull())
+        {
+            mSqButtons = LightObj{SqTypeIdentity< Buttons >{}, SqVM(), &Valid().buttons, false};
+        }
+        // Return the associated script object
+        return mSqButtons;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the emoji used for the custom status.
+    */
+    SQMOD_NODISCARD LightObj & GetEmoji()
+    {
+        if (mSqEmoji.IsNull())
+        {
+            mSqEmoji = LightObj{SqTypeIdentity< DpEmoji >{}, SqVM(), &Valid().emoji, false};
+        }
+        // Return the associated script object
+        return mSqEmoji;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the ID of the party.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetPartyID() const { return Valid().party.id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the party's current size. Used to show the party's current size.
+    */
+    SQMOD_NODISCARD SQInteger GetCurrentPartySize() const { return Valid().party.current_size; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the party's maximum size. Used to show the party's maximum size.
+    */
+    SQMOD_NODISCARD SQInteger GetMaxPartySize() const { return Valid().party.maximum_size; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the secrets for rich presence joining and spectating.
+    */
+    SQMOD_NODISCARD LightObj & GetSecrets()
+    {
+        if (mSqSecrets.IsNull())
+        {
+            mSqSecrets = LightObj{SqTypeIdentity< DpActivitySecrets >{}, SqVM(), &Valid().secrets, false};
+        }
+        // Return the associated script object
+        return mSqSecrets;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the type for the activity from SqDiscordActivityType.
+    */
+    SQMOD_NODISCARD SQInteger GetType() const { return Valid().type; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the type for the activity from SqDiscordActivityType.
+    */
+    void SetType(SQInteger type) const { Valid().type = static_cast< dpp::activity_type >(type); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the type for the activity from SqDiscordActivityType.
+    */
+    DpActivity & ApplyType(SQInteger type) { SetType(type); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve when the activity was created.
+    */
+    SQMOD_NODISCARD SQInteger GetCreatedAt() const
+    {
+        return static_cast< SQInteger >(std::chrono::duration_cast< std::chrono::seconds >(std::chrono::system_clock::from_time_t(Valid().created_at).time_since_epoch()).count());
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify when the activity was created.
+    */
+    void SetCreatedAt(SQInteger s) const
+    {
+        Valid().created_at = std::chrono::system_clock::to_time_t(std::chrono::time_point< std::chrono::system_clock >{std::chrono::seconds{s}});
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify when the activity was created.
+    */
+    DpActivity & ApplyCreatedAt(SQInteger s) { SetCreatedAt(s); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve when the activity was started.
+    */
+    SQMOD_NODISCARD SQInteger GetStart() const
+    {
+        return static_cast< SQInteger >(std::chrono::duration_cast< std::chrono::seconds >(std::chrono::system_clock::from_time_t(Valid().start).time_since_epoch()).count());
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify when the activity was started.
+    */
+    void SetStart(SQInteger s) const
+    {
+        Valid().start = std::chrono::system_clock::to_time_t(std::chrono::time_point< std::chrono::system_clock >{std::chrono::seconds{s}});
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify when the activity was started.
+    */
+    DpActivity & ApplyStart(SQInteger s) { SetStart(s); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve when the activity was stopped.
+    */
+    SQMOD_NODISCARD SQInteger GetEnd() const
+    {
+        return static_cast< SQInteger >(std::chrono::duration_cast< std::chrono::seconds >(std::chrono::system_clock::from_time_t(Valid().end).time_since_epoch()).count());
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify when the activity was stopped.
+    */
+    void SetEnd(SQInteger s) const
+    {
+        Valid().end = std::chrono::system_clock::to_time_t(std::chrono::time_point< std::chrono::system_clock >{std::chrono::seconds{s}});
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify when the activity was stopped.
+    */
+    DpActivity & ApplyEnd(SQInteger s) { SetEnd(s); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the creating application (e.g. a linked account on the user's client)
+    */
+    SQMOD_NODISCARD dpp::snowflake GetApplicationID() const { return Valid().application_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the flags for the activity from SqDiscordActivityFlags.
+    */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return Valid().flags; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the activity from SqDiscordActivityFlags.
+    */
+    void SetFlags(SQInteger flags) const { Valid().flags = static_cast< uint8_t >(flags); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the activity from SqDiscordActivityFlags.
+    */
+    DpActivity & ApplyFlags(SQInteger flags) { SetFlags(flags); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether or not the activity is an instanced game session.
+    */
+    SQMOD_NODISCARD bool IsInstance() const { return Valid().is_instance; }
+    /* --------------------------------------------------------------------------------------------
+     * Get the assets large image url if they have one, otherwise returns an empty string.
+     * In case of prefixed image IDs (mp:{image_id}) it returns an empty string.
+     * See: https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-asset-image
+    */
+    SQMOD_NODISCARD std::string GetLargeAssetURL(SQInteger size, SQInteger format) const
+    { return Valid().get_large_asset_url(static_cast< uint16_t >(size), static_cast< dpp::image_type >(format)); }
+    /* --------------------------------------------------------------------------------------------
+     * Get the assets small image url if they have one, otherwise returns an empty string.
+     * In case of prefixed image IDs (mp:{image_id}) it returns an empty string.
+     * See: https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-asset-image
+    */
+    SQMOD_NODISCARD std::string GetSmallAssetURL(SQInteger size, SQInteger format) const
+    { return Valid().get_small_asset_url(static_cast< uint16_t >(size), static_cast< dpp::image_type >(format)); }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents user presence, e.g. what game they are playing and if they are online.
+*/
+struct DpPresence
+{
+    using Ptr = std::unique_ptr< dpp::presence >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced presence instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    // --------------------------------------------------------------------------------------------
+    using Activities = DpVectorProxy< dpp::activity, DpActivity >;
+    // --------------------------------------------------------------------------------------------
+    LightObj mSqActivities{};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpPresence() noexcept
+        : DpPresence(new Ptr::element_type(), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpPresence(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    explicit DpPresence(const Ptr::element_type & o) noexcept
+        : DpPresence(new Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpPresence(Ptr::element_type && o) noexcept
+        : DpPresence(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    DpPresence(SQInteger status, DpActivity & activity)
+        : DpPresence(new Ptr::element_type(static_cast< dpp::presence_status >(status), activity.Valid()), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    DpPresence(SQInteger status, SQInteger type, StackStrF & description)
+        : DpPresence(new Ptr::element_type(static_cast< dpp::presence_status >(status), static_cast< dpp::activity_type >(status), description.ToStr()), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpPresence(const DpPresence & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpPresence(DpPresence && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpPresence() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpPresence & operator = (const DpPresence & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpPresence & operator = (DpPresence && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Cleanup presence activities, if any
+        if (!mSqActivities.IsNull())
+        {
+            mSqActivities.CastI< Activities >()->Cleanup();
+            // Release script resources
+            mSqActivities.Release();
+        }
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord presence handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user that the presence applies to.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetUserID() const { return Valid().user_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the user that the presence applies to.
+    */
+    void SetUserID(dpp::snowflake id) const { Valid().user_id = id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the user that the presence applies to.
+    */
+    DpPresence & ApplyUserID(dpp::snowflake id) { SetUserID(id); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the guild that the presence applies to.
+    */
+    SQMOD_NODISCARD dpp::snowflake GetGuildID() const { return Valid().guild_id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild that the presence applies to.
+    */
+    void SetGuildID(dpp::snowflake id) const { Valid().guild_id = id; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the guild that the presence applies to.
+    */
+    DpPresence & ApplyGuildID(dpp::snowflake id) { SetGuildID(id); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the presence bit-mask.
+    */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return static_cast< SQInteger >(Valid().flags); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the presence bit-mask.
+    */
+    void SetFlags(SQInteger f) const { Valid().flags = static_cast< uint8_t >(f); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the presence bit-mask.
+    */
+    DpPresence & ApplyFlags(SQInteger f) { SetFlags(f); return *this; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the list of activities.
+    */
+    SQMOD_NODISCARD LightObj & GetActivities()
+    {
+        if (mSqActivities.IsNull())
+        {
+            mSqActivities = LightObj{SqTypeIdentity< Activities >{}, SqVM(), &Valid().activities, false};
+        }
+        // Return the associated script object
+        return mSqActivities;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Build JSON string from this object.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the users status on desktop.
+    */
+    SQMOD_NODISCARD SQInteger GetDesktopStatus() const { return static_cast< SQInteger >(Valid().desktop_status()); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user's status on web.
+    */
+    SQMOD_NODISCARD SQInteger GetWebStatus() const { return static_cast< SQInteger >(Valid().web_status()); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user's status on mobile.
+    */
+    SQMOD_NODISCARD SQInteger GetMobileStatus() const { return static_cast< SQInteger >(Valid().mobile_status()); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the user's status as shown to other users.
+    */
+    SQMOD_NODISCARD SQInteger GetStatus() const { return static_cast< SQInteger >(Valid().status()); }
+};
+
+
+} // Namespace:: SqMod

module/Library/Discord/Role.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Role.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Role.hpp

@@ -0,0 +1,13 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+} // Namespace:: SqMod

module/Library/Discord/User.cpp

@@ -0,0 +1,142 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/User.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqDpUser, _SC("SqDiscordUser"))
+SQMOD_DECL_TYPENAME(SqDpUserIdentifier, _SC("SqDiscordUser"))
+
+// ------------------------------------------------------------------------------------------------
+void Register_Discord_User(HSQUIRRELVM vm, Table & ns)
+{
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("User"),
+        Class< DpUserIdentifier, NoCopy< DpUser > >(vm, SqDpUser::Str)
+        // Constructors
+        .Ctor()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpUser::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpUser::IsValid)
+        .Prop(_SC("Identified"), &DpUser::IsIdentified)
+        .Prop(_SC("JSON"), &DpUser::BuildJSON)
+        .Prop(_SC("CreationTime"), &DpUser::GetCreationTime)
+        .Prop(_SC("Name"), &DpUser::GetName, &DpUser::SetName)
+        .Prop(_SC("Avatar"), &DpUser::GetAvatar, &DpUser::SetAvatar)
+        .Prop(_SC("Flags"), &DpUser::GetFlags, &DpUser::SetFlags)
+        .Prop(_SC("Discriminator"), &DpUser::GetDiscriminator, &DpUser::SetDiscriminator)
+        .Prop(_SC("RefCount"), &DpUser::GetRefCount, &DpUser::SetRefCount)
+        .Prop(_SC("AvatarUrl"), &DpUser::GetAvatarUrl)
+        .Prop(_SC("DefaultAvatarUrl"), &DpUser::GetDefaultAvatarUrl)
+        .Prop(_SC("Mention"), &DpUser::GetMention)
+        .Prop(_SC("IsActiveDeveloper"), &DpUser::IsActiveDeveloper)
+        .Prop(_SC("IsBot"), &DpUser::IsBot)
+        .Prop(_SC("IsSystem"), &DpUser::IsSystem)
+        .Prop(_SC("IsMfaEnabled"), &DpUser::IsMfaEnabled)
+        .Prop(_SC("IsVerified"), &DpUser::IsVerified)
+        .Prop(_SC("HasNitroFull"), &DpUser::HasNitroFull)
+        .Prop(_SC("HasNitroClassic"), &DpUser::HasNitroClassic)
+        .Prop(_SC("HasNitroBasic"), &DpUser::HasNitroBasic)
+        .Prop(_SC("IsDiscordEmployee"), &DpUser::IsDiscordEmployee)
+        .Prop(_SC("IsPartneredOwner"), &DpUser::IsPartneredOwner)
+        .Prop(_SC("HasHypesquadEvents"), &DpUser::HasHypesquadEvents)
+        .Prop(_SC("IsBughunter1"), &DpUser::IsBughunter1)
+        .Prop(_SC("IsHouseBravery"), &DpUser::IsHouseBravery)
+        .Prop(_SC("IsHouseBrilliance"), &DpUser::IsHouseBrilliance)
+        .Prop(_SC("IsHouseBalance"), &DpUser::IsHouseBalance)
+        .Prop(_SC("IsEarlySupporter"), &DpUser::IsEarlySupporter)
+        .Prop(_SC("IsTeamUser"), &DpUser::IsTeamUser)
+        .Prop(_SC("IsBughunter2"), &DpUser::IsBughunter2)
+        .Prop(_SC("IsVerifiedBot"), &DpUser::IsVerifiedBot)
+        .Prop(_SC("IsVerifiedBotDev"), &DpUser::IsVerifiedBotDev)
+        .Prop(_SC("IsCertifiedModerator"), &DpUser::IsCertifiedModerator)
+        .Prop(_SC("IsBotHttpInteractions"), &DpUser::IsBotHttpInteractions)
+        .Prop(_SC("HasAnimatedIcon"), &DpUser::HasAnimatedIcon)
+        // Member Methods
+        .Func(_SC("SetName"), &DpUser::ApplyName)
+        .Func(_SC("SetFlags"), &DpUser::ApplyFlags)
+        .Func(_SC("SetDiscriminator"), &DpUser::ApplyDiscriminator)
+        .Func(_SC("BuildJSON"), &DpUser::BuildJSON_)
+        .Func(_SC("GetMention"), &DpUser::GetMention)
+        .Func(_SC("FormatUsername"), &DpUser::FormatUsername)
+        // Member Overloads
+        .Overload(_SC("GetAvatarUrl"), &DpUser::GetAvatarUrl)
+        .Overload(_SC("GetAvatarUrl"), &DpUser::GetAvatarUrl_1)
+        .Overload(_SC("GetAvatarUrl"), &DpUser::GetAvatarUrl_2)
+        .Overload(_SC("GetAvatarUrl"), &DpUser::GetAvatarUrl_3)
+    );
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(_SC("UserIdentifier"),
+        Class< DpUserIdentifier, NoCopy< DpUserIdentifier > >(vm, SqDpUserIdentifier::Str)
+        // Constructors
+        .Ctor()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqDpUserIdentifier::Fn)
+        // Member Properties
+        .Prop(_SC("Valid"), &DpUserIdentifier::IsValid)
+        .Prop(_SC("Identified"), &DpUserIdentifier::IsIdentified)
+        .Prop(_SC("JSON"), &DpUserIdentifier::BuildJSON)
+        .Prop(_SC("CreationTime"), &DpUserIdentifier::GetCreationTime)
+        .Prop(_SC("Name"), &DpUserIdentifier::GetName, &DpUserIdentifier::SetName)
+        .Prop(_SC("Avatar"), &DpUserIdentifier::GetAvatar, &DpUserIdentifier::SetAvatar)
+        .Prop(_SC("Flags"), &DpUserIdentifier::GetFlags, &DpUserIdentifier::SetFlags)
+        .Prop(_SC("Discriminator"), &DpUserIdentifier::GetDiscriminator, &DpUserIdentifier::SetDiscriminator)
+        .Prop(_SC("RefCount"), &DpUserIdentifier::GetRefCount, &DpUserIdentifier::SetRefCount)
+        .Prop(_SC("AvatarUrl"), &DpUserIdentifier::GetAvatarUrl)
+        .Prop(_SC("DefaultAvatarUrl"), &DpUserIdentifier::GetDefaultAvatarUrl)
+        .Prop(_SC("Mention"), &DpUserIdentifier::GetMention)
+        .Prop(_SC("IsActiveDeveloper"), &DpUserIdentifier::IsActiveDeveloper)
+        .Prop(_SC("IsBot"), &DpUserIdentifier::IsBot)
+        .Prop(_SC("IsSystem"), &DpUserIdentifier::IsSystem)
+        .Prop(_SC("IsMfaEnabled"), &DpUserIdentifier::IsMfaEnabled)
+        .Prop(_SC("IsVerified"), &DpUserIdentifier::IsVerified)
+        .Prop(_SC("HasNitroFull"), &DpUserIdentifier::HasNitroFull)
+        .Prop(_SC("HasNitroClassic"), &DpUserIdentifier::HasNitroClassic)
+        .Prop(_SC("HasNitroBasic"), &DpUserIdentifier::HasNitroBasic)
+        .Prop(_SC("IsDiscordEmployee"), &DpUserIdentifier::IsDiscordEmployee)
+        .Prop(_SC("IsPartneredOwner"), &DpUserIdentifier::IsPartneredOwner)
+        .Prop(_SC("HasHypesquadEvents"), &DpUserIdentifier::HasHypesquadEvents)
+        .Prop(_SC("IsBughunter1"), &DpUserIdentifier::IsBughunter1)
+        .Prop(_SC("IsHouseBravery"), &DpUserIdentifier::IsHouseBravery)
+        .Prop(_SC("IsHouseBrilliance"), &DpUserIdentifier::IsHouseBrilliance)
+        .Prop(_SC("IsHouseBalance"), &DpUserIdentifier::IsHouseBalance)
+        .Prop(_SC("IsEarlySupporter"), &DpUserIdentifier::IsEarlySupporter)
+        .Prop(_SC("IsTeamUser"), &DpUserIdentifier::IsTeamUser)
+        .Prop(_SC("IsBughunter2"), &DpUserIdentifier::IsBughunter2)
+        .Prop(_SC("IsVerifiedBot"), &DpUserIdentifier::IsVerifiedBot)
+        .Prop(_SC("IsVerifiedBotDev"), &DpUserIdentifier::IsVerifiedBotDev)
+        .Prop(_SC("IsCertifiedModerator"), &DpUserIdentifier::IsCertifiedModerator)
+        .Prop(_SC("IsBotHttpInteractions"), &DpUserIdentifier::IsBotHttpInteractions)
+        .Prop(_SC("HasAnimatedIcon"), &DpUserIdentifier::HasAnimatedIcon)
+        .Prop(_SC("HasAnimatedBanner"), &DpUserIdentifier::HasAnimatedBanner)
+        .Prop(_SC("Banner"), &DpUserIdentifier::GetBanner, &DpUserIdentifier::SetBanner)
+        .Prop(_SC("Locale"), &DpUserIdentifier::GetLocale, &DpUserIdentifier::SetLocale)
+        .Prop(_SC("Email"), &DpUserIdentifier::GetEmail, &DpUserIdentifier::SetEmail)
+        .Prop(_SC("AccentColor"), &DpUserIdentifier::GetAccentColor, &DpUserIdentifier::SetAccentColor)
+        .Prop(_SC("Verified"), &DpUserIdentifier::GetVerified, &DpUserIdentifier::SetVerified)
+        .Prop(_SC("BannerUrl"), &DpUserIdentifier::GetBannerUrl)
+        // Member Methods
+        .Func(_SC("SetName"), &DpUserIdentifier::ApplyName)
+        .Func(_SC("SetFlags"), &DpUserIdentifier::ApplyFlags)
+        .Func(_SC("SetDiscriminator"), &DpUserIdentifier::ApplyDiscriminator)
+        .Func(_SC("BuildJSON"), &DpUserIdentifier::BuildJSON_)
+        .Func(_SC("GetMention"), &DpUserIdentifier::GetMention)
+        .Func(_SC("FormatUsername"), &DpUserIdentifier::FormatUsername)
+        .Func(_SC("SetLocale"), &DpUserIdentifier::ApplyLocale)
+        .Func(_SC("SetEmail"), &DpUserIdentifier::ApplyEmail)
+        .Func(_SC("SetAccentColor"), &DpUserIdentifier::ApplyAccentColor)
+        // Member Overloads
+        .Overload(_SC("GetAvatarUrl"), &DpUserIdentifier::GetAvatarUrl)
+        .Overload(_SC("GetAvatarUrl"), &DpUserIdentifier::GetAvatarUrl_1)
+        .Overload(_SC("GetAvatarUrl"), &DpUserIdentifier::GetAvatarUrl_2)
+        .Overload(_SC("GetAvatarUrl"), &DpUserIdentifier::GetAvatarUrl_3)
+        .Overload(_SC("GetBannerUrl"), &DpUserIdentifier::GetBannerUrl)
+        .Overload(_SC("GetBannerUrl"), &DpUserIdentifier::GetBannerUrl_1)
+        .Overload(_SC("GetBannerUrl"), &DpUserIdentifier::GetBannerUrl_2)
+        .Overload(_SC("GetBannerUrl"), &DpUserIdentifier::GetBannerUrl_3)
+    );
+}
+
+} // Namespace:: SqMod

module/Library/Discord/User.hpp

@@ -0,0 +1,549 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+/* ------------------------------------------------------------------------------------------------
+ * Represents a user on discord. May or may not be a member of a DpGuild.
+*/
+struct DpUser
+{
+    using Ptr = std::unique_ptr< dpp::user >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced voice state instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpUser() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpUser(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    {
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpUser(const Ptr::element_type & o) noexcept
+        : DpUser(new Ptr::element_type(o), true)
+    {
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpUser(Ptr::element_type && o) noexcept
+        : DpUser(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    {
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpUser(const DpUser & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpUser(DpUser && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpUser() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpUser & operator=(const DpUser & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpUser & operator=(DpUser && o) noexcept
+    {
+        if (this != &o)
+        {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr)
+        {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        }
+        else
+            mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const
+    {
+        if (!mPtr)
+            STHROWF("Invalid discord user handle");
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const
+    {
+        Validate();
+        return *mPtr;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast<bool>(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether this represents an identified user.
+    */
+    SQMOD_NODISCARD bool IsIdentified() const { return false; }
+    /* --------------------------------------------------------------------------------------------
+     * Get the creation time of this object according to Discord.
+    */
+    SQMOD_NODISCARD SQFloat GetCreationTime() const { return Valid().get_creation_time(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the name of the user.
+     */
+    SQMOD_NODISCARD const std::string & GetName() const { return Valid().username; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the user.
+     */
+    void SetName(StackStrF & name) const { Valid().username = name.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the user.
+     */
+    DpUser & ApplyName(StackStrF & name)
+    {
+        SetName(name);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the avatar hash of the user.
+     */
+    SQMOD_NODISCARD const dpp::utility::iconhash & GetAvatar() const { return Valid().avatar; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the avatar hash of the user.
+     */
+    void SetAvatar(dpp::utility::iconhash & avatar) const { Valid().avatar = avatar; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the flags for the user from SqDiscordUserFlags.
+     */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return Valid().flags; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the user from SqDiscordUserFlags.
+     */
+    void SetFlags(SQInteger flags) const { Valid().flags = static_cast< uint32_t >(flags); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the user from SqDiscordUserFlags.
+     */
+    DpUser & ApplyFlags(SQInteger flags)
+    {
+        SetFlags(flags);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the discriminator (aka tag), 4 digits usually displayed with leading zeroes for the user.
+     * To print the discriminator with leading zeroes, use FormatUsername()
+     */
+    SQMOD_NODISCARD SQInteger GetDiscriminator() const { return Valid().discriminator; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the discriminator for the user.
+     */
+    void SetDiscriminator(SQInteger discriminator) const { Valid().discriminator = static_cast< uint16_t >(discriminator); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the discriminator for the user.
+     */
+    DpUser & ApplyDiscriminator(SQInteger discriminator)
+    {
+        SetDiscriminator(discriminator);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the reference count of how many guilds this user is in.
+     */
+    SQMOD_NODISCARD SQInteger GetRefCount() const { return Valid().refcount; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the reference count of how many guilds this user is in.
+     */
+    void SetRefCount(SQInteger refcount) const { Valid().refcount = static_cast< uint8_t >(refcount); }
+    /* --------------------------------------------------------------------------------------------
+     * Build JSON string from this user.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the avatar url of the user.
+     * If the user doesn't have an avatar, the default user avatar url is returned which is always in `png` format!
+     * Size of the avatar is in pixels. It can be any power of two between 16 and 4096.
+     * Check SqDiscordImageType enum for available image formats.
+    */
+    SQMOD_NODISCARD std::string GetAvatarUrl() const { return Valid().get_avatar_url(); }
+    SQMOD_NODISCARD std::string GetAvatarUrl_1(uint16_t size) const { return Valid().get_avatar_url(size); }
+    SQMOD_NODISCARD std::string GetAvatarUrl_2(uint16_t size, SQInteger format) const { return Valid().get_avatar_url(size, static_cast< dpp::image_type >(format)); }
+    SQMOD_NODISCARD std::string GetAvatarUrl_3(uint16_t size, SQInteger format, bool prefer_animated) const { return Valid().get_avatar_url(size, static_cast< dpp::image_type >(format), prefer_animated); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the default avatar url of the user. This is calculated by the discriminator.
+    */
+    SQMOD_NODISCARD std::string GetDefaultAvatarUrl() const { return Valid().get_default_avatar_url(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve a ping/mention for the user.
+    */
+    SQMOD_NODISCARD std::string GetMention() const { return Valid().get_mention(); }
+    /* --------------------------------------------------------------------------------------------
+     * Format a username into user\#discriminator. For example Brain#0001
+    */
+    SQMOD_NODISCARD std::string FormatUsername() const { return Valid().format_username(); }
+    /* --------------------------------------------------------------------------------------------
+     * Helper methods for flags.
+    */
+    SQMOD_NODISCARD bool IsActiveDeveloper() const { return Valid().is_active_developer(); }
+    SQMOD_NODISCARD bool IsBot() const { return Valid().is_bot(); }
+    SQMOD_NODISCARD bool IsSystem() const { return Valid().is_system(); }
+    SQMOD_NODISCARD bool IsMfaEnabled() const { return Valid().is_mfa_enabled(); }
+    SQMOD_NODISCARD bool IsVerified() const { return Valid().is_verified(); }
+    SQMOD_NODISCARD bool HasNitroFull() const { return Valid().has_nitro_full(); }
+    SQMOD_NODISCARD bool HasNitroClassic() const { return Valid().has_nitro_classic(); }
+    SQMOD_NODISCARD bool HasNitroBasic() const { return Valid().has_nitro_basic(); }
+    SQMOD_NODISCARD bool IsDiscordEmployee() const { return Valid().is_discord_employee(); }
+    SQMOD_NODISCARD bool IsPartneredOwner() const { return Valid().is_partnered_owner(); }
+    SQMOD_NODISCARD bool HasHypesquadEvents() const { return Valid().has_hypesquad_events(); }
+    SQMOD_NODISCARD bool IsBughunter1() const { return Valid().is_bughunter_1(); }
+    SQMOD_NODISCARD bool IsHouseBravery() const { return Valid().is_house_bravery(); }
+    SQMOD_NODISCARD bool IsHouseBrilliance() const { return Valid().is_house_brilliance(); }
+    SQMOD_NODISCARD bool IsHouseBalance() const { return Valid().is_house_balance(); }
+    SQMOD_NODISCARD bool IsEarlySupporter() const { return Valid().is_early_supporter(); }
+    SQMOD_NODISCARD bool IsTeamUser() const { return Valid().is_team_user(); }
+    SQMOD_NODISCARD bool IsBughunter2() const { return Valid().is_bughunter_2(); }
+    SQMOD_NODISCARD bool IsVerifiedBot() const { return Valid().is_verified_bot(); }
+    SQMOD_NODISCARD bool IsVerifiedBotDev() const { return Valid().is_verified_bot_dev(); }
+    SQMOD_NODISCARD bool IsCertifiedModerator() const { return Valid().is_certified_moderator(); }
+    SQMOD_NODISCARD bool IsBotHttpInteractions() const { return Valid().is_bot_http_interactions(); }
+    SQMOD_NODISCARD bool HasAnimatedIcon() const { return Valid().has_animated_icon(); }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * A user with additional fields only available via the oauth2 identify scope.
+ * These are not included in DpUser as additional scopes are needed to fetch them which bots do not normally have.
+*/
+struct DpUserIdentifier
+{
+    using Ptr = std::unique_ptr< dpp::user_identified >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced voice state instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpUserIdentifier() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpUserIdentifier(Ptr::pointer ptr, bool owned = false) noexcept
+        : mPtr(ptr), mOwned(owned)
+    {
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpUserIdentifier(const Ptr::element_type & o) noexcept
+        : DpUserIdentifier(new Ptr::element_type(o), true)
+    {
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpUserIdentifier(Ptr::element_type && o) noexcept
+        : DpUserIdentifier(new Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    {
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpUserIdentifier(const DpUserIdentifier & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpUserIdentifier(DpUserIdentifier && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpUserIdentifier() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpUserIdentifier & operator=(const DpUserIdentifier & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpUserIdentifier & operator=(DpUserIdentifier && o) noexcept
+    {
+        if (this != &o)
+        {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr)
+        {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        }
+        else
+            mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const
+    {
+        if (!mPtr)
+            STHROWF("Invalid discord user handle");
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD Ptr::element_type & Valid() const
+    {
+        Validate();
+        return *mPtr;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast<bool>(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether this represents an identified user.
+    */
+    SQMOD_NODISCARD bool IsIdentified() const { return false; }
+    /* --------------------------------------------------------------------------------------------
+     * Get the creation time of this object according to Discord.
+    */
+    SQMOD_NODISCARD SQFloat GetCreationTime() const { return Valid().get_creation_time(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the name of the user.
+     */
+    SQMOD_NODISCARD const std::string & GetName() const { return Valid().username; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the user.
+     */
+    void SetName(StackStrF & name) const { Valid().username = name.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the name of the user.
+     */
+    DpUserIdentifier & ApplyName(StackStrF & name)
+    {
+        SetName(name);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the avatar hash of the user.
+     */
+    SQMOD_NODISCARD const dpp::utility::iconhash & GetAvatar() const { return Valid().avatar; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the avatar hash of the user.
+     */
+    void SetAvatar(dpp::utility::iconhash & avatar) const { Valid().avatar = avatar; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the flags for the user from SqDiscordUserFlags.
+     */
+    SQMOD_NODISCARD SQInteger GetFlags() const { return Valid().flags; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the user from SqDiscordUserFlags.
+     */
+    void SetFlags(SQInteger flags) const { Valid().flags = static_cast< uint32_t >(flags); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the flags for the user from SqDiscordUserFlags.
+     */
+    DpUserIdentifier & ApplyFlags(SQInteger flags)
+    {
+        SetFlags(flags);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the discriminator (aka tag), 4 digits usually displayed with leading zeroes for the user.
+     * To print the discriminator with leading zeroes, use FormatUsername()
+     */
+    SQMOD_NODISCARD SQInteger GetDiscriminator() const { return Valid().discriminator; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the discriminator for the user.
+     */
+    void SetDiscriminator(SQInteger discriminator) const { Valid().discriminator = static_cast< uint16_t >(discriminator); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the discriminator for the user.
+     */
+    DpUserIdentifier & ApplyDiscriminator(SQInteger discriminator)
+    {
+        SetDiscriminator(discriminator);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the reference count of how many guilds this user is in.
+     */
+    SQMOD_NODISCARD SQInteger GetRefCount() const { return Valid().refcount; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the reference count of how many guilds this user is in.
+     */
+    void SetRefCount(SQInteger refcount) const { Valid().refcount = static_cast< uint8_t >(refcount); }
+    /* --------------------------------------------------------------------------------------------
+     * Build JSON string from this user.
+    */
+    SQMOD_NODISCARD std::string BuildJSON() const { return Valid().build_json(); }
+    SQMOD_NODISCARD std::string BuildJSON_(bool with_id) const { return Valid().build_json(with_id); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the avatar url of the user.
+     * If the user doesn't have an avatar, the default user avatar url is returned which is always in `png` format!
+     * Size of the avatar is in pixels. It can be any power of two between 16 and 4096.
+     * Check SqDiscordImageType enum for available image formats.
+    */
+    SQMOD_NODISCARD std::string GetAvatarUrl() const { return Valid().get_avatar_url(); }
+    SQMOD_NODISCARD std::string GetAvatarUrl_1(uint16_t size) const { return Valid().get_avatar_url(size); }
+    SQMOD_NODISCARD std::string GetAvatarUrl_2(uint16_t size, SQInteger format) const { return Valid().get_avatar_url(size, static_cast< dpp::image_type >(format)); }
+    SQMOD_NODISCARD std::string GetAvatarUrl_3(uint16_t size, SQInteger format, bool prefer_animated) const { return Valid().get_avatar_url(size, static_cast< dpp::image_type >(format), prefer_animated); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the default avatar url of the user. This is calculated by the discriminator.
+    */
+    SQMOD_NODISCARD std::string GetDefaultAvatarUrl() const { return Valid().get_default_avatar_url(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve a ping/mention for the user.
+    */
+    SQMOD_NODISCARD std::string GetMention() const { return Valid().get_mention(); }
+    /* --------------------------------------------------------------------------------------------
+     * Format a username into user\#discriminator. For example Brain#0001
+    */
+    SQMOD_NODISCARD std::string FormatUsername() const { return Valid().format_username(); }
+    /* --------------------------------------------------------------------------------------------
+     * Helper methods for flags.
+    */
+    SQMOD_NODISCARD bool IsActiveDeveloper() const { return Valid().is_active_developer(); }
+    SQMOD_NODISCARD bool IsBot() const { return Valid().is_bot(); }
+    SQMOD_NODISCARD bool IsSystem() const { return Valid().is_system(); }
+    SQMOD_NODISCARD bool IsMfaEnabled() const { return Valid().is_mfa_enabled(); }
+    SQMOD_NODISCARD bool IsVerified() const { return Valid().is_verified(); }
+    SQMOD_NODISCARD bool HasNitroFull() const { return Valid().has_nitro_full(); }
+    SQMOD_NODISCARD bool HasNitroClassic() const { return Valid().has_nitro_classic(); }
+    SQMOD_NODISCARD bool HasNitroBasic() const { return Valid().has_nitro_basic(); }
+    SQMOD_NODISCARD bool IsDiscordEmployee() const { return Valid().is_discord_employee(); }
+    SQMOD_NODISCARD bool IsPartneredOwner() const { return Valid().is_partnered_owner(); }
+    SQMOD_NODISCARD bool HasHypesquadEvents() const { return Valid().has_hypesquad_events(); }
+    SQMOD_NODISCARD bool IsBughunter1() const { return Valid().is_bughunter_1(); }
+    SQMOD_NODISCARD bool IsHouseBravery() const { return Valid().is_house_bravery(); }
+    SQMOD_NODISCARD bool IsHouseBrilliance() const { return Valid().is_house_brilliance(); }
+    SQMOD_NODISCARD bool IsHouseBalance() const { return Valid().is_house_balance(); }
+    SQMOD_NODISCARD bool IsEarlySupporter() const { return Valid().is_early_supporter(); }
+    SQMOD_NODISCARD bool IsTeamUser() const { return Valid().is_team_user(); }
+    SQMOD_NODISCARD bool IsBughunter2() const { return Valid().is_bughunter_2(); }
+    SQMOD_NODISCARD bool IsVerifiedBot() const { return Valid().is_verified_bot(); }
+    SQMOD_NODISCARD bool IsVerifiedBotDev() const { return Valid().is_verified_bot_dev(); }
+    SQMOD_NODISCARD bool IsCertifiedModerator() const { return Valid().is_certified_moderator(); }
+    SQMOD_NODISCARD bool IsBotHttpInteractions() const { return Valid().is_bot_http_interactions(); }
+    SQMOD_NODISCARD bool HasAnimatedIcon() const { return Valid().has_animated_icon(); }
+    SQMOD_NODISCARD bool HasAnimatedBanner() const { return Valid().has_animated_banner(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the locale of the user.
+     */
+    SQMOD_NODISCARD const std::string & GetLocale() const { return Valid().locale; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the locale of the user.
+     */
+    void SetLocale(StackStrF & locale) const { Valid().locale = locale.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the locale of the user.
+     */
+    DpUserIdentifier & ApplyLocale(StackStrF & locale)
+    {
+        SetLocale(locale);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the locale of the user.
+     */
+    SQMOD_NODISCARD const std::string & GetEmail() const { return Valid().email; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the email of the user.
+     */
+    void SetEmail(StackStrF & email) const { Valid().email = email.ToStr(); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the email of the user.
+     */
+    DpUserIdentifier & ApplyEmail(StackStrF & email)
+    {
+        SetEmail(email);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the banner hash of the user.
+     */
+    SQMOD_NODISCARD const dpp::utility::iconhash & GetBanner() const { return Valid().banner; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the banner hash of the user.
+     */
+    void SetBanner(dpp::utility::iconhash & banner) const { Valid().banner = banner; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the banner color encoded as an integer representation of hexadecimal color code for the user.
+     */
+    SQMOD_NODISCARD SQInteger GetAccentColor() const { return Valid().accent_color; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the banner color encoded as an integer representation of hexadecimal color code for the user.
+     */
+    void SetAccentColor(SQInteger color) const { Valid().accent_color = static_cast< uint32_t >(color); }
+    /* --------------------------------------------------------------------------------------------
+     * Modify the banner color encoded as an integer representation of hexadecimal color code for the user.
+     */
+    DpUserIdentifier & ApplyAccentColor(SQInteger color)
+    {
+        SetAccentColor(color);
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether the email on this account has been verified.
+     */
+    SQMOD_NODISCARD bool GetVerified() const { return Valid().verified; }
+    /* --------------------------------------------------------------------------------------------
+     * Modify whether the email on this account has been verified.
+     */
+    void SetVerified(bool verified) const { Valid().verified = verified; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the banner url of the user, if they have one, otherwise returns an empty string.
+     * Size of the avatar is in pixels. It can be any power of two between 16 and 4096.
+     * Check SqDiscordImageType enum for available image formats.
+    */
+    SQMOD_NODISCARD std::string GetBannerUrl() const { return Valid().get_banner_url(); }
+    SQMOD_NODISCARD std::string GetBannerUrl_1(uint16_t size) const { return Valid().get_banner_url(size); }
+    SQMOD_NODISCARD std::string GetBannerUrl_2(uint16_t size, SQInteger format) const { return Valid().get_banner_url(size, static_cast< dpp::image_type >(format)); }
+    SQMOD_NODISCARD std::string GetBannerUrl_3(uint16_t size, SQInteger format, bool prefer_animated) const { return Valid().get_banner_url(size, static_cast< dpp::image_type >(format), prefer_animated); }
+};
+
+} // Namespace:: SqMod

module/Library/Discord/Utilities.cpp

@@ -0,0 +1,9 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/Discord/Utilities.hpp"
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+
+
+} // Namespace:: SqMod

module/Library/Discord/Utilities.hpp

@@ -0,0 +1,531 @@
+#pragma once
+
+// ------------------------------------------------------------------------------------------------
+#include "Core/Utility.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <dpp/dpp.h>
+
+// ------------------------------------------------------------------------------------------------
+#include <memory>
+
+// ------------------------------------------------------------------------------------------------
+namespace Sqrat {
+
+// // Allow the VM to treat the dpp::snowflake type as a integer.
+// template<> struct Var<dpp::snowflake>
+// {
+//     dpp::snowflake value;
+//     Var(HSQUIRRELVM vm, SQInteger idx) {
+//         sq_getinteger(vm, idx, reinterpret_cast<SQInteger*>(&static_cast<uint64_t&>(value)));
+//     }
+//     inline static void push(HSQUIRRELVM vm, const dpp::snowflake& value) noexcept {
+//         sq_pushinteger(vm, static_cast<SQInteger>(static_cast<uint64_t>(value)));
+//     }
+// };
+
+// // Allow the VM to treat the dpp::snowflake type as a integer.
+// template<> struct Var<const dpp::snowflake&>
+// {
+//     dpp::snowflake value;
+//     Var(HSQUIRRELVM vm, SQInteger idx) {
+//         sq_getinteger(vm, idx, reinterpret_cast<SQInteger*>(&static_cast<uint64_t&>(value)));
+//     }
+//     inline static void push(HSQUIRRELVM vm, const dpp::snowflake& value) noexcept {
+//         sq_pushinteger(vm, static_cast<SQInteger>(static_cast<uint64_t>(value)));
+//     }
+// };
+
+
+// ------------------------------------------------------------------------------------------------
+// Used to get and push dpp::snowflake instances to and from the stack
+template <> struct Var<dpp::snowflake> {
+    dpp::snowflake value; ///< The actual value of get operations
+    Var(HSQUIRRELVM vm, SQInteger idx) : value(popAsInt< uint64_t, true >(vm, idx).value) { }
+    // Push dpp::snowflake instances to the stack as integers
+    static void push(HSQUIRRELVM vm, const dpp::snowflake& value) noexcept {
+        sq_pushinteger(vm, static_cast< SQInteger >(static_cast< std::uint64_t >(value)));
+    }
+    static void push(HSQUIRRELVM vm, dpp::snowflake& value) noexcept {
+        sq_pushinteger(vm, static_cast< SQInteger >(static_cast< std::uint64_t & >(value)));
+    }
+};
+template <> struct Var<dpp::snowflake&> : public Var<dpp::snowflake> {
+    Var(HSQUIRRELVM vm, SQInteger idx) : Var<dpp::snowflake>(vm, idx) { }
+};
+template <> struct Var<const dpp::snowflake&> : public Var<dpp::snowflake> {
+    Var(HSQUIRRELVM vm, SQInteger idx) : Var<dpp::snowflake>(vm, idx) { }
+};
+
+}
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+/* ------------------------------------------------------------------------------------------------
+ * Wrapper around a std::vector of DPP values.
+*/
+template < class T, class W > struct DpVectorProxy
+{
+    using Ptr = std::unique_ptr< std::vector< T > >;
+    using Vec = std::vector< std::pair< LightObj, W * > >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced vector instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Cached script objects vector.
+    */
+    Vec mVec{};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpVectorProxy() noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpVectorProxy(typename Ptr::pointer ptr, bool owned = false)
+        : mPtr(ptr), mVec(), mOwned(owned)
+    { if (mPtr) mVec.resize(mPtr->size()); }
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit DpVectorProxy(const typename Ptr::element_type & o) noexcept
+        : DpVectorProxy(new typename Ptr::element_type(o), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    explicit DpVectorProxy(typename Ptr::element_type && o) noexcept
+        : DpVectorProxy(new typename Ptr::element_type(std::forward< Ptr::element_type >(o)), true)
+    { }
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor (disabled).
+    */
+    DpVectorProxy(const DpVectorProxy & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    DpVectorProxy(DpVectorProxy && o) noexcept = default;
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~DpVectorProxy() noexcept { Cleanup(); }
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator (disabled).
+    */
+    DpVectorProxy & operator = (const DpVectorProxy & o) = delete;
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    DpVectorProxy & operator = (DpVectorProxy && o) noexcept
+    {
+        if (this != &o) {
+            Cleanup();
+            // Transfer members values
+            mPtr = std::move(o.mPtr);
+            mVec = std::move(o.mVec);
+            mOwned = o.mOwned;
+        }
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Release any referenced resources and default to an empty/invalid state.
+    */
+    void Cleanup()
+    {
+        // Invalidate cached instances
+        ClearCache();
+        // Do we own this to try delete it?
+        if (!mOwned && mPtr) {
+            // Not our job, simply forget about it
+            [[maybe_unused]] auto p = mPtr.release();
+        } else mPtr.reset(); // We own this so delete the instance
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle.
+    */
+    void Validate() const { if (!mPtr) STHROWF("Invalid discord vector handle"); }
+    /* --------------------------------------------------------------------------------------------
+     * Validate the managed handle and retrieve a const reference to it.
+    */
+    SQMOD_NODISCARD typename Ptr::element_type & Valid() const { Validate(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check whether a valid instance is managed.
+    */
+    SQMOD_NODISCARD bool IsValid() const { return static_cast< bool >(mPtr); }
+    /* --------------------------------------------------------------------------------------------
+     * Make sure an index is within range and return the container. Container must exist.
+    */
+    void ValidIdx_(SQInteger i)
+    {
+        if (static_cast< size_t >(i) >= Valid().size())
+        {
+            STHROWF("Invalid vector container index({})", i);
+        }
+    }
+    typename Ptr::element_type & ValidIdx(SQInteger i) { ValidIdx_(i); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Make sure an index is within range and return the container. Container must exist.
+    */
+    void ValidIdx_(SQInteger i) const
+    {
+        if (static_cast< size_t >(i) >= Valid().size())
+        {
+            STHROWF("Invalid vector container index({})", i);
+        }
+    }
+    const typename Ptr::element_type & ValidIdx(SQInteger i) const { ValidIdx_(i); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Make sure a container instance is referenced and is populated, then return it.
+    */
+    void ValidPop_()
+    {
+        if (Valid().empty())
+        {
+            STHROWF("Vector container is empty");
+        }
+    }
+    typename Ptr::element_type & ValidPop() { ValidPop_(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Make sure a container instance is referenced and is populated, then return it.
+    */
+    void ValidPop_() const
+    {
+        if (Valid().empty())
+        {
+            STHROWF("Vector container is empty");
+        }
+    }
+    const typename Ptr::element_type & ValidPop() const { ValidPop_(); return *mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Check if a container instance is referenced.
+    */
+    SQMOD_NODISCARD bool IsNull() const { return !mPtr; }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve a value from the container.
+    */
+    SQMOD_NODISCARD LightObj & Get_(SQInteger i)
+    {
+        // Is the element cached?
+        if (mVec[static_cast< size_t >(i)].first.IsNull())
+        {
+            mVec[static_cast< size_t >(i)] = Obj(&mPtr->at(static_cast< size_t >(i)));
+        }
+        // Return the object from the cache
+        return mVec[static_cast< size_t >(i)].first;
+    }
+    SQMOD_NODISCARD LightObj & Get(SQInteger i)
+    {
+        // Was the referenced vector modified?
+        if (mVec.size() < Valid().size())
+        {
+            // Synchronize the size
+            mVec.resize(mPtr->size());
+            // Synchronize the cache
+            CacheSync();
+        }
+        // Validate index
+        ValidIdx_(i);
+        // Perform the request
+        return Get_(i);
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Modify a value from the container.
+    */
+    void Set(SQInteger i, const W & v) { ValidIdx(i)[static_cast< size_t >(i)] = v.Valid(); }
+    /* --------------------------------------------------------------------------------------------
+     * Check if the container has no elements.
+    */
+    SQMOD_NODISCARD bool Empty() const { return Valid().empty(); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the number of elements in the container.
+    */
+    SQMOD_NODISCARD SQInteger Size() const { return static_cast< SQInteger >(Valid().size()); }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the number of elements that the container has currently allocated space for.
+    */
+    SQMOD_NODISCARD SQInteger Capacity() const { return static_cast< SQInteger >(Valid().capacity()); }
+    /* --------------------------------------------------------------------------------------------
+     * Synchronize cache container instances.
+    */
+    void CacheSync()
+    {
+        // Invalidate cached instances, if any
+        for (size_t i = 0; i < mVec.size(); ++i)
+        {
+            // Is this element cached?
+            if (mVec[i].second != nullptr)
+            {
+                // Discard previous instance, if any
+                [[maybe_unused]] auto _ = mVec[i].second->mPtr.release();
+                // Sync to new instance
+                mVec[i].second->mPtr.reset(&mPtr->at(i));
+            }
+        }
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Increase the capacity of the container to a value that's greater or equal to the one specified.
+    */
+    DpVectorProxy & Reserve(SQInteger n)
+    {
+        Valid().reserve(ClampL< SQInteger, size_t >(n));
+        mVec.reserve(mPtr->size());
+        CacheSync();
+        return *this;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Request the removal of unused capacity.
+    */
+    void Compact() { Valid().shrink_to_fit(); CacheSync(); mVec.shrink_to_fit(); }
+    /* --------------------------------------------------------------------------------------------
+     * Erase all elements from the cache container.
+    */
+    void ClearCache()
+    {
+        // Invalidate cached instances, if any
+        for (auto & e : mVec)
+        {
+            // Is this element cached?
+            if (e.second != nullptr)
+            {
+                // Invalidate the instance
+                e.second->Cleanup();
+                // Forget about it
+                e.second = nullptr;
+                // Release script object
+                e.first.Release();
+            }
+        }
+        // Clear the cache vector
+        mVec.clear();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Erase all elements from the container.
+    */
+    void Clear() { Validate(); ClearCache(); mPtr->clear(); }
+    /* --------------------------------------------------------------------------------------------
+     * Push a value at the back of the container.
+    */
+    void Push(const W & v)
+    {
+        Valid().push_back(v.Valid());
+        mVec.emplace_back();
+        CacheSync();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Extends the Container by appending all the items in the given container.
+    */
+    void Extend(DpVectorProxy & v)
+    {
+        Valid().insert(Valid().end(), v.Valid().begin(), v.Valid().end());
+        mVec.resize(mPtr->size());
+        CacheSync();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Pop the last element in the container.
+    */
+    void Pop()
+    {
+        Validate();
+        // Is this element cached?
+        if (mVec.back().second != nullptr)
+        {
+            // Invalidate the instance
+            mVec.back().second->Cleanup();
+            mVec.back().first.Release();
+        }
+        // Safe to remove
+        mPtr->pop_back();
+        mVec.pop_back();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Erase the element at a certain position.
+    */
+    void EraseAt(SQInteger i)
+    {
+        ValidIdx_(i);
+        // Is this element cached?
+        if (mVec[static_cast< size_t >(i)].second != nullptr)
+        {
+            // Invalidate the instance
+            mVec[static_cast< size_t >(i)].second->Cleanup();
+            mVec[static_cast< size_t >(i)].first.Release();
+        }
+        // Safe to remove
+        mPtr->erase(mPtr->begin() + static_cast< size_t >(i));
+        mVec.erase(mVec.begin() + static_cast< size_t >(i));
+        // Synchronize cache
+        CacheSync();
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Iterate all values through a functor.
+    */
+    void Each(Function & fn)
+    {
+        Validate();
+        // Iterate referenced vector elements
+        for (size_t i = 0; i < mVec.size(); ++i)
+        {
+            fn.Execute(Get(static_cast< SQInteger >(i)));
+        }
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Iterate values in range through a functor.
+    */
+    void EachRange(SQInteger p, SQInteger n, Function & fn)
+    {
+        ValidIdx_(p);
+        ValidIdx_(p + n);
+        // Iterate specified range
+        for (n += p; p < n; ++p)
+        {
+            fn.Execute(Get(static_cast< SQInteger >(p)));
+        }
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Iterate all values through a functor until stopped (i.e false is returned).
+    */
+    void While(Function & fn)
+    {
+        Validate();
+        // Iterate referenced vector elements
+        for (size_t i = 0; i < mVec.size(); ++i)
+        {
+            auto ret = fn.Eval(Get(static_cast< SQInteger >(i)));
+            // (null || true) == continue & false == break
+            if (!ret.IsNull() || !ret.template Cast< bool >())
+            {
+                break;
+            }
+        }
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Iterate values in range through a functor until stopped (i.e false is returned).
+    */
+    void WhileRange(SQInteger p, SQInteger n, Function & fn)
+    {
+        ValidIdx_(p);
+        ValidIdx_(p + n);
+        // Iterate specified range
+        for (n += p; p < n; ++p)
+        {
+            auto ret = fn.Eval(Get(static_cast< SQInteger >(p)));
+            // (null || true) == continue & false == break
+            if (!ret.IsNull() || !ret.template Cast< bool >())
+            {
+                break;
+            }
+        }
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve a wrapped instance as a script object.
+    */
+    SQMOD_NODISCARD static std::pair< LightObj, W * > Obj(T * ptr, bool owned = false)
+    {
+        // Create the wrapper instance for given pointer
+        auto wp = std::make_unique< W >(ptr, false);
+        // Create script object for wrapper instance
+        std::pair< LightObj, W * > p{LightObj{wp.get()}, wp.get()};
+        // Release ownership of the wrapper instance
+        [[maybe_unused]] auto _ = wp.release();
+        // Return the script object and wrapper instance
+        return p;
+    }
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve a wrapped instance as a script object.
+    */
+    SQMOD_NODISCARD static std::pair< LightObj, W * > Obj(const T * ptr, bool owned = false)
+    {
+        return Obj(const_cast< T * >(ptr), owned);
+    }
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Register a wrapper vector for the specified types.
+*/
+template < class T, class W, class U > inline void Register_Discord_VectorProxy(HSQUIRRELVM vm, Table & ns, const SQChar * name)
+{
+    using Container = DpVectorProxy< T, W >;
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(name,
+        Class< Container, NoConstructor< Container > >(vm, U::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &U::Fn)
+        // Properties
+        .Prop(_SC("Null"), &Container::IsNull)
+        .Prop(_SC("Empty"), &Container::Empty)
+        .Prop(_SC("Size"), &Container::Size)
+        .Prop(_SC("Capacity"), &Container::Capacity, &Container::Reserve)
+        // Member Methods
+        .Func(_SC("Get"), &Container::Get)
+        .Func(_SC("Set"), &Container::Set)
+        .Func(_SC("Reserve"), &Container::Reserve)
+        .Func(_SC("Compact"), &Container::Compact)
+        .Func(_SC("Clear"), &Container::Clear)
+        .Func(_SC("Push"), &Container::Push)
+        .Func(_SC("Append"), &Container::Push)
+        .Func(_SC("Extend"), &Container::Extend)
+        .Func(_SC("Pop"), &Container::Pop)
+        .Func(_SC("EraseAt"), &Container::EraseAt)
+        .Func(_SC("Each"), &Container::Each)
+        .Func(_SC("EachRange"), &Container::EachRange)
+        .Func(_SC("While"), &Container::While)
+        .Func(_SC("WhileRange"), &Container::WhileRange)
+    );
+}
+
+/* ------------------------------------------------------------------------------------------------
+ * Wrapper around a std::unordered_map of DPP values.
+*/
+template < class K, class V, class W > struct DpUnorderedMapProxy
+{
+    using Native = std::unordered_map< K, V >;
+    using Binder = std::pair< LightObj, W * >;
+    using Script = std::unordered_map< K, Binder >;
+    using Ptr = std::unique_ptr< Native >;
+    /* --------------------------------------------------------------------------------------------
+     * Referenced map instance.
+    */
+    Ptr mPtr{nullptr};
+    /* --------------------------------------------------------------------------------------------
+     * Cached script objects map.
+    */
+    Script mMap{};
+    /* --------------------------------------------------------------------------------------------
+     * Whether the referenced pointer is owned.
+    */
+    bool mOwned{false};
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    DpUnorderedMapProxy() noexcept = default;
+};
+
+/* ------------------------------------------------------------------------------------------------
+ * Register a wrapper unordered map for the specified types.
+*/
+template < class K, class V, class W, class U > inline void Register_Discord_UnorderedMapProxy(HSQUIRRELVM vm, Table & ns, const SQChar * name)
+{
+    using Container = DpUnorderedMapProxy< K, V, W >;
+    // --------------------------------------------------------------------------------------------
+    ns.Bind(name,
+        Class< Container, NoConstructor< Container > >(vm, U::Str)
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &U::Fn)
+        // Properties
+        //.Prop(_SC("Null"), &Container::IsNull)
+        //.Prop(_SC("Empty"), &Container::Empty)
+        //.Prop(_SC("Size"), &Container::Size)
+        //.Prop(_SC("Capacity"), &Container::Capacity, &Container::Reserve)
+        // Member Methods
+        //.Func(_SC("Get"), &Container::Get)
+        //.Func(_SC("Set"), &Container::Set)
+    );
+}
+
+} // Namespace:: SqMod

module/Library/IO/Buffer.cpp

@@ -11,6 +11,13 @@
 
 // ------------------------------------------------------------------------------------------------
 #include <Poco/Checksum.h>
+#include <Poco/Base32Encoder.h>
+#include <Poco/Base32Decoder.h>
+#include <Poco/Base64Encoder.h>
+#include <Poco/Base64Decoder.h>
+
+// ------------------------------------------------------------------------------------------------
+#include <sstream>
 
 // ------------------------------------------------------------------------------------------------
 namespace SqMod {
@@ -30,7 +37,7 @@ SQInteger SqBuffer::WriteRawString(StackStrF & val) const
     }
     // Calculate the string length
     Buffer::SzType length = ConvTo< Buffer::SzType >::From(val.mLen);
-    // Write the the string contents
+    // Write the string contents
     m_Buffer->AppendS(val.mPtr, length);
     // Return the length of the written string
     return val.mLen;
@@ -224,7 +231,7 @@ AABB SqBuffer::ReadAABB() const
     // Advance the buffer cursor
     m_Buffer->Advance< AABB >(1);
     // Return the requested information
-    return AABB(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -237,7 +244,7 @@ Circle SqBuffer::ReadCircle() const
     // Advance the buffer cursor
     m_Buffer->Advance< Circle >(1);
     // Return the requested information
-    return Circle(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -250,7 +257,7 @@ Color3 SqBuffer::ReadColor3() const
     // Advance the buffer cursor
     m_Buffer->Advance< Color3 >(1);
     // Return the requested information
-    return Color3(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -263,7 +270,7 @@ Color4 SqBuffer::ReadColor4() const
     // Advance the buffer cursor
     m_Buffer->Advance< Color4 >(1);
     // Return the requested information
-    return Color4(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -276,7 +283,7 @@ Quaternion SqBuffer::ReadQuaternion() const
     // Advance the buffer cursor
     m_Buffer->Advance< Quaternion >(1);
     // Return the requested information
-    return Quaternion(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -289,7 +296,7 @@ Sphere SqBuffer::ReadSphere() const
     // Advance the buffer cursor
     m_Buffer->Advance< Sphere >(1);
     // Return the requested information
-    return Sphere(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -302,7 +309,7 @@ Vector2 SqBuffer::ReadVector2() const
     // Advance the buffer cursor
     m_Buffer->Advance< Vector2 >(1);
     // Return the requested information
-    return Vector2(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -315,7 +322,7 @@ Vector2i SqBuffer::ReadVector2i() const
     // Advance the buffer cursor
     m_Buffer->Advance< Vector2i >(1);
     // Return the requested information
-    return Vector2i(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -328,7 +335,7 @@ Vector3 SqBuffer::ReadVector3() const
     // Advance the buffer cursor
     m_Buffer->Advance< Vector3 >(1);
     // Return the requested information
-    return Vector3(value);
+    return {value};
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -341,7 +348,34 @@ Vector4 SqBuffer::ReadVector4() const
     // Advance the buffer cursor
     m_Buffer->Advance< Vector4 >(1);
     // Return the requested information
-    return Vector4(value);
+    return {value};
+}
+
+// ------------------------------------------------------------------------------------------------
+extern SQInteger SqFromNativeJSON(HSQUIRRELVM vm, const char * data, size_t size);
+
+// ------------------------------------------------------------------------------------------------
+SQInteger SqBuffer::GetJSON(HSQUIRRELVM vm) const
+{
+    // Remember the current stack size
+    const SQInteger top = sq_gettop(vm);
+    // Was the JSON string size specified?
+    if (top < 2)
+    {
+        return sq_throwerror(vm, _SC("Please specify the size of the JSON string to parse"));
+    }
+    // Do we even point to a valid buffer?
+    if (!m_Buffer)
+    {
+        return sq_throwerror(vm, _SC("Invalid memory buffer reference"));
+    }
+    // Validate the buffer itself
+    else if (!(*m_Buffer))
+    {
+        return sq_throwerror(vm, _SC("Invalid memory buffer"));
+    }
+    // Attempt to create the JSON object and push it on the stack
+    return SqFromNativeJSON(vm, &m_Buffer->Cursor< char >(), static_cast< size_t >(Var< SQInteger >{vm, 2}.value));
 }
 
 // ------------------------------------------------------------------------------------------------
@@ -352,7 +386,7 @@ SQInteger SqBuffer::GetCRC32(SQInteger n) const
     // Create the checksum computer
     Poco::Checksum c(Poco::Checksum::TYPE_CRC32);
     // Give it the data to process
-    c.update(&m_Buffer->Cursor< char >(), n >= 0 ? static_cast< uint32_t >(n) : m_Buffer->Remaining());
+    c.update(&m_Buffer->Cursor< char >(), ClampRemaining(n));
     // return the result
     return static_cast< SQInteger >(c.checksum());
 }
@@ -365,12 +399,46 @@ SQInteger SqBuffer::GetADLER32(SQInteger n) const
     // Create the checksum computer
     Poco::Checksum c(Poco::Checksum::TYPE_ADLER32);
     // Give it the data to process
-    c.update(&m_Buffer->Cursor< char >(), n >= 0 ? static_cast< uint32_t >(n) : m_Buffer->Remaining());
+    c.update(&m_Buffer->Cursor< char >(), ClampRemaining(n));
     // return the result
     return static_cast< SQInteger >(c.checksum());
 
 }
 
+// ------------------------------------------------------------------------------------------------
+LightObj SqBuffer::GetBase32(SQInteger n) const
+{
+    // Validate the managed buffer reference
+    ValidateDeeper();
+    // Create a string receiver
+    std::ostringstream out;
+    // Create the encoder
+    Poco::Base32Encoder enc(out);
+    // Encode the string
+    enc.write(&m_Buffer->Cursor< char >(), ClampRemaining(n));
+    // Close the encoder
+    enc.close();
+    // Return the resulted string
+    return LightObj{out.str()};
+}
+
+// ------------------------------------------------------------------------------------------------
+LightObj SqBuffer::GetBase64(SQInteger n) const
+{
+    // Validate the managed buffer reference
+    ValidateDeeper();
+    // Create a string receiver
+    std::ostringstream out;
+    // Create the encoder
+    Poco::Base64Encoder enc(out);
+    // Encode the string
+    enc.write(&m_Buffer->Cursor< char >(), ClampRemaining(n));
+    // Close the encoder
+    enc.close();
+    // Return the resulted string
+    return LightObj{out.str()};
+}
+
 // ================================================================================================
 void Register_Buffer(HSQUIRRELVM vm)
 {
@@ -457,6 +525,9 @@ void Register_Buffer(HSQUIRRELVM vm)
         .Func(_SC("ReadVector4"), &SqBuffer::ReadVector4)
         .Func(_SC("CRC32"), &SqBuffer::GetCRC32)
         .Func(_SC("ADLER32"), &SqBuffer::GetADLER32)
+        .Func(_SC("Base32"), &SqBuffer::GetBase32)
+        .Func(_SC("Base64"), &SqBuffer::GetBase64)
+        .SquirrelMethod< SqBuffer, &SqBuffer::GetJSON >(_SC("GetJSON"))
     );
 }
 

module/Library/IO/Buffer.hpp

@@ -193,6 +193,24 @@ public:
         return *m_Buffer;
     }
 
+    /* --------------------------------------------------------------------------------------------
+     * Limit the specified amount at to the range of the cursor and the end of the buffer.
+    */
+    SQMOD_NODISCARD SzType ClampRemaining(SQInteger n) const
+    {
+        // Do we even specify a buffer amount?
+        if (n >= 0)
+        {
+            // Is it within the range we currently have left?
+            if (static_cast< SzType >(n) <= m_Buffer->Remaining())
+            {
+                return static_cast< SzType >(n);
+            }
+        }
+        // Fall back to the actual remaining data
+        return m_Buffer->Remaining();
+    }
+
     /* --------------------------------------------------------------------------------------------
      * Retrieve a certain element type at the specified position.
     */
@@ -276,33 +294,41 @@ public:
     /* --------------------------------------------------------------------------------------------
      * Reposition the edit cursor to the specified number of elements ahead.
     */
-    void Advance(SQInteger n) const
+    SqBuffer & Advance(SQInteger n)
     {
         Valid().Advance(ConvTo< SzType >::From(n));
+        // Allow chaining
+        return *this;
     }
 
     /* --------------------------------------------------------------------------------------------
      * Reposition the edit cursor to the specified number of elements behind.
     */
-    void Retreat(SQInteger n) const
+    SqBuffer & Retreat(SQInteger n)
     {
         Valid().Retreat(ConvTo< SzType >::From(n));
+        // Allow chaining
+        return *this;
     }
 
     /* --------------------------------------------------------------------------------------------
      * Reposition the edit cursor to a fixed position within the buffer.
     */
-    void Move(SQInteger n) const
+    SqBuffer & Move(SQInteger n)
     {
         Valid().Move(ConvTo< SzType >::From(n));
+        // Allow chaining
+        return *this;
     }
 
     /* --------------------------------------------------------------------------------------------
      * Append a value to the current cursor location and advance the cursor.
     */
-    void Push(SQInteger v) const
+    SqBuffer & Push(SQInteger v)
     {
         Valid().Push(ConvTo< Value >::From(v));
+        // Allow chaining
+        return *this;
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -396,15 +422,17 @@ public:
     /* --------------------------------------------------------------------------------------------
      * Grow the size of the internal buffer by the specified amount of bytes.
     */
-    void Grow(SQInteger n) const
+    SqBuffer & Grow(SQInteger n)
     {
-        return Valid().Grow(ConvTo< SzType >::From(n) * sizeof(Value));
+        Valid().Grow(ConvTo< SzType >::From(n) * sizeof(Value));
+        // Allow chaining
+        return *this;
     }
 
     /* --------------------------------------------------------------------------------------------
      * Makes sure there is enough capacity to hold the specified element count.
     */
-    void Adjust(SQInteger n)
+    SqBuffer & Adjust(SQInteger n)
     {
         // Validate the managed buffer reference
         Validate();
@@ -420,6 +448,8 @@ public:
         {
             STHROWF("{}", e.what()); // Re-package
         }
+        // Allow chaining
+        return *this;
     }
 
     /* --------------------------------------------------------------------------------------------
@@ -752,6 +782,12 @@ public:
     */
     SQMOD_NODISCARD Vector4 ReadVector4() const;
 
+    /* --------------------------------------------------------------------------------------------
+     * Transform a portion of the data in the buffer to a JSON object.
+     * This has the benefit that a temporary string doesn't have to be created.
+    */
+    SQMOD_NODISCARD SQInteger GetJSON(HSQUIRRELVM vm) const;
+
     /* --------------------------------------------------------------------------------------------
      * Compute the CRC-32 checksums on the data in the buffer.
     */
@@ -761,6 +797,16 @@ public:
      * Compute the Adler-32 checksums on the data in the buffer.
     */
     SQMOD_NODISCARD SQInteger GetADLER32(SQInteger n) const;
+
+    /* --------------------------------------------------------------------------------------------
+     * Encode the specified range of data as base32 and return it.
+    */
+    SQMOD_NODISCARD LightObj GetBase32(SQInteger n) const;
+
+    /* --------------------------------------------------------------------------------------------
+     * Encode the specified range of data as base64 and return it.
+    */
+    SQMOD_NODISCARD LightObj GetBase64(SQInteger n) const;
 };
 
 } // Namespace:: SqMod

module/Library/IO/INI.cpp

@@ -381,7 +381,7 @@ void Register_INI(HSQUIRRELVM vm)
         .Func(_SC("Check"), &IniResult::Check)
     );
 
-    inins.Bind(_SC("IniEntries"),
+    inins.Bind(_SC("Entries"),
         Class< IniEntries >(vm, EntriesTypename::Str)
         // Constructors
         .Ctor()
@@ -409,7 +409,7 @@ void Register_INI(HSQUIRRELVM vm)
         .Func(_SC("SortByLoadOrder"), &IniEntries::SortByLoadOrder)
     );
 
-    inins.Bind(_SC("IniDocument"),
+    inins.Bind(_SC("Document"),
         Class< IniDocument, NoCopy< IniDocument > >(vm, DocumentTypename::Str)
         // Constructors
         .Ctor()
@@ -464,7 +464,7 @@ void Register_INI(HSQUIRRELVM vm)
         .Overload< bool (IniDocument::*)(const SQChar *, const SQChar *, const SQChar *, bool) >(_SC("DeleteValue"), &IniDocument::DeleteValue)
     );
 
-    RootTable(vm).Bind(_SC("SqIni"), inins);
+    RootTable(vm).Bind(_SC("SqINI"), inins);
 
     ConstTable(vm).Enum(_SC("SqIniError"), Enumeration(vm)
         .Const(_SC("Ok"),                       int32_t(SI_OK))

module/Library/JSON.cpp

@@ -2,6 +2,7 @@
 #include "Library/JSON.hpp"
 
 // ------------------------------------------------------------------------------------------------
+#include <sajson.h>
 #include <sqratConst.h>
 
 // ------------------------------------------------------------------------------------------------
@@ -11,13 +12,10 @@
 namespace SqMod {
 
 // ------------------------------------------------------------------------------------------------
-static SQInteger SqToJSON(HSQUIRRELVM vm) noexcept
-{
-    return sq_throwerror(vm, _SC("Not implemented yet!"));
-}
+SQMOD_DECL_TYPENAME(SqCtxJSON, _SC("SqCtxJSON"))
 
 // ------------------------------------------------------------------------------------------------
-static SQInteger SqFromJson_Push(HSQUIRRELVM vm, const sajson::value & node) noexcept
+static SQInteger SqFromJson_Push(HSQUIRRELVM vm, const sajson::value & node) noexcept // NOLINT(misc-no-recursion)
 {
     // Operation result
     SQInteger r = SQ_OK;
@@ -151,11 +149,616 @@ static SQInteger SqFromJSON(HSQUIRRELVM vm) noexcept
     return SQ_SUCCEEDED(r) ? 1 : r;
 }
 
+// ------------------------------------------------------------------------------------------------
+SQInteger SqFromNativeJSON(HSQUIRRELVM vm, const char * data, size_t size)
+{
+    // Attempt to parse the specified JSON string
+    const sajson::document & document = sajson::parse(sajson::dynamic_allocation(), sajson::string(data, size));
+    // See if there was an error
+    if (!document.is_valid())
+    {
+        return sq_throwerror(vm, document.get_error_message_as_cstring());
+    }
+    // Process the nodes that were parsed from the string
+    SQInteger r = SqFromJson_Push(vm, document.get_root());
+    // We either have a value to return or we propagate some error
+    return SQ_SUCCEEDED(r) ? 1 : r;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::OpenArray()
+{
+    // Add the array-begin character
+    mOutput.push_back('[');
+    // Go forward one level
+    Advance();
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::CloseArray()
+{
+    // If the last character is a comma then replace it
+    if (mOutput.back() == ',')
+    {
+        mOutput.back() = ']';
+    }
+    // Append the array-end character
+    else
+    {
+        mOutput.push_back(']');
+    }
+    // Move the comma after the closing character
+    mOutput.push_back(',');
+    // Go back one level
+    Retreat();
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::ReopenArray()
+{
+    // If the last character is a comma then remove it
+    if (mOutput.back() == ',')
+    {
+        mOutput.pop_back();
+    }
+    // If the last character is the array-end character then replace it with a comma
+    if (mOutput.back() == ']')
+    {
+        mOutput.back() = ',';
+    }
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::OpenObject()
+{
+    // Add the object-begin character
+    mOutput.push_back('{');
+    // Go forward one level
+    Advance();
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::CloseObject()
+{
+    // If the last character is a comma then replace it
+    if (mOutput.back() == ',')
+    {
+        mOutput.back() = '}';
+    }
+    // Append the object-end character
+    else
+    {
+        mOutput.push_back('}');
+    }
+    // Move the comma after the closing character
+    mOutput.push_back(',');
+    // Go back one level
+    Retreat();
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::ReopenObject()
+{
+    // If the last character is a comma then remove it
+    if (mOutput.back() == ',')
+    {
+        mOutput.pop_back();
+    }
+    // If the last character is the object-end character then replace it with a comma
+    if (mOutput.back() == '}')
+    {
+        mOutput.back() = ',';
+    }
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::MakeKey()
+{
+    // If the last character is a comma then replace it
+    if (mOutput.back() == ',')
+    {
+        mOutput.back() = ':';
+    }
+    // Append the array-end character
+    else
+    {
+        mOutput.push_back(':');
+    }
+    // Allow the hook to react
+    if (mKeyHook)
+    {
+        mKeyHook(*this);
+    }
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+bool CtxJSON::CheckWeakRefWrap(HSQUIRRELVM vm, SQInteger idx) noexcept
+{
+    SQRESULT r = sq_getweakrefval(vm, idx);
+    // Whether the type doesn't have to be wrapped
+    bool w = true;
+    // Attempt to grab the value pointed by the weak reference
+    if (SQ_SUCCEEDED(r))
+    {
+        // Attempt to serialize the actual value
+        w = sq_gettype(vm, -1) != OT_TABLE && sq_gettype(vm, -1) != OT_ARRAY && sq_gettype(vm, -1) == OT_INSTANCE;
+        // Pop the referenced value
+        sq_poptop(vm);
+    }
+    // Wrap the value by default
+    return w;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::SerializeParams(HSQUIRRELVM vm)
+{
+    bool wrap_everything_in_array = false;
+    // Clear the output buffer if necessary
+    mOutput.clear();
+    mDepth = 0;
+    // Fetch the number of objects on the stack
+    const auto top = sq_gettop(vm);
+    // If there's more than one argument then they all get wrapped inside an array
+    // If there is one argument and is not an array, table or instance then do the same
+    if (top > 2 || (sq_gettype(vm, 2) != OT_TABLE &&
+                    sq_gettype(vm, 2) != OT_ARRAY &&
+                    sq_gettype(vm, 2) != OT_INSTANCE &&
+                    CheckWeakRefWrap(vm, 2)))
+    {
+        wrap_everything_in_array = true;
+        // Open an array
+        OpenArray();
+    }
+    // Serialize every specified argument
+    for (SQInteger i = 2; i <= top; ++i)
+    {
+        if (SQRESULT r = SerializeAt(vm, i); SQ_FAILED(r))
+        {
+            return r; // Propagate the error
+        }
+    }
+    // Was everything wrapped inside an array?
+    if (wrap_everything_in_array)
+    {
+        CloseArray();
+    }
+    // Remove trailing separator, if any
+    if (mOutput.back() == ',')
+    {
+        mOutput.pop_back();
+    }
+    // Push the output string on the stack
+    sq_pushstring(vm, mOutput.c_str(), static_cast< SQInteger >(mOutput.size()));
+    // Specify that we have a value on the stack
+    return 1;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::SerializeAt(HSQUIRRELVM vm, SQInteger idx) // NOLINT(misc-no-recursion)
+{
+    // Identify object type
+    switch (sq_gettype(vm, idx))
+    {
+        case OT_NULL: {
+            PushNull();
+        } break;
+        case OT_INTEGER: {
+            SQInteger v;
+            // Attempt to retrieve the value from the stack
+            if (SQRESULT r = sq_getinteger(vm, idx, &v); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+            // Write the value in the output
+            PushInteger(v);
+        } break;
+        case OT_FLOAT: {
+            SQFloat v;
+            // Attempt to retrieve the value from the stack
+            if (SQRESULT r = sq_getfloat(vm, idx, &v); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+            // Write the value in the output
+        #ifdef SQUSEDOUBLE
+            PushDouble(v);
+        #else
+            PushFloat(v);
+        #endif
+        } break;
+        case OT_BOOL: {
+            SQBool v;
+            // Attempt to retrieve the value from the stack
+            if (SQRESULT r = sq_getbool(vm, idx, &v); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+            // Write the value in the output
+            PushBool(v != SQFalse);
+        } break;
+        case OT_STRING: {
+            const SQChar * v = nullptr;
+            SQInteger n = 0;
+            // Attempt to retrieve and convert the string
+            if (SQRESULT r = sq_getstringandsize(vm, idx, &v, &n); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+            // Write the value in the output
+            PushString(v, static_cast< size_t >(n));
+        } break;
+        case OT_TABLE: {
+            if (SQRESULT r = SerializeTable(vm, idx); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+        } break;
+        case OT_ARRAY: {
+            if (SQRESULT r = SerializeArray(vm, idx); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+        } break;
+        case OT_INSTANCE: {
+            if (SQRESULT r = SerializeInstance(vm, idx); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+        } break;
+        case OT_WEAKREF: {
+            if (SQRESULT r = SerializeWeakRef(vm, idx); SQ_FAILED(r))
+            {
+                return r; // Propagate the error
+            }
+        } break;
+        case OT_USERDATA:
+        case OT_CLOSURE:
+        case OT_NATIVECLOSURE:
+        case OT_GENERATOR:
+        case OT_USERPOINTER:
+        case OT_THREAD:
+        case OT_FUNCPROTO:
+        case OT_CLASS:
+        case OT_OUTER:
+            return sq_throwerrorf(vm, _SC("Type (%s) is not serializable"), SqTypeName(sq_gettype(vm, 2)));
+    }
+    // Serialization was successful
+    return SQ_OK;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::SerializeArray(HSQUIRRELVM vm, SQInteger idx) // NOLINT(misc-no-recursion)
+{
+    // Begin array scope
+    OpenArray();
+    // Push null to initiate iteration
+    sq_pushnull(vm);
+    // So we can use absolute stack indexes to avoid errors
+    const auto top = sq_gettop(vm);
+    // Start iterating the array at the specified position in the stack
+    for(SQRESULT r = SQ_OK; SQ_SUCCEEDED(sq_next(vm, idx));)
+    {
+        // Attempt serialization of the currently iterated value
+        r = SerializeAt(vm, top + 2);
+        // Check for failures
+        if (SQ_FAILED(r))
+        {
+            // Pop the null iterator, key and value from the stack
+            sq_pop(vm, 3);
+            // Propagate the error
+            return r;
+        }
+        // Pop the key and value from the stack (i.e. cleanup after `sq_next`)
+        sq_pop(vm, 2);
+    }
+    // Pop the null iterator
+    sq_poptop(vm);
+    // Close array scope
+    CloseArray();
+    // Serialization was successful
+    return SQ_OK;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::SerializeTable(HSQUIRRELVM vm, SQInteger idx) // NOLINT(misc-no-recursion)
+{
+    // Begin object scope
+    OpenObject();
+    // Push null to initiate iteration
+    sq_pushnull(vm);
+    // So we can use absolute stack indexes to avoid errors
+    const auto top = sq_gettop(vm);
+    // Start iterating the object at the specified position in the stack
+    for(SQRESULT r = SQ_OK; SQ_SUCCEEDED(sq_next(vm, idx));)
+    {
+        if (sq_gettype(vm, -2) == OT_STRING)
+        {
+            // Attempt serialization of the currently iterated element key
+            r = SerializeAt(vm, top + 1);
+            // Can we proceed with the value?
+            if (SQ_SUCCEEDED(r))
+            {
+                // Mark the value above as the key of this element and
+                // attempt serialization of the currently iterated element value
+                r = MakeKey().SerializeAt(vm, top + 2);
+            }
+        }
+        else
+        {
+            r = sq_throwerror(vm, _SC("Only string values are accepted as object keys"));
+        }
+        // Check for failures
+        if (SQ_FAILED(r))
+        {
+            // Pop the null iterator, key and value from the stack
+            sq_pop(vm, 3);
+            // Propagate the error
+            return r;
+        }
+        // Pop the key and value from the stack (i.e. cleanup after `sq_next`)
+        sq_pop(vm, 2);
+    }
+    // Pop the null iterator
+    sq_poptop(vm);
+    // Close object scope
+    CloseObject();
+    // Serialization was successful
+    return SQ_OK;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::SerializeInstance(HSQUIRRELVM vm, SQInteger idx)
+{
+    sq_pushstring(vm, mMetaMethod.c_str(), static_cast< SQInteger >(mMetaMethod.size()));
+    // Attempt to retrieve the meta-method from the instance
+    if(SQRESULT r = sq_get(vm, idx); SQ_FAILED(r))
+    {
+        return r; // Propagate the error
+    }
+    // Make sure this is actually a closure/function that we can invoke
+    else if (const auto t = sq_gettype(vm, -1); t != OT_CLOSURE && t != OT_NATIVECLOSURE)
+    {
+        // Remove whatever is on the stack
+        sq_poptop(vm);
+        // Abort the operation as we can't do anything about it
+        return sq_throwerrorf(vm, _SC("`_tojson` meta-method is not a closure for type (%s)"), SqTypeName(vm, idx).c_str());
+    }
+    // Push the instance itself the stack (the environment)
+    sq_push(vm, idx);
+    // Push this instance on the stack (the json context)
+    ClassType< CtxJSON >::PushInstance(vm, this);
+    // Invoke the function to perform the conversion in this context
+    SQRESULT r = sq_call(vm, 2, SQFalse, SQFalse);
+    // Remove the closure from the stack
+    sq_poptop(vm);
+    // Propagate the result, whatever that is
+    return r;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::SerializeWeakRef(HSQUIRRELVM vm, SQInteger idx) // NOLINT(misc-no-recursion)
+{
+    SQRESULT r = sq_getweakrefval(vm, idx);
+    // Attempt to grab the value pointed by the weak reference
+    if (SQ_SUCCEEDED(r))
+    {
+        // Attempt to serialize the actual value
+        r = SerializeAt(vm, sq_gettop(vm));
+        // Pop the referenced value
+        sq_poptop(vm);
+    }
+    // Propagate the error, if any
+    return r;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::PushValues(HSQUIRRELVM vm)
+{
+    // Fetch the number of objects on the stack
+    const auto top = sq_gettop(vm);
+    // Do we have a value?
+    if (top < 2)
+    {
+        return sq_throwerror(vm, _SC("Must specify at least one value to be pushed"));
+    }
+    // Serialize every specified argument
+    for (SQInteger i = 2; i <= top; ++i)
+    {
+        if (SQRESULT r = SerializeAt(vm, i); SQ_FAILED(r))
+        {
+            return r; // Propagate the error
+        }
+    }
+    // Allow chaining
+    sq_push(vm, 1);
+    // Specify that a value was returned
+    return 1;
+}
+
+// ------------------------------------------------------------------------------------------------
+SQRESULT CtxJSON::PushElement(HSQUIRRELVM vm)
+{
+    // Fetch the number of objects on the stack
+    const auto top = sq_gettop(vm);
+    // Do we have a value?
+    if (top < 3)
+    {
+        return sq_throwerrorf(vm, _SC("Not enough parameters. Received %lld but %lld needed"), top-1, 2);
+    }
+    else if (sq_gettype(vm, 2) != OT_STRING)
+    {
+        return sq_throwerrorf(vm, _SC("Element key must be a string"));
+    }
+    // Attempt serialization of the currently iterated element key
+    if (SQRESULT r = SerializeAt(vm, 2); SQ_SUCCEEDED(r))
+    {
+        // Mark the value above as the key of this element and
+        // attempt serialization of the currently iterated element value
+        r = MakeKey().SerializeAt(vm, 3);
+        // Check for failures
+        if (SQ_FAILED(r))
+        {
+            return r; // Propagate the error
+        }
+    }
+    // Allow chaining
+    sq_push(vm, 1);
+    // Specify that a value was returned
+    return 1;
+}
+
+// ------------------------------------------------------------------------------------------------
+CtxJSON & CtxJSON::PushKey(StackStrF & key)
+{
+    // Validate the string value
+    if (key.mLen >= 0 && SQ_SUCCEEDED(key.mRes))
+    {
+        PushString(key.mPtr, static_cast< size_t >(key.mLen));
+        MakeKey();
+    }
+    else
+    {
+        STHROWF("Invalid object key");
+    }
+    // Allow chaining
+    return *this;
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushNull()
+{
+    mOutput.append("null,");
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushInteger(SQInteger value)
+{
+    fmt::format_int f(value);
+    // Append the formatted integer to the buffer
+    mOutput.append(f.data(), f.size());
+    mOutput.push_back(',');
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushFloat(float value)
+{
+    fmt::format_to(std::back_inserter(mOutput), "{},", value);
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushDouble(double value)
+{
+    fmt::format_to(std::back_inserter(mOutput), "{},", value);
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushBool(bool value)
+{
+    if (value)
+    {
+        mOutput.append("true,", 5);
+    }
+    else
+    {
+        mOutput.append("false,", 6);
+    }
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushString(const SQChar * str)
+{
+    mOutput.push_back('"');
+    mOutput.append(str);
+    mOutput.push_back('"');
+    mOutput.push_back(',');
+    // Allow the hook to know
+    mString.assign(str);
+}
+
+// ------------------------------------------------------------------------------------------------
+void CtxJSON::PushString(const SQChar * str, size_t length)
+{
+    mOutput.push_back('"');
+    mOutput.append(str, length);
+    mOutput.push_back('"');
+    mOutput.push_back(',');
+    // Allow the hook to know
+    mString.assign(str, length);
+}
+
+// ------------------------------------------------------------------------------------------------
+static SQInteger SqToJSON(HSQUIRRELVM vm) noexcept
+{
+    // Make sure the instance is cleaned up even in the case of exceptions
+    DeleteGuard< CtxJSON > sq_dg(new CtxJSON());
+    // Remember the instance, so we don't have to cast the script object back
+    auto ctx = sq_dg.Get();
+    // Turn it into a script object because it may be passed as a parameter to `_tojson` meta-methods
+    LightObj obj(sq_dg, vm);
+    // Proceed with the serialization
+    return ctx->SerializeParams(vm);
+}
+
+// ------------------------------------------------------------------------------------------------
+static SQInteger SqToCompactJSON(HSQUIRRELVM vm) noexcept
+{
+    // Make sure the instance is cleaned up even in the case of exceptions
+    DeleteGuard< CtxJSON > sq_dg(new CtxJSON(false));
+    // Remember the instance, so we don't have to cast the script object back
+    auto ctx = sq_dg.Get();
+    // Turn it into a script object because it may be passed as a parameter to `_tojson` meta-methods
+    LightObj obj(sq_dg, vm);
+    // Proceed with the serialization
+    return ctx->SerializeParams(vm);
+}
+
 // ================================================================================================
 void Register_JSON(HSQUIRRELVM vm)
 {
     RootTable(vm).SquirrelFunc(_SC("SqToJSON"), SqToJSON);
+    RootTable(vm).SquirrelFunc(_SC("SqToCompactJSON"), SqToCompactJSON);
     RootTable(vm).SquirrelFunc(_SC("SqFromJSON"), SqFromJSON);
+    // --------------------------------------------------------------------------------------------
+    RootTable(vm).Bind(_SC("SqCtxJSON"),
+        Class< CtxJSON, NoCopy< CtxJSON > >(vm, SqCtxJSON::Str)
+        // Constructors
+        .Ctor()
+        .Ctor< bool >()
+        .Ctor< bool, StackStrF & >()
+        // Meta-methods
+        .SquirrelFunc(_SC("_typename"), &SqCtxJSON::Fn)
+        // Properties
+        .Prop(_SC("Output"), &CtxJSON::GetOutput)
+        .Prop(_SC("Depth"), &CtxJSON::GetDepth)
+        .Prop(_SC("OOA"), &CtxJSON::GetObjectOverArray, &CtxJSON::SetObjectOverArray)
+        .Prop(_SC("ObjectOverArray"), &CtxJSON::GetObjectOverArray, &CtxJSON::SetObjectOverArray)
+        // Member Methods
+        .SquirrelMethod< CtxJSON, &CtxJSON::SerializeParams >(_SC("Serialize"))
+        .SquirrelMethod< CtxJSON, &CtxJSON::PushValues >(_SC("PushValues"))
+        .SquirrelMethod< CtxJSON, &CtxJSON::PushElement >(_SC("PushElement"))
+        .Func(_SC("OpenArray"), &CtxJSON::OpenArray)
+        .Func(_SC("CloseArray"), &CtxJSON::CloseArray)
+        .Func(_SC("OpenObject"), &CtxJSON::OpenObject)
+        .Func(_SC("CloseObject"), &CtxJSON::CloseObject)
+        .Func(_SC("MakeKey"), &CtxJSON::MakeKey)
+        .FmtFunc(_SC("PushKey"), &CtxJSON::PushKey)
+        .Func(_SC("SetOOA"), &CtxJSON::SetObjectOverArray)
+        .Func(_SC("SetObjectOverArray"), &CtxJSON::SetObjectOverArray)
+    );
 }
 
 } // Namespace:: SqMod

module/Library/JSON.hpp

@@ -5,12 +5,281 @@
 #include "Library/IO/Buffer.hpp"
 
 // ------------------------------------------------------------------------------------------------
-#include <sajson.h>
+#include <functional>
+
+// ------------------------------------------------------------------------------------------------
+#include <fmt/args.h>
+#include <fmt/format.h>
+#include <fmt/xchar.h>
 
 // ------------------------------------------------------------------------------------------------
 namespace SqMod {
 
-// ------------------------------------------------------------------------------------------------
+/* ------------------------------------------------------------------------------------------------
+ * JSON serializer. The generated JSON output is always minified for efficiency reasons.
+*/
+struct CtxJSON
+{
+    /* --------------------------------------------------------------------------------------------
+     * Output string.
+    */
+    String mOutput{};
 
+    /* --------------------------------------------------------------------------------------------
+     * Prefer a table with named members even when a simple array would do the job.
+     * Take a Vector3 for example. Compact array [x, y, z] or named object {x: #.#, y: #.#, z: #.#}
+    */
+    bool mObjectOverArray{true};
+
+    /* --------------------------------------------------------------------------------------------
+     * How nested are we currently.
+    */
+    uint32_t mDepth{0};
+
+    /* --------------------------------------------------------------------------------------------
+     * The meta-method name to use on objects.
+    */
+    String mMetaMethod{"_tojson"};
+
+    /* --------------------------------------------------------------------------------------------
+     * Last pushed string value. Can be used to heck for key name in the hook.
+    */
+    String mString{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Internal utility used to monitor the existence of certain keys to allow overloading.
+    */
+    std::function< void(CtxJSON&) > mKeyHook{};
+
+    /* --------------------------------------------------------------------------------------------
+     * Default constructor.
+    */
+    CtxJSON() = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    explicit CtxJSON(bool ooa)
+        : CtxJSON()
+    {
+        mObjectOverArray = ooa;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Explicit constructor.
+    */
+    CtxJSON(bool ooa, StackStrF & mmname)
+        : CtxJSON()
+    {
+        mObjectOverArray = ooa;
+        // Allow custom metamethod names
+        mMetaMethod.assign(mmname.mPtr, static_cast< size_t >(mmname.mLen));
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Internal constructor.
+    */
+    explicit CtxJSON(std::function< void(CtxJSON&) > && kh)
+        : CtxJSON()
+    {
+        mKeyHook = std::move(kh);
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Copy constructor.
+    */
+    CtxJSON(const CtxJSON &) = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Move constructor.
+    */
+    CtxJSON(CtxJSON &&) noexcept = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Destructor.
+    */
+    ~CtxJSON() = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Copy assignment operator.
+    */
+    CtxJSON & operator = (const CtxJSON &) = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Move assignment operator.
+    */
+    CtxJSON & operator = (CtxJSON &&) noexcept = default;
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the current depth.
+    */
+    SQMOD_NODISCARD const String & GetOutput() const noexcept
+    {
+        return mOutput;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve the current depth.
+    */
+    SQMOD_NODISCARD SQInteger GetDepth() const noexcept
+    {
+        return mDepth;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether objects are preferred over arrays.
+    */
+    SQMOD_NODISCARD bool GetObjectOverArray() const noexcept
+    {
+        return mObjectOverArray;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether objects are preferred over arrays.
+    */
+    CtxJSON & SetObjectOverArray(bool toggle) noexcept
+    {
+        mObjectOverArray = toggle;
+        // Allow chaining
+        return *this;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Increase indentation by one level.
+    */
+    void Advance() noexcept
+    {
+        ++mDepth;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Decrease indentation by one level.
+    */
+    void Retreat() noexcept
+    {
+        assert(mDepth > 0);
+        if (mDepth) --mDepth;
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Begin writing an array.
+    */
+    CtxJSON & OpenArray();
+
+    /* --------------------------------------------------------------------------------------------
+     * Stop writing an array.
+    */
+    CtxJSON & CloseArray();
+
+    /* --------------------------------------------------------------------------------------------
+     * Resume writing an array.
+    */
+    CtxJSON & ReopenArray();
+
+    /* --------------------------------------------------------------------------------------------
+     * Begin writing an object.
+    */
+    CtxJSON & OpenObject();
+
+    /* --------------------------------------------------------------------------------------------
+     * Stop writing an object.
+    */
+    CtxJSON & CloseObject();
+
+    /* --------------------------------------------------------------------------------------------
+     * Resume writing an object.
+    */
+    CtxJSON & ReopenObject();
+
+    /* --------------------------------------------------------------------------------------------
+     * Begin writing a key value.
+    */
+    CtxJSON & MakeKey();
+
+    /* --------------------------------------------------------------------------------------------
+     * Check whether the specified weak-ref points to a type of value that must be wrapped.
+    */
+    SQMOD_NODISCARD static bool CheckWeakRefWrap(HSQUIRRELVM vm, SQInteger idx) noexcept;
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize given arguments.
+    */
+    SQRESULT SerializeParams(HSQUIRRELVM vm);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize the value a specific position in the stack.
+    */
+    SQRESULT SerializeAt(HSQUIRRELVM vm, SQInteger idx);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize the array a specific position in the stack. Stack index must be absolute!
+    */
+    SQRESULT SerializeArray(HSQUIRRELVM vm, SQInteger idx);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize the table a specific position in the stack. Stack index must be absolute!
+    */
+    SQRESULT SerializeTable(HSQUIRRELVM vm, SQInteger idx);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize the instance a specific position in the stack. Stack index must be absolute!
+    */
+    SQRESULT SerializeInstance(HSQUIRRELVM vm, SQInteger idx);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize the weak-ref a specific position in the stack. Stack index must be absolute!
+    */
+    SQRESULT SerializeWeakRef(HSQUIRRELVM vm, SQInteger idx);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize a value to the current container. It assumes an array or object is currently open.
+    */
+    SQRESULT PushValues(HSQUIRRELVM vm);
+
+    /* --------------------------------------------------------------------------------------------
+     * Serialize a key/value pair to the current object. It assumes an object is currently open.
+    */
+    SQRESULT PushElement(HSQUIRRELVM vm);
+
+    /* --------------------------------------------------------------------------------------------
+     * Push a key in the output. It assumes an object was open and previous element closed properly.
+    */
+    CtxJSON & PushKey(StackStrF & key);
+
+    /* --------------------------------------------------------------------------------------------
+     * Write a null value to the output.
+    */
+    void PushNull();
+
+    /* --------------------------------------------------------------------------------------------
+     * Write an integer value to the output.
+    */
+    void PushInteger(SQInteger value);
+
+    /* --------------------------------------------------------------------------------------------
+     * Write a single precision floating point value to the output.
+    */
+    void PushFloat(float value);
+
+    /* --------------------------------------------------------------------------------------------
+     * Write a double precision floating point value to the output.
+    */
+    void PushDouble(double value);
+
+    /* --------------------------------------------------------------------------------------------
+     * Write a boolean value to the output.
+    */
+    void PushBool(bool value);
+
+    /* --------------------------------------------------------------------------------------------
+     * Write a string value to the output.
+    */
+    void PushString(const SQChar * str);
+
+    /* --------------------------------------------------------------------------------------------
+     * Write a string value to the output.
+    */
+    void PushString(const SQChar * str, size_t length);
+};
 
 } // Namespace:: SqMod

module/Library/Net.cpp

@@ -22,6 +22,8 @@ void InitializeNet()
 #endif
 #ifndef NO_SSL
     f |= MG_FEATURES_SSL;
+#else
+    OutputMessage("Network compiled without SSL support.");
 #endif
 #ifndef NO_CGI
     f |= MG_FEATURES_CGI;
@@ -89,6 +91,9 @@ WebSocketClient & WebSocketClient::Connect()
     {
         STHROWF("Connection failed: {}", err_buf);
     }
+    // Reset memebrs
+    mClosing.store(false);
+    mClosed.store(false);
     // Allow chaining
     return *this;
 }
@@ -113,6 +118,9 @@ WebSocketClient & WebSocketClient::ConnectExt()
     {
         STHROWF("Connection failed: {}", err_buf);
     }
+    // Reset memebrs
+    mClosing.store(false);
+    mClosed.store(false);
     // Allow chaining
     return *this;
 }
@@ -129,6 +137,11 @@ int WebSocketClient::DataHandler(int flags, char * data, size_t data_len) noexce
     {
         LogFtl("Failed to queue web-socket data");
     }
+    // Should we auto-close the connection
+    if (((flags & 0xF) == MG_WEBSOCKET_OPCODE_CONNECTION_CLOSE) && mAutoClose.load() == true)
+    {
+        return 0;
+    }
     // Return 1 to keep the connection open
     return 1;
 }
@@ -167,6 +180,7 @@ void Register_Net(HSQUIRRELVM vm)
         .Prop(_SC("OnClose"), &WebSocketClient::GetOnClose, &WebSocketClient::SetOnClose)
         .Prop(_SC("Valid"), &WebSocketClient::IsValid)
         .Prop(_SC("Closing"), &WebSocketClient::IsClosing)
+        .Prop(_SC("AutoClose"), &WebSocketClient::GetAutoClose, &WebSocketClient::SetAutoClose)
         // Member Methods
         .FmtFunc(_SC("SetTag"), &WebSocketClient::ApplyTag)
         .FmtFunc(_SC("SetData"), &WebSocketClient::ApplyData)

module/Library/Net.hpp

@@ -154,6 +154,18 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     */
     std::atomic< bool > mClosing{false};
 
+    /* --------------------------------------------------------------------------------------------
+     * Whether the closing callback was inoked (avoid recursive calls).
+    */
+    std::atomic< bool > mClosed{false};
+
+    /* --------------------------------------------------------------------------------------------
+     * Whether to not keep the connection open after receiving the close event.
+     * Internally this event is ignored but if set to true the connection is immediatelly closed
+     * in the internal event handler, before the event may reach the script callback.
+    */
+    std::atomic< bool > mAutoClose{false};
+
     /* --------------------------------------------------------------------------------------------
      * Server host to connect to, i.e. "echo.websocket.org" or "192.168.1.1" or "localhost".
     */
@@ -179,7 +191,8 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     */
     WebSocketClient()
         : Base(), mHandle(nullptr), mQueue(1024), mOnData(), mOnClose(), mTag(), mData()
-        , mPort(0), mSecure(false), mClosing(false), mHost(), mPath(), mOrigin(), mExtensions()
+        , mPort(0), mSecure(false), mClosing(false), mClosed(false), mAutoClose(false)
+        , mHost(), mPath(), mOrigin(), mExtensions()
     {
         ChainInstance(); // Remember this instance
     }
@@ -189,7 +202,7 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     */
     WebSocketClient(StackStrF & host, uint16_t port, StackStrF & path)
         : Base(), mHandle(nullptr), mQueue(1024), mOnData(), mOnClose(), mTag(), mData()
-        , mPort(port), mSecure(false), mClosing(false)
+        , mPort(port), mSecure(false), mClosing(false), mClosed(false), mAutoClose(false)
         , mHost(host.mPtr, host.GetSize())
         , mPath(path.mPtr, path.GetSize())
         , mOrigin(), mExtensions()
@@ -202,7 +215,7 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     */
     WebSocketClient(StackStrF & host, uint16_t port, StackStrF & path, bool secure)
         : Base(), mHandle(nullptr), mQueue(1024), mOnData(), mOnClose(), mTag(), mData()
-        , mPort(port), mSecure(secure), mClosing(false)
+        , mPort(port), mSecure(secure), mClosing(false), mClosed(false), mAutoClose(false)
         , mHost(host.mPtr, host.GetSize())
         , mPath(path.mPtr, path.GetSize())
         , mOrigin(), mExtensions()
@@ -215,7 +228,7 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     */
     WebSocketClient(StackStrF & host, uint16_t port, StackStrF & path, bool secure, StackStrF & origin)
         : Base(), mHandle(nullptr), mQueue(1024), mOnData(), mOnClose(), mTag(), mData()
-        , mPort(port), mSecure(secure), mClosing(false)
+        , mPort(port), mSecure(secure), mClosing(false), mClosed(false), mAutoClose(false)
         , mHost(host.mPtr, host.GetSize())
         , mPath(path.mPtr, path.GetSize())
         , mOrigin(origin.mPtr, origin.GetSize())
@@ -229,7 +242,7 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     */
     WebSocketClient(StackStrF & host, uint16_t port, StackStrF & path, bool secure, StackStrF & origin, StackStrF & ext)
         : Base(), mHandle(nullptr), mQueue(1024), mOnData(), mOnClose(), mTag(), mData()
-        , mPort(port), mSecure(secure), mClosing(false)
+        , mPort(port), mSecure(secure), mClosing(false), mClosed(false), mAutoClose(false)
         , mHost(host.mPtr, host.GetSize())
         , mPath(path.mPtr, path.GetSize())
         , mOrigin(origin.mPtr, origin.GetSize())
@@ -289,6 +302,22 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
         return mClosing.load();
     }
 
+    /* --------------------------------------------------------------------------------------------
+     * Retrieve whether auto-closing is enabled or not.
+    */
+    SQMOD_NODISCARD bool GetAutoClose() const
+    {
+        return mAutoClose.load();
+    }
+
+    /* --------------------------------------------------------------------------------------------
+     * Modify whether auto-closing is enabled or not.
+    */
+    void SetAutoClose(bool toggle)
+    {
+        mAutoClose.store(toggle);
+    }
+
     /* --------------------------------------------------------------------------------------------
      * Retrieve the associated user tag.
     */
@@ -648,7 +677,7 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
     /* --------------------------------------------------------------------------------------------
      * Sends the contents of the given buffer through the socket as a single frame.
     */
-    SQMOD_NODISCARD SQInteger SendOpCode(SqBuffer & buf, SQInteger opcode)
+    SQMOD_NODISCARD SQInteger SendOpCode(SQInteger opcode)
     {
         return mg_websocket_client_write(Valid(), static_cast< int >(opcode), nullptr, 0);
     }
@@ -706,9 +735,12 @@ struct WebSocketClient : public SqChainedInstances< WebSocketClient >
             }
         }
         // Is the server closing the connection?
-        if (closing && !mOnClose.IsNull())
+        if (closing && !mClosed.load() && !mOnClose.IsNull())
         {
-            mOnClose.Execute(); // Let the user know
+            // Let the user know
+            mOnClose.Execute();
+            // Prevent calling this callback again
+            mClosed.store(true);
         }
     }
 
@@ -756,5 +788,4 @@ protected:
     }
 };
 
-
 } // Namespace:: SqMod

module/Library/RegEx.cpp

@@ -0,0 +1,191 @@
+// ------------------------------------------------------------------------------------------------
+#include "Library/RegEx.hpp"
+
+// ------------------------------------------------------------------------------------------------
+#include <sqratConst.h>
+
+// ------------------------------------------------------------------------------------------------
+namespace SqMod {
+
+// ------------------------------------------------------------------------------------------------
+SQMOD_DECL_TYPENAME(SqRxMatchTypename, _SC("SqRxMatch"))
+SQMOD_DECL_TYPENAME(SqRxMatchesTypename, _SC("SqRxMatches"))
+SQMOD_DECL_TYPENAME(SqRxInstanceTypename, _SC("SqRxInstance"))
+
+// ------------------------------------------------------------------------------------------------
+// bool RxInstance::STUDY = true;
+// int RxInstance::OPTIONS = 0;
+// int RxInstance::STUDY_OPTIONS = 0;
+
+// ================================================================================================
+void Register_RegEx(HSQUIRRELVM vm)
+{
+    RootTable(vm).Bind(SqRxMatchTypename::Str,
+       Class< RxMatch >(vm, SqRxMatchTypename::Str)
+       // Constructors
+       .Ctor()
+       .Ctor< SQInteger >()
+       .Ctor< SQInteger, SQInteger >()
+       // Meta-methods
+       .SquirrelFunc(_SC("_typename"), &SqRxMatchTypename::Fn)
+       // Properties
+       .Prop(_SC("Offset"), &RxMatch::GetOffset, &RxMatch::SetOffset)
+       .Prop(_SC("Length"), &RxMatch::GetLength, &RxMatch::SetLength)
+       .Prop(_SC("End"), &RxMatch::GetEnd)
+       // Member Methods
+       .Func(_SC("SubStr"), &RxMatch::SubStr)
+    );
+    RootTable(vm).Bind(SqRxMatchesTypename::Str,
+       Class< RxMatches >(vm, SqRxMatchesTypename::Str)
+       // Constructors
+       .Ctor()
+       // Meta-methods
+       .SquirrelFunc(_SC("_typename"), &SqRxMatchesTypename::Fn)
+       // Properties
+       .Prop(_SC("Front"), &RxMatches::Front)
+       .Prop(_SC("Back"), &RxMatches::Back)
+       .Prop(_SC("Empty"), &RxMatches::Empty)
+       .Prop(_SC("Size"), &RxMatches::Size)
+       .Prop(_SC("Capacity"), &RxMatches::Capacity, &RxMatches::Reserve)
+       // Member Methods
+       .Func(_SC("Get"), &RxMatches::Get)
+       .Func(_SC("Reserve"), &RxMatches::Reserve)
+       .Func(_SC("Compact"), &RxMatches::Compact)
+       .Func(_SC("Clear"), &RxMatches::Clear)
+       .Func(_SC("Pop"), &RxMatches::Pop)
+       .Func(_SC("EraseAt"), &RxMatches::EraseAt)
+       .Func(_SC("EraseFrom"), &RxMatches::EraseFrom)
+       .Func(_SC("Each"), &RxMatches::Each)
+       .Func(_SC("EachRange"), &RxMatches::EachRange)
+       .Func(_SC("While"), &RxMatches::While)
+       .Func(_SC("WhileRange"), &RxMatches::WhileRange)
+       .Func(_SC("SubStr"), &RxMatches::SubStr)
+    );
+    // RootTable(vm).Bind(_SC("SqRx"),
+    //     Class< RxInstance, NoCopy< RxInstance > >(vm, SqRxInstanceTypename::Str)
+    //     // Constructors
+    //     .Ctor()
+    //     .Ctor< StackStrF & >()
+    //     .Ctor< int, StackStrF & >()
+    //     .Ctor< int, bool, StackStrF & >()
+    //     // Meta-methods
+    //     .SquirrelFunc(_SC("_typename"), &SqRxInstanceTypename::Fn)
+    //     //.Func(_SC("_tostring"), &CPlayer::ToString)
+    //     // Static Values
+    //     .SetStaticValue(_SC("STUDY"), RxInstance::STUDY)
+    //     .SetStaticValue(_SC("OPTIONS"), RxInstance::OPTIONS)
+    //     .SetStaticValue(_SC("STUDY_OPTIONS"), RxInstance::STUDY_OPTIONS)
+    //     // Properties
+    //     .Prop(_SC("Valid"), &RxInstance::IsValid)
+    //     .Prop(_SC("Studied"), &RxInstance::IsStudied)
+    //     // Member Methods
+    //     .FmtFunc(_SC("CompileF"), &RxInstance::Compile1)
+    //     .FmtFunc(_SC("CompileExF"), &RxInstance::Compile2)
+    //     .FmtFunc(_SC("TryCompileF"), &RxInstance::TryCompile1)
+    //     .FmtFunc(_SC("TryCompileExF"), &RxInstance::TryCompile2)
+    //     .FmtFunc(_SC("MatchFirst"), &RxInstance::MatchFirst)
+    //     .FmtFunc(_SC("MatchFirstEx"), &RxInstance::MatchFirst_)
+    //     .FmtFunc(_SC("MatchFirstFrom"), &RxInstance::MatchFirstFrom)
+    //     .FmtFunc(_SC("MatchFirstFromEx"), &RxInstance::MatchFirstFrom_)
+    //     .FmtFunc(_SC("Match"), &RxInstance::Match)
+    //     .FmtFunc(_SC("MatchEx"), &RxInstance::Match_)
+    //     .FmtFunc(_SC("MatchFrom"), &RxInstance::MatchFrom)
+    //     .FmtFunc(_SC("MatchFromEx"), &RxInstance::MatchFrom_)
+    //     .FmtFunc(_SC("Matches"), &RxInstance::Matches)
+    //     .FmtFunc(_SC("MatchesEx"), &RxInstance::Matches_)
+    //     .FmtFunc(_SC("MatchesEx2"), &RxInstance::MatchesEx)
+    //     // Member Overloads
+    //     .Overload(_SC("Compile"), &RxInstance::Compile1)
+    //     .Overload(_SC("Compile"), &RxInstance::Compile2)
+    //     .Overload(_SC("TryCompile"), &RxInstance::TryCompile1)
+    //     .Overload(_SC("TryCompile"), &RxInstance::TryCompile2)
+    //     .Overload(_SC("Study"), &RxInstance::Study0)
+    //     .Overload(_SC("Study"), &RxInstance::Study1)
+    // );
+    // --------------------------------------------------------------------------------------------
+    // ConstTable(vm).Enum(_SC("SqRxOption"), Enumeration(vm)
+    //     .Const(_SC("Caseless"),         static_cast< SQInteger >(PCRE_CASELESS))
+    //     .Const(_SC("Multiline"),        static_cast< SQInteger >(PCRE_MULTILINE))
+    //     .Const(_SC("Dotall"),           static_cast< SQInteger >(PCRE_DOTALL))
+    //     .Const(_SC("Extended"),         static_cast< SQInteger >(PCRE_EXTENDED))
+    //     .Const(_SC("Anchored"),         static_cast< SQInteger >(PCRE_ANCHORED))
+    //     .Const(_SC("DollarEndOnly"),    static_cast< SQInteger >(PCRE_DOLLAR_ENDONLY))
+    //     .Const(_SC("Extra"),            static_cast< SQInteger >(PCRE_EXTRA))
+    //     .Const(_SC("NotBOL"),           static_cast< SQInteger >(PCRE_NOTBOL))
+    //     .Const(_SC("NotEOL"),           static_cast< SQInteger >(PCRE_NOTEOL))
+    //     .Const(_SC("UnGreedy"),         static_cast< SQInteger >(PCRE_UNGREEDY))
+    //     .Const(_SC("NotEmpty"),         static_cast< SQInteger >(PCRE_NOTEMPTY))
+    //     .Const(_SC("UTF8"),             static_cast< SQInteger >(PCRE_UTF8))
+    //     .Const(_SC("UTF16"),            static_cast< SQInteger >(PCRE_UTF16))
+    //     .Const(_SC("UTF32"),            static_cast< SQInteger >(PCRE_UTF32))
+    //     .Const(_SC("NoAutoCapture"),    static_cast< SQInteger >(PCRE_NO_AUTO_CAPTURE))
+    //     .Const(_SC("NoUTF8Check"),      static_cast< SQInteger >(PCRE_NO_UTF8_CHECK))
+    //     .Const(_SC("NoUTF16Check"),     static_cast< SQInteger >(PCRE_NO_UTF16_CHECK))
+    //     .Const(_SC("NoUTF32Check"),     static_cast< SQInteger >(PCRE_NO_UTF32_CHECK))
+    //     .Const(_SC("AutoCallout"),      static_cast< SQInteger >(PCRE_AUTO_CALLOUT))
+    //     .Const(_SC("PartialSoft"),      static_cast< SQInteger >(PCRE_PARTIAL_SOFT))
+    //     .Const(_SC("Partial"),          static_cast< SQInteger >(PCRE_PARTIAL))
+    //     .Const(_SC("NeverUTF"),         static_cast< SQInteger >(PCRE_NEVER_UTF))
+    //     .Const(_SC("DfaShortest"),      static_cast< SQInteger >(PCRE_DFA_SHORTEST))
+    //     .Const(_SC("NoAutoPossess"),    static_cast< SQInteger >(PCRE_NO_AUTO_POSSESS))
+    //     .Const(_SC("DfaRestart"),       static_cast< SQInteger >(PCRE_DFA_RESTART))
+    //     .Const(_SC("FirstLine"),        static_cast< SQInteger >(PCRE_FIRSTLINE))
+    //     .Const(_SC("DupNames"),         static_cast< SQInteger >(PCRE_DUPNAMES))
+    //     .Const(_SC("NewLineCR"),        static_cast< SQInteger >(PCRE_NEWLINE_CR))
+    //     .Const(_SC("NewLineLF"),        static_cast< SQInteger >(PCRE_NEWLINE_LF))
+    //     .Const(_SC("NewLineCRLF"),      static_cast< SQInteger >(PCRE_NEWLINE_CRLF))
+    //     .Const(_SC("NewLineAny"),       static_cast< SQInteger >(PCRE_NEWLINE_ANY))
+    //     .Const(_SC("NewLineAnyCRLF"),   static_cast< SQInteger >(PCRE_NEWLINE_ANYCRLF))
+    //     .Const(_SC("BsrAnyCRLF"),       static_cast< SQInteger >(PCRE_BSR_ANYCRLF))
+    //     .Const(_SC("BsrUnicode"),       static_cast< SQInteger >(PCRE_BSR_UNICODE))
+    //     .Const(_SC("JavaScriptCompat"), static_cast< SQInteger >(PCRE_JAVASCRIPT_COMPAT))
+    //     .Const(_SC("NoStartOptimize"),  static_cast< SQInteger >(PCRE_NO_START_OPTIMIZE))
+    //     .Const(_SC("NoStartOptimise"),  static_cast< SQInteger >(PCRE_NO_START_OPTIMISE))
+    //     .Const(_SC("PartialHard"),      static_cast< SQInteger >(PCRE_PARTIAL_HARD))
+    //     .Const(_SC("NotEmptyAtStart"),  static_cast< SQInteger >(PCRE_NOTEMPTY_ATSTART))
+    //     .Const(_SC("UCP"),              static_cast< SQInteger >(PCRE_UCP))
+    // );
+    // --------------------------------------------------------------------------------------------
+    // ConstTable(vm).Enum(_SC("SqRxError"), Enumeration(vm)
+    //     .Const(_SC("NoMatch"),       	static_cast< SQInteger >(PCRE_ERROR_NOMATCH))
+    //     .Const(_SC("Null"),       		static_cast< SQInteger >(PCRE_ERROR_NULL))
+    //     .Const(_SC("BadOption"),     	static_cast< SQInteger >(PCRE_ERROR_BADOPTION))
+    //     .Const(_SC("BadMagic"),      	static_cast< SQInteger >(PCRE_ERROR_BADMAGIC))
+    //     .Const(_SC("UnknownOpCode"), 	static_cast< SQInteger >(PCRE_ERROR_UNKNOWN_OPCODE))
+    //     .Const(_SC("UnknownNode"),   	static_cast< SQInteger >(PCRE_ERROR_UNKNOWN_NODE))
+    //     .Const(_SC("NoMemory"),      	static_cast< SQInteger >(PCRE_ERROR_NOMEMORY))
+    //     .Const(_SC("NoSubstring"),   	static_cast< SQInteger >(PCRE_ERROR_NOSUBSTRING))
+    //     .Const(_SC("MatchLimit"),    	static_cast< SQInteger >(PCRE_ERROR_MATCHLIMIT))
+    //     .Const(_SC("Callout"),       	static_cast< SQInteger >(PCRE_ERROR_CALLOUT))
+    //     .Const(_SC("BadUTF8"),       	static_cast< SQInteger >(PCRE_ERROR_BADUTF8))
+    //     .Const(_SC("BadUTF16"),      	static_cast< SQInteger >(PCRE_ERROR_BADUTF16))
+    //     .Const(_SC("BadUTF32"),      	static_cast< SQInteger >(PCRE_ERROR_BADUTF32))
+    //     .Const(_SC("BadUTF8Offset"), 	static_cast< SQInteger >(PCRE_ERROR_BADUTF8_OFFSET))
+    //     .Const(_SC("BadUTF16Offset"),	static_cast< SQInteger >(PCRE_ERROR_BADUTF16_OFFSET))
+    //     .Const(_SC("Partial"),       	static_cast< SQInteger >(PCRE_ERROR_PARTIAL))
+    //     .Const(_SC("BadPartial"),    	static_cast< SQInteger >(PCRE_ERROR_BADPARTIAL))
+    //     .Const(_SC("Internal"),      	static_cast< SQInteger >(PCRE_ERROR_INTERNAL))
+    //     .Const(_SC("BadCount"),      	static_cast< SQInteger >(PCRE_ERROR_BADCOUNT))
+    //     .Const(_SC("DfaUitem"),      	static_cast< SQInteger >(PCRE_ERROR_DFA_UITEM))
+    //     .Const(_SC("DfaUcond"),      	static_cast< SQInteger >(PCRE_ERROR_DFA_UCOND))
+    //     .Const(_SC("DfaUmLimit"),    	static_cast< SQInteger >(PCRE_ERROR_DFA_UMLIMIT))
+    //     .Const(_SC("DfaWsSize"),     	static_cast< SQInteger >(PCRE_ERROR_DFA_WSSIZE))
+    //     .Const(_SC("DfaRecurse"),    	static_cast< SQInteger >(PCRE_ERROR_DFA_RECURSE))
+    //     .Const(_SC("RecursionLimit"),	static_cast< SQInteger >(PCRE_ERROR_RECURSIONLIMIT))
+    //     .Const(_SC("NullWsLimit"),   	static_cast< SQInteger >(PCRE_ERROR_NULLWSLIMIT))
+    //     .Const(_SC("BadNewLine"),    	static_cast< SQInteger >(PCRE_ERROR_BADNEWLINE))
+    //     .Const(_SC("BadOffset"),     	static_cast< SQInteger >(PCRE_ERROR_BADOFFSET))
+    //     .Const(_SC("ShortUTF8"),     	static_cast< SQInteger >(PCRE_ERROR_SHORTUTF8))
+    //     .Const(_SC("ShortUTF16"),    	static_cast< SQInteger >(PCRE_ERROR_SHORTUTF16))
+    //     .Const(_SC("RecurseLoop"),   	static_cast< SQInteger >(PCRE_ERROR_RECURSELOOP))
+    //     .Const(_SC("JitStackLimit"), 	static_cast< SQInteger >(PCRE_ERROR_JIT_STACKLIMIT))
+    //     .Const(_SC("BadMode"),       	static_cast< SQInteger >(PCRE_ERROR_BADMODE))
+    //     .Const(_SC("BadEndianness"), 	static_cast< SQInteger >(PCRE_ERROR_BADENDIANNESS))
+    //     .Const(_SC("DfaBadRestart"), 	static_cast< SQInteger >(PCRE_ERROR_DFA_BADRESTART))
+    //     .Const(_SC("JitBadOption"),  	static_cast< SQInteger >(PCRE_ERROR_JIT_BADOPTION))
+    //     .Const(_SC("BadLength"),     	static_cast< SQInteger >(PCRE_ERROR_BADLENGTH))
+    //     .Const(_SC("Unset"),       		static_cast< SQInteger >(PCRE_ERROR_UNSET))
+    // );
+}
+
+} // Namespace:: SqMod