Registro de eventos

O ModuleScript ReplicatedStorage.RoMetricsEvents lista os eventos do seu jogo. O plugin lê e escreve nele; o SDK lê em runtime apenas para avisos com debug = true (um evento fora do registro ainda é enviado).

Ele é opcional, mas deixa o time alinhado: nomes padronizados, descrição de cada evento e funis documentados.

Formato

--!strict
-- Generated by the RoMetrics Studio plugin.
return {
	version = 1,
	events = {
		{
			name = "BossKilled",
			description = "Jogador derrota um chefe",
			kind = "custom",          -- "custom" | "funnel" | "progression" | "economy"
			trigger = "code",         -- "code" | "tag"
			props = {
				{ key = "boss", type = "string" }, -- "string" | "number" | "boolean"
			},
		},
		{
			name = "Tutorial",
			kind = "funnel",
			trigger = "code",
			steps = {
				{ name = "Spawned" },
				{ name = "OpenedShop", event = "ShopOpened" }, -- evento que leva a este passo (opcional)
			},
		},
	},
}

O que name significa em cada tipo

kind	name é	Chamada
custom	nome do evento	LogCustomEvent, track ou tags
funnel	nome do funil	LogFunnelStepEvent
progression	nome do caminho	LogProgressionEvent
economy	moeda	LogEconomyEvent

Regras

• name: ^[A-Za-z0-9_.:-]{1,64}$, único no registro (sem diferenciar maiúsculas).
• Chaves de props: ^[A-Za-z_][A-Za-z0-9_]{0,63}$.
• Passos de funil: nomes até 64 caracteres, únicos dentro do funil.

Pode editar à mão mantendo o formato. A aba Validação do plugin aponta erros, duplicados, eventos usados no código mas não registrados e tags órfãs.