Skip to content

mnemoo/tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mnemoo Tools

A toolkit for analyzing game lookup tables (LUTs) with a Go backend and SvelteKit frontend.

Powered by Stake Engine. Respect whole Stake Engine team ❤️

Prerequisites

You must install these dependencies first - they are required to run the backend and frontend:

Dependency Version Download
Go 1.24+ go.dev/dl
Node.js 22+ nodejs.org
pnpm latest npm install -g pnpm
macOS installation
# Install Homebrew if not installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install go node
npm install -g pnpm
Windows installation
  1. Download and install Go
  2. Download and install Node.js
  3. Open terminal and run: npm install -g pnpm
Linux (Ubuntu/Debian) installation
# Install Go
sudo apt update && sudo apt install golang-go

# Install Node.js (via NodeSource)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Install pnpm
npm install -g pnpm

Quick Start

Option 1: Use the Launcher (Recommended)

  1. Clone the repository:

    git clone https://github.com/mnemoo/tools.git
    cd tools
  2. Run the launcher:

    cd launcher
    go run .

The Launcher GUI will:

  • Check and show missing dependencies
  • Let you select the index.json file
  • Start/stop backend and frontend with one click
  • Open the app in your browser

Option 2: Download Pre-built Launcher

If you already have Go, Node.js, and pnpm installed, download the launcher binary from Releases:

  • mtools-launcher-darwin-arm64 - macOS Apple Silicon
  • mtools-launcher-linux-amd64 - Linux x64
  • mtools-launcher-linux-arm64 - Linux ARM64
  • mtools-launcher-windows-amd64.exe - Windows x64
  • mtools-launcher-windows-arm64.exe - Windows ARM64

Note: The launcher is just a GUI - it still requires Go and Node.js to compile and run the backend/frontend. You also need to clone/download the repository and place the launcher binary in the root folder.


Manual Setup

Run backend and frontend separately

Start Backend

cd backend
go run ./cmd -index /path/to/your/index.json

Backend runs on:

Start Frontend

cd frontend
pnpm install
pnpm dev --port 7750

Frontend runs on http://localhost:7750

Project Structure

mtools/
├── backend/          # Go API server
├── frontend/         # SvelteKit web application
├── launcher/         # Desktop launcher (Fyne GUI)
└── stakergs/         # Shared Go library

Documentation