Crate roblox_slang 

Roblox Slang

Type-safe internationalization (i18n) for Roblox experiences.

Roblox Slang is a CLI tool and library that generates type-safe Luau code from translation files, enabling autocomplete and compile-time validation for game localization.

Features

• Type-safe translations: Generate Luau code with full autocomplete support
• Multiple input formats: JSON, YAML, and CSV
• Pluralization: CLDR-compliant plural rules for all languages
• String interpolation: Type-safe parameter substitution
• Roblox Cloud integration: Upload/download translations to Roblox Cloud
• Watch mode: Auto-rebuild on file changes
• Validation: Detect missing keys, conflicts, and coverage issues

Quick Start

# Initialize a new project
roblox-slang init

# Build translations
roblox-slang build

# Watch for changes
roblox-slang build --watch

Library Usage

use roblox_slang::{Config, parser, generator, config};
use std::path::Path;

// Load configuration
let cfg = config::load_config(Path::new("slang-roblox.yaml"))?;

// Parse translations
let translations = parser::json::parse_json_file(
    Path::new("translations/en.json"),
    "en"
)?;

// Generate Luau code
let luau_code = generator::luau::generate_luau(&translations, &cfg.base_locale)?;

Modules

• cli: Command-line interface implementation
• config: Configuration file parsing and validation
• generator: Luau code and CSV generation
• migrator: Migration from other i18n formats
• parser: Translation file parsing (JSON, YAML, CSV)
• utils: Utility functions (flattening, validation, etc.)
• validator: Translation validation and analysis

Re-exports

pub use config::Config;

pub use parser::types::Translation;

Modules

cli

CLI command implementations

config

Configuration management

generator

Code generation

migrator

Migration tools

parser

Translation file parsing

roblox

Roblox Cloud API integration module

utils

Utility functions

validator

Translation validation