Universo Platformo Godot

Implementation of Universo Platformo built on Godot Engine 4 and GDScript.

Overview

Universo Platformo Godot is a full-stack Godot 4 implementation of the Universo Platformo concept, providing a modular platform for metaverse applications, multiplayer experiences, and collaborative digital spaces. Both frontend and backend components are written in GDScript.

This project follows the architectural patterns of Universo Platformo React, adapted for the Godot engine ecosystem.

Key Features

• Full-Stack GDScript: Both client UI and backend server written in GDScript
• Backend-as-Proxy for Supabase: The frontend never calls Supabase directly; all authentication operations go through the built-in GDScript backend server
• Modular Package Architecture: Features organized in
  -frt
  (frontend) and
  -srv
  (backend) packages under the
  packages/
  directory
• Start Pages: Guest landing page (sign-in / sign-up) and authenticated welcome page, routing based on Supabase auth state via the
  AuthManager
  autoload
• Session Persistence: Auth session stored locally in
  user://session.json
• Bilingual Documentation: Complete documentation in English and Russian

Architecture

All Supabase access goes through the local backend server. The frontend (

[Frontend — start-frt]          [Backend — start-srv]        [Supabase Cloud]
  AuthManager autoload    →    BackendServer + AuthAPI   →   REST Auth API
  no SUPABASE_URL/KEY           holds SUPABASE_URL/KEY        (external)
  calls http://127.0.0.1:8080   proxies to Supabase

The backend starts as the

Project Structure

universo-platformo-godot/
├── packages/
│   ├── start-frt/base/          # Start page frontend
│   │   ├── scenes/              #   Guest and authenticated page scenes
│   │   └── scripts/             #   Page controller scripts
│   ├── start-srv/base/          # Start page backend
│   │   └── scripts/             #   HTTP server + Auth API proxy to Supabase
│   ├── clusters-frt/base/       # Clusters frontend (UI plugin stub)
│   └── clusters-srv/base/       # Clusters backend (logic plugin stub)
├── scenes/
│   └── main.tscn                # Main scene — auth-routing entry point
├── scripts/
│   └── autoload/
│       ├── config.gd            #   Reads .env and config.json
│       ├── database_manager.gd  #   Database interface (Supabase)
│       ├── network_manager.gd   #   Godot ENet multiplayer networking
│       ├── backend_server.gd    #   Starts local HTTP backend server
│       └── auth_manager.gd      #   Frontend auth state (calls backend)
├── .env.example                 # Environment variable template
├── config.json                  # Application feature configuration
└── project.godot                # Godot project configuration

Packages

start-frt — Start Page Frontend

Guest landing page with email/password sign-in and sign-up forms. Authenticated welcome page displaying user info and a sign-out button.

start-srv — Start Page Backend

Lightweight HTTP/1.1 server (

clusters-frt / clusters-srv — Clusters

Plugin stubs for the Clusters feature. Frontend manages cluster UI; backend handles cluster data and API. Full implementation is planned for a future iteration.

Technology Stack

Getting Started

Prerequisites

• Godot Engine 4.3+ (latest stable recommended)
• Git
• A Supabase project with authentication enabled

Installation

1. Clone the repository:

2. Copy the environment template and configure:

Edit

3. Open the project in Godot Editor:

Running

Press F5 in the Godot Editor, or run from the command line:

The application starts the backend HTTP server and the frontend start page. Without a configured

Project Status

• Repository structure and Godot project setup
• Core autoload system (Config, DatabaseManager, NetworkManager)
• Backend HTTP server (BackendServer, HTTPServer, AuthAPI)
• Supabase auth proxy (sign-in, sign-up, sign-out via backend)
• Frontend auth manager (routes all calls through backend only)
• Start page: guest landing with sign-in / sign-up form
• Start page: authenticated welcome with user info and sign-out
• Clusters package stubs (clusters-frt, clusters-srv)
• Clusters full implementation
• Metaverses, Spaces, Uniks packages
• Headless server-mode scene

Related Projects

• Universo Platformo React — React/Express reference implementation
• Documentation:
  docs.universo.pro
  (coming soon)

License

[License information to be added]

Community & Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Coming soon at
  docs.universo.pro