-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Didn't translate protocol/p2p because it contains a lot of technical information so I prefer avoiding any translation mistakes
- Loading branch information
1 parent
ae457b0
commit 81c2424
Showing
16 changed files
with
841 additions
and
101 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
> Rédaction en cours |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
# Guide d'apparence | ||
|
||
> Rédaction en cours | ||
## Palette de couleurs et Thèmes | ||
|
||
XMCL prend en charge les couleurs personnalisées, notamment : | ||
|
||
- Couleur de la carte | ||
- Couleur de la barre supérieure | ||
- Couleur de la barre latérale | ||
- Couleur de l'arrière plan | ||
- Couleur de surbrillance des composants de base | ||
- Couleur d'erreur | ||
|
||
XMCL a aussi 2 schémas de couleurs par défaut : `Light mode` (mode clair) et `Dark mode` (mode sombre). | ||
|
||
:::tip | ||
Les couleurs du mode sombre et du mode clair sont stockées séparément dans chaque mode, et le changement de mode changera la palette de couleurs globale. | ||
::: | ||
|
||
## Effets d'arrière-plan | ||
|
||
Les arrière-plans XMCL prennent en charge les paramètres suivants : | ||
|
||
- Image | ||
- Vidéo | ||
- Effets de particules | ||
|
||
:::warning Remarque | ||
Le launcher n'enregistrera que le chemin du fichier de la vidéo d'arrière-plan. Si la vidéo est déplacée après la sélection, le paramètre d'arrière-plan sera invalide. | ||
|
||
Ce n'est pas un problème avec les images, car les données d'image sont stockées. | ||
::: |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,49 @@ | ||
# Guide d'installation | ||
|
||
Le launcher fournit plusieurs formats d'installation, dont certains sont moins courants. Ici, nous nous concentrerons sur l'introduction des fonctionnalités de format **moins courantes** ou **spéciales**. | ||
|
||
## APPX | ||
|
||
APPX est un format de **package d'installation** fourni par Windows 10 qui permet aux programmes de s'exécuter dans un environnement virtualisé/sandbox. Les programmes installés via APPX s'exécuteront tous dans le bac à sable Windows. | ||
|
||
Le plus grand avantage pour les utilisateurs est que les fichiers cache de l'application, les modifications du registre et les autres opérations seront isolées - lorsque vous désinstallez l'application, le cache et les modifications du registre seront supprimés aussi. | ||
|
||
:::info Bonne nouvelle | ||
Ne vous inquiétez pas si le programme modifie le registre, étant donné que le seul ajout au registre par XMCL puisse être l'association d'extension de fichier. | ||
::: | ||
|
||
AppX est mis à jour via le mécanisme appinstaller. Selon la stratégie de [mise à jour automatique](https://learn.microsoft.com/fr-fr/windows/msix/app-installer/auto-update-and-repair--overview#automatic-updates) intégrée à appinstaller, XMCL vérifie les mises à jour lorsque l'utilisateur **lance l'application**, et s'il y a une mise à jour, elle sera mise à jour au prochain lancement. | ||
|
||
:::tip Bonne nouvelle | ||
Les mises à jour automatiques d'APPX prennent en charge la **livraison d'optimisation** et les **mises à jour incrémentielles** de Windows - ne mettant à jour que le contenu modifié. | ||
::: | ||
|
||
## Installation en ligne (appinstaller) | ||
|
||
`appinstaller` est essentiellement le même que le format `APPX`. `appinstaller` lui-même est un fichier texte `XML` qui contient l'`URL` de `APPX`. Lorsque l'interface d'installation s'affiche, elle tente de télécharger `APPX` et de l'installer. Par conséquent, son mécanisme de mise à jour est le même que APPX. | ||
|
||
## AppImage | ||
|
||
AppImage est un format d'application Linux qui peut s'exécuter sur n'importe quel bureau Linux sans installation. Le fichier AppImage est exécutable, il suffit de double-cliquer ou de l'exécuter depuis le terminal. | ||
|
||
C'est le seul programme de non-installation fourni par XMCL (~~en fait, je ne veux pas le supporter~~). Par conséquent, son mécanisme de mise à jour est différent des autres formats et les utilisateurs doivent télécharger eux-mêmes une nouvelle AppImage pour effectuer la mise à jour. | ||
|
||
## Autres formats | ||
|
||
Actuellement, d'autres formats d'installation prennent en charge les [mises à jour à chaud] ou prennent en charge la méthode de mise à jour fournie par electron-builder. Ce mode de mise à jour ne nécessite généralement pas trop d'attention (~~si vous ne pouvez pas mettre à jour, vous pouvez simplement télécharger à nouveau le launcher~~). | ||
|
||
:::tip Hot update | ||
Une mise à jour "Hot update" signifie que le launcher remplace le fichier asar principal (~30Mo) par lui-même, sans avoir besoin d'un nouveau téléchargement complet du launcher. | ||
::: | ||
|
||
## Annexe : Choisir le répertoire des données du jeu | ||
|
||
Lors de l'installation initiale, les utilisateurs doivent choisir le `Game Data Directory`. XMCL placera les `assets` téléchargées, les `libraries`, les `versions`, etc. dans ce répertoire. | ||
|
||
:::warning Remarque | ||
Comme mentionné sur la page de configuration, en raison de la structure de fichier spéciale de XMCL, il n'est pas recommandé d'utiliser le répertoire de jeu **raw** Minecraft comme répertoire de données de XMCL. | ||
::: | ||
|
||
Ici, il est recommandé de choisir un nouveau dossier comme `Game Data Directory` de XMCL. | ||
|
||
Pour plus d'informations sur la structure du répertoire des données du jeu, veuillez consulter le [Guide de gestion des données](/fr/guide/manage.md#minecraft-related-data). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,53 @@ | ||
# Stockage de données | ||
|
||
Les données XMCL sont divisées en deux parties : | ||
|
||
1. XMCL en tant que cache et base de données générée par chromium | ||
2. Données liées à Minecraft | ||
|
||
## Cache et base de données XMCL | ||
|
||
Le cache lié à XMCL lui-même est stocké dans le chemin d'accès système appdata, qui est différent sur différentes plates-formes. | ||
|
||
::: code-group | ||
```cmd[Windows] | ||
%AppData%\xmcl | ||
``` | ||
```cmd [Windows (APPX/appinstaller)] | ||
%LocalAppData%\Packages\XMCL_ncdvebj03zfcm\LocalCache\Roaming\xmcl | ||
# Version >= 0.34 | ||
%LocalAppData%\Packages\XMCL_68mcaawk44tpj\LocalCache\Roaming\xmcl | ||
``` | ||
```sh [macOS] | ||
~/Library/Application Support/xmcl | ||
``` | ||
```sh [Linux] | ||
~/.config/xmcl | ||
``` | ||
::: | ||
|
||
:::warning Remarque | ||
Ne supprimez pas les fichiers ici à moins que vous ne sachiez ce que vous faites. | ||
::: | ||
|
||
Vous trouverez ici quelques fichiers "json" utilisés pour stocker diverses configurations, et la base de données sera également stockée ici. | ||
|
||
- [Données utilisateur](../protocol/user.md). Stocke les comptes des utilisateurs, les liens de skin, etc. Stocké dans le fichier `/user.json`. | ||
- [Paramètres globaux](../protocol/setting.md). Paramètres globaux, tels que la langue, l'URL du proxy, le node de téléchargement, etc. Stockés dans le fichier `/settings.json`. | ||
- [Cache d'instance](../protocol/instance.md). Enregistre le dernier chemin d'instance sélectionné et les chemins de toutes les instances connues. Stocké dans le fichier `/instances.json`. | ||
- [Cache Java](../protocole/java.md). Enregistre les chemins Java détectés, les informations de version, etc. Stocké dans le fichier `/java.json`. | ||
- [Base de données des ressources](../protocol/resources.md). Métadonnées pour les fichiers de ressources, telles que les informations de mod analysés. Stocké au format `leveldb`, dans le dossier `/resources-v2`. | ||
- [Journaux](../protocol/logs.md). Journaux historiques XMCL. Stocké dans le dossier `/logs`. | ||
|
||
## Données liées à Minecraft | ||
|
||
Je pense que vous connaissez très bien la structure des répertoires des données Minecraft. | ||
Le répertoire de données de XMCL est légèrement différent de celui de Minecraft : | ||
|
||
<script setup> | ||
import CentraProjectTree from '../../../src/components/CentraProjectTree.vue' | ||
</script> | ||
|
||
<CentraProjectTree /> | ||
|
||
La plupart du contenu est en fait le même que Minecraft, parmi lesquels le dossier `instances` contient tous les fichiers d'instance. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
# Package d'intégration | ||
|
||
## Importer le package d'intégration | ||
|
||
## Exporter le package d'intégration |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
# Guide multijoueur | ||
|
||
> Rédaction en cours | ||
## Démarrage rapide | ||
|
||
Accédez à la page `Multijoueur sur LAN`. | ||
|
||
![](../../assets/multiplayer.jpg) | ||
|
||
Cliquez sur le bouton `Rejoindre/Créer un groupe` en haut à droite. | ||
|
||
![](../../assets/multiplayer-join.jpg) | ||
|
||
Vous pouvez créer un groupe si votre connexion Internet est bonne. Cliquez sur `Group ID` pour le copier. | ||
|
||
![](../../assets/multiplayer-joined.jpg) | ||
|
||
Votre pair doit saisir cet "identifiant de groupe" pour rejoindre votre groupe. Une fois qu'il s'est inscrit, vous devriez voir son statut de connexion ci-dessous. | ||
|
||
![](../../assets/multiplayer-connected.jpg) | ||
|
||
Ensuite, vous devez démarrer le jeu et ouvrir le jeu sur LAN, et votre ami devrait voir votre jeu même si vous n'êtes pas dans le même LAN. | ||
|
||
![](../../assets/multiplayer-lan.jpg) | ||
|
||
## Comment utiliser les services de transfert | ||
|
||
> Rédaction en cours | ||
## Skins hors ligne | ||
|
||
> Rédaction en cours |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,51 @@ | ||
# Guide de mise à jour | ||
|
||
> Rédaction en cours | ||
Comme le launcher est encore au stade `beta`, la sauvegarde des données est particulièrement importante... Ici, nous allons vous présenter comment résoudre les problèmes rencontrés lors des mises à jour et comment effectuer une sauvegarde si vous souhaitez réinstaller. | ||
|
||
## La mise à jour APPX nécessite une réinstallation | ||
|
||
Étant donné que l'ancien launcher de version du format `APPX` a des certificats expirés, lors de la mise à niveau de l'ancienne version vers la nouvelle version, il faudra désinstaller l'ancienne version. Dans ce cas, veuillez sauvegarder votre dossier de données XMCL. | ||
|
||
Supposons que `foo` soit votre nom d'utilisateur : | ||
|
||
::: code-group | ||
```[Windows (APPX)] | ||
%LocalAppData%\Packages\XMCL_ncdvebj03zfcm\LocalCache\Roaming\xmcl | ||
``` | ||
::: | ||
|
||
Vous pouvez le copier et le mettre sur le bureau. Après la réinstallation, la nouvelle version de XMCL devrait avoir le chemin de fichier suivant : | ||
|
||
::: code-group | ||
```[Windows (APPX)] | ||
%LocalAppData%\Packages\XMCL_68mcaawk44tpj\LocalCache\Roaming\xmcl | ||
``` | ||
::: | ||
|
||
Remettez simplement vos fichiers de sauvegarde. | ||
|
||
## Échec de la mise à jour APPX | ||
|
||
La mise à jour APPX devrait également ouvrir un dossier contenant un fichier `xmcl.appinstaller` téléchargé. Vous pouvez double-cliquer manuellement sur ce fichier pour installer la mise à jour. | ||
|
||
## D'autres mises à jour nécessitant une réinstallation | ||
|
||
Cette situation ne nécessite pas réellement de backup, car seul `APPX` effacera les fichiers de données de XMCL. Bien sûr, vous pouvez sauvegarder une backup si vous le souhaitez, et les fichiers de données seront situés aux emplacements suivants : | ||
|
||
::: code-group | ||
```cmd [Windows] | ||
%AppData%\xmcl | ||
``` | ||
```sh [macOS] | ||
~/Library/Application Support/xmcl | ||
``` | ||
```sh [Linux] | ||
~/.config/xmcl | ||
``` | ||
::: | ||
|
||
## La mise à jour d'une autre version a échoué | ||
|
||
Il suffit de retélécharger le launcher... |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
--- | ||
layout: home | ||
|
||
hero: | ||
name: Documentation XMCL | ||
text: J'espère que vous trouverez les réponses à vos questions sur XMCL ici | ||
tagline: Si vous ne pouvez pas... vous êtes plus que bienvenu d'envoyer des pull requests afin d'améliorer la documentation ! | ||
image: | ||
src: /logo.png | ||
alt: X Minecraft Launcher | ||
actions: | ||
- theme: brand | ||
text: Guide d'Installation | ||
link: /fr/guide/install | ||
- theme: alt | ||
text: Lien GitHub | ||
link: https://github.com/voxelum/x-minecraft-launcher | ||
|
||
features: | ||
- icon: 📥 | ||
title: Guide d'Apparence XMCL | ||
details: Comment embellir l'interface visuelle XMCL ? | ||
link: /fr/guide/appearance | ||
- icon: ⚡️ | ||
title: Protocole en ligne P2P expliqué | ||
details: Le protocole P2P utilisé par XMCL sera introduit en détail. | ||
link: /fr/protocol/p2p | ||
- icon: 📚 | ||
title: Format des données stockées par XMCL | ||
details: Comment XMCL stocke les données ? | ||
link: /fr/guide/manage | ||
--- | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,109 @@ | ||
# Format de stockage des instances | ||
|
||
> Rédaction en cours | ||
XMCL, similaire à MultiMC, stocke des informations pour chaque instance. | ||
|
||
Ces informations sont stockées dans le [répertoire de données XMCL](/fr/guide/manage#xmcl-cache-and-database): | ||
|
||
<!-- ```bash | ||
. | ||
├─ instances | ||
│ ├─ .vitepress | ||
│ │ └─ config.js | ||
│ ├─ api-examples.md | ||
│ ├─ markdown-examples.md | ||
│ └─ index.md | ||
└─ package.json | ||
``` --> | ||
|
||
```sh | ||
Répertoire de données XMCL | ||
└─ 📜instances.json # Fichier de configuration d'instance globale | ||
``` | ||
|
||
Ainsi que le [répertoire de données de jeu XMCL](/fr/guide/manage#minecraft-related-data): | ||
|
||
```sh | ||
Répertoire de données de jeu XMCL | ||
└─📂instances # Contient des fichiers pour les instances | ||
├─📂instance-a | ||
│ └─ 📜instance.json # Fichier de configuration pour l'instance A | ||
└─ 📂instance-b | ||
└─ 📜instance.json # Fichier de configuration pour l'instance B | ||
``` | ||
|
||
## Format du fichier de Configuration Globale | ||
|
||
Ici, nous supposons que vos données XMCL sont stockées dans `/path/to/xmcl`. | ||
|
||
```json5 | ||
{ | ||
// Ceci est la dernière instance sélectionnée. Le launcher sélectionnera celle-ci lors de son lancement. | ||
"selectedInstance": "/chemin/vers/xmcl/instances/instance-a", | ||
// Il s'agit d'une liste en cache de toutes les instances. Les chemins d'instances externes importés seront également stockés ici. Ils seront indisponibles si le launcher est supprimé. | ||
"instances": [ | ||
"/path/to/xmcl/instances/instance-a", | ||
"/path/to/xmcl/instances/instance-b", | ||
// Instances externes | ||
"/external/.minecraft" | ||
] | ||
} | ||
``` | ||
|
||
## Fichier de configuration de l'instance | ||
|
||
Supposons que vous en ayez créé un dans `/path/to/xmcl/instances/mc.hypixel.com`. | ||
|
||
```json5 | ||
{ | ||
// C'est le nom affiché dans le launcher | ||
"name": "mc.hypixel.com", | ||
// Non implémenté actuellement. Définit la résolution du jeu d'instance | ||
"resolution": { "width": 800, "height": 400, "fullscreen": false }, | ||
// Mémoire minimale | ||
"minMemory": 0, | ||
// Mémoire maximale | ||
"maxMemory": 0, | ||
// Paramètres de démarrage supplémentaires JVM | ||
"vmOptions": [], | ||
// Paramètres de démarrage supplémentaires MC | ||
"mcOptions": [], | ||
"url": "", | ||
// URL de l'icône de l'instance | ||
"icon": "", | ||
// Indique si XMCL affichera une fenêtre de journal (log) après le lancement | ||
"showLog": false, | ||
// Indique s'il faut masquer le launcher après le lancement | ||
"hideLauncher": true, | ||
// Version requise pour l'instance, une chaîne de caractères vide représente non requis | ||
"runtime": { | ||
"minecraft": "1.16.3", | ||
"forge": "", | ||
"liteloader": "", | ||
"fabricLoader": "", | ||
"yarn": "", | ||
"optifine": "", | ||
"quiltLoader": "" | ||
}, | ||
// Chemin Java, vide représente la détection automatique | ||
"java": "", | ||
// Version de lancement spécifiée manuellement, vide représente un calcul basé sur l'exécution | ||
"version": "", | ||
// Adresse du serveur, si présente le launcher se connectera directement à ce serveur | ||
"server": { "host": "mc.hypixel.net", "port": 25565 }, | ||
// Auteur du modpack | ||
"auteur": "ci010", | ||
// Description | ||
"description": "", | ||
"lastAccessDate": 1661774086015, | ||
"creationDate": 1602514422594, | ||
"modpackVersion": "", | ||
"fileApi": "", | ||
"tags": [], | ||
"assignMemory": false, | ||
// S'il faut lancer rapidement | ||
"fastLaunch": false | ||
} | ||
|
||
``` |
Oops, something went wrong.