Skip to content

Guide: Internal structure access

Archie_UwU edited this page Jan 4, 2024 · 2 revisions

Caution

Internal structure access is intended for power-users. If you don't explicitely need this functionality, it is recommended to leave it disabled.

Additionally, internal structure access is only supported for GameMaker runtimes 2022.1 up to 2023.11.

Enabling internal structure access

YYToolkit Next contains, by design, many opaque structures. For power-users and people knowledgeable on the GameMaker engine internals, direct access to variable members may be enabled via an opt-in system. Keep in mind this access is inherently unsafe, and may affect engine stability if used improperly. To enable internal structure access, go into your plugin's "Project Properties" under the "Project" submenu.

Important

Before proceeding further, make sure the following conditions are met:

  • Configuration is set to All Configurations
  • Platform is set to All Platforms

Under C/C++, go into the Preprocessor page, and add the YYTK_DEFINE_INTERNAL; definition before all the other definitions.

Disabling internal structure access

To disable internal structure access, remove the YYTK_DEFINE_INTERNAL; preprocessor definition from all configurations and platforms.

Quick Access

Documentation

Writeups

Clone this wiki locally