let's promote using $on_mod(Loaded) instead of $execute by default

Author: Cvolton

handbook/vol1/chap1_3.md

@@ -33,7 +33,7 @@ void MenuLayer_onNewgrounds(MenuLayer* self, CCObject* sender) {
     log::info("After original!");
 }
 
-$execute {
+$on_mod(Loaded) {
     Mod::get()->addHook(
         reinterpret_cast<void*>(geode::base::get() + 0x27b480),
         &MenuLayer_onNewgrounds,

mods/settings.md

@@ -63,14 +63,14 @@ auto myBool = Mod::get()->getSettingValue<bool>("my-bool-setting");
 auto myInt  = Mod::get()->getSettingValue<int64_t>("my-int-setting");
 ```
 
-You can detect whenever the value of a setting is changed by using the [listenForSettingChanges] function. In most situations, you should call this function in an `$execute` block, so it gets enabled immediately when your mod is loaded. **The function will not be called on startup**, only when the value is changed afterwards. Note that the type you get the value as must match the value type of the setting type - if you are using a custom setting, make sure to specialize `geode::SettingTypeForValueType<T>`.
+You can detect whenever the value of a setting is changed by using the [listenForSettingChanges] function. In most situations, you should call this function in an `$on_mod(Loaded)` block, so it gets enabled immediately when your mod is loaded. **The function will not be called on startup**, only when the value is changed afterwards. Note that the type you get the value as must match the value type of the setting type - if you are using a custom setting, make sure to specialize `geode::SettingTypeForValueType<T>`.
 
 ```cpp
 #include <Geode/loader/SettingV3.hpp>
 
 using namespace geode::prelude;
 
-$execute {
+$on_mod(Loaded) {
     listenForSettingChanges("my-float-setting", [](double value) {
         // do something with the value
     });
@@ -687,7 +687,7 @@ SettingNodeV3* MyCustomSettingV3::createNode(float width) {
 }
 
 // When the mod is loaded, you need to register your setting type
-$execute {
+$on_mod(Loaded) {
     // You can also handle the errors, but if this fails, the game is probably about to crash anyway
     (void)Mod::get()->registerCustomSettingType("my-awesome-type", &MyCustomSettingV3::parse);
 }
@@ -890,7 +890,7 @@ SettingNodeV3* MyButtonSettingV3::createNode(float width) {
 }
 
 // Register as before
-$execute {
+$on_mod(Loaded) {
     (void)Mod::get()->registerCustomSettingType("my-button-type", &MyButtonSettingV3::parse);
 }
 ```

tutorials/events.md

@@ -60,15 +60,15 @@ Listening to events is done using an `EventListener`. An event listener needs an
 ```cpp
 // main.cpp
 
-#include <Geode/DefaultInclude.hpp> // $execute
+#include <Geode/DefaultInclude.hpp> // $on_mod(Loaded)
 #include <Geode/loader/Event.hpp> // EventListener, EventFilter
 
 #include "DragDropEvent.hpp" // Our created event
 
 using namespace geode::prelude;
 
-// Execute runs the code inside **when your mod is loaded**
-$execute {
+// on_mod(Loaded) runs the code inside **when your mod is loaded**
+$on_mod(Loaded) {
     // This technically doesn't leak memory, since the listener should live for the entirety of the program
     new EventListener<EventFilter<DragDropEvent>>(+[](DragDropEvent* ev) {
         for (std::filesystem::path& file : ev->getFiles()) {
@@ -89,14 +89,14 @@ Notice that our callback returns a `ListenerResult`, more specifically `Listener
 ```cpp
 // main.cpp
 
-#include <Geode/DefaultInclude.hpp> // $execute
+#include <Geode/DefaultInclude.hpp> // $on_mod(Loaded)
 #include <Geode/loader/Event.hpp> // EventListener, EventFilter
 
 #include "DragDropEvent.hpp" // Our created event
 
 using namespace geode::prelude;
 
-$execute {
+$on_mod(Loaded) {
     new EventListener<EventFilter<DragDropEvent>>(+[](DragDropEvent* ev) {
         for (std::filesystem::path& file : ev->getFiles()) {
             log::debug("File dropped: {}", file);

tutorials/manualhooks.md

@@ -19,7 +19,7 @@ void MenuLayer_onNewgrounds(MenuLayer* self, CCObject* sender) {
     log::info("After original!");
 }
 
-$execute {
+$on_mod(Loaded) {
     Mod::get()->hook(
         reinterpret_cast<void*>(geode::base::get() + 0x191E90), // address
         &MenuLayer_onNewgrounds, // detour
@@ -40,7 +40,7 @@ void myDrawCircle(const cocos2d::CCPoint& center, float radius, float angle, uns
     log::info("alright {}", radius);
 }
 
-$execute {
+$on_mod(Loaded) {
     Mod::get()->hook(
         reinterpret_cast<void*>(
             // All of this is to get the address of ccDrawCircle

tutorials/modify-geode.md

@@ -31,7 +31,7 @@ These rules are in place because the Geode UI is a highly volatile place that **
 
 using namespace geode::prelude;
 
-$execute {
+$on_mod(Loaded) {
     new EventListener<EventFilter<ModLogoUIEvent>>(+[](ModLogoUIEvent* event) {
         if (event->getModID() == "geode.loader") {
             // Remember: no assumptions, even trivial ones!