Ludus Range Configuration

Use this skill to build safe, valid Ludus YAML configurations and explain tradeoffs in topology, networking, and role design.

Key Principles

1. Always suggest the YAML schema validation header at the top of configs:

   # yaml-language-server: $schema=https://docs.ludus.cloud/schemas/range-config.json
   

2. Use {{ range_id }} template strings in vm_name and hostname fields. This resolves to the user's range ID (e.g., "JS").

3. Windows hostnames are limited to 15 characters due to NETBIOS.

4. VLANs must be 2-255 and become the third octet of the VM's IP (e.g., vlan 10 = 10.X.10.Y).

5. ip_last_octet must be unique within a VLAN.