|
1 | | - |
| 1 | + |
2 | 2 |
|
| 3 | +# Gml.Backend |
3 | 4 |
|
4 | | - |
5 | | - |
6 | | - |
7 | | - |
| 5 | +Gml.Backend is a comprehensive project designed to facilitate rapid deployment of server infrastructure for Minecraft game profiles, including Forge, Fabric, and LiteLoader. This product suite encompasses three integral services: |
8 | 6 |
|
9 | | -# Gml.Backend |
| 7 | +- **Gml.Web.Api**: A RESTful API that provides an interface for interaction with server data. |
| 8 | +- **Gml.Web.Client**: Commonly referred to as the Monitoring Dashboard, this component offers a user-friendly interface for monitoring and administrating game profiles and the launcher. |
| 9 | +- **Gml.Web.Skin.Service**: A service dedicated to the management of textures, allowing for customization and personalization for each player. |
10 | 10 |
|
11 | | -Gml.Backend is a comprehensive project, designed to facilitate rapid deployment of server infrastructure for Minecraft game profiles: Forge, Fabric, LiteLoader. |
12 | | -This product suite encompasses three integral services: |
| 11 | +Together, these services offer a robust foundation for managing Minecraft game profiles with mods. |
13 | 12 |
|
14 | | -[Gml.Web.Api:](https://github.com/Gml-Launcher/Gml.Web.Api) This is a RESTful API that provides an interface for interaction with server data. |
| 13 | +## Documentation |
| 14 | +- [Official Website](https://gml.recloud.tech) |
| 15 | +- [Official Documentation](https://wiki.recloud.tech) |
| 16 | +- [Wiki Mirror](https://gml-launcher.github.io/Gml.Docs) |
15 | 17 |
|
16 | | -[Gml.Web.Client:](https://github.com/Scondic/Gml.Web.Client) Commonly referred to as the Monitoring Dashboard, this component offers a user-friendly interface for monitoring and administrating game profiles and the launcher. |
| 18 | +## Installation Instructions |
17 | 19 |
|
18 | | -[Gml.Web.Skin.Service:](https://github.com/Gml-Launcher/Gml.Web.Skin.Service) This service is specifically dedicated to the management of textures, allowing for customization and personalization for each player. |
| 20 | +### Step 1: Clone the Repository |
| 21 | +Clone the stable version of the repository using the following command: |
19 | 22 |
|
20 | | -Together, these services offer a robust foundation for managing Minecraft game profiles with mods. |
| 23 | +```bash |
| 24 | +git clone --recursive https://github.com/GamerVII-NET/Gml.Backend.git |
| 25 | +``` |
| 26 | + |
| 27 | +### Step 2: Navigate to the Project Directory |
| 28 | +Move to the project directory: |
| 29 | + |
| 30 | +```bash |
| 31 | +cd Gml.Backend |
| 32 | +``` |
| 33 | + |
| 34 | +### Step 3: Configure the `.env` File |
| 35 | +Create or edit the `.env` file in the root of the `Gml.Backend` directory. Below is an example configuration: |
| 36 | + |
| 37 | +```plaintext |
| 38 | +# User and Group Identifiers for Linux |
| 39 | +UID=0 |
| 40 | +GID=0 |
| 41 | +
|
| 42 | +# Security key (replace with your own secure key) |
| 43 | +SECURITY_KEY=643866c80c46c909332b30600d3265803a3807286d6eb7c0d2e164877c809519 |
| 44 | +
|
| 45 | +# Project settings |
| 46 | +PROJECT_NAME=GmlBackendPanel |
| 47 | +PROJECT_DESCRIPTION= |
| 48 | +PROJECT_POLICYNAME=GmlServerPolicy |
| 49 | +PROJECT_PATH= |
| 50 | +
|
| 51 | +# S3 Configuration |
| 52 | +S3_ENABLED=true |
| 53 | +MINIO_ROOT_USER=GamerVII |
| 54 | +MINIO_ROOT_PASSWORD=waefawegferyjerthdrthrtrdthdr |
| 55 | +
|
| 56 | +# External Access Settings |
| 57 | +MINIO_ADDRESS=:5009 |
| 58 | +MINIO_ADDRESS_PORT=5009 |
| 59 | +MINIO_CONSOLE_ADDRESS=:5010 |
| 60 | +MINIO_CONSOLE_ADDRESS_PORT=5010 |
| 61 | +PORT_GML_BACKEND=5000 |
| 62 | +PORT_GML_FRONTEND=5003 |
| 63 | +PORT_GML_FILES=5005 |
| 64 | +PORT_GML_SKINS=5006 |
| 65 | +
|
| 66 | +# Microservices |
| 67 | +SERVICE_TEXTURE_ENDPOINT=http://gml-web-skins:8085 |
| 68 | +``` |
| 69 | + |
| 70 | +### Step 4: Configure the Client `.env` File |
| 71 | +Create or edit the `.env` file in the `src/Gml.Web.Client/` directory: |
| 72 | + |
| 73 | +```plaintext |
| 74 | +# Web API address |
| 75 | +NEXT_PUBLIC_BACKEND_URL=http://localhost:5000/api/v1 |
| 76 | +``` |
| 77 | + |
| 78 | +### Step 5: Launch the Project with Docker |
| 79 | +Ensure Docker is installed and running on your system. Then, execute the following command to build and start the project: |
| 80 | + |
| 81 | +```bash |
| 82 | +docker compose up -d --build |
| 83 | +``` |
21 | 84 |
|
22 | | -# Documentation |
23 | | -[Official Website](https://gml.recloud.tech) |
| 85 | +Docker will download the necessary images and launch the project. Once the containers are running, you can access the services in your browser at the following addresses: |
24 | 86 |
|
25 | | -[Official documentation](https://wiki.recloud.tech) |
| 87 | +## Infrastructure |
| 88 | +> **Note**: Starting from version `0.1.0-rc1`, server files are stored in the installation directory. [Learn more](#). |
26 | 89 |
|
27 | | -[Wiki mirror](https://gml-launcher.github.io/Gml.Docs/home.html) |
| 90 | +### Server Infrastructure |
| 91 | +- **Web API**: `http://localhost:5000` (Main service) |
| 92 | +- **Web Dashboard**: `http://localhost:5003` (Requires registration) |
| 93 | +- **Gml.Web.Skin.Service**: `http://localhost:5006` (Accessible only within the container) |
28 | 94 |
|
| 95 | +## Important Notes |
| 96 | +- **FileBrowser** has been removed starting from version `0.1.0-rc1`. [Details](#). |
| 97 | +- **Minio** has been removed starting from version `1.0.3`. [Details](#). |
| 98 | +- Ensure the `.env` files are correctly configured before launching the project. Update the configurations as needed based on your requirements. |
0 commit comments