Introduction

Zircon is an advanced debugging console for Roblox games, built with TypeScript.

Features

• Zirconium Language Scripting

  Zircon comes inbuilt with a runtime scripting language called Zirconium. This allows you to run scripts against your game during runtime.

  More information on how to set this up, will come when Zircon is closer to being production-ready.

  Supports:

  • Functions Using ZirconServer.Registry.RegisterFunction + ZirconFunctionBuilder
  • Namespaces Using ZirconServer.Registry.RegisterNamespace + ZirconNamespaceBuilder
  • Enums Using ZirconServer.Registry.RegisterEnum + ZirconEnumBuilder

• Structured Logging

  If you want logging for Zircon, you will need to install @rbxts/log.

  Then to use Zircon with Log, you simply do

  import Log from "@rbxts/log";import Log, { Logger } from "@rbxts/log";import Zircon from "@rbxts/zircon";
  Log.SetLogger(    Logger.configure()        // ... Any other configurations/enrichers go here.        .WriteTo(Zircon.Log.Console()) // This will emit any `Log` messages to the Zircon console        .Create() // Creates the logger from the configuration);

  This will need to be done on both the client and server to achieve full logging.

  All logging done through this can be filtered through the console itself. That's the power of structured logging! ;-)

Registering and using Zircon Commands

Below is an example of how to register a command in Zircon:

import { ZirconServer, ZirconFunctionBuilder } from "@rbxts/zircon";import Log from "@rbxts/log";
ZirconServer.Registry.RegisterFunction(    new ZirconFunctionBuilder("print_message")        .AddArguments("string")        .Bind((context, message) => Log.Info(                "Zircon says {Message} from {Player}",                 message,                context.GetExecutor()        )),    [ZirconServer.Registry.User])

This will create a global print_message that all players can run.

Then if run in Zircon:

The first argument of RegisterFunction takes a ZirconFunctionBuilder - which is the easiest way to build a function. AddArguments takes any number of arguments for types you want, in built types in Zircon you can use a string for. Otherwise you supply the type validator object.