Installation

Quick Install (PowerShell)

The fastest way to install on Windows - automatically detects your architecture (x64 or ARM64):

PowerShell

irm https://raw.githubusercontent.com/yanlvl99/lune-custom-build/main/installer/install.ps1 | iex

This will:

• Auto-detect x64 vs ARM64
• Download the latest release
• Install to %LOCALAPPDATA%\Lune
• Add to your PATH

Windows Installer (MSI)

Download the appropriate MSI for your architecture:

1. Download MSI

   Go to GitHub Releases and download:

   • x64 (Intel/AMD): lune-installer-x64.msi
   • ARM64 (Snapdragon/etc): lune-installer-arm64.msi

2. Run Installer

   Double-click the MSI file. Options available:

   • Install for all users (requires admin)
   • Install for current user only
   • Automatically adds to PATH

3. Verify Installation

   Open a new terminal and run:

   Terminal

   lune --version

Manual Installation

Android (Termux)

Run this one-liner to install everything automatically:

Termux

# 1. Install dependencies
pkg update && pkg install -y curl libc++ zlib

# 2. Download and install
curl -LO https://github.com/yanlvl99/lune-custom-build/releases/latest/download/lune-android-aarch64.tar.gz
tar -xzf lune-android-aarch64.tar.gz
mv lune $PREFIX/bin/
chmod +x $PREFIX/bin/lune

# 3. Configure library path (add to ~/.bashrc for persistence)
export LD_LIBRARY_PATH=$PREFIX/lib:$LD_LIBRARY_PATH
echo 'export LD_LIBRARY_PATH=$PREFIX/lib:$LD_LIBRARY_PATH' >> ~/.bashrc

# 4. Verify
lune --version

Android Limitations

The Android build does not include:

• Luau JIT - Native code generation is disabled (interpreter only)
• FFI module - Native library loading (@lune/ffi) is not available

All other modules work normally.

Linux (PC)

Terminal

# Download and extract
curl -LO https://github.com/yanlvl99/lune-custom-build/releases/latest/download/lune-linux-x86_64.tar.gz
tar -xzf lune-linux-x86_64.tar.gz

# Move to PATH
sudo mv lune /usr/local/bin/
chmod +x /usr/local/bin/lune

# Verify
lune --version

Windows (Manual)

1. Download lune-windows-x86_64.zip from Releases

2. Extract lune.exe to a folder (e.g., C:\Program Files\Lune)

3. Add to PATH:

   • Open Start → “Environment Variables”
   • Edit Path → Add the folder path
   • Click OK and restart terminal

macOS

Terminal

# Intel Mac
curl -LO https://github.com/yanlvl99/lune-custom-build/releases/latest/download/lune-macos-x86_64.tar.gz

# Apple Silicon (M1/M2/M3)
curl -LO https://github.com/yanlvl99/lune-custom-build/releases/latest/download/lune-macos-aarch64.tar.gz

# Extract and install
tar -xzf lune-macos-*.tar.gz
sudo mv lune /usr/local/bin/
chmod +x /usr/local/bin/lune

Using Rokit

Rokit is a toolchain manager for Roblox projects.

Terminal

rokit add yanlvl99/lune-custom-build@0.10.8

To upgrade:

Terminal

rokit update lune

Building from Source

Requires Rust installed:

Terminal

git clone https://github.com/yanlvl99/lune-custom-build
cd lune-custom-build
cargo build --release

The binary will be at target/release/lune (or lune.exe on Windows).

Next Steps

After installation, initialize your first project:

Terminal

lune --init

Continue reading in Command Line Usage to learn how to run scripts.