LogicForge

LogicForge is an extensible visual programming template designed to bridge the gap between high-level logic design and game execution. It provides a structured interface where users can create sequences of command blocks to control game entities and interact with the world.

Unlike traditional "visual scripting" tools that aim to replace coding entirely, LogicForge is a visual representation of command-based execution. It acts as a high-level wrapper for your existing code, making it perfect for AI behavior, quest systems, or educational mechanics.

🚀 Key Features

  • Extensible Architecture: Designed from the ground up to be customized. Create your own blocks and logic categories in minutes.
  • Visual-to-Code Philosophy: Every block is a direct representation of a command or instruction you've defined in code.
  • Modular Implementation: The logic editor is decoupled from the game world, allowing you to swap implementations easily.
  • Intuitive UI: A clean, drag-and-drop interface for arranging commands, conditions, and loops.

🎮 The "Adventurer" Example

The package comes with a built-in demo scenario to showcase the system's capabilities. In this example, you must guide a character through a level using logic blocks:

  • Navigation: Commands for basic movement (Walk, Turn).
  • Perception: Logic blocks to detect obstacles and avoid enemies.
  • Collection: Instructions to identify and pick up items.
  • Goal Orientation: Sequences designed to navigate the character to the final objective.

🛠 How It Works

LogicForge follows a simple Define -> Sequence -> Execute workflow:

  1. Define: Developers create a command class that inherits from the LogicForge base.
  2. Sequence: The user (or designer) arranges these blocks in the visual editor.
  3. Execute: The engine parses the visual tree and triggers the corresponding logic in the game world.

Creating a Custom Command

Because LogicForge is built for extensibility, adding new functionality is straightforward:

// Example of a custom command implementation
public class JumpCommand : BaseCommand 
{
    public override void Execute() 
    {
        // Implement your code here.
    }
}

📦 Getting Started

  1. Import: Drop the LogicForge folder into your project.
  2. Explore: Open the ExampleScene to see the "Adventurer" logic in action.
  3. Extend: Check the Documentation/Extending folder to learn how to create your own custom nodes.

📄 Documentation

You can find the documentation on https://vitorfgd.github.io/LogicForge/api