Setting Up Your Lua Development Environment

Part 1: Installing the Lua Interpreter

First, we need to install the Lua interpreter on your computer. While Factorio has its own Lua interpreter built-in, having a separate, "standalone" one is essential for learning and testing code quickly without needing to launch the game.

We will be following a video guide for this process. It walks through every step visually, which is very helpful. I'll provide a summary of the steps for you to follow along.

1.1: Download and Prepare Lua

Our first task is to download the pre-compiled Lua files for Windows and place them in an easy-to-find location.

1.2: Tell Windows Where to Find Lua

Now that Lua is on your computer, we need to tell Windows where to find it. We do this by editing the PATH environment variable. The PATH is just a list of directories that Windows automatically checks when you type a command into the terminal. By adding C:\Lua to this list, we can run Lua from any folder on our computer.

1.3: Verify Your Installation

Let's make sure everything worked.

1. Open a new Windows Terminal or Command Prompt.
2. Type lua -v and press Enter.

You should see a message confirming the Lua version, something like Lua 5.3.5. This proves that Windows can find and run the interpreter.

You can also start Lua's interactive mode by just typing lua and pressing Enter. You'll see a > prompt. This is called a REPL (Read-Eval-Print Loop), and it's useful for testing small snippets of code. Try typing print("Hello, Lua!") and press Enter. To exit the REPL, type os.exit() and press Enter.

Part 2: Setting Up Your Code Editor

While you could write Lua code in Notepad, a proper code editor gives you "superpowers" like syntax highlighting (making code colorful and easy to read) and error checking. We'll use Visual Studio Code (VS Code), which is the top choice for many programmers, including Factorio modders.

2.1: Install Visual Studio Code and an Extension

First, let's get VS Code installed and add an extension specifically for Lua. Extensions add extra functionality to the editor.

Here is what the extension looks like in the VS Code marketplace:

2.2: Configure VS Code to Run Lua Scripts

This is the final and most important step. We will create a special configuration file that tells VS Code how to use the Lua interpreter we installed earlier to run our scripts. This will allow us to run any Lua file by simply pressing a keyboard shortcut.

When the video prompts you to paste code into the tasks.json file, use the code block below. It's a slightly improved version of the one in the video.

First, check the name of your Lua executable file inside your C:\Lua folder. It will likely be lua53.exe or lua54.exe. Make sure the "command" line in the code below matches that filename exactly.

{
    // This file tells VS Code how to "build" or run our code.
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run Current Lua File",
            "type": "shell",
            // IMPORTANT: Change "lua53" to "lua54" or whatever your .exe is named!
            "command": "lua53",
            "args": [
                "${file}" // This tells the command to run the currently open file.
            ],
            "group": {
                "kind": "build",
                "isDefault": true // This makes it the default build task.
            },
            "presentation": {
                "clear": true // Clears the terminal before each run.
            }
        }
    ]
}

Copy the code above and paste it into your tasks.json file in VS Code, replacing everything that was there. Save the file.

Putting It All Together

You've done it! Your professional Lua development environment is ready. Let's do a final test.

1. In VS Code, make sure you have a Lua file open (e.g., myscript.lua).
2. If the file is empty, add the line: print("My Lua setup is working!")
3. Press Ctrl+Shift+B (or go to Terminal > Run Build Task...).

You should see a terminal window pop up at the bottom of VS Code, and your message My Lua setup is working! should be printed there.

Conclusion

Congratulations on completing your first lesson! It was a very practical one, but absolutely essential. You have now:

• Installed the standard Lua interpreter.
• Configured your system PATH so you can run Lua from anywhere.
• Installed and configured Visual Studio Code, a professional code editor.
• Created a build task to run your Lua scripts with a simple keyboard shortcut.

You are now fully equipped to start programming. All the foundational work is done.

Preview of the next lesson: In our next session, we'll dive into the code. You will write and run your first simple Lua script, learn how to print text to the console, and get acquainted with variables—the most basic building blocks for storing information in any program.