Guccho

Overview

Guccho is a web-based service designed for interacting with private osu! servers, focusing on compatibility and ease of use.

System Requirements

• Node.js version 18 or higher.
• A compatible platform (details on supported platforms provided below).

Installation and Setup

• Configuration preparation is crucial:

  • Generate guccho.ui.config.ts based on guccho.ui.config.example.ts.
  • Create guccho.backend.config.ts using guccho.backend.config.example.ts as a template.
  • Edit the newly created configuration files as guided by the included comments.
  • If using env() or safeEnv(), set up a .env file using .env.example as a reference.

• Install dependencies:

  pnpm install

Tooling

For use with bancho.py or [email protected], ensure DB_DSN is set in your environment variables to enable Prisma/Drizzle tooling.

Supported Backends

• bancho.py (also known as gulag)
• ppy.sb

Production Deployment

• To build the application for production:

  pnpm build

• To start the production server:

  pnpm start:prod

• Further details on deployment can be found in the Nuxt.js deployment documentation.

Development Environment

• Launch the development server at http://localhost:3000:

  pnpm dev

Upcoming Features (To-Dos)

• Implement functionality to grant owner privileges to the first registered user.

Architecture Diagram

flowchart TB
    subgraph abstracted [Abstract]
        user(User) --- relation(Relationship)
        user --- score(Score)
        score --- beatmap
        leaderboard(Leaderboard) --- beatmap(Beatmap)
    end
    subgraph extendable [Extendable]
        status(Status)
        article(Article)
        log(Log)
        session(Session)
    end
    subgraph providers [Providers]
      extendable
      abstracted
    end
    subgraph impl [Implementations]
        ppy.sb(ppy.sb) === |extends| bancho.py
    end
    subgraph resource [Resources]
        mysql[(MySQL)]
        gulag[/Bancho.py Server/]
        redis[(Redis)]
        file[(File)]
        memory[/Memory/]
        env
    end
    subgraph server [Server]
      trpc-server(TRPC Server)
      providers
      impl
      bancho.py(Bancho.py) === |implements, extends| $base([Base])
    end
    subgraph pages [Pages]
      page-user(/user/:id)
      pages-other(/...)
    end
    subgraph client [Client]
      search(Search)
      trpc-client(TRPC Client)
      pages --- trpc-client
      pages --- client-session
      search --- trpc-client
      client-session(Client Session) --- trpc-client
    end
    A[Gamer] --> |Browser| pages

    trpc-client --> |superjson| trpc-server --> |devalue| trpc-client

    trpc-server === providers

    session --- user

    extendable ===== |$def| $base
    abstracted ===== |$active| impl

    ppy.sb --- |additional tables| mysql

    bancho.py --- |"gulag api(v1)"| gulag
    bancho.py --- |leaderboard| redis
    bancho.py --- mysql

    $base --- |session| redis
    $base --- |runtime, session| memory
    $base --- |log| file
    $base --- |reads| env

Loading

The team (Guccho)

• ppy.sb
• Guccho