Console Logging

Use ctx.AddConsoleMessage(text, type) to write to the editor console.

Message Types

  • ConsoleMessageType::Info — General information
  • ConsoleMessageType::Success — Success messages
  • ConsoleMessageType::Warning — Warnings
  • ConsoleMessageType::Error — Errors

Basic Usage

1 ctx.AddConsoleMessage("Player spawned", ConsoleMessageType::Info);
2 ctx.AddConsoleMessage("Level complete!", ConsoleMessageType::Success);
3 ctx.AddConsoleMessage("Low health", ConsoleMessageType::Warning);
4 ctx.AddConsoleMessage("Failed to load asset", ConsoleMessageType::Error);

Warn-Once Pattern

Avoid spamming the console by using a static flag:

1 400">static 400">bool warned = 400">false;
2 400">if (!warned) {
3 ctx.AddConsoleMessage("[MyScript] Something looks off", ConsoleMessageType::Warning);
4 warned = 400">true;
5 }

Best Practices

  • Use descriptive prefixes like [ScriptName] for easy filtering
  • Don't log every frame — use conditionals or warn-once patterns
  • Use appropriate message types for severity
  • Logging is non-fatal by default, allowing scripts to fail gracefully