CLI commands

The elura binary is a project scaffolding tool. It never starts a server and does not modify existing files unless --force is supplied.

It is optional: Manual setup shows how to create a working Gateway and World directly from Rust source and JSON configuration.

General syntax

elura init <TARGET> [OPTIONS]

Common options:

Option	Meaning
-d, --dir <PATH>	Output directory; defaults to .
-f, --force	Overwrite generated paths that already exist
--dry-run	Show create/overwrite/conflict actions without writing
-h, --help	Show contextual help

Use elura help init <target> for target-specific help.

Targets

Target	Output
config	Runtime JSON, environment examples, and configuration notes
gateway	src/bin/gateway.rs
world	src/bin/world.rs
monolith	Monolith entry point, JSON config, and Compose file
module	A named World module skeleton
route	A typed Rust route plus protobuf definition
docker	Docker Compose files and environment example
k8s	Kubernetes/Kustomize base; kubernetes is an alias
all	Project manifest, config, Gateway, World, Docker, and Kubernetes

Generate a module

Names must start with a lowercase ASCII letter and contain only lowercase letters, digits, or underscores.

elura init module --name inventory --dir .

This creates src/world/inventory/mod.rs. Add the new module to the application’s module tree and install it with World::install (or Monolith::install).

Generate a route

Application route IDs start at 100. IDs 1 through 4 are reserved by the runtime, and the remainder below 100 is reserved for future protocol use.

elura init route \
  --module inventory \
  --name equip_item \
  --id 120 \
  --dir .

This creates:

proto/inventory/v2/equip_item.proto
src/world/inventory/equip_item.rs

The generator does not edit mod.rs or build.rs. The generated Rust file contains the route's Route implementation and registration function. Wire the new module into your application explicitly so route ownership remains reviewable.

Client SDKs

The CLI does not generate or install client SDKs. Rust, C++20, and C# / Unity SDKs are maintained in separate official GitHub repositories. See Client SDKs for repository links, installation, and transport behavior.

Safe regeneration

Use a dry run before updating generated infrastructure:

elura init k8s --dir . --dry-run

If files conflict, compare your customized versions with the current templates before using --force. Generated files are application code, not disposable build artifacts.