{"id":51331669,"url":"https://github.com/isnanno/stellar-blade-mod-server","last_synced_at":"2026-07-01T23:05:01.892Z","repository":{"id":362422060,"uuid":"1258989506","full_name":"isnanno/stellar-blade-mod-server","owner":"isnanno","description":"API REST Node.js para catalogar e distribuir mods de Stellar Blade","archived":false,"fork":false,"pushed_at":"2026-07-01T21:00:16.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T21:27:25.000Z","etag":null,"topics":["express","mods","nodejs","rest-api","stellar-blade"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/isnanno.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-04T05:16:05.000Z","updated_at":"2026-07-01T21:00:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/isnanno/stellar-blade-mod-server","commit_stats":null,"previous_names":["isnanno/stelllarmods-api","isnanno/stellarmodsapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/isnanno/stellar-blade-mod-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isnanno%2Fstellar-blade-mod-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isnanno%2Fstellar-blade-mod-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isnanno%2Fstellar-blade-mod-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isnanno%2Fstellar-blade-mod-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/isnanno","download_url":"https://codeload.github.com/isnanno/stellar-blade-mod-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isnanno%2Fstellar-blade-mod-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35025993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["express","mods","nodejs","rest-api","stellar-blade"],"created_at":"2026-07-01T23:05:01.012Z","updated_at":"2026-07-01T23:05:01.878Z","avatar_url":"https://github.com/isnanno.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stellar Blade Mod Server\n\n[![Node.js](https://img.shields.io/badge/Node.js-Express-339933?logo=node.js\u0026logoColor=white)](server.js)\n[![API](https://img.shields.io/badge/API-REST-1F6FEB)](routes/)\n[![Stellar Blade](https://img.shields.io/badge/Stellar%20Blade-mod%20server-1a1a2e)](https://store.steampowered.com/app/3489700)\n\nServidor backend em Node.js para gerenciar e distribuir mods do jogo **Stellar Blade** via API REST. Alimenta um instalador automático em Python que lê os mods disponíveis e os instala na pasta correta do jogo.\n\n---\n\n## Funcionalidades\n\n- **API pública** — endpoint JSON consumido pelo instalador em Python\n- **Página pública** — vitrine visual dos mods disponíveis\n- **Painel de administração** — cadastro, edição e exclusão de mods com autenticação por senha\n- **Tratamento automático de dados** — barras invertidas (`\\`) convertidas para `/`, sufixo `MB` adicionado automaticamente ao peso\n- **Persistência em arquivo** — mods salvos em `mods.json`, sem banco de dados\n\n---\n\n## Stack\n\n| Camada | Tecnologia |\n|---|---|\n| Runtime | Node.js 18+ |\n| Framework | Express 4 |\n| Autenticação | Cookie de sessão (`cookie-parser`) |\n| Armazenamento | `mods.json` (arquivo local) |\n| Deploy | Square Cloud |\n\n---\n\n## Estrutura do projeto\n\n```\nstellar-blade-mod-server/\n├── index.js          # Servidor Express (rotas, lógica, HTML inline)\n├── mods.json         # Banco de dados dos mods (gerado automaticamente)\n├── package.json\n└── squarecloud.app   # Configuração de deploy na Square Cloud\n```\n\n---\n\n## Instalação local\n\n```bash\n# Clone o repositório\ngit clone https://github.com/seu-usuario/stellar-blade-mod-server.git\ncd stellar-blade-mod-server\n\n# Instale as dependências\nnpm install\n\n# Inicie o servidor\nnpm start\n```\n\nO servidor sobe em `http://localhost:3000`.\n\n---\n\n## Rotas\n\n### Públicas\n\n| Método | Rota | Descrição |\n|---|---|---|\n| `GET` | `/` | Página visual com todos os mods |\n| `GET` | `/api/mods` | JSON com todos os mods (consumido pelo instalador Python) |\n\n### Painel Admin (requer autenticação)\n\n| Método | Rota | Descrição |\n|---|---|---|\n| `GET` | `/admin` | Painel de gerenciamento |\n| `POST` | `/admin/login` | Autenticação por senha |\n| `GET` | `/admin/logout` | Encerra a sessão |\n| `POST` | `/admin/save` | Adiciona ou edita um mod |\n| `POST` | `/admin/remover` | Remove um mod pelo ID |\n\n---\n\n## Formato da API\n\n`GET /api/mods` retorna um array JSON:\n\n```json\n[\n  {\n    \"id\": \"0001\",\n    \"nome\": \"Outfit Eve - White\",\n    \"peso\": \"512 MB\",\n    \"destino\": \"SB/Content/Paks/~mods\",\n    \"link_download\": \"https://drive.google.com/uc?export=download\u0026id=...\"\n  }\n]\n```\n\n| Campo | Tipo | Descrição |\n|---|---|---|\n| `id` | string | Identificador único com 4 dígitos |\n| `nome` | string | Nome exibido no instalador |\n| `peso` | string | Tamanho do arquivo (ex: `512 MB`) |\n| `destino` | string | Caminho relativo à pasta raiz do jogo |\n| `link_download` | string | URL de download direto |\n\n\u003e **Destino:** Use `.` para instalar diretamente na raiz da pasta do jogo, ou um subcaminho relativo como `SB/Content/Paks/~mods`.\n\n---\n\n## Painel de Administração\n\nAcesse `/admin` e insira a senha definida em `ADMIN_PASSWORD` (variável de ambiente).\n\n### Cadastro de mod\n\n- **Nome** — nome do mod exibido no instalador\n- **Peso** — apenas o número (ex: `512`); o sufixo ` MB` é adicionado automaticamente\n- **Pasta de Destino** — caminho relativo; barras invertidas (`\\`) são convertidas para `/` automaticamente, então você pode colar caminhos do Windows diretamente\n- **Link de Download** — URL direta, preferencialmente do Google Drive (`uc?export=download\u0026id=...`)\n\n### Editar e excluir\n\nCada mod listado na tabela possui dois botões:\n\n- **Editar** — preenche o formulário com os dados existentes para edição\n- **Excluir** — remove o mod após confirmação\n\n---\n\n## Deploy na Square Cloud\n\n1. Certifique-se de que o `squarecloud.app` está configurado corretamente:\n\n```ini\nDISPLAY_NAME=Stellar Blade Mod Server\nDESCRIPTION=Servidor de mods para o instalador de Stellar Blade\nMAIN=index.js\nMEMORY=256\nVERSION=recommended\nSTART=node index.js\n```\n\n2. Gere o zip com os arquivos necessários:\n\n```\nindex.js\npackage.json\nmods.json\nsquarecloud.app\n```\n\n\u003e **Não inclua** a pasta `node_modules` — a Square Cloud instala as dependências automaticamente.\n\n3. Faça o upload do zip no painel da [Square Cloud](https://squarecloud.app).\n\n---\n\n## Variáveis de ambiente\n\n| Variável | Descrição |\n|----------|-----------|\n| `PORT` | Porta HTTP (padrão: `3000`) |\n| `ADMIN_PASSWORD` | Senha do painel `/admin` (**obrigatória**) |\n\nCopie `.env.example` para `.env` localmente ou configure os secrets no deploy (Square Cloud).\n\n```bash\nPORT=3000\nADMIN_PASSWORD=sua_senha_forte\n```\n\n\u003e **Importante:** nunca commite a senha no código. Rotacione a senha se ela já apareceu em versões antigas do repositório.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisnanno%2Fstellar-blade-mod-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisnanno%2Fstellar-blade-mod-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisnanno%2Fstellar-blade-mod-server/lists"}