{"id":17879529,"url":"https://github.com/joaovl5/the-normal-project","last_synced_at":"2026-02-04T09:03:06.832Z","repository":{"id":259675908,"uuid":"879179169","full_name":"joaovl5/the-normal-project","owner":"joaovl5","description":"⚔️ A custom Authentication system and Launcher for offline Minecraft Java Servers ⚔️","archived":false,"fork":false,"pushed_at":"2024-10-27T08:12:23.000Z","size":8895,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T22:25:58.933Z","etag":null,"topics":["authentication","discord-bot","fastapi","forge","kotlin","minecraft","minecraft-java","minecraft-launcher","oauth","offline-mode","papermc","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joaovl5.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-10-27T08:01:21.000Z","updated_at":"2024-12-09T08:46:15.000Z","dependencies_parsed_at":"2024-10-27T09:36:34.022Z","dependency_job_id":null,"html_url":"https://github.com/joaovl5/the-normal-project","commit_stats":null,"previous_names":["joaovl5/the-normal-project"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/joaovl5/the-normal-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovl5%2Fthe-normal-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovl5%2Fthe-normal-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovl5%2Fthe-normal-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovl5%2Fthe-normal-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joaovl5","download_url":"https://codeload.github.com/joaovl5/the-normal-project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joaovl5%2Fthe-normal-project/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265711039,"owners_count":23815461,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["authentication","discord-bot","fastapi","forge","kotlin","minecraft","minecraft-java","minecraft-launcher","oauth","offline-mode","papermc","python"],"created_at":"2024-10-28T12:04:54.824Z","updated_at":"2026-02-04T09:03:01.772Z","avatar_url":"https://github.com/joaovl5.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎮 The Normal Project\n\n\u003cdiv align=\"center\"\u003e\n\n![License](https://img.shields.io/badge/license-unlicense-blue.svg)\n![Discord](https://img.shields.io/badge/discord-integrated-7289DA)\n![Minecraft](https://img.shields.io/badge/minecraft-1.19.2-brightgreen)\n\n_A comprehensive authentication ecosystem for Minecraft servers, powered by Discord OAuth2_\n\n[Features](#-features) • [Architecture](#-architecture) • [Installation](#-installation) • [Components](#-components) • [Flow](#-authentication-flow)\n\n\u003c/div\u003e\n\n## 🌟 Features\n\n- **Seamless Authentication** via Discord OAuth2\n- **Auto-updating System** for both launcher and modpacks\n- **Achievement Tracking** with points and rewards\n- **Cross-platform Support** for Windows, macOS, and Linux\n- **Anti-alt Account System** through Discord account linking\n- **Rich Discord Integration** with stats and commands\n\n## 🏗️ Architecture\n\nThe project consists of six main components working in harmony:\n\n### 🚀 Launcher\n\n- **Tech Stack**: Electron, Vue.js, Python\n- **Features**:\n  - Achievement display\n  - Points tracking\n  - Event announcements\n  - Newsletter updates\n  - Auto-updating system\n\n### 💾 Installer\n\n- **Tech Stack**: Python, Tkinter\n- **Purpose**: Streamlined launcher deployment\n- **Features**: One-click installation\n\n### 🌐 Hub\n\n- **Tech Stack**: Python, FastAPI, MongoDB\n- **Role**: Central authentication service\n- **Features**:\n  - OAuth2 handling\n  - Token management\n  - User data storage\n  - API endpoints\n\n### 🤖 Discord Bot\n\n- **Tech Stack**: Python, Interactions\n- **Features**:\n  - Player statistics\n  - Admin controls\n  - Modpack management\n  - Update broadcasting\n\n### 🔌 Client Mod\n\n- **Tech Stack**: Java, Forge\n- **Purpose**: Authentication bridge\n- **Features**: Secure token handling\n\n### 🛡️ Server Plugin\n\n- **Tech Stack**: Kotlin, PaperMC\n- **Purpose**: Server-side verification\n- **Features**: Token validation\n\n## 📁 Project Structure\n\n```\nnormal-project/\n├── minecraft/           # Java/Kotlin projects\n│   ├── mod/     # Forge client mod\n│   └── plugin/  # PaperMC plugin\n├── installer/          # Python installer\n├── launcher/           # Electron application\n├── hub/                # Backend services\n```\n\n## 🔒 Authentication Flow\n\n```mermaid\nsequenceDiagram\n    participant User\n    participant Launcher\n    participant Discord\n    participant Hub\n    participant Minecraft\n    participant Server\n\n    User-\u003e\u003eLauncher: Launch Game\n    Launcher-\u003e\u003eDiscord: OAuth2 Request\n    Discord--\u003e\u003eHub: Authorization Code\n    Hub--\u003e\u003eLauncher: Auth Token\n    Launcher-\u003e\u003eMinecraft: Start with -Dcode\n    Minecraft-\u003e\u003eServer: Hidden /login\n    Server--\u003e\u003eHub: Validate Token\n    Server-\u003e\u003eUser: Allow Connection\n```\n\n1. 🎮 User initiates login through launcher\n2. 🔑 Discord OAuth2 flow begins\n3. 🌐 Hub processes authentication\n4. 🎯 Launcher receives auth token\n5. ⚡ Minecraft starts with custom flag\n6. 🔒 Server validates and allows connection\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with for the \"Isso é Normal?\" Minecraft community**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaovl5%2Fthe-normal-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoaovl5%2Fthe-normal-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoaovl5%2Fthe-normal-project/lists"}