Q3Map2

Q3Map2 est le logiciel que GtkRadiant utilise pour compiler les maps. Mais il est possible de s'en servir sans passer par GtkRadiant pour diverses raisons: utiliser un autre ordinateur pour la compilation, avoir un plus grand contrôle de la compilation, ne pas utiliser des ressources inutiles (Interface de GtkRadian)…

Q3Map2 est un logiciel qui fonctionne en lignes de commandes à écrire dans un terminal. Pour accéder à un terminal sous XP, il faut passer par le menu Démarrer > Executer…, inscrire cmd et valider. Apparaît alors une fenêtre noire avec texte blanc, c'est le terminal (ou console).

La syntaxe de base pour compiler est¹⁾:

Dans le menu Build de GtkRadiant, vous pouvez voir plusieurs options de compilation. Si vous cliquez sur “Customize…”, apparaît une fenêtre avec les différents pré-réglages de compilation, avec la ou les lignes de commandes correspondantes.

Par exemple sur l'image ci-dessus, on peut voir que le préréglage sélectionné fait appel à quatre commandes. Pour réaliser la même chose avec Q3Map2, il faudrait lancer successivement ces trois commandes:

La syntaxe à utiliser est la même que pour windows, du type:

Il peut alors être intéressant de se créer un script pour ne pas avoir à retaper les mêmes commandes. En voici un exemple permettant une compilation rapide en vue de test.

#!/bin/bash
#Dépendance: libnotify-bin (sudo apt-get install libnotify-bin)
#Copier ce code dans un fichier texte
#Ne pas oublier de rendre ce fichier executable
 
#Renseigner les trois lignes ci-dessous avec les informations correspondant à votre système:
chemin_q3map2="/home/user/GtkRadiant-1.5.0-i686/q3map2.x86"
chemin_jeu="/home/user/UrbanTerror"
chemin_map="/home/user/mapping/ma_map.map"
 
notify-send "Q3Map2" "Lancement de la compilation"
 
$chemin_q3map2 -meta -fs_basepath $chemin_jeu -fs_game q3ut4 -game q3ut4 $chemin_map
notify-send "Q3Map2" "Première passe terminée (bsp)"
 
$chemin_q3map2 -light -faster -fs_basepath $chemin_jeu -fs_game q3ut4 -game q3ut4 $chemin_map
notify-send "Q3Map2" "Seconde passe terminée (light faster)"

Si compiler est transformer un fichier .map en .bsp, la décompilation est la manœuvre inverse. La décompilation peut être utile pour étudier comment d'autres mappeurs conçoient leurs maps, mais ne doit pas être utilisée pour modifier une map existante sans le consentement de son auteur. La décompilation ne permet pas de tout récupérer, les entités d'éclairages sont ignorées, par exemple.

Ouvrir la console Windows en passant par le menu Démarrer > Executer…, inscrire cmd et valider. Apparaît alors une fenêtre noire avec texte blanc, c'est la console. Pour décompiler une map, il faut entrer cette commande dans la console:

Les passages entre guillemets sont à modifier en fonction de votre configuration. Vous trouverez le fichier .map dans le même dossier que le .bsp original.

Un script batch permet d'automatiser la décompilation (pas besoin de taper de commande):

1/ créer un répertoire (par exemple “decompilationbsp”)

2/ y mettre une carte (ou plusieurs :)) au format .bsp nb1 : Les cartes d'origines se trouvent dans q3ut4/zpak000_assets.pk3; le .pk3 etant un fichier .zip renommé
nb2 : si vous ne voyez pas l'extentsion (.pk3) faites dans l'explorateur windows : outils> option sur les dossiers > affichage > décocher “masquer les extensions des fichiers dont le type est connu”

3/ créer un fichier texte dans le repertoire

4/ coller ce code dans le fichier :

rem -----------------------------------------------------------------------------------
rem               Décompilateur bsp de map pour Urban Terror :D
rem               by landouille
rem -----------------------------------------------------------------------------------
rem Glissez Votre map sur ce fichier bat, il sera converti au même nom mais en .bsp dans
rem le même répertoire que celui appelé. 
rem Il faut toutefois préciser :
rem GTKRADIANT_PATH : chemin vers GtkRadiant
rem Q3MAP2_PATH : chemin vers le q3map2.exe (de GtkRadiant)
rem -----------------------------------------------------------------------------------

 
rem ------ définition des Chemins
set Q3MAP2_PATH="C:Program FilesGtkRadiant 1.5.0q3map2.exe"
set GTKRADIANT_PATH  = "C:Program FilesGtkRadiant 1.5.0"

rem ------ 
set GEN_OPTIONS=-fs_basepath %GTKRADIANT_PATH% -game q3ut4

rem ------ Récupère le nom du fichier glisser/deposé et le chemin
@echo off
for %%i in (%1) do ( rem %1 récupère le nom du fichier glissé-déposé. 
 set chemin=%%~dpi
 set "nom_fichier=%%~nxi"
 set "nom_fichier_generre=%%~ni_converted.map"
 call :PROCESS
 )
 goto EXIT
 
 
:PROCESS
CLS rem efface l'ecran
 
 echo * nom du fichier = %nom_fichier%
 echo * chemin = %chemin% 
 echo ********************************
 echo * Le nouveau fichier %nom_fichier_generre% sera generre dans %chemin%
 echo ********************************
 
pause 

rem ------ Conversion
%Q3MAP2_PATH% -convert -format map %GEN_OPTIONS% -v "%chemin%%nom_fichier%" 
echo convertion termine
pause

Le code est commenté mais pour ceux qui y comprennent rien, la seule chose à changer (si besoin) se sont ses deux lignes si cela ne correspond pas a vos chemins: set Q3MAP2_PATH=“C:Program FilesGtkRadiant 1.5.0q3map2.exe” set GTKRADIANT_PATH = “C:Program FilesGtkRadiant 1.5.0”

5/ enregistrer et renommer le fichier en “decompilateurbsp.bat”

6/ depuis l'explorateur windows faites glisser votre .bsp sur le .bat et il sera converti :)

Le principe est le même que pour Windows, ouvrir un terminal et y mettre:

Un script est également disponible pour faciliter le travail:

#!/bin/bash
#Dépendance: libnotify-bin (sudo apt-get install libnotify-bin)
#Copier ce code dans un fichier nommé decompiler (par exemple)
#Ne pas oublier de rendre ce script executable (chmod +x ~/decompiler)
#Copyright kimented - licence: http://creativecommons.org/licenses/by-sa/2.0/fr/
 
#syntaxe: ~/decompiler /chemin/complet/fichier.bsp
#ou clic droit sur fichier.bsp > ouvrir avec "/chemin/vers/decompiler"
 
#Renseigner les deux ligne ci-dessous avec les informations correspondant à votre système:
chemin_q3map2="/home/user/GtkRadiant/q3map2.x86"
chemin_radiant="/home/user/GtkRadiant"
 
if [ -f "$1" ]; then
echo "Décompilation..."
notify-send "Décompilation" "Opération en cours..."
$chemin_q3map2 -convert -format map -fs_basepath $chemin_radiant -game q3ut4 -v $1
notify-send "Décompilation" "L'opération est terminée"
elif [ $# = "0" ]; then
notify-send "Erreur" "Pas de fichier désigné"
else
echo "Fichier inexistant"
notify-send "Erreur" "Le fichier $1 n'a pas été trouvé"
fi

Télécharger le script: decompiler.gz Script testé sous Ubuntu et Debian avec GtkRadiant 1.5