Sommaire · English

Patchs

Un patch est un petit fichier qui ne contient que les différences entre une ROM et une version modifiée de cette ROM : une traduction, une correction de bogues, un hack. On le diffuse à la place de la ROM modifiée, puisque diffuser la ROM reviendrait à diffuser le jeu ; c'est à chacun de l'appliquer à sa propre copie.

RomSieve applique les patchs d'un dossier aux ROMs de votre collection : chaque patch dont la ROM d'origine est identifiée dans la source donne une version patchée, écrite dans la destination à côté de la version d'origine, ou dans un dossier à part (voir Un dossier Patchs). La ROM d'origine n'est jamais modifiée.

Un patch ne s'applique qu'à la ROM exacte pour laquelle il a été fait : même région, même révision, même dump. RomSieve la trouve pour vous par sa somme de contrôle (CRC32), ce qui demande un fichier DAT.

Formats pris en charge

Format Extension ROM d'origine trouvée par Contrôles
IPS .ips votre choix, sinon le CRC32 écrit dans le nom du patch, ou dans son readme (voir Rapprochement) aucun : le format n'enregistre aucune somme de contrôle
IPS32 .ips ou .ips32 votre choix, sinon le CRC32 écrit dans le nom du patch, ou dans son readme aucun
UPS .ups le CRC32 et la taille qu'il enregistre CRC32 du patch, de la ROM d'origine et du résultat
BPS .bps le CRC32 et la taille qu'il enregistre CRC32 du patch, de la ROM d'origine et du résultat

Le format est lu dans le contenu du fichier, pas seulement dans son extension. UPS et BPS sont les plus sûrs : ils ne s'appliquent qu'à la bonne ROM et vérifient leur résultat. Un patch abîmé ou tronqué est refusé avant d'être appliqué.

Les autres formats (xdelta, PPF, APS, BSDiff…) ne sont pas pris en charge : leurs fichiers sont ignorés. Les sets d'arcade MAME et les logiciels des listes MAME ne sont jamais patchés.

Dossier des patchs

Dans l'étape Collection, le cadre Patchs a le champ Dossier des patchs, avec son bouton Parcourir.... Il est toujours affiché, quelle que soit la convention. À côté de son titre, Gérer les patchs… ouvre la fenêtre Patchs sur la dernière simulation (voir La liste des patchs) ; il est grisé tant qu'aucune simulation n'a trouvé de patch.

La case Appliquer les patchs, à côté du titre du cadre, est cochée par défaut, et se coche d'elle-même quand vous choisissez un dossier avec Parcourir.... Décochée, aucun patch n'est appliqué, mais le dossier reste dans les réglages et les profils pour la prochaine fois : il n'est pas lu, N'écrire que les versions patchées et le dossier des versions patchées sont grisés, et le journal dit que l'application des patchs est désactivée. Le reste ne change pas : un dossier des patchs placé dans la source n'est toujours pas trié comme des ROMs, et la destination ne doit toujours pas le chevaucher, pour qu'une purge ne mette jamais vos patchs en quarantaine.

Le journal de la simulation dit combien de patchs ont été trouvés et combien ont donné une version patchée.

Rapprochement

Seule une ROM identifiée dans le DAT peut recevoir un patch, quel que soit son statut : une version écartée par le 1G1R reçoit son patch comme une autre. C'est souvent le cas d'une traduction, faite pour la version japonaise d'un jeu que le 1G1R écarte au profit de la version américaine.

Readme des IPS

Un readme est un fichier texte .txt ou .nfo d'au plus 1 Mo, rangé à côté du patch : dans le même dossier du dossier des patchs, ou dans la même archive, au même endroit. Un readme sur le disque n'accompagne jamais un patch rangé dans une archive, ni l'inverse.

Pour le CRC32, RomSieve ne lit que les lignes où figure le mot CRC, et sur elles les CRC32 qui le suivent. Un readme donne souvent aussi le CRC32 du résultat patché : il ne désigne aucune ROM de la source, et il est ignoré. Votre choix, puis le nom du patch, l'emportent toujours sur son readme, et un UPS ou un BPS, qui enregistre lui-même sa ROM d'origine, ne lit jamais le sien.

Un readme donne parfois le CRC32 d'une ROM avec et sans son en-tête copieur, sur deux lignes (par exemple File CRC32 et ROM CRC32). Un IPS ne dit pas laquelle des deux formes il attend : RomSieve ne l'applique pas. Le readme dit en général pour quelle forme le patch a été fait : choisissez alors cette forme dans la fenêtre Patchs (voir Choisir la ROM du patch).

Le panneau de détail d'une version patchée nomme le readme qui a donné le CRC32.

Un readme nomme souvent aussi la ROM pour laquelle le patch a été fait, sous son nom No-Intro suivi de son extension (Make sure to use the "Super Mario Bros. 2 (USA).nes" ROM, Mega Man 2 (USA).nes - NOINTRO, ou après Database match:). Quand aucun CRC32 ne désigne une ROM de la source, RomSieve propose la ROM ainsi nommée dans la fenêtre Patchs (« readme.txt cite le nom de cette ROM »), sans jamais l'appliquer seule : un readme peut nommer une autre révision, ou une ROM qu'il faut d'abord traduire. Le nom est comparé à ceux du DAT sans tenir compte des majuscules, au nom de fichier comme au nom du jeu (un readme écrit .nes là où un DAT sans en-tête écrit .unh). Un nom GoodTools ((U) [!]) ou approché ne désigne aucune ROM. Si la ROM nommée est dans le DAT mais pas dans la source, la raison du patch la nomme.

La version patchée

NES, Lynx et Super Nintendo

Un patch fait pour le fichier entier d'une ROM à en-tête copieur donne un résultat qui en a un : il est écrit tel que le patch le produit. Un patch fait pour les données sans l'en-tête donne des données seules :

Quand un tel patch change la taille des données (un patch qui agrandit la ROM), l'en-tête est écrit tel quel, et peut ne plus en donner la bonne taille : le journal le dit pour chaque version patchée concernée. Un patch fait pour le fichier entier, qui peut mettre l'en-tête à jour lui-même, n'a pas ce défaut.

L'en-tête doit encore être celui de la ROM d'origine quand le patch est appliqué : un en-tête modifié depuis la simulation passe la version patchée en Erreur, sans rien écrire.

Ancien en-tête iNES 1.0. Les ROMs NES actuelles ont un en-tête NES 2.0, qui donne des précisions dans ses derniers octets. Les patchs plus anciens, et les CRC32 que donnent leurs readme et la page romhacking.net de chaque patch, ont été faits avec l'en-tête iNES 1.0 d'alors, où ces octets étaient à zéro : leur CRC32 n'est celui d'aucun fichier actuel, ni d'aucune ROM du DAT. RomSieve cherche donc aussi chaque ROM NES sous cet ancien en-tête, recalculé d'après le sien (les données restent les mêmes). Un patch fait pour lui s'applique alors à la ROM ainsi lue, et le résultat est écrit tel que le patch le produit, avec l'en-tête qu'il porte. Le panneau de détail le dit (« sous un ancien en-tête iNES 1.0 »). Une ROM qui a déjà un en-tête iNES 1.0 n'a pas besoin de cette forme, et une ROM sans en-tête ne peut pas la recevoir.

Choix du nom

Le nom part toujours de celui de la ROM d'origine, tel que le DAT le donne : la région et la révision viennent du DAT, jamais de l'auteur du patch, et chaque version patchée se range à côté de sa ROM d'origine. Le libellé entre crochets est tiré du nom du patch :

Patch ROM d'origine Version patchée
Jeu (Japan) (T-En).bps Jeu (Japan).sfc Jeu (Japan) [T-En].sfc
Jeu (T-En v1.2).bps Jeu (Japan).sfc Jeu (Japan) [T-En v1.2].sfc
Jeu (T-En) [47E70E08].ips Jeu (Japan).sfc Jeu (Japan) [T-En].sfc
SMB3_eng_v1.2.ups Super Mario Bros. 3 (Japan).nes Super Mario Bros. 3 (Japan) [SMB3_eng_v1.2].nes
Alpha (1990)(Ocean)[h Hack].bps Alpha (1990)(Ocean).adf Alpha (1990)(Ocean)[h Hack].adf

N'écrire que les versions patchées

Cochez N'écrire que les versions patchées, dans l'étape Sortie, sous le champ Versions patchées (cadre Arborescence), pour qu'un jeu qui a une version patchée ne soit écrit que sous cette forme. Avec le 1G1R, la ROM retenue pour ce jeu n'est pas écrite, même si le patch a été fait pour une autre version du jeu : un patch fait pour Jeu (World) (Collection).md, que le 1G1R écarte au profit de Jeu (World).md, donne la seule version patchée, et Jeu (World).md n'est pas écrite. Sans le 1G1R, chaque ROM retenue est un choix à part, et seule la ROM d'origine du patch est remplacée. Le tableau montre une ROM remplacée Exclu, avec la raison Remplacée par une version patchée ; une ROM que le 1G1R écartait déjà garde sa raison. Option décochée, la ROM retenue et la version patchée sont toutes deux écrites. L'option est grisée sans dossier des patchs, ou quand Appliquer les patchs est décoché.

Un dossier Patchs

Par défaut, une version patchée va dans le dossier de sa ROM d'origine. Le champ Versions patchées de l'étape Sortie, dans le cadre Arborescence, sous le Modèle, la range ailleurs, pour deux usages :

Le champ est un modèle de dossiers, comme le Modèle (voir Variables), mais il part de la racine de la destination, même avec Tout à la racine : les dossiers d'un lot de DAT ne s'y ajoutent pas d'eux-mêmes. Ses variables prennent les valeurs de la ROM d'origine ({title}, {dat}, {publisher}…), même quand le 1G1R l'écarte, et deux variables n'existent que pour lui :

Variable Contenu
{origin_folder} Le dossier entier où va la ROM d'origine : le dossier de son DAT dans un lot (sous les dossiers de son chemin s'ils sont reproduits), puis les dossiers du modèle ; aucun avec Tout à la racine
{dat_folder} Le dossier du DAT de la ROM d'origine dans un lot, sous les dossiers de son chemin s'ils sont reproduits ; aucun pour un DAT seul, ou sans Un dossier par DAT

Chacune forme un dossier à elle seule, entre deux / : {origin_folder}/Patchs est permis, {origin_folder}-patchs ne l'est pas. Vide, le champ (À côté de la ROM d'origine) donne le même dossier que {origin_folder}.

Exemples avec Chrono Trigger (Japan).sfc, le modèle {title} et un patch (T-En) :

Versions patchées DAT seul Lot, un dossier par DAT Lot, arborescence des DAT reproduite (No-Intro/)
(vide) Chrono Trigger/ Nintendo - SNES/Chrono Trigger/ No-Intro/Nintendo - SNES/Chrono Trigger/
Patchs/{title} Patchs/Chrono Trigger/ Patchs/Chrono Trigger/ (tous les DAT ensemble) Patchs/Chrono Trigger/
Patchs/{dat}/{title} Patchs/Nintendo - SNES/Chrono Trigger/ Patchs/Nintendo - SNES/Chrono Trigger/ Patchs/Nintendo - SNES/Chrono Trigger/
{dat_folder}/Patchs Patchs/ Nintendo - SNES/Patchs/ No-Intro/Nintendo - SNES/Patchs/
{origin_folder}/Patchs Chrono Trigger/Patchs/ Nintendo - SNES/Chrono Trigger/Patchs/ No-Intro/Nintendo - SNES/Chrono Trigger/Patchs/

Le fichier y garde son nom, Chrono Trigger (Japan) [T-En].sfc (une archive .zip en mode ZIP). Le dossier _unmatched des fichiers non conformes reste à la racine : une version patchée n'y va jamais, puisque sa ROM d'origine est identifiée.

Rien n'est écrit hors de la destination. Un dossier qui en sortirait, ou qui écrirait dans les dossiers que RomSieve garde pour lui, est refusé : chemin qui commence par / ou \, lecteur (C:), dossier .., caractère interdit dans un nom (< > : " | ? *), _purged ou .romsieve comme premier dossier, {origin_folder} ou {dat_folder} qui ne forme pas un dossier à lui seul. L'aperçu dit pourquoi, une ligne le signale sous l'étape Sortie (Patchées : dossier refusé), et la simulation comme le tri sont refusés avant d'écrire quoi que ce soit. Une variable inconnue, une accolade sans paire ou un dossier _unmatched ne sont qu'un avertissement de l'aperçu, comme pour le modèle.

Changer le dossier des versions patchées rend la dernière simulation périmée ; la suivante marque Modifiés les seules lignes des versions patchées. Annuler le dernier tri les supprime, ainsi que les dossiers vidés.

Modes de transfert

Mode Version patchée
Copier Un fichier, écrit à côté de la ROM d'origine ou dans son dossier
Déplacer Un fichier, écrit avant que la ROM d'origine ne quitte la source. Avec N'écrire que les versions patchées, la ROM remplacée reste dans la source.
Hard link, Symlink Une copie : un lien ne peut pas porter un contenu modifié. Le journal le dit.
ZIP Une archive à elle, au format TorrentZip, comme celle de tout autre jeu, rangée dans le même dossier

Une ROM d'origine rangée dans une archive est extraite à côté de la cible le temps d'appliquer le patch, puis supprimée. L'archive n'est jamais modifiée.

L'écriture suit les mêmes règles de sûreté que toute autre (voir Sécurité, purge et annulation) : le fichier n'apparaît sous son nom qu'une fois complet, et un tri arrêté ou en échec ne laisse aucun fichier tronqué. Le CRC32 de la ROM d'origine est vérifié pendant l'application : une ROM modifiée depuis son identification est refusée, même pour un IPS. Pour un UPS ou un BPS, le CRC32 du résultat l'est aussi : un résultat faux passe la version patchée en Erreur, sans rien laisser dans la destination. Avec Vérifier les fichiers copiés, la version patchée est relue après son écriture.

Patchs non appliqués

Un patch qui ne donne aucune version patchée a sa ligne dans le journal, avec sa raison :

Raison Ce qu'il faut faire
La ROM d'origine, nom, manque dans la source (ou : un readme désigne la ROM d'origine, nom, …) Le DAT connaît cette ROM, mais la source ne l'a pas : ajoutez-la à la source. Dans un lot, le DAT de la ROM suit son nom
Un readme cite la ROM d'origine, nom, qui manque dans la source Le readme ne donne aucun CRC32 connu, mais nomme une ROM du DAT : ajoutez-la à la source, ou vérifiez dans le readme la révision attendue
Aucune ROM du DAT n'a ce CRC32 : le patch a été fait pour un autre dump ou pour un hack Cherchez la ROM que demande le readme du patch ; pour un IPS, choisissez-lui une ROM dans la fenêtre Patchs
Aucune ROM du DAT n'a ce CRC32 : … ou pour une autre forme de la ROM que celle que décrit le DAT (avec un autre en-tête copieur, ou sans) Pour la NES, la Lynx ou la Super Nintendo, le patch a pu être fait pour la ROM avec un en-tête (ou un autre en-tête) quand le DAT la décrit sans, ou l'inverse : un DAT de l'autre forme la nommera. Pour un IPS, choisissez sa ROM et sa Forme dans la fenêtre Patchs
Ni le nom du patch IPS ni un texte qui l'accompagne ne donnent le CRC32 de la ROM d'origine Choisissez sa ROM dans la fenêtre Patchs (voir Choisir la ROM du patch)
Patch illisible Le fichier est tronqué, abîmé, ou d'un autre format
Le nom du patch donne les CRC32 de plusieurs ROMs de la source Choisissez la bonne ROM dans la fenêtre Patchs
Un readme donne les CRC32 de plusieurs ROMs de la source Choisissez la bonne ROM dans la fenêtre Patchs
Un readme donne le CRC32 d'une ROM avec et sans son en-tête copieur Choisissez dans la fenêtre Patchs la forme pour laquelle il a été fait
La ROM que vous avez choisie pour ce patch n'est pas identifiée dans la source Elle a quitté la source, ou le DAT ne l'identifie plus : choisissez-en une autre, ou revenez au choix automatique
La ROM d'origine fait partie d'un jeu en plusieurs fichiers Un .cue et ses pistes, ou un jeu en plusieurs disques : ces jeux ne sont pas patchés
La ROM n'a pas la taille que le patch attend Ce n'est pas la ROM pour laquelle le patch a été fait

Un patch que vous avez écarté n'y figure pas : le journal le dit à part (Patch écarté à votre demande). Pour faire taire un patch que rien ne répare, écartez-le (voir Ne pas appliquer un patch).

Sans DAT, les patchs ne sont pas lus : le journal le dit.

La liste des patchs

La fenêtre Patchs montre tous les patchs de la dernière simulation, et c'est là que vous dites à RomSieve ce qu'il doit en faire. Elle s'ouvre après une simulation :

La fenêtre Patchs

À gauche, les patchs sont groupés par état :

La recherche au-dessus de la liste garde les patchs dont le nom ou le dossier contient tous les mots, dans n'importe quel ordre (-mot écarte) : FF3 extra ne montre que les patchs du dossier Extra & Visual Patches de FF3. Les groupes, leurs comptes et Voir les suggestions ne gardent que les patchs trouvés. La croix efface la recherche.

À droite, le détail du patch sélectionné dit en clair où il en est (pour un patch appliqué : ce qui désigne sa ROM, et le nom de sa version patchée), puis donne ses actions : Appliquer à cette ROM et Ne pas appliquer ce patch. Quand vous avez fait un choix pour le patch, sa ligne d'état se termine par un lien qui l'oublie (voir Ne pas appliquer un patch). En dessous, une ligne dit votre dernier changement (« ROM choisie : … », « Patch écarté », « Fichier renommé en … ») et propose Défaire (voir Vos choix).

Le pied compte les patchs modifiés. Relancer la simulation relance la simulation, qui suit vos choix : la fenêtre reste ouverte et montre ses résultats, sur le même patch. Si vous fermez la fenêtre avec des choix que la simulation n'a pas encore vus, elle est relancée : le tableau montre toujours ce que donnent vos choix.

Choisir la ROM du patch

Un UPS ou un BPS désigne lui-même sa ROM et la vérifie : on ne lui en choisit pas d'autre. Pour un IPS, le détail demande Pour quelle ROM est ce patch ? :

Appliquer à cette ROM enregistre votre choix : la prochaine simulation applique le patch à cette ROM, quoi que disent son nom et son readme. Le fichier du patch n'est pas modifié, et un patch rangé dans une archive se choisit comme les autres. Tant que la ROM actuelle d'un patch appliqué est choisie, le bouton est grisé. La touche Entrée n'enregistre jamais rien.

Si une version patchée ne fonctionne pas, parce que le patch a été fait pour une autre ROM, choisissez-lui la bonne de la même façon : votre choix l'emporte sur le CRC32 de son nom et sur son readme.

Voir les suggestions (n)…, sur le titre du groupe ROM proposée, n'applique rien : il montre pour chaque patch la ROM choisie, puis le dossier du patch et la raison de la proposition (« Le nom du patch commence par le titre de cette ROM »…), de quoi juger chaque suggestion. Rien n'y est coché d'avance. Cochez ceux à appliquer (ou Tout cocher), puis Appliquer (n) ; Retour revient au détail sans rien enregistrer.

Ne pas appliquer un patch

Ne pas appliquer ce patch écarte le patch sélectionné, quel que soit son format : la prochaine simulation ne l'applique pas, et ne le compte plus parmi les patchs non appliqués. C'est aussi la façon de faire taire un patch qui ne s'applique à rien et que vous voulez garder dans le dossier. Le menu contextuel d'une version patchée du tableau propose la même action, qui relance aussitôt la simulation.

Pour écarter d'un coup les patchs qui ne s'appliqueront jamais (ceux qui s'appliquent à une ROM déjà patchée, par exemple), cherchez-les, puis cliquez sur Ne pas appliquer les patchs affichés (n)…, sous la recherche. Le bouton est grisé sans recherche, qui montrerait tous les patchs. Il montre la liste des patchs trouvés, tous cochés, avec leur dossier : décochez ceux à garder, puis Ne pas appliquer (n) ; Retour n'enregistre rien. Chaque patch écarté peut ensuite être repris.

Revenir au choix automatique, au bout de la ligne d'état d'un patch pour lequel vous avez choisi une ROM, oublie votre choix : la prochaine simulation l'applique de nouveau d'après ce qu'il enregistre, son nom ou son readme. Pour un patch écarté, le lien s'appelle Reprendre ce patch et fait de même ; Ne pas appliquer ce patch n'est alors plus affiché.

La version patchée qu'un tri a déjà écrite dans une destination reste en place : Annuler le dernier tri la supprime, si ce tri est le dernier.

Vos choix

Dans les résultats

Annulation

Chaque version patchée est inscrite au journal du tri : Annuler le dernier tri la supprime, sauf si elle a été modifiée depuis le tri. Vos choix pour les patchs ne sont pas inscrits au journal : Annuler le dernier tri ne les défait pas (voir Vos choix).

En ligne de commande

--patches <dossier> donne le dossier des patchs et les applique, même quand Appliquer les patchs est décoché dans les réglages ; --no-patches n'en applique aucun, sans changer les réglages ; --patch-only n'écrit que les versions patchées (voir Ligne de commande). Le dossier des versions patchées vient du fichier de réglages ou du profil ; un dossier refusé arrête run comme patches, en code 3. Le bilan compte les versions patchées et les patchs non appliqués.

romsieve-cli patches simule le tri et liste tous ses patchs : ceux qu'il n'applique pas, avec les ROMs proposées, ceux qu'il applique et ce qui désigne leur ROM, et ceux que vous avez écartés. Les choix de la fenêtre s'y font aussi, enregistrés avec --yes : --link <patch> --rom <ROM> applique un IPS à une ROM (son nom, ou le CRC32 de la forme pour laquelle le patch a été fait, obligatoire pour une ROM à en-tête copieur), --ignore <patch> écarte un patch, --auto <patch> oublie votre choix. --name-from-notes --yes écrit le CRC32 dans le nom des IPS appliqués grâce à leur readme, pour d'autres outils.