Recipe

Recipe: Godot GDScript scaffold

Bootstrap a Godot 4 project with Meridian auth baked into GDScript — ready for Windows export.

Prerequisites

  • Godot 4.2+ installed
  • Meridian loader binary placed in project root
  • Active Meridian license key

Step 1 — Project layout

project/
├── meridian_loader.exe
├── meridian_payload.dll
├── scenes/
│   └── main.tscn
└── scripts/
    └── auth.gd

Step 2 — GDScript auth singleton

extends Node

var _license_valid: bool = false

func _ready() -> void:
    var output = []
    var exit_code = OS.execute(
        "meridian_loader.exe",
        ["--verify"],
        output,
        true
    )
    _license_valid = (exit_code == 0)

func is_licensed() -> bool:
    return _license_valid

Step 3 — Export settings

Set export target to Windows Desktop. Under Resources, include meridian_loader.exe and meridian_payload.dll as non-importable files. Enable Embed Pck for single-exe distribution.

Next steps

Wire auth.gd into your main scene. Call is_licensed() before exposing gameplay. See the loader CLI reference for all flags.

Meridian — getnimbus.net