Manuale tecnico SWOS ITA Mod
Documentazione per chi vuole capire, ampliare o portare su altri eseguibili le patch del mod: Serie C1 e C2, coppe sudamericane (Libertadores, Supercopa, CONMEBOL), Coppa Intercontinentale in carriera, rose reali 1996-97, tornei storici (Mondiale 1982, Coppa Mitropa 1934, FA Cup 1871-72), Apertura e Clausura in Argentina, Australia, Nuova Zelanda e MLS 1997 (2.5), stagioni storiche con la DDR 1988-89 e le coppe europee di quell'anno (2.6), e il mondo di carriera Mondo 2026-27 con i suoi motori condivisi (4.0). Tutto quello che segue è stato ricavato dal disassemblato e verificato con build e partite di prova.
Premessa
Tanto tempo fa - anno 2004 - in una galassia lontana lontana, dove Internet stava appena separandosi dal suono del modem, l'intelligenza artificiale era un argomento da romanzi di fantascienza e i videogiochi si vendevano in eleganti scatole di cartone nei negozi, il sottoscritto - insieme ad Ali Erdinc Koroglu, Jan Wickberg, Martin Binet, Zlatko Karakas, Ross Mayhew e Steve Smith - fondò lo Swos Working Group (web.archive.org) in onore del nostro videogioco preferito di sempre: l'edizione 1996-1997 di Sensible World of Soccer. Eravamo animati da un sogno: rendere ancora più bello quel gioco aggiungendo alcune competizioni la cui mancanza avvertivamo particolarmente amara. La serie C italiana (divisa in C1 e C2), in cui giocavano atleti che sarebbero poi diventati campioni a livello internazionale come Simone Inzaghi e Gianluca Zambrotta, e le coppe sudamericane, su tutte la mitica Copa Libertadores di cui, in un'epoca nella quale il calcio in tv era ancora una novità e non così abbondante, sentivamo il fascino delle cose esotiche e lontane. Ci sarebbe piaciuto giocare queste competizioni particolarmente in modalità carriera, quella preferita in assoluto dai giocatori di Swos: anche perché, nella modalità stagione e competizioni predefinite, eravamo già riusciti ad aggiungerle in una nuova edizione di Swos che si sarebbe dovuta chiamare Swos 2004. Il lavoro fu fatto con il reverse engineering e l'hex editing, ricordo l'emozione nello scoprire le routine di aggiunta delle competizioni ma anche l'amara frustrazione di non riuscire a farle funzionare in modalità carriera, che puntualmente si bloccava. Oggi, anno di grazia 2026, ho voluto chiudere il conto con questa storia personale che durante questi due decenni non mi aveva mai abbandonato, che era il rimpianto di essere arrivati vicino a un sogno e di non esserci mai riusciti. Del resto, mi dicevo per tentare di consolarmi, io alla fine sono diventato uno sviluppatore web e mobile, quello del reverse engineering su un codice x86 del 1996 era stato già un miracolo e per lo più nessuno dei tantissimi modder moderni era riuscito a compiere l'impresa.
Oggi, grazie alla AI, che ha cambiato per sempre il concetto stesso di programmazione, l'impresa è compiuta: potete ora scaricare la patch che aggiunge, in tutte le lingue del gioco, la serie C1 e C2 al campionato italiano, con le rose originali dell'epoca, ma soprattutto aggiunge per il Sud America la Coppa Libertadores, la Conmebol e la Supercopa, con le regole di ammissione di allora. E, come ciliegina sulla torta, non poteva mancare la Coppa Intercontinentale. Quello che mi interessa, però, non è solo il risultato, ma anche la spiegazione di come attraverso la AI ci si è arrivati. Quindi qui pubblichiamo, in inglese e in italiano, la documentazione completa del metodo seguito per creare le patch, che mi ha finalmente svelato cosa non avevamo capito nel lontano 2004 e spero possa ispirare altri sviluppatori e amanti del videogioco più bello del mondo a espanderne ulteriormente la modalità carriera. Un grazie immenso al lavoro di Zlatko Karakas, di cui dopo tanti anni di assenza ho trovato il fondamentale lavoro di disassemblaggio dell'exe originale (github.com).
Questa patch è dedicata alla memoria di Steve Smith, straordinario compilatore di rose aggiornate per Swos, che ci ha lasciati troppo presto. E a tutti quelli che sperano di vedere, prima o poi, realizzato un sogno che può essere lungo anche 22 anni…
— Davide Lorigliola
1Panoramica
Il mod non tocca mai i file originali. Uno script Python legge orig/ITALIAN.EXE e orig/DATA/TEAM.020, applica tutte le modifiche in modo deterministico e scrive i file installati in c/SWOS/. Ogni indirizzo che serve viene cercato nell'eseguibile per firma (sequenze di byte uniche) e verificato con assert: se una firma non si trova o non è unica, il build si ferma invece di produrre un exe sbagliato.
| Area | Cosa fa | Dove | Stato |
|---|---|---|---|
| Italia a 4 divisioni | Serie A 18, B 20, C1 18, C2 18; 4 promozioni e 4 retrocessioni fra livelli adiacenti; risolto il blocco di fine stagione del 1997 | patch.py | provato |
| Squadre C1/C2 | 36 club reali 1996-97 con rose, allenatori e forza calibrata | c1c2.py, c1c2_rosters.py | provato |
| Coppe sudamericane | Libertadores (formato reale 1997: 5 gironi da 4, detentrice direttamente agli ottavi, 2.0), Supercopa, CONMEBOL: menu, vista mondo, carriera, qualificate dalle classifiche, regole della detentrice | sacups.py | provato |
| Doppia partecipazione | Club sudamericani: Supercopa nello slot 1 (quello della coppa nazionale, libero in Sudamerica) + coppa continentale nello slot 3 | sacups.py | provato |
| Persistenza | Liste delle coppe sudamericane e finaliste dell'Intercontinentale salvate con la carriera | sacups.py, salists.py | provato |
| Intercontinentale | Finale secca a dicembre fra vincitrice Coppa Campioni e vincitrice Libertadores; finaliste aggiornate a fine stagione; slot 2 oppure slot 4 | sacups.py | slot 2, fine stagione slot 4 |
| Nuove nazioni (1.1–1.2) | Campionato del Costa Rica; Egitto, Marocco, Tunisia, Nigeria, Camerun, Corea del Sud, Cina, Arabia Saudita, Guatemala, Honduras con campionato e coppa nazionale (club reali, giocatori inventati) | countries.py, africa.py | provato (1 stagione) |
| Coppe continentali per club (1.1–1.2) | CAF Champions League, CAF Cup Winners Cup, CAF Cup, CONCACAF Champions Cup, Asian Club Championship, Asian Cup Winners Cup: menu, vista mondo, carriera, qualificate dalle classifiche, salvate in coda al file .CAR | cafcups.py, trailer.py | provato (1 stagione) |
| Tornei storici (2.0) | Mondiale 1982, Coppa Mitropa 1934, FA Cup 1871-72 con formato e rose reali, solo nelle Competizioni predefinite; gironi dispari, sorteggi fissi, esenzioni, sorteggio a moneta | historic.py, lib97.py | provato |
2Ambiente e build
Cartelle
~/swos-mod/
orig/ ITALIAN.EXE, ENGLISH.EXE, DATA/TEAM.020, swos9697ita.iso (MAI modificare)
c/SWOS/ gioco installato per DOSBox-X: ITALIAN.EXE, DATA/TEAM.020, salvataggi *.CAR
tools/ tutto il codice del mod (Python + sorgenti nasm dentro sacups.py)
ref/swos.asm disassemblato IDA completo (etichette = VA dell'exe INGLESE), da github.com/zlatkok/swos-port
ref/symbols.txt, ref/docs/SWOS/*.txt formati di file e note (teams.txt, career.txt, ...)
notes/STATUS.md registro dettagliato di ogni sessione (fonte primaria)
notes/addrmap.json mappa di delta ENGLISH → ITALIAN per oggetto
docs/ questo manuale (src/ = sorgenti nelle due lingue, tools/mkdocs.py genera le pagine)
Comandi
cd ~/swos-mod/tools && python3 patch.py # scrive c/SWOS/ITALIAN.EXE e c/SWOS/DATA/TEAM.020
python3 tools/salists.py c/SWOS/SALVA.CAR # decodifica le liste SA / Intercontinentale di un salvataggio
ndisasm -b32 -o 0xA1000 file.bin # disassemblatore (Homebrew), nasm per assemblare
Dipendenze: Python 3, nasm e ndisasm nel PATH. Il gioco gira in DOSBox-X con il CD montato dall'ISO originale. Il build è deterministico: stessi input, stesso md5 (il generatore casuale ha seme fisso 1997).
Ordine del build in patch.py:
patch_teams: ricostruisce TEAM.020 (Serie A e B originali + 36 club C1/C2) e restituisce la tabella di rimappatura degli indici.patch_exe: aggiunge una pagina da 4 KB all'oggetto 1 (add_object_page), prepara il pool di stringhe, rimappa i club italiani nelle liste delle coppe europee, applica la patch Italia (patch_italy), poi tuttosacups.patch(coppe, tabelle, carriera, fine stagione), imposta vsize e flag dell'oggetto 1, salva ricostruendo le tabelle dei fixup.
3Regole d'oro
Ognuna di queste regole viene da un bug reale incontrato durante lo sviluppo.
STR_BASE = obj2+0x16F8 (non "aChairmanScenes" come dice il disassemblato inglese). Un nome messo nell'oggetto 1 appare come spazzatura. Per i nomi nuovi c'è strpool.py, che oggi è praticamente pieno.cseg_9487A verifica che la somma dei 2000 byte di leaguesTableCopy sia 0 modulo 256; se non lo è, il gioco si blocca (int 3; jmp $). Qualsiasi dato parcheggiato in tabelle del gioco deve portarsi dietro un byte di bilanciamento.movs, rep). Il registro ES non è garantito uguale a DS nei punti in cui entriamo. Tutte le copie nel codice aggiunto sono cicli byte per byte attraverso DS.D0 = obj2+0x315B7 …). I registri x86 non vengono preservati fra chiamate del gioco.assert. Questo rende possibile il port sugli altri eseguibili (inglese, francese, tedesco) e protegge da errori silenziosi.p.remove); altrimenti il loader riscrive quei byte e la nuova call salta nel vuoto (capitolo 20).4Formato LE e fixup
ITALIAN.EXE è un eseguibile DOS/4GW in formato LE (Linear Executable) con due oggetti principali:
| Oggetto | Contenuto | Base di link | Note |
|---|---|---|---|
| obj1 | codice | 0x10000 | vsize originale 0xA09C9 → 0xA1000 (sessione 2) → 0xA2000 (pagina aggiunta). Reso scrivibile (flag 0x2) perché il codice di fine stagione riscrive le liste delle coppe che stanno nella nuova pagina. |
| obj2 | dati | 0xC0000 | tutte le variabili del gioco, i buffer di carriera, le tabelle delle competizioni, le stringhe |
Gli indirizzi nel disassemblato (cseg_8B2D3, dseg_D8CAA) sono VA dell'exe inglese. Per l'italiano: offset nell'oggetto = VA − base, poi si applica il delta di notes/addrmap.json (11 tratti per obj1, 16 per obj2). In pratica, per ogni routine ci si fida della firma trovata nell'exe italiano; la mappa serve solo per orientarsi.
Fixup
Ogni indirizzo assoluto nel file ha un record di fixup interno (oggetto sorgente, offset nella pagina, oggetto destinazione, offset destinazione). Quando si sovrascrive un'istruzione che conteneva un indirizzo, il suo fixup va rimosso (p.remove), altrimenti il loader corrompe i byte nuovi. Quando si aggiunge un indirizzo, va aggiunto il fixup (p.add_ptr). lepatch.save ricostruisce la tabella dei fixup; se cresce oltre lo spazio disponibile sposta in avanti le pagine dati (finora di 0x800 byte) e aggiorna gli offset dell'header.
Pagina aggiunta
add_object_page(data, 1) aggiunge una pagina fisica da 4 KB in fondo al file, la inserisce nella mappa delle pagine subito dopo quelle dell'oggetto 1, aggiunge una voce vuota nella tabella delle pagine dei fixup, sposta di +4/+8 gli offset delle tabelle dell'header e incrementa page_idx dell'oggetto 2. Tutto il codice e i dati delle coppe sudamericane vivono in questa pagina, da obj1+0xA1000. Oggi è occupata fino a circa obj1+0xA1932 (circa 1,7 KB liberi). Lo spazio lasciato libero nella vecchia cavità 0xA0A18–0xA1000 (circa 1,5 KB) è di nuovo disponibile.
5Gli strumenti
- le.py
- Parser LE in sola lettura: oggetti, mappa pagina → file,
obj_bytes(n),fixups()che restituisce (obj sorgente, offset, tipo, obj destinazione, offset destinazione, …). Usato per tutte le verifiche. - lepatch.py
- Classe
LEPatch:put/getper oggetto e offset,target(obj, off)legge dove punta un fixup,add_ptr,remove,retarget,set_vsize,add_flags,save(ricostruzione fixup + spostamento pagine dati). Funzioneadd_object_page. Andata e ritorno senza modifiche = file identico. - nasmcave.py
- Assembla sorgenti nasm (scritti come stringhe dentro
sacups.py) a un indirizzo della cavità. I simboli arrivano come{nome: (oggetto, offset)}. Il sorgente viene assemblato tre volte: normale, con obj1 spostato di 0x01000000 e con obj2 spostato. Ogni dword che cambia è un riferimento assoluto e riceve il fixup verso l'oggetto giusto; i salti relativi dentro obj1 non cambiano e non ne hanno bisogno.labels()legge il file map di nasm per gli indirizzi delle etichette. - strpool.py
- Spazio per nuove stringhe nell'oggetto 2: le stringhe mai referenziate
.COPPA AFRICANA CLUB******eCOPPA SUDAMERICANA*****, più il riempimento con asterischi della secondaCOPPA EUFAe diERRORE DISCO(il testo resta intatto). Contiene COPA LIBERTADORES, SUPERCOPA, COPA CONMEBOL, SERIE C1, SERIE C2 e un nome accorciato per COPPA INTERCONTINENTALE. Pieno: resta 1 byte. - sacups.py
- Il cuore del mod: strutture delle coppe sudamericane e dell'Intercontinentale, tabelle continentali, sorgenti nasm
CAREER_ASM(inizio stagione e caricamento) eQUALIFY_ASM(fine stagione), ricerca di tutte le firme e installazione degli agganci. - patch.py
- Punto d'ingresso del build: Italia (base dei numeri globali, struttura a 4 divisioni), TEAM.020, rimappatura dei club italiani nelle coppe europee.
- c1c2.py / c1c2_rosters.py
- Club di C1/C2 (maglie, divisione), rose reali 1996-97 con allenatori, obiettivi di forza, costruzione dei record squadra (sezione 8).
- salists.py
- Legge un
.CARe stampa le liste salvate: coda 'C4'/'C5'/'C6' (1.2/1.3/2.0), altrimenti il blocco della 1.0/1.1 (SA o S2, con somma di controllo); liste Libertadores/Supercopa/CONMEBOL, coppia dell'Intercontinentale. - addrmap.py
- Genera
notes/addrmap.jsonconfrontando ENGLISH.EXE e ITALIAN.EXE a finestre mascherate (i byte dei fixup esclusi). - asmbytes.py
- Estrae i byte
dbdi un'etichetta dati daref/swos.asm, utile per cercare le stesse tabelle nell'exe italiano. - mkdocs.py
- Genera
docs/index.html(inglese) edocs/it.html(italiano) per GitHub Pages dai sorgenti indocs/src/.
6Mappa della memoria (exe italiano)
Offset relativi all'oggetto. Tra parentesi il nome nel disassemblato inglese. Tutti trovati per firma nel build.
Oggetto 2: dati
| Offset | Nome | Significato |
|---|---|---|
| 0x16F8 | STR_BASE | base degli offset dei nomi di leghe e coppe |
| 0x71C8 | dseg_C707E | lista delle competizioni internazionali (45 voci) → spostata in obj1 |
| 0x8032 | italyTable | struttura lega Italia originale (42 B) → sostituita da una in obj1 |
| 0x8C66 | competitionsTable | 256 puntatori per nazione/continente |
| 0x9122 | southAmericaTable | tabella del Sudamerica → spostata in obj1 |
| 0x96D6 | careerFileBuffer | inizio del salvataggio carriera (offset 0 del .CAR) |
| 0x16E20 | selTeamNumber | squadra del giocatore (byte basso = file, alto = indice) |
| 0x16E26 | dseg_D6CDC | divisione del giocatore |
| 0x17FB2 | someLeaguesTable | 2000 byte, uno per numero globale di squadra (promozioni/retrocessioni); offset 0xE8DC nel .CAR |
| 0x18DF4 | dseg_D8CAA | puntatori ai contest dei 5 slot (+4 per slot, sezione 11) |
| 0x18E08 | dseg_D8CBE | tipo di coppa europea del giocatore (trofeo, reputazione, premio) |
| 0x18E0A | dseg_D8CC0 | tabella posizioni dei play-off (slot 4) |
| 0x18E54 / 0x199A6 / 0x1A22C / 0x19DE9 | buffer slot 1 / 2 / 3 / 4 | 0x443 byte ciascuno |
| 0x1F640 | competitionFileBuffer | buffer slot 0 (il campionato) |
| 0x1F67D | dseg_DF533 | regole sostituzioni del campionato (3 word: 5, 2, 8) |
| 0x20A79 | dseg_E092F | quale coppa è nello slot 3 (0 CC, 1 CWC, 2 UEFA; il mod aggiunge 3 Lib, 4 Sup, 5 CON; −1 nessuna) |
| 0x315B7 … | D0 D1 D2 … D7 A0 … A4 | pseudo-registri: D0 0x315B7, D1 0x315BB, D2 0x315BF, D7 0x315D3, A0 0x315D7, A1 0x315DB, A2 0x315DF, A3 0x315E3, A4 0x315E7 |
| 0x4EFF3 | DIY_competitionStart | contest "di lavoro": le routine copiano qui uno slot, lo elaborano e lo ricopiano |
| 0x5953C | leaguesTableCopy | copia di someLeaguesTable usata a fine stagione (checksum!) |
| 0xC058B | dseg_18070F | vincitore della Coppa Campioni (detentore); il mod lo usa anche per la Libertadores |
| 36 | Release 3.2: pacchetti torneo (TORNEI STORICI da dati: gironi, eliminazione, 3° posto, ripetizioni e sorteggio, tabelloni reali); Mondiale 1934 | superato (harness automatico) |
Oggetto 1: codice (routine del gioco usate dal mod)
| Offset | Routine | Ruolo |
|---|---|---|
| 0x7B127 | cseg_8B2D3 | carica un contest in uno slot (D0 = slot, A0 = contest, D1, D2) |
| 0x7D4B5 | cseg_8D661 | il club del giocatore è nella lista di questa coppa? |
| 0x7D917 | cseg_8DAC3 | slot 4: play-off della divisione, con squadre segnaposto |
| 0x7EB02 | cseg_8ECAE | fine campionato: squadre vere nei play-off |
| 0x82BA9 | cseg_92D55 | fine Coppa Campioni: vincitore → dseg_18070F |
| 0x2915F | GetCurrentSeasonPointer | record della stagione (nomi delle competizioni a +1Ah, +1Eh…) |
| VA 0x91345 | assert 80 squadre | quello che bloccava il gioco nel 1997 |
| 0xA09D0 | (nuovo) | struttura lega Italia a 4 divisioni (70 B) |
| 0xA1000–0xA1932 | (nuovo) | pagina aggiunta: coppe SA, Intercontinentale, tabelle, codice carriera e fine stagione |
7Italia a 4 divisioni
Il blocco di fine stagione del 1997
Ogni squadra ha un numero globale (0–1999) usato come indice in someLeaguesTable. L'Italia partiva da 424 con solo 51 numeri: aggiungere squadre sconfinava nella Lettonia (475). Le squadre in più collidevano, e a fine stagione l'assert cseg_91428 (80 squadre nelle liste europee, contatori 16/32/32) finiva in int 3; jmp $. Nel 1997 il mod originale inseriva byte fra la struttura dell'Italia e quella della Lettonia: circa 50 strutture di leghe raggiunte da puntatori fissi venivano lette sfasate e il gioco si bloccava.
La soluzione: la base dell'Italia passa a 1850 (numeri 1794–1999 liberi) nella tabella teamsCountryNumbers, e la nuova struttura della lega va nella cavità di obj1, con il fixup di italyTable reindirizzato (e allargato da 16 a 32 bit).
Struttura di una lega
header 10 byte: [num, type, country, start, end, nameOff, 0, 0, 0, nDiv]
02 03 35
per divisione 6 byte: [squadre, promosse dirette, squadre play-off promozione, retrocesse, play-off retrocessione, offset dati play-off]
00
per divisione 2 dword: offset dei nomi (da STR_BASE)
Il mod usa DIVISIONS in patch.py: A (18, 0, 0, 4), B (20, 4, 0, 4), C1 (18, 4, 0, 4), C2 (18, 4, 0, 0). L'Inghilterra ha già 4 divisioni con lo stesso formato: il motore gestisce 4 livelli senza modifiche al codice.
8Squadre e rose C1/C2
TEAM.020
Il file inizia con un word big-endian (numero squadre) seguito da record da 684 byte. Nel record: +1 ordinale, +2 numero globale (big-endian), +5 nome (17 B), +25 divisione (0 A, 1 B, 2 C1, 3 C2; 4 era "non-league"), +26 prima maglia (5 B), +31 seconda maglia, +36 allenatore (23 B), +60 ordine dei 16 giocatori in formazione, +76 16 giocatori da 38 byte.
| Byte giocatore | Contenuto |
|---|---|
| +0 | nazionalità (18 Italia, 13 Germania, 68 Argentina, 109 Gabon…) |
| +2 | numero di maglia |
| +3 | nome (23 B, terminato da zero: massimo 22 caratteri) |
| +26 | bit 5–7 ruolo (0 G, 1 RB, 2 LB, 3 D, 4 RW, 5 LW, 6 M, 7 A), bit 3–4 carnagione (00 chiara, 10 scura, 01 rossa) |
| +28…+31 | 7 abilità a nibble: passaggio, tiro, colpo di testa, contrasto, controllo, velocità, finalizzazione. Il bit 3 del nibble segna un'abilità principale; il valore reale è v & 7 |
| +32 | prezzo (indice 0–49: 25K … 15M+). Il portiere non ha abilità: il prezzo è la sua bravura |
Il file finale ha 74 squadre (A 18, B 20, C1 18, C2 18), ordinate alfabeticamente, e rimane sotto il limite di circa 93 squadre per nazione (teamFileBuffer da 64014 B). Poiché l'ordine cambia rispetto all'originale, remap_italian_cup_teams corregge gli indici dei club italiani nelle liste delle coppe europee (per nome).
Come si costruisce un club (c1c2.real_team)
- Rosa reale dalla pagina it.wikipedia "<club> 1996-1997" (sezione rosa), divisa in P/D/C/A. I titolari noti vanno per primi; gli altri seguono l'ordine della pagina.
- Si sceglie come modello uno dei 13 club non-league originali con un mix di ruoli compatibile (G/D/M/A contati sulle 16 posizioni), a caso fra i migliori.
- Ogni posizione del modello riceve il prossimo nome del ruolo corrispondente; se il ruolo è esaurito si prende da un ruolo vicino. Per i club che esistevano già, un ruolo mancante (per esempio il secondo portiere) si riempie con un giocatore originale SWOS di quel club.
- Abilità e prezzi del modello si spostano di passi interi verso un obiettivo di prezzo medio ricavato dalla classifica reale (1 passo di abilità = 2 unità di prezzo, limite −3…+2). C1: 15.5–19; C2: 12–15; la Serie B originale ha media 17.9.
- I nomi già presenti nel file (trasferimenti a metà stagione) vanno in fondo alla lista del ruolo, per evitare doppioni. Nomi oltre 22 caratteri: iniziale del nome (
M. DAL COMPARE).
c1c2_rosters.py (l'ordine decide chi entra nei 16) e rilanciare il build. Per cambiare la forza di un club: TARGET.9Struttura delle competizioni
[0] id contest [1] tipo: 1 eliminazione diretta, 2 gironi + eliminazione
[2] nazione (FF = qualsiasi)
[3],[4] mesi: 8 × mese contato da gennaio del primo anno della stagione (≥ 12 = anno dopo)
[5] nomi a +5+[5]: due dword, offset da STR_BASE (stringhe nell'oggetto 2!)
[7] lista squadre a +7+[7]: coppie di byte (numero file TEAM, indice)
[8] 1 = lista fissa (prima fase nell'ordine della lista)
[9] 0 = ogni turno successivo sorteggiato da cseg_27F08 (rimescolamento, poi coppie consecutive, la prima in casa);
altrimenti i contro n−1−i, casa/trasferta a caso
[10] gol in trasferta: 0 no, 1 dopo 90 minuti, 2 dopo i supplementari (Coppa Campioni 1)
[11] incontri per coppia nel girone (2 = andata e ritorno) [12] punti per vittoria
tipo 1: [10] numero squadre, [14..] un byte per turno (0x94 andata e ritorno, 0x14 finale secca), poi 00
tipo 2: [14] numero di fasi, [15] numero squadre, poi da [16] una terna per fase:
(squadre, gironi, squadre per girone); il primo byte della terna dopo = squadre che passano,
dopo l'ultima fase il numero di vincitori (01); gironi FF = finale per il terzo posto.
Le squadre della prima fase sono [15] stesso (tutte quelle della lista).
Da [34] (0x22) un byte per fase: bit 7-6 gare (2 = andata e ritorno), 5-4 supplementari (0 no, 1 sì,
2 solo nella ripetizione), 3-2 rigori (idem): 0x94 andata e ritorno + suppl. + rigori, 0x84 andata e
ritorno, niente suppl., rigori, 0x14 partita secca. Squadre per girone pari (altrimenti int 3; il mod lo toglie).
Formati a gironi del gioco originale (byte da [14]): Coppa Campioni 04 10 04 04 | 08 00 08 | 04 00 04 | 02 00 02 | 01; Mondiale 06 18 06 04 | 10 00 10 | 08 00 08 | 04 00 04 | 02 FF 02 | 02 00 02 | 01 (migliori terze, finale per il terzo posto); Copa América 1995 04 0C 03 04 | 08 00 08 … (2 migliori terze); Coppa d'Asia 05 1E 05 06 | 10 00 10 … (5 gironi da 6 → 16). cseg_24DFA trasforma la struttura nel file DIY (record di fase da 0x76 byte: +0x15D gironi, +0x161 squadre, +0x163 qualificate, +0x169/+0x16B gironi / squadre per girone).
Dai gironi all'eliminazione (cseg_8A2CE; Mondiale ed Europei hanno routine proprie): q = qualificate ÷ gironi, r = resto. Una classifica unica: le prime q di ogni girone in ordine di girone, poi le (q+1)-esime di tutti i gironi ordinate per rendimento, di cui passano anche le prime r. Il sorteggio (cseg_26A78) accoppia poi i con n−1−i con casa/trasferta a caso se [9] ≠ 0; con [9] = 0 rimescola la lista (cseg_27F08) e accoppia squadre consecutive, la prima in casa all'andata. Il hist_draw del mod sostituisce quel rimescolamento con tabelle fisse (DRAWS: id del torneo, squadre del turno, permutazione). Il motore non ha esenzioni, ma una squadra può saltare la prima fase (vedi sotto).
Copa Libertadores 1997 (2.0, lib97.py). 21 club, la detentrice per ultima. lib_bye sostituisce la call cseg_2573C in fondo a cseg_24DFA (obj1+0x15335) e porta a 20 la prima fase di diyFileBufferCopy (obj2+0x4EBD4, +0x161): i gironi prendono i primi 20 club della lista A2+59h; i record dei gironi sono indicizzati per indice nella tabella squadre (cseg_270C7), quindi la 21ª non gioca nessun girone e il suo indice resta in A2+59h[20]. Agli ottavi lib_pre (chiamato da hist_draw) la mette al posto della migliore quarta (16 ÷ 5 dà resto 1) e scambia la 3ª del girone 2 con la 3ª del girone del paese della detentrice (numero del girone in A2+119h): la detentrice incontra sempre la 3ª del proprio girone, come nel 1996 e nel 1997. Segue il tabellone reale del 1997 (ottavi 11 15 9 4 13 1 12 0 6 8 10 3 14 2 7 5 sulla lista 1e A–E, 2e A–E, 3e A–E, detentrice; quarti 1 0 3 2 4 5 7 6). lib_cal sostituisce mov esi,[A0] in cseg_89758 (obj1+0x79676), che prende ogni partita dei gironi da una tabella per numero di squadre (dseg_11F356, 4 squadre: 0-1 2-3, 0-2 1-3, 3-0 1-2; secondo ciclo invertito quando [5Fh] è dispari): i nostri gironi usano invece il calendario reale del 1997 (gironi 1–4 esatti per giornata, girone 5 l'adattamento più vicino). Entrambi agiscono solo per l'id 0x6C con 21 club, quindi una Libertadores 1.3 in un vecchio salvataggio resta nel suo formato fino a fine stagione.
| Id | Competizione | Formato | Mesi |
|---|---|---|---|
| 0x6C | COPA LIBERTADORES | 2.0: intestazione della Coppa Campioni con fasi proprie 05 15 05 04 | 10 00 10 | 08 00 08 | 04 00 04 | 02 00 02 | 01, turni 00 84 84 84 84, [9] = 0, [10] = 0: 21 squadre (20 in 5 gironi da 4, due paesi per girone come nel 1997, calendario reale; la detentrice salta i gironi), prime 3 + detentrice agli ottavi, tabellone reale fisso, andata e ritorno fino alla finale, niente gol in trasferta né supplementari, rigori. (1.3: 20 squadre, prime 3 + migliore quarta agli ottavi con andata e ritorno, finale secca. (1.0–1.2: 16 squadre, 4 gironi.) | come le coppe europee (settembre–maggio) |
| 0x6D | SUPERCOPA | 16 squadre, andata e ritorno, finale secca (clone della Coppa delle Coppe) | idem |
| 0x6E | COPA CONMEBOL | idem | idem |
| 0x6F | COPPA INTERCONTINENTALE | tipo 1, 2 squadre, un turno 0x14 (finale secca); default Juventus – River Plate (Tokyo, novembre 1996) | 0x58–0x60: dicembre, finestra fino a gennaio |
Id liberi: 0x70–0x7B (le leghe usano 0x24–0x6B, 0x7C le personalizzate, 0x7D–0xB1 le coppe). Le squadre sudamericane vengono da TEAM.043 (ARG), 045 (BOL), 046 (BRA), 048 (CHI), 049 (COL), 050 (ECU), 064 (PAR), 065 (PER), 071 (URU), 077 (VEN).
10Tabelle continentali e vista mondo
ViewWorldMenu → ChooseCompetitionMenu → SelectTeamsFinalMenu: ogni puntatore nella voce del continente di competitionsTable diventa un pulsante. Le coppe europee non hanno un trattamento speciale, quindi basta aggiungere puntatori.
Scegliendo una competizione, cseg_3AA17 controlla se è uno dei 4 slot del giocatore (stato reale). Altrimenti cseg_3ABB2 la rigenera al volo: seme casuale = id del contest << 8 | stagione, poi simula fino alla data corrente. Le competizioni in cui il giocatore non c'è non hanno stato persistente: per mostrarle basta che esistano struttura e lista squadre.
- Tabella Sudamerica spostata da obj2+0x9122 a obj1+0xA10E4: qualificazioni mondiali, Copa América, Libertadores, Supercopa, CONMEBOL, Intercontinentale.
- Tabella Europa spostata anch'essa in obj1: 252, Coppa Campioni, Coppe, UEFA, Intercontinentale, −1, 43 nazioni. Cinque pulsanti verdi ci stanno.
- Lista internazionale (
dseg_C707E, obj2+0x71C8) spostata a obj1+0xA1154 con le 4 coppe aggiunte: per questi contest il campo DIY 0x3B vale 0 (simulazione,CalculateViewResult).
11Carriera: i 5 slot
In carriera ogni squadra ha 5 slot di competizione. Per ogni slot il gioco tiene un puntatore al contest (dseg_D8CAA + 4 × slot, 0 = vuoto) e un buffer da 0x443 byte con la competizione in corso. Il calendario scorre gli slot e gioca le partite della settimana.
| Slot | Puntatore | Buffer | Uso originale | Uso nel mod |
|---|---|---|---|---|
| 0 | 0x18DF4 | 0x1F640 | campionato | invariato |
| 1 | 0x18DF8 | 0x18E54 | coppa nazionale | Supercopa per i club sudamericani (nessuna coppa nazionale in Sudamerica) |
| 2 | 0x18DFC | 0x199A6 | coppa di lega, oppure amichevoli e tournée | Intercontinentale se lo slot è libero (Italia, tutti i paesi sudamericani) |
| 3 | 0x18E00 | 0x1A22C | coppa europea | anche Libertadores / Supercopa / CONMEBOL |
| 4 | 0x18E04 | 0x19DE9 | play-off della divisione | Intercontinentale per i paesi con coppa di lega, se la divisione non ha play-off |
Intestazione del buffer
+0 tipo (word), +27h puntatore al nome, +2Bh numero dello slot (word), +2Dh id del contest, +3Dh/+3Fh/+41h regole sostituzioni (5 in panchina, 2 cambi, 8).
cseg_8B2D3 (carica un contest in uno slot)
- Scrive il puntatore in
D8CAA[slot]e+2Bh = slot, poi controlla il tipo: slot 1 e 2 accettano solo coppe di tipo 1 (eliminazione), slot 4 solo tipo 1, slot 0 niente tipo 1. Un tipo sbagliato manda inint 3. - Slot ≠ 4: prende le squadre dalla lista del contest (D2 = 0) o dalle squadre selezionate (D2 ≠ 0), costruisce il tabellone e calcola le date (
cseg_8B71C+cseg_8B8B8). - Slot 4: riempie la lista con
careerTeamripetuto (segnaposto) e non calcola le date. A fine campionatocseg_8ECAElegge daD8CC0quali posizioni di classifica vanno ai play-off, sostituisce i segnaposto (cseg_32E15), calcola le date, copia le regole sostituzioni del campionato e impostaD6B62 = 1("durante i play-off non puoi essere esonerato").
12Inizio stagione
ContinueCareerNextSeason (e InitCareer) chiamano InitializeNewSeason: slot 0, 1, 2 dalla tabella della nazione, poi la catena delle coppe europee (cseg_8D661 con D7 = 0, 1, 2 su Coppa Campioni, Coppe, UEFA), infine call cseg_8DAC3 (slot 4, play-off).
flowchart TD
A[InitializeNewSeason: slot 0, 1, 2] --> B{Club in una coppa europea?}
B -- sì --> F[euro_found: int_step, poi E092F = D7]
B -- no --> I[init_sa]
I --> I1{Blocco salvato 'S2' o 'SA'?}
I1 -- no, carriera nuova --> I2[DEFAULTS in liste + INTLIST, lists_out]
I1 -- sì --> I3
I2 --> I3{Slot 1 vuoto e club nella Supercopa?}
I3 -- sì --> I4[Supercopa nello slot 1]
I3 -- no --> I5
I4 --> I5[int_step: Intercontinentale nello slot 2 se libero e club finalista]
I5 --> I6[Slot 3: Libertadores, Supercopa se non già in slot 1, CONMEBOL; D8CBE = D7 - 3]
F --> D[call cseg_8DAC3 dirottata su int4_step]
I6 --> D
D --> D1[cseg_8DAC3: play-off in slot 4 se la divisione li ha]
D1 --> D2{Slot 4 vuoto, club finalista, Intercontinentale non in slot 2?}
D2 -- sì --> D3[Intercontinentale nello slot 4 con lo scambio dei buffer]
D2 -- no --> Z[fine]
D3 --> Z
Intercontinentale nello slot 4: lo scambio dei buffer
Caricare la coppa direttamente nello slot 4 darebbe una partita "tua squadra contro tua squadra" senza date. int4_step invece:
- chiama il vero
cseg_8DAC3; se lo slot 4 è occupato (play-off) si ferma; - azzera l'id del buffer 4 (così un vecchio buffer non viene ripristinato al caricamento);
- copia il buffer dello slot 2 (coppa di lega) nel buffer 4;
- chiama
cseg_8B2D3con slot 2: l'Intercontinentale viene costruita completa, con le finaliste e le date; - scambia i due buffer da 0x443 byte: Intercontinentale nello slot 4, coppa di lega di nuovo intatta nello slot 2;
+2Bh = 4, regole sostituzioni dal campionato (come fa il gioco per i play-off), ripristina il puntatore dello slot 2,D8CBA = INT.
L'aggancio playoffs all'ingresso di cseg_8ECAE esce subito quando lo slot 4 contiene l'Intercontinentale: altrimenti a fine campionato il gioco la ricostruirebbe leggendo una tabella dei play-off inesistente.
13Caricamento di un salvataggio
ProcessCareerFile ricostruisce i puntatori degli slot dalla tabella della nazione (slot 0–2), dal record della divisione (slot 4) e da E092F (slot 3). I buffer degli slot sono nel salvataggio, i puntatori no: il mod li ripristina guardando l'id nei buffer.
load_slot1: legge il blocco salvato (sezione 15) nelle liste; se lo slot 1 è vuoto e il buffer 1 ha id 0x6D → Supercopa; se lo slot 2 è vuoto e il buffer 2 ha id 0x6F → Intercontinentale; se lo slot 4 è vuoto e il buffer 4 ha id 0x6F → Intercontinentale.load_slot3: estende la mappatura diE092F: 3 → Libertadores, 4 → Supercopa, 5 → CONMEBOL.
14Fine stagione
cseg_91428: combinazione delle liste, per la nazione del giocatore e poi per ogni nazione europea simula o legge la classifica (cseg_9153F), promozioni, coppe; cseg_92D55 / 9307A / 9339D chiudono Coppa Campioni, Coppe e UEFA; cseg_93974 aggiunge le qualificate; assert finale 80 squadre (16/32/32); cseg_92BBF riammette i detentori.
Il mod dirotta la chiamata a cseg_92D55 (obj1+0x812C4) su sa_qualify:
[A4] = Libertadoresecall cseg_92D55 + 10(salta la prima istruzione che imposterebbe la Coppa Campioni): chiude la Libertadores (giocata dal giocatore o simulata concseg_3ADAE) e scrive la vincitrice indseg_18070F→LIBWIN.- Per ogni nazione sudamericana: simula la massima divisione con
cseg_915ED(la stessa simulazione della vista mondo, così le classifiche coincidono). Per la divisione del giocatore legge invece lo slot 0. Dal DIY: +6Dh offset delle righe in ordine di classifica (righe da 12h byte), +12Dh numero squadra per riga. - Scrive le qualificate: Libertadores = campione e seconda di ognuno dei 10 paesi (1.3: 5 gironi BOL+PAR, ARG+ECU, CHI+VEN, BRA+PER, URU+COL,
LIB_Q); CONMEBOL = piazzamenti successivi (CON_Q, 8 coppie: ARG 3–5, BRA 3–5, CHI e URU 3–4, gli altri terze). Supercopa: lista fissa di ex campioni. - Regole della detentrice (reali 1997, 2.0):
LIBWINdiventa il 21° club ed entra agli ottavi. Se si è qualificata anche dal campionato, quel posto va alla 3ª del suo paese, presa dalla lista CONMEBOL, il cui posto va al club successivo (SPARE: la posizione dopo l'ultima del paese in CONMEBOL, letta con le classifiche); se è nella lista CONMEBOL,SPAREprende quel posto. Se non è in Supercopa, ne prende l'ultimo posto. call cseg_92D55vero: chiude la Coppa Campioni. Entrambi i rami finiscono incseg_92F1C, che scrive sempre il vincitore indseg_18070F.INTLIST[0] = [dseg_18070F],INTLIST[1] = LIBWIN(ciascuno saltato se 0FFFFh), poilists_outeret.
flowchart LR S[cseg_91428 fine stagione] --> Q[sa_qualify] Q --> L[Fine Libertadores: LIBWIN] L --> C[Classifiche SA → liste Lib e CON] C --> H[Regole detentrice] H --> E[cseg_92D55 vero: vincitrice CC] E --> N[INTLIST = CC, LIBWIN] N --> O[lists_out: blocco salvato + checksum] O --> R[ritorno a cseg_91428]
15Persistenza nel salvataggio
Il salvataggio contiene someLeaguesTable (2000 byte, uno per numero globale). I numeri 1730–1849 non appartengono a nessuna squadra: il mod ci parcheggia i suoi dati dal numero 1740 (obj2+0x1867E), con una copia speculare in leaguesTableCopy (obj2+0x59C08), perché a fine stagione il gioco copia una tabella sull'altra (cseg_8CC0A e cseg_8CC4E). InitCareer azzera la tabella: una tabella a zero significa carriera nuova.
| Offset | Formato S2 (attuale) | Formato SA (sessione 12) |
|---|---|---|
| +0 | marcatore 'S2' (word 0x3253) | marcatore 'SA' (0x4153) |
| +2 | Libertadores: 16 × (file, indice) | idem |
| +34 | Supercopa | idem |
| +66 | CONMEBOL | idem |
| +98 | Intercontinentale: 2 × (file, indice) | byte di bilanciamento |
| +102 | byte di bilanciamento | — |
Il byte di bilanciamento vale −(somma dei byte precedenti del blocco) mod 256, così la somma dell'intero blocco è 0 e quella della tabella resta 0 per il controllo di cseg_9487A. Lettura: 'S2' tutto dal salvataggio; 'SA' le tre liste più la coppia di default Juventus – River; nessun marcatore → valori del 1997 (DEFAULTS, 100 byte). Il primo fine stagione di una carriera 'SA' la riscrive in 'S2'.
# verifica in Python
blk = save[SAVED:SAVED + 103]
assert blk[:2] == b'S2' and sum(blk) % 256 == 0
16Trofei e reputazione
I bit dei trofei si costruiscono in cseg_39392 dai flag D6C64 (Coppa Campioni, bit 2, reputazione +100), D6C68 (UEFA, bit 3, +50) e D6C66 (Coppe, bit 4, +50). cseg_3D7CB sceglie il flag da dseg_D8CBE, cseg_5DEB9 il premio. Il mod imposta D8CBE = D7 − 3 quando entra una coppa sudamericana:
- Libertadores conta come Coppa Campioni;
- Supercopa nello slot 3 conta come Coppa delle Coppe;
- CONMEBOL conta come UEFA;
- Supercopa nello slot 1 conta come coppa nazionale.
Il riepilogo della stagione (ManagementRecordMenu) mostra già il nome corretto ("COPA LIBERTADORES - WINNERS"). Nomi e bit dedicati (i bit 10–15 sono liberi) richiederebbero nuove stringhe, ma il pool è pieno.
17Tabella degli agganci
Ogni aggancio sovrascrive istruzioni originali con un jmp o cambia il bersaglio di una call; i fixup delle istruzioni sovrascritte vengono rimossi.
| Sito (obj1) | Byte | Originale | Diventa |
|---|---|---|---|
| 0x7D307 | 11 | mov [E092F],-1; jmp done (nessuna coppa europea) | jmp init_sa |
| 0x7D312 | 12 | mov ax,[D7]; mov [E092F],ax (coppa europea trovata) | jmp euro_found |
| 0x7D31E | rel32 | call cseg_8DAC3 | call int4_step |
| 0x237C1 | 10 | cmp [E092F],-1; jz out (ProcessCareerFile) | jmp load_slot1 |
| 0x237FD | 12 | cmp [E092F],2; jz map; jmp out | jmp load_slot3 |
| 0x7EB02 | 13 | cmp dword [D8CBA],0; jz out (cseg_8ECAE) | jmp playoffs |
| 0x812C4 | rel32 | call cseg_92D55 (fine stagione) | call sa_qualify |
Modifiche ai dati: base Italia nella tabella dei numeri globali; fixup di italyTable reindirizzato alla nuova struttura; tabelle Sudamerica, Europa e lista internazionale reindirizzate in obj1; nomi nuovi nel pool di stringhe; indici dei club italiani nelle liste europee; vsize e flag dell'oggetto 1.
init_sa, sa_qualify…) cambiano quando il codice cresce: l'output di patch.py ne stampa i principali, e nasmcave.labels() li restituisce tutti.18Verifica senza giocare
Prima di consegnare una build per le prove, questi controlli vengono fatti ogni volta:
- Il build passa tutti gli
assert(firme uniche, bersagli attesi). - Rilettura con
le.py: le tabelle dei fixup si analizzano senza errori. ndisasmdel codice generato e di ogni sito di aggancio: ogni salto va all'etichetta giusta.- Ogni operando assoluto ha un fixup verso l'oggetto e l'offset corretti (lo script annota ogni riga del disassemblato con i fixup).
- Confronto con la build precedente: i byte cambiano solo nei punti voluti; i fixup cambiati fuori dalla pagina aggiunta devono essere solo quelli attesi.
- Per i dati salvati: emulazione in Python della somma di controllo su una copia di un salvataggio vero.
Se un controllo fallisce e non si risolve, si rimette la build precedente (ITALIAN_S12.EXE è l'ultima provata a fondo).
19Nuove nazioni e coppe continentali per club (1.1–1.2)
Le versioni 1.1 e 1.2 aggiungono undici nazioni di club (Costa Rica, Egitto, Marocco, Tunisia, Nigeria, Camerun, Corea del Sud, Cina, Arabia Saudita, Guatemala, Honduras), le coppe nazionali delle dieci nuove e sei coppe continentali per club (tre africane, la CONCACAF Champions Cup, due asiatiche). Tutto viene generato da countries.py, africa.py, asia.py, namerica.py, cafcups.py e trailer.py; ogni tabella viene trovata dal contenuto, quindi le quattro lingue usano lo stesso codice.
Come si registra una nazione
Il numero di una nazione è anche il numero del suo file squadre: LoadTeamFile trasforma qualunque numero 0–255 in data/team.nnn (100 = CUSTOMS.EDT, al massimo 64000 byte). Il gioco riconosce una nazione di club da queste tabelle (offset di ENGLISH.EXE):
| Tabella | Dove | Voce | Cosa fa il mod |
|---|---|---|---|
countriesTable | obj2+0x6742, 256 dword | puntatore a [byte continente, nome, aggettivo] | record nuovo nella pagina aggiunta a obj2, puntatore nuovo + fixup |
competitionsTable | obj2+0x8B1C, 256 dword | puntatore a [puntatori ai campionati, -2, puntatori alle coppe, -1] | tabella della nazione e struttura del campionato nel cave di obj1 |
teamsCountryNumbers | obj2+0xB2A38, 256 word | base dei numeri globali (globale = base + ordinale, < 2000) | intervallo libero controllato contro tutti i file squadre |
| tabelle dei continenti | competitionsTable[80..85] | [puntatori alle competizioni, -1] + byte delle nazioni + FF | ricostruite nel cave con le nazioni nuove (e le coppe CAF) |
| lista di fine stagione | obj2+0x943A, terminata da FF | nazioni i cui campionati vengono elaborati a fine stagione in carriera | copiata nel cave + nazioni nuove; il suo unico riferimento nel codice viene reindirizzato |
Il byte 5 della struttura del campionato è la distanza dei nomi delle divisioni meno 5, non un flag: 0x15 solo con 2 divisioni, in generale 9 + 6 × divisioni (0 = nomi predefiniti). Un campionato a una divisione con 0x15 bloccava il menu delle competizioni predefinite (Costa Rica, corretto nella 1.1).
Pagine aggiunte e numeri liberi
- obj2 cresce finché la vecchia coda BSS/stack è coperta da pagine a zero, poi una pagina libera: nomi e record delle nazioni stanno a obj2+0xC6000 (la cima dello stack, ESP = vecchia vsize, resta sotto). EN/IT aggiungono 2 pagine, FR/DE 3.
- obj1 ha una seconda pagina aggiunta, 0xA2000: tabelle delle nazioni, strutture di campionati e coppe, coppe CAF, coda del salvataggio.
- Numeri globali davvero liberi nei dati originali: 424–474, 1730–1849 e 1924–1999. Le nazioni nuove usano 424–469, 1730–1785 e 1924–1959; 1847–1849 contengono il marcatore di carriera 'S3'. Ancora liberi: 470–474, 1786–1846, 1960–1999. Numeri di nazione: tutti i controlli "è una nazionale?" del codice sono 80 ≤ n ≤ 85, quindi 86–99 sono nazioni di club come i buchi sotto 80.
- Id delle competizioni: campionati 0x70–0x75, coppe per club 0x76–0x7B (CAF ×3, CONCACAF, asiatiche ×2), coppe nazionali e campionati successivi 0xB2–0xC0 (dopo l'ultima coppa originale, 0xB1). Gli id servono solo come identificativi e come seme casuale: nel codice non ci sono controlli per fasce.
Le nazioni nuove
- Costa Rica (TEAM.047, dati originali): aveva 12 club ma né nome né campionato. Ora ha una PRIMERA DIVISION da 12 squadre in Nord America.
- Egitto, Marocco, Tunisia, Nigeria, Camerun (TEAM.052, 053, 054, 056, 058): club reali e classifica finale 1996-97 (1997 per Nigeria e Camerun), da RSSSF e Wikipedia; coppa nazionale da 16 (Tunisia 8).
- Corea del Sud, Cina, Arabia Saudita (61, 63, 86; 1997, 1997, 1996-97) e Guatemala, Honduras (87, 88; 1996-97): stesso metodo, modelli dai club della J-League, dell'Algeria e di El Salvador, coppe nazionali da 8.
- Giocatori inventati. Per questi campionati non esistono rose 1996-97 affidabili, quindi i nomi di giocatori e allenatori sono inventati con nomi comuni di ogni paese, su ruoli, volti e abilità dei club africani originali (Algeria, Ghana), spostati verso una forza che scende con la posizione in classifica. Rose reali di quegli anni sono benvenute (GitHub Issues).
Coppe continentali per club e coda del salvataggio
- Competizioni (
cafcups.CUPS): CAF Champions League (copia della Coppa Campioni: 4 gironi da 4 + eliminazione diretta), CAF Cup Winners Cup, CAF Cup, CONCACAF Champions Cup, Asian Club Championship e Asian Cup Winners Cup (eliminazione diretta a 16). Pulsanti del loro continente e membri della lista delle competizioni internazionali. - Carriera: la catena dello slot 3 di
sacups.pyè generata dalla lista: D7 = 6 … 11; trofeo e premio come la coppa europea dello stesso livello (una tabella dei livelli). - Fine stagione: la tabella delle qualificazioni ora ha 30 nazioni: per esempio CAF Champions League posizioni 1–2, Coppa delle Coppe 3–4 (il gioco non conserva le vincitrici delle coppe nazionali), CAF Cup 5–6, CONCACAF 1–4.
- Coda del salvataggio:
SaveCareerFilescrive 'C6' + tutte le liste salvate (sudamericane con la Libertadores da 21, coppia dell'Intercontinentale, le sei coppe: 304 byte; 'C5' della 1.3: 302 byte, 'C4' della 1.2: 294 byte) dopo i record delle squadre se c'è spazio ing_selectedTeams(68400 byte, seguiti dagli pseudo-registri);LoadCareerFilele rilegge. Salvataggi vecchi: il blocco 'S2'/'SA' della 1.0/1.1 insomeLeaguesTableviene letto e azzerato, le code precedenti ('C1'…'C5') vengono lette; la loro lista Libertadores da 16 o 20 viene completata con i primi club di default non presenti (lib_merge; la fine stagione la ricostruisce comunque); una carriera nuova si riconosce dall'assenza del marcatore 'S3'.
20Tornei storici (2.0)
Tre tornei storici con formato e rose reali, giocabili solo nelle Competizioni predefinite: non compaiono mai in carriera, stagione, DIY, amichevoli o modifica squadre. Codice in historic.py (esenzione: lib97.py), rose in mitropa34.py e facup72.py (fonti nei loro docstring).
- Il pulsante. Ogni menu di squadre/competizioni è
SelectTeamsFinalMenuavviato dacompetitionsTable[254](la tabella mondo).hist_presetsostituisce solo lacall SelectTeamsFinalMenudiSelectTeamsForPresetCompetition(obj1+0x3C533): per la durata della chiamatacompetitionsTable[254]punta a una tabella mondo estesa ([worldCup, -1]+ continenti + 89), poi viene ripristinata. Il paese 89 (CLASSICS: it TORNEI STORICI, en CLASSIC TOURNEYS, fr TOURNOIS ANCIENS, de TURNIERKLASSIKER) ha un record incountriesTableecompetitionsTable[89] = [-2, WC82, M34, FA, -1](solo coppe).hist_namessostituiscecall SetCountryNamesinSelectTeamsReinite dà al pulsante il colore 11 (dal blu al viola) e 5 pixel di distacco. - Squadre. TEAM.089 (Mondiale 1982), TEAM.090 (Mitropa 1934), TEAM.091 (FA Cup 1871-72): numero del file squadre = numero del paese,
countriesTable[90]/[91]= il record CLASSICS. Tutti e tre condividono i numeri globali 1786–1817 (non si incontrano mai fra loro né con squadre reali nello stesso torneo, eSetLeagueNumbersgira solo in carriera). IlCUSTOMS.EDTdei DLC di SWOS 2020 ha gli stessi record da 684 byte dei file TEAM. - Tornei (cloni dell'intestazione del Mondiale): 0xC1 Mondiale 1982, fasi
05 18 06 04 | 0C 04 03 | 04 00 04 | 02 FF 02 | 02 00 02 | 01, turni00 00 14 14 14, 2 punti a vittoria; 0xC2 Mitropa 1934,04 10 00 10 | 08 00 08 | 04 00 04 | 02 00 02 | 01, turni80(andata e ritorno, niente supplementari né rigori: la parità nel complessivo si rigioca come spareggio), gol in trasferta disattivati; 0xC3 FA Cup 1871-72,04 0F 00 0F | 08 00 08 | 04 00 04 | 02 00 02 | 01, turni00(gara secca, il pareggio si rigioca). - Gironi dispari.
cseg_24DFAsi bloccava (test D0,1; jz; int 3; jmp $) con un numero dispari di squadre per girone, ma i gironi sono campionati DIY, che accettano da 2 a 24 squadre.odd_groupstrasforma iljzinjmp(obj1+0x1523F): la seconda fase del 1982 ha 4 gironi da 3. - Sorteggi fissi.
hist_drawsostituisce entrambe lecall cseg_27F08(il rimescolamento casuale diA2+59hchiamato dacseg_26A78ecseg_26DFCquando il [15Fh] del turno è 0; obj1+0x169A0, +0x16D24). Righe diDRAWS: id del torneo, squadre del turno, permutazionenew[k] = old[perm[k]]; una permutazione che inizia conFFvuol dire "solo l'esenzione, poi il sorteggio casuale del gioco". Le qualificate dai gironi arrivano come 1ª di ogni girone A…, poi 2ª A…, poi le migliori (cseg_8A2CE). Mondiale 1982: seconda fase0 2 11 | 1 3 10 | 6 8 5 | 7 9 4(1A 1C 2F, 1B 1D 2E, 2A 2C 1F, 2B 2D 1E), semifinali0 2 1 3(A–C, B–D). Mitropa: gli accoppiamenti reali in ordine, semifinali e finale con la squadra di casa reale per prima. - Esenzione in una coppa a eliminazione diretta (FA Cup: Hampstead Heathens). Stesso meccanismo della Libertadores (capitolo 9):
lib_byefa giocare il 1° turno a 14 club su 15;cseg_8A7BFcopia solo 14 voci ecseg_2ACAEmette in testa le 7 vincenti, quindiA2+59h[14]sopravvive elib_prelo sposta al posto 7 del 2° turno, prima del sorteggio libero. - Il sorteggio a moneta. Nel 1872 e nel 1934 non c'erano i rigori: una ripetizione o uno spareggio finiti in parità si decidevano a sorte.
coin_drawsostituisceor byte [D7],80h; and byte [D7],0FDhincseg_2AE97(pareggio → ripetizione, obj1+0x1B37A) per le partite giocate e simulate: nei nostri tornei, quandoDIY_competitionStart[32Fh](contatore delle ripetizioni) non è 0, vincitore a caso (Rand2), risultato registrato come "rigori" 1-0 / 0-1 con i flag di gara decisa.coin_textsostituisce ilmov ax,[skip]prima delPrintFormatteddei risultati incseg_289AC(obj1+0x18BA1) e scrive "%a VINCE AL SORTEGGIO". - Lezione (regola d'oro). Quando un aggancio sovrascrive un'istruzione che contiene un indirizzo assoluto, la sua fixup va rimossa prima (
p.remove): altrimenti il loader DOS/4GW riscrive quei byte e la nuovacallsalta nel vuoto. Tutti i crash delle prime build del sorteggio venivano da qui. - Rose. Mondiale 1982: le 24 nazionali del DLC SWOS 2020 di Insane, prese per nome. Mitropa 1934: formazioni reali sulle nazionali del 1934 del DLC Mondiale 1934 di Insane (posti, numeri, volti; i nazionali del 1934 tengono il suo record, gli altri sono livellati sulla forza del club; Meazza, Sindelar, Sárosi, Bican, Schiavio, Plánička, Reguzzoni, Nejedlý, Monti, Orsi al vertice). FA Cup 1871-72: il DLC "British Football Pioneers" di Francescomanetti82 e Gorzo come modelli. I giocatori copiati da un DLC tengono il ruolo del loro posto.
- Nomi ricostruiti (nessuna fonte; nomi tipici del paese). Mitropa 1934 (22): Ferencváros 1 (Ferenc Horváth), Floridsdorfer AC 4 (Anton Huber, Leopold Hofer, Franz Moser, Anton Gruber), Ambrosiana 1 (Pietro Greco), Bologna 1 (Giovanni Colombo, portiere di riserva), Bocskai 5 (Sándor Varga, Ferenc Tóth, Ferenc Molnár, Imre Varga, József Németh), Austria Wien 2 (Karl Hofer, Anton Hofer), Újpest 2 (István Farkas, József Tóth), Teplitzer FK 1 (Miroslav Pokorný), Admira Wien 3 (Franz Pichler, Karl Moser, Franz Berger), Hungária 2 (Imre Molnár, József Balogh). Allenatori sconosciuti lasciati vuoti (Floridsdorfer AC, Austria Wien, Teplitzer FK, Admira Wien); alcuni giocatori hanno solo il cognome, come nelle fonti; le maglie di Kladno e Teplitz sono provvisorie. FA Cup 1871-72 (59): Civil Service, Hitchin, Royal Engineers e Wanderers 1 ciascuno, Hampstead Heathens 2 (riserve), Maidenhead 5, Great Marlow 5, Upton Park 4, Harrow Chequers 6, Reigate Priory 15 (reale solo R. W. Clutton), Donington School tutti e 16. I ruoli dei giocatori del 1871 sono ricostruiti (le formazioni si stampavano senza); le maglie di Hitchin, Maidenhead e Reigate Priory sono provvisorie; "HAMPSTEAD HEATH." per il limite di 16 caratteri.
- Non riproducibili. I ritiri e le vittorie a tavolino della FA Cup, le decisioni del comitato che facevano passare entrambi i club (Hitchin–Crystal Palace, Queen's Park–Donington, Wanderers–Crystal Palace), il ritiro del Queen's Park prima della ripetizione della semifinale.
21Argentina, Oceania e MLS (2.5)
Quattro campionati ricostruiti come si giocarono nel 1996-97. Codice in arg97.py (Argentina), nsl97.py + nsl_lineups.py (Australia), nz97.py (Nuova Zelanda, e il codice dei rigori condiviso con la MLS), mls97.py + mls_tm.py (USA), finals97.py (play-off e registro della stagione). Le fonti sono elencate nelle docstring; le pagine scaricate restano fuori dal repository.
- Apertura / Clausura. La Primera tiene una sola struttura di campionato da 38 giornate;
arg_round(davanti ai contatori per partitacseg_8922B) la cambia all'inizio della prima partita del Clausura:[5Fh]= 1 ciclo rimasto,[5Bh]=[1CBh]= 0 e ogni riga con V+N+P = giocate = n−1 (anche chi costruisce il calendario chiamacseg_8922B, con tutti i risultati a 0: il controllo su V+N+P evita che lo scambio scatti mentre si crea una carriera). La classifica dell'Apertura viene copiata nel trailer (AP_TAB), la classifica si azzera, il nome diventa TORNEO CLAUSURA e il registro della stagione riceve un testo fisso per club "CLAUSURA (AP: club)" (salvato come distanza dalla stringa del presidente, quindi resta dopo salvataggio e caricamento). Ogni stagione parte come APERTURA (arg_prebuild,arg_loaddopo il caricamento). - Classifica complessiva e promedio.
arg_agggira prima delle qualificazioni sudamericane (sa_qualifylegge la classifica dello slot 0): riscrive la classifica dello slot 0 come Apertura + Clausura (3 punti a vittoria, differenza reti), poiarg_relegatesceglie i due promedios peggiori (punti a 2 per vittoria / partite, ultime tre stagioni; storico nell'elemento PROM del trailer, 32 club × 10 byte, valori iniziali = le stagioni reali 1994-95 e 1995-96) e li porta in fondo, cosìcseg_93FD8li retrocede.arg_prom_updateaggiunge la stagione allo storico. - Australia. TEAM.044 = 54 record (52 club di campionato + le due rappresentative della NSL Cup); divisioni 14/12/14/12. All'Australia servono 52 numeri globali: la Bolivia (TEAM.045) passa a 1248–1261 e la Nuova Zelanda a 1960–1999 (globale =
teamsCountryNumbers[file] + ordinale, ricalcolato a ogni caricamento;BASE_MOVES). NSL Cup: struttura di tipo 1 con lista fissa (16 club, turni 94 54 54 14), sorteggi fissi tramitehist_draw. - Punto dei rigori NSSL.
nz_setupsostituiscemov penaltiesState,0nella preparazione della partita di carrieracseg_89381(1 se entrambi i club sono della NSSL o della MLS): un pareggio va ai rigori al 90'.nz_drawnel ramo del pareggio dicseg_88A12dà +1 punto a chi vince ai rigori (partite simulate: vincitore a caso); per la MLS prima si toglie il +1 a testa del motore (3/1/0).nz_mark(fine dicseg_2A71E) trasforma la voce dell'elenco partite in "VINCE x-y AI RIG.". La nuova struttura della Nuova Zelanda ha 4 divisioni (NSSL, NORTHERN, CENTRAL, SOUTHERN), 4 punti a vittoria. - Play-off (NSL Finals, NSSL Playoffs). Il play-off nativo di divisione: voce di divisione "0 promosse, 4 al play-off" = posti 1–4, blocco del play-off
[contest][lista][4 word di indice][4×4 delta a zero](nessuno si sposta), contest = coppa di tipo 1 clonata da quella del paese 25 (id C4/C5, turni NSL 94 14, NSSL 14 14), costruita nello slot 4 dacseg_8B2D3e riempita a fine campionato dacseg_8ECAE. Bug trovato: il numero di turni del buffer dello slot 4[59h]arriva a 1 per 4 club (cseg_268C6calcola 2; chi scrive l'1 non è stato trovato), quindi il calendario della carriera (ramo di tipo 1 dicseg_8BF89) dava una data solo alle semifinali e la finale non si giocava mai.cal_roundsaggancia quella lettura (IT obj1+0x7BF4C, EN +0x7C0F8) e imposta 2 turni per C4/C5. - Registro della stagione.
rec_guard: il registro cerca il club in ogni competizione della stagione (ricerca IT obj1+0x2B6ED, EN +0x2B899); un club assente dalla lista fissa della sua coppa (il Perth Glory, che non giocò la NSL Cup 1996-97) finiva in un assert (int 3; jmp $). Ora la ricerca restituisce −1 e la riga della coppa viene tolta.rec_playoff(chiamata IT obj1+0x295E9, EN +0x29795): un club che ha giocato il nostro play-off ha come riga del campionato il risultato del play-off (1 = VINCITORI, FINALISTA, ALLE SEMI-FINALI), con la ricerca di coppa del gioco stesso sul buffer dello slot 4 (puntatore del contest = puntatore dello slot 0 + 16). - MLS 1997. Record di TEAM.073 sul posto (rose da Transfermarkt, i 16 giocatori più impiegati, record di SWOS riusato quando il giocatore esiste); struttura del campionato con 4 partite per coppia.
- Nota per il debug. In DOSBox-X l'obj1 è caricato all'indirizzo lineare 0x262000: un breakpoint è
BP 160:(0x262000 + offset in obj1).
22Stagioni storiche: la DDR 1988-89 (2.6)
Vuoi metterti alla guida di una squadra della stagione 1988-89 del campionato della DDR e cercare di vincere campionato, coppa nazionale e la coppa europea a cui la tua squadra è qualificata? Ora puoi! Dalla sessione 30 è il pacchetto stagione packs/ddr-1988-89 compilato da mkseason.py (capitolo 23); nella 2.6 il codice era ddr89.py ed euro8889.py, con piccole aggiunte a historic.py, lib97.py e patch.py.
- Squadre. TEAM.092 = le 14 dell'Oberliga (ordine della classifica finale), TEAM.093 = le 18 squadre minori della FDGB-Pokal, TEAM.094/095/096 = le squadre straniere di Coppa dei Campioni, Coppa delle Coppe e Coppa UEFA 1988-89. Un paese con un solo campionato deve avere tante squadre quante ne dichiara il campionato (il numero di squadre di un paese è
teamsCountryNumbers[n+1] − [n]): per questo le squadre della sola coppa stanno in un file a parte. Numeri globali: DDR 1786–1817; le coppe europee usano 1850.. come l'Italia, che non è mai in una stagione della DDR. - Paesi e competizioni. Paese 92 «DDR 1988-89» con tabella [Oberliga, −2, Pokal, coppa, −1]. Oberliga: 1 girone da 14, andata e ritorno, 2 punti a vittoria, 2 retrocessioni (id C6). Pokal: struttura della coppa australiana (32 squadre, 5 turni secchi con supplementari e rigori, id C7), tabellone fisso con
historic.DRAWS. Coppe europee: struttura della Coppa delle Coppe del gioco (id C8/C9/CA), liste fisse e un sorteggio fisso per turno: il tabellone reale. Il PSV detentore salta il primo turno della Coppa dei Campioni come il club esente della FA Cup (lib_bye/lib_pre). - Coppa europea nello slot 2.
InitNewSeasoncarica lo slot 2 dalla terza voce della tabella del paese;euro_slot2sostituisce ilmov [A0], eaxche la precede (IT obj1+0x7B04F): cerca fra le squadre selezionate la prima della DDR non controllata dal computer (teamControls≠ 1) e le dà la sua coppa (BFC → Campioni, Jena → Coppe, Dresda e Lipsia → UEFA); se non ce n'è, lo slot 2 resta vuoto. - STAGIONI STORICHE. Il selettore della Stagione usa una tabella del mondo [Mondiale, −1] + continenti + 97 (pseudo-continente, nome per lingua, viola come TORNEI STORICI tramite
hist_names); la tabella 97 è [−1] + 92 + FF. Il gioco legge un elenco di paesi solo per i numeri 80–85: iljadopocmp word [D7], 85inSelectTeamsFinalMenupassa dacont_check, che accetta anche 97. Le prossime stagioni storiche si aggiungono alla lista del 97. - Rose. Oberliga: i 16 giocatori con più minuti (weltfussball.de), abilità dal database SWOS 2020 «1990_91 - Team Updates» di Peppecapello quando il giocatore c'è. Coppe: rose 1988-89 di weltfussball.de (minuti in campionato, altrimenti in coppa); modello = il record dello stesso club nel gioco 1996-97 quando esiste; i giocatori già nel gioco tengono il loro record. La ß diventa SS nei nomi.
Serie A 1947-48 (3.0)
Stagione > STAG. STORICHE > ITALIA 1947-48 (anche nei TORNEI STORICI come SERIE A 1947-48), pacchetto packs/italia-1947-48, file TEAM.145. 21 squadre nell'ordine finale con i nomi del 1948, 42 giornate (ogni giornata una riposa), 2 punti a vittoria, 4 retrocessioni; solo campionato (niente Coppa Italia 1943-58, nessuna coppa europea). Date del calendario copiate dalla Spagna 1996-97 (22 squadre, 42 giornate). Valori del Torino dal "1900s Retro Pack Teams (1900-1970)" di SWOS 2020 (FrancescoManetti82 e Gorzo), le altre 20 squadre tarate sui punti finali con record 1996-97 di pari forza (senza spostamenti di livello). Il setup del campionato in Stagione/Carriera finiva in int 3; jmp $ con un numero dispari di squadre: patch odd_leagues, applicata solo se un pacchetto ha una divisione dispari. Strumento tools/itwiki_season.py per le bozze di stagioni italiane da it.wikipedia.
Giornate vere (3.3.5): le tabelle degli accoppiamenti del gioco per un numero dispari di squadre (dseg_11F356[n - 2], n = 5..23) non sono giornate: il motore del campionato gioca n // 2 coppie per giornata (cseg_8922B) e con 21 squadre in 15 giornate su 21 una squadra compariva due volte e un'altra mancava. tools/oddtables.py (chiamato da mkseason.odd_leagues, quindi solo nelle build con una divisione dispari) le riscrive sul posto con il metodo del cerchio: stesse coppie e stessa lunghezza, una squadra a riposo per giornata, casa e trasferta alternate (al massimo 3 di fila). In carriera le tabelle vecchie potevano anche far scrivere al costruttore del calendario (cseg_8B8D9) due partite della squadra allenata in un solo blocco e bloccare la stagione successiva. Scenario season4748: 6 giornate di 10 partite con 20 squadre diverse.
DDR ricalibrata (3.0): gli spostamenti di livello di calibrate falsavano la forza (1 livello = circa 9 punti di prezzo nei valori, il prezzo ne muove 2): ora i modelli di campionato sono scelti per forza, senza spostamenti, e i valori seguono la classifica 1988-89 (TEAM.092). Regola da qui in avanti: prima di pubblicare una stagione o un mondo storico si confrontano i valori costruiti con le classifiche reali e una stagione simulata deve somigliare a quella vera.
23Pacchetti stagione e carriere storiche (3.0)
Un pacchetto stagione è una cartella di soli dati (packs/<id>/: pack.json + clubs.csv, players.csv, ties.csv, formato in packs/README.md) che tools/mkseason.py compila in file squadre e tabelle dell'exe, in modo deterministico. La DDR 1988-89 del capitolo 22 ora è il pacchetto packs/ddr-1988-89 (identica byte per byte alla 2.6; ddr89.py ed euro8889.py sono stati rimossi). In una build entrano più pacchetti (mkseason.ENABLED); una rosa si costruisce con calibrate (forza obiettivo), game (giocatori già nel gioco) o explicit (ogni valore indicato). I numeri di nazione 101–251 sono liberi e funzionano (il nome del file squadre si costruisce da 0–255).
Un pacchetto carriera ("kind": "career") è un pacchetto giocato come carriera, dal pulsante CARR. STORICHE (pseudo-continente 98) del selettore squadra della carriera: career_sel sostituisce call ChooseTeamsDialog in SelectTeamToManage e scambia competitionsTable[254] con una tabella mondo che contiene 98. Il suo campionato può avere più divisioni con promozioni e retrocessioni (divisions + la colonna division di clubs.csv = byte +25 del record). Un mondo è un insieme di pacchetti carriera con lo stesso numero world: una carriera iniziata con uno dei suoi club vede solo le nazioni e le coppe europee del mondo (tools/careerworld.py). Stato: menu e divisioni provati (M1); cambio di mondo (M2) e anno, vista del mondo, detentori (M3) provati per due stagioni con un mondo di test a 4 nazioni.
Come funzionano davvero le coppe europee in carriera
- Inizio carriera.
InitCareerazzerasomeLeaguesTable(tutti i 2000 byte), mettecareerFileBuffer= 0 e chiama tre volteLoadSomeEuroCup:data\eurocup.tmd,eurocwc.tmd,uefacup.tmdvengono accodati intmdFileBuffer(80 × 684 byte, parte del salvataggio;careerFileBufferconta i record). Un record TMD è semplicemente un record di file squadre:SetTeamGlobalNumbersricalcola la word +2 =teamsCountryNumbers[byte 0] + byte 1. Poi la tabellacareerContests[sorgente, destinazione, dimensione] copia le strutture statiche delle coppe nel salvataggio:euroCupCopy(79 byte, 0x1ADFE),cupWinnersCupCopy(92, 0x1AE4D),uefaCupCopy(92, 0x1AEA9). - Elenco squadre di una struttura coppa a byte [7] + 7, una coppia di byte (file nazione, ordinale) per club: 16 coppie nella copia della Coppa dei Campioni, 32 nelle altre due. Le coppe della stagione successiva SONO queste copie nel salvataggio.
- Fine stagione (
cseg_91428).cseg_936C0punta i tre cursori di lista sugli elenchi squadre dentro le copie, azzera i contatori ed espande le tabelle dei posti statiche (0x95C6 / 0x9615 / 0x9664) in liste di nazioni di lavoro. Una tabella dei posti è[dd nazioni, dw n, dw prese]…+dd −1:cseg_93E36mescola gli n byte di nazione e ne prendeprese(es. Coppa dei Campioni: 4 su 4, 5 su 6, 5 su 11, 2 su 22). Poi ogni nazione diseasonEndList(0x9584, prima quella del giocatore) passa percseg_9153F(campionato) ecseg_93974(qualificate, solo continente europeo):cseg_93D67scrive la coppia del club nell'elenco della coppa ecseg_94193copia il suo record intmdFileBuffer[careerFileBuffer++]. - Controlli.
careerFileBufferdeve valere 80 dopo il ciclo e di nuovo alla fine, i tre contatori 16 / 32 / 32: altrimentiint 3; jmp $(il blocco del 1997, capitolo 7). - Detentori (
cseg_92BBF→cseg_92C4D): la vincitrice della coppa sostituisce una voce a caso dell'elenco, e il suo record viene scambiato intmdFileBuffer. La routine confrontavoce >> 8condetentore >> 8: su PC è l'ordinale del club (byte 1), non la nazione — un residuo dell'originale 68000 big-endian. Termina solo se qualche voce ha un altro ordinale e non è quella del giocatore. Quindi il detentore prende il posto di una qualificata (nel mondo di test un campione nazionale ha perso il posto in Coppa dei Campioni): i formati reali in cui il detentore ha un posto suo richiedono un aggancio qui. - Checksum. A fine stagione
cseg_9487Aesige chesomeLeaguesTablesommi a 0 modulo 256 (capitolo 15). Il numero globale 1999 appartiene a un club di TEAM.062; 1818–1846 non appartengono a nessuno.
Il cambio di mondo (M2)
- Byte del mondo =
someLeaguesTable[1845] (0x17FB2 + 1845), byte di bilanciamento [1846] = −mondo; 0 = il mondo 1996-97. Entrambi i byte vanno anche inleaguesTableCopy:InitializeNewSeasonricopia quella tabella susomeLeaguesTable(cseg_8CC4E), e un byte scritto una volta sola spariva (trovato nella prima prova: la stagione 2 aveva le qualificate del 1996-97). Lo scrive l'aggancio sulla prima chiamata aLoadSomeEuroCup, dalla nazione del club scelto (salvata all'ingresso diInitCareer, 0x7C5EA). - Coppe europee del mondo: coppe a eliminazione diretta che stanno nelle copie del salvataggio: Coppa dei Campioni ≤ 16 club, Coppa delle Coppe e Coppa UEFA ≤ 32, totale ≤ 80, ognuna una potenza di 2. Le strutture usano il formato della Coppa delle Coppe con id, date e nomi della coppa originale. Nel salvataggio non si sposta nulla.
- Agganci (ITALIAN.EXE, obj1): ingresso di
InitCareer0x7C5EA; le tre chiamate aLoadSomeEuroCupda 0x7C7D3 (un mondo carica un solo file,data\worldNN.tmd= i suoi club europei della prima stagione); dopo la copia dicareerContests0x7C876 (le tre strutture del mondo); riferimento aseasonEndList0x812FB; i cinque controlli da 0x81345; le tabelle dei posti da 0x835AF (anche la lettura del primo gruppo della tabella UEFA). - Campi del pacchetto:
world,europe_places{cc, cwc, uefa}, facoltativofirst_europe(predefinito: ordine del campionato),world_cups(turni) in un solo pacchetto del mondo. I club di un mondo possono riusare i numeri globali dei club europei 1996-97: una carriera storica non carica mai quei file. - Anno della stagione (M3).
seasonPlayingè un byte (96 = 1996, +1 a stagione, 100 → 0);PrintNameAndSeasonaggiunge 100 sotto il 1996 eCareerOverFinishsotto il 1995. Un mondo imposta il suo primo anno (world_cups.start_year) dopo la copia dicareerContests, e i due confronti usano quell'anno. - Euro 128 (2026-10-10). Un mondo grande (più di 80 club europei, o una coppa oltre 16 / 32 / 32) gioca fino a Coppa dei Campioni 32, Coppa delle Coppe 32, Coppa UEFA 64 (128 club; una coppa di tipo 1 ne contiene al massimo 64). I 128 record, le tre coppe e le tre liste dei posti si spostano in una coda azzerata dell'obj2 (la sua dimensione virtuale cresce di 0x16000; 18 istruzioni
mov [Ax], offset Xscelgono il buffer spostato tramite piccoli stub;dseg_C707E, la lista dei tornei i cui club vengono dal buffer tmd, è copiata con le tre coppe nuove). Il .CAR mantiene il suo formato: in un mondo grande l'area degli 80 record contiene un blocco W1 (le coppe + per ogni club file/ordinale e i 99 byte che il gioco modifica), e il caricamento ricostruisce i 128 record dai file TEAM. In ogni mondo la fine stagione salta le simulazioni delle qualificate 1996-97 (Sudamerica, Africa, Asia, CONCACAF, Argentina: i loro club condividono i numeri globali con i club del mondo) e chiude la Coppa dei Campioni come coppa a eliminazione diretta (cseg_45B51/cseg_3ACAB, come la Coppa delle Coppe) invece che come la coppa a gironi del 1996-97. I pack carriera hanno pagine obj1/obj2 proprie; un id di campionato può essere condiviso dalle nazioni di uno stesso mondo. Provato per tre stagioni con un mondo di test di 31 nazioni. - Vista del mondo e giocatori stranieri (M3). In un mondo
ViewWorldMenu(la suacall ChooseCompetitionMenu) eBuyOtherForeignPlayer(la suacall ChooseTeamsDialog) girano concompetitionsTable[254]= [mondiale, −1, 99] e[99]= il continente del mondo: le sue tre coppe puntano alle copie nel salvataggio (liste correnti, stato reale per la coppa del giocatore) e le sue nazioni. - Niente panchine delle nazionali (M3). La coda di
cseg_8D7B4scrive −1 inlastNationalityCallin un mondo (−1 = nessuna offerta incseg_5B705). - Detentori con un posto loro (M3).
cseg_93BCEazzera un detentore qualificato dal campionato ecseg_92C4Dsostituisce una qualificata a caso: con un posto in più per il detentore la coppa restava con un club in meno (blocco). In un mondo le trecall cseg_93BCE(campione dicseg_939C9, i cicli di Coppe e UEFA) saltano ogni detentore e ogni club già in una lista (il posto va al club successivo della classifica), ecall cseg_92BBFaggiunge in coda i tre detentori con i loro record salvati (cseg_94193). Posti = dimensione della coppa − 1; i controlli prima dei detentori usano il totale − 3. Il codice dei mondi sta in una sesta pagina di obj1 (0xA6000), aggiunta solo nelle build con un mondo.
Numeri di maglia d'epoca (3.3.4)
- Numeri per posizione. Prima dei numeri fissi di rosa (1993-95) il numero di maglia indicava il posto nella formazione. Un pacchetto con
"numbers": "place"(tutti i pacchetti storici della mod, Europa 1984-85 compresa) è rinumerato damkseason._place_numbers: gli 11 titolari tengono un 1..11 che hanno già, se unico (Baresi 6 nel Milan), e gli altri prendono quelli liberi; la panchina (posti 12..16) fa lo stesso con 12..16; tutti gli altri prendono i numeri liberi sopra il 16 nell'ordine della formazione. - Menu oltre l'11.
tools/menunum.py: il testo della panchina nei menu della rosa stampa 0..99 (si fermava a 19) e il campo della tattica ha gli sprite per 12..99 (1620..1707), così anche nei menu le squadre modificate e le rose moderne con numeri oltre l'11 li mostrano giusti.
24SWOS++ (2.7)
Dalla 2.7 la mod funziona con SWOS++ di Zlatko Karakas (partite in rete, replay completi, editor DIY, numeri di maglia fino a 255, calibrazione del joystick), solo sull'eseguibile inglese (CD o GOG). L'ha chiesto Zlatko (tramite Playaveli). Studio e strumento: notes/swospp.md, tools/swospp.py. Gli indirizzi sono offset negli oggetti di ENGLISH.EXE: SWOS++ esiste solo in inglese.
- Perché patchit.com non funziona sulla mod. Scrive 36 blocchi a offset fissi nel file dell'exe originale, 21 dei quali dentro la tabella dei fixup. La mod ricostruisce quella tabella e aggiunge pagine, quindi gli offset nel file si spostano. Gli offset negli oggetti invece restano gli stessi, perché la mod non sposta mai il codice originale.
- L'installazione, in termini di oggetti.
main_+0x18:sub esp,0→ nop,call SWOS→call DumpTimerVariables. DumpTimerVariables (obj1+0xA929, codice di debug inutilizzato) diventa uno stub che salva i registri e gli pseudo-registri D0/D1/A0/A1, chiamaLoadFile("LOADER.BIN", pitchDatBuffer), chiama il loader con eax = base di obj2 ed ebx = base di obj1, poi ripristina tutto e salta aSWOS. La stringa a obj2+0x54F4 ("SAVE DISK F…") diventaLOADER.BIN. SetDefaultOptions+0x10 espinBigScambiano un byte ciascuno (1 → 0). Fixup: 14 record della routine di debug tolti, 7 aggiunti (cima dello stack, base di obj2, base di obj1, quattro pseudo-registri). - tools/swospp.py riapplica esattamente questo sull'exe modificato, con
lepatch. Sull'exe originale il risultato è identico a quello di patchit: stessi byte negli oggetti, stessi 73388 fixup.patchit()riproduce patchit byte per byte, così il patcher riconosce anche un gioco originale con SWOS++ già installato. - A runtime. loader.bin carica swospp.bin, lo riloca e modifica 54 punti in memoria agli indirizzi inglesi (voce del menu principale, GameLoop, DrawSprites, finestre dei file, ShowMenu, MenuProc, CheckControls, schermata delle sostituzioni, …). Nessuno di questi punti, e nessuno dei 495 indirizzi di SWOS usati da swospp.bin, tocca un byte cambiato dalla mod: il più vicino è a 1142 byte da un hook della mod.
- Patcher. Due uscite in più,
ENGLISH.EXE + SWOS++e la sua gemella GOG, costruite damkpatcher.build_swospp(). Si ottengono dall'exe originale, da un qualsiasi exe inglese modificato da una versione precedente, da quello attuale, oppure da un originale con SWOS++ già installato. loader.bin e swospp.bin non sono inclusi: si scaricano dalla pagina delle release di Zlatko. - Provato con SWOS++ 1.9.2.2 in DOSBox-X: voce nel menu principale, menu della mod, partite (numeri di maglia, sostituzioni, ammonizioni, replay e highlights), carriera con le coppe della mod con salvataggio e caricamento, editor DIY. Non provati: partite in rete, carriere storiche.
25Maglie di casa e trasferta (3.0)
Il gioco sceglie le maglie da solo, e molte sfide classiche (Juventus-Milan, Milan-Inter, Inter-Juventus, il Chelsea contro Juventus, Newcastle o Manchester City) non si giocavano mai con le maglie di casa. Analisi del grafo dei colori: DaniSwos, thread del forum SWOS United "Home-Away kit automatic selection". Strumenti: tools/kitsim.py (simulatore), tools/kitcolors.py (patch).
- Come sceglie il gioco.
SetInGameTeamsPrimaryColorsdà un punteggio a quattro abbinamenti conGetTeamKitsSimilarityFactor: casa-casa, casa-trasferta, trasferta-casa, trasferta-trasferta (casa = la prima squadra). Usa il primo sotto 11. Il punteggio (fattore di somiglianza) somma 5 o 2 punti per ogni coppia di colori in conflitto (colori delle maglie 5, colore di una maglia contro i pantaloncini dell'altra 2, pantaloncini contro pantaloncini 5); alcune combinazioni di tipi di maglia valgono subito 66–99. Una maglia a righe che resta sotto 11 viene ricontrollata come colore medio (tabelladseg_130942, es. rosso+nero → granata). Se tutti e quattro arrivano a 11 o più, la seconda squadra prende una maglia tinta unita in uno dei suoi colori o, se nessuno va, nel primo colore diteamKitTieBreakColorsche funziona; come ultima risorsa rosso contro blu. - I colori in conflitto sono due tabelle di 10 word,
conflictingBasicTeamColorsTableeconflictingShortsTeamColorsTable(riga = colore, bit n = conflitto con il colore n; colori 0 grigio, 1 bianco, 2 nero, 3 arancio, 4 rosso, 5 blu, 6 granata, 7 azzurro, 8 verde, 9 giallo). - Le regole della mod. (1) Il nero non è più in conflitto con blu e verde, il blu non più con l'azzurro: nella palette di gioco (
pal.256) sono lontani (nero 0,0,0; blu 0,0,252; verde 0,220,0; azzurro 152,152,252). (2) Pantaloncini dello stesso colore per le due squadre pesano 3 invece di 5. (3) Correzione di un bug: dopo il passaggio dei colori medi l'inizio del ciclo controlla D0/D4, che a quel punto contengono i flag "convertita" e non i tipi di maglia, così l'altra maglia a righe perdeva le righe (l'Inter diventava tutta nera contro il Milan); ora controllashirtType1/shirtType2. 23 byte per exe (12 nelle tabelle, 2 operandi più i loro fixup, 1 immediato), trovati per contenuto in tutte e quattro le lingue. - Effetto. Su tutte le sfide tra squadre della stessa nazione dei TEAM originali il casa-casa passa dal 69,5% al 79,6% (variante C di kitsim). Provato in DOSBox-X: Juventus-Milan, Milan-Inter, Inter-Juventus e Milan-Vicenza con le maglie di casa, tutte ben distinguibili.
- Pulsante MAGLIE ed editor SELEZIONA MAGLIE (solo per la partita). Nella schermata pre-partita, in alto a sinistra (x 30–88, y 1–11 sullo schermo, tra la spunta/X della voce 0 e il nome della squadra): MAGLIE / KITS / TENUES / TRIKOT seguito da AUTO o FISSE. Il
playMatchMenucompresso (obj2, termina condw -999) viene copiato nella cave di obj1 con una voce in più, la 68, in coda (gli indici del gioco non cambiano; i suoi fixup vengono replicati), e lacall ShowMenudiShowPlayMatchMenupassa da uno stub che prima ricopia l'originale nella copia: SWOS++ modifica l'originale in memoria all'avvio (il suo onReturn e un puntatore di una voce,swospp.bin+0x10EEE/+0x10F67), e una copia fatta solo alla build perderebbe quelle modifiche; la voce 13 (primo giocatore) ha su → 68. Il fuoco apre SELEZIONA MAGLIE, costruito attorno all'editor delle maglie del gioco: le voci 4–19 dieditTeamsMenu(prima e seconda tenuta: maglia grande, pantaloncini e calzettoni da cambiare con fuoco + direzione, i quattro tipi di maglia), copiate byte per byte con gli stessi indici, perché le loro routine (EditTeamsChange*,EditTeamsSelect*ShirtType,*KitColorConversion,Mark*KitShirt) ridisegnano per indice e lavorano sueditTeamsTeam, un buffer usato solo dal menu Modifica squadre. Intorno: 0 titolo, 1 nome della squadra (fuoco = l'altra squadra), 2 la tenuta indossata (fuoco = prima/seconda), 3 la scelta dell'altra squadra, 20 esci, 21 OK, 22 reset (le tenute del file della squadra). Due slot in obj2 (nome, entrambe le tenute, tenuta indossata, puntatore alla squadra) conservano le modifiche finché sullo schermo ci sono le stesse due squadre; vengono azzerati dopo la partita e con ESCI, così il MAGLIE successivo riparte dai file delle squadre. - Al calcio d'inizio un salto all'inizio di
SetInGameTeamsPrimaryColors: se OK ha confermato la scelta, lo slot di ogni squadra viene trovato per nome (A2 sopra, A3 sotto), la tenuta indossata va intopTeamInGame/bottomTeamInGametramiteConvertTeamKitColors, la scelta automatica viene saltata e la scelta disattivata (una sola partita; il pulsante torna su AUTO). Nulla viene scritto nei file delle squadre o nel salvataggio. Un primo tentativo che riciclava come pulsante la voce 4 "COACH:", fuori schermo, è fallito: durante il gioco quella voce è il nome dell'allenatore della riga GIOCA. - Prove con l'harness automatico di DOSBox-X (
tools/swostest.py, script di tasti; dump della memoria per leggere i menu decompressi): pulsante disegnato e raggiungibile, l'editor si apre con le tenute delle due squadre, cambio squadra e prima/seconda tenuta, OK, al calcio d'inizio il Milan in prima tenuta contro l'Inter in seconda; cambio colore con fuoco + destra (tasti combinati dell'harness: strisce del Milan da rosso a granata, viste in partita); ESC in partita (-matchdell'harness) e dump della memoria: scelta disattivata, slot azzerati, pulsante di nuovo su AUTO. Con SWOS++ 1.9.2.2 (exe inglese +tools/swospp.py, feeder-timerdell'harness): pulsante KITS SET, editor, cambio colore, OK, tenute applicate al calcio d'inizio e ritorno ad AUTO dopo la partita funzionano tutti; la copia coincide con il menu originale in memoria. Ancora da provare: due giocatori umani.
26Europa 1984-85 e coppe europee (3.0)
Il pulsante CARR. STORICHE della carriera elenca i mondi storici (pseudo-continente 98 → voce 200 + numero del mondo → paesi). Il primo è EUROPA 1984-85: 32 paesi, 949 club, rose reali dal database di DaniSwos (CM01/02 Retro Update Team), campionati nell'ordine finale 1983-84, coppe nazionali reali 1984-85 per 15 paesi, coppe europee 32/32/64 con gli accoppiamenti reali del primo turno. I dati sono in packs/europe-1984-85/<paese>: chiunque può completarli (per esempio gli allenatori mancanti, colonna coach di clubs.csv).
- Nomi per lingua.
button_namesnelpack.jsondi ogni paese eworld_cups.namenel pacchetto principale danno il nome nella lingua dell'exe (INGHILTERRA / ENGLAND / ANGLETERRE, EUROPA 1984-85 / EUROPE 1984-85). - Il livello in più del menu.
SelectTeamsFinalMenumostra i campionati di un paese solo a profondità 2 (numSelectedTeams);w_lvlaccetta anche la profondità 3 quando la voce precedente (cima dicountryStack) è un mondo. - Niente derby nei primi due turni. Coppa delle Coppe e Coppa UEFA (tutte e tre le coppe in un mondo): il primo turno è sorteggiato (
w_draw1dopocseg_28139), il secondo nasce dai vincitori del primo:w_r2dopocseg_2ACAE(coppe simulate) ew_r2pdopocseg_29659(la coppa del giocatore, che riordina i vincitori con la tabella a DIY+30Dh). Una sfida tra club dello stesso paese scambia la squadra in trasferta con quella di un'altra sfida. - Detentori. Normali carriere: il detentore della Coppa dei Campioni che non si è qualificato prende il posto di un club di un altro paese (
cseg_92C4Dconfrontava l'ordinale invece del paese). Mondi: i detentori giocano in più; un campione nazionale che detiene la Coppa delle Coppe o la UEFA gioca la Coppa dei Campioni e il suo posto da detentore va al club successivo della sua classifica (w_pick_cc,WH_SAVE). - Intercontinentale. Corretto il bug (dalla 2.5) per cui il vincitore della Coppa dei Campioni che giocava l'Intercontinentale ripartiva in Coppa delle Coppe:
sacups.euro_foundsalva il tipo di coppa prima checseg_8B2D3sporchi D7. - Nazionali. Nella 3.0 le offerte delle nazionali erano disattivate in un mondo (le nazionali del gioco sono quelle del 1996); la 3.1 porta le nazionali dell'epoca: capitolo 27.
- Registro gestione (3.3.6).
FillManagementRecordInfoaggiunge 1996 / 97 al numero della stagione; in un mondow_mrecaggiunge invece il primo anno del mondo (1984/85, 1985/86 ...). Scenariow84_record. - Campionati a due zone: Argentina, Panama, MLS (4.1.2). Il giudizio del presidente a fine stagione, i richiami e l'esonero, la valutazione per il rinnovo del contratto e il registro gestione usano la posizione del club nella sua zona (conference), riportata alla dimensione del campionato, non il posto nelle due zone messe una sotto l'altra come un'unica classifica. Un club primo nella seconda zona (la Western Conference della MLS) conta come primo. In Argentina e Panama ogni titolo di Apertura o Clausura vinto conta a fine stagione come una coppa vinta.
27Nazionali dell'Europa 1984-85 (3.1)
Nel mondo Europa 1984-85 le nazionali sono quelle dell'epoca e giocano il ciclo 1984-88. Dati in packs/europe-1984-85/national (dal database di DaniSwos: per nazionalità prima i nazionali del 1984, nati dal 1951), motore in tools/careerworld.py, compilatore in tools/mkseason.py (NationalPack).
- File squadre. 143 squadre nell'ordine di
TEAM.080-085del gioco (stesse posizioni: la Germania Est al posto della Croazia, l'URSS della Russia, la Germania Ovest della Germania; 12 posti post-1990 inutilizzati), scritte comeTEAM.180-185con i record che dicono 80-85, così i numeri globali e ogni riferimento (file, posizione) restano quelli del gioco. In una carriera del mondoLoadTeamFileleggeTEAM.18xal posto diTEAM.08x:w_tfilesul nome del file,w_tcachesul controllo "già caricato". - nationalTeams. I 142 record del gioco (file, posizione, nazionalità, paese di casa, valutazione; 41 nel bacino delle offerte, 63 con una nazionalità) sono sostituiti per mondo (
nat_tabledanations.csv): niente nazioni post-1990, paese di casa = il campionato del mondo di quella nazione (Galles → Inghilterra), nessuna panchina per le nazionali extra-europee. Quattro stub scelgono la tabella e i suoi tre contatori nei 10 punti che li leggono. - Panchine e convocazioni.
w_natnon disattiva più la panchina della nazionale in un mondo che ha le nazionali; le convocazioni FUORI CASA passano daw_buy(i paesi del mondo). - Nuove nazionalità. GDR 153, URS 154, FRG 155 (
NEW_NATS, tre lettere per lingua dell'exe):shortCountryNamese l'elenco delle nazionalità del menu carriera (+ YUG 37) passano nella cave della carriera, più lunghi;ChangeNationalityricomincia alla nuova lunghezza. - Competizioni.
pack.jsonnational: cicli di 4 stagioni con ospitanti, gironi di qualificazione [posti, squadre] e le qualificate degli altri continenti. I sorteggi di qualificazione (call cseg_33A1Aincseg_6604A/cseg_65CA2) diventanow_wcqdraw/w_ecqdraw(detentore e ospitanti esclusi, girone del giocatore impostato); la fine stagione (cseg_95298/cseg_94E85) diventaw_wcfill/w_ecfill(posti per girone con le procedure del gioco, poi le qualificate dirette fino a riempire la fase finale). Mondiale 1986 = il formato diworldCupdelle competizioni preimpostate (24 squadre, 6 gironi, migliori terze), Euro 88 = 2 gironi da 4, semifinali, finale; 2 punti a vittoria. Ospitanti per ciclo:w_hostwc/w_hostec; detentore Italia scritto a inizio carriera e nel riempimento del primo ciclo (carriere salvate con la 3.0). - Test automatici. Il banco di prova (
tools/swostest.py, guidanotes/harness.md) fa girare DOSBox-X in turbo leggendo ~1 MB di memoria per pausa: circa dieci volte più veloce.world8485_natforza la panchina della nazionale con l'interruttore di debug del gioco e verifica il ciclo qui sopra; la stagione da club che la precede si gioca una volta per build con un club maltese e resta in cache.
28Tornei storici da dati (3.2)
Un pacchetto torneo (kind: tourney, guida packs/TOURNEYS.it.md) aggiunge un torneo a TORNEI STORICI con soli dati; il primo è packs/world-cup-1934. Compilatore: Pack.tourney in tools/mkseason.py; exe: historic.patch.
- Struttura. La competizione è una copia dell'intestazione
worldCupdel gioco (come Mondiale 1982, Mitropa 1934 e FA Cup 1871-72 della 2.0): id, punti a vittoria a +0Ch, le fasi da +0Eh (numero, poi squadre / gironi / squadre per girone per ogni fase: eliminazione gironi 0, 3° posto FFh, poi 1) e da +22h un byte di gare per fase (single14h,single_et54h,two_legs94h,single_replay00h,two_legs_replay80h), due offset dei nomi, poi (file, ordinale) per squadra. File squadre 146 (voce paese = il record CLASSICS, base 1786 condivisa da tutti i tornei storici). - Tabelloni.
hist_draw(la tabella dei sorteggi fissi che sostituisce il sorteggio casualecseg_27F08) accetta un flag nel bit 7 del numero di squadre del turno: ordinare le qualificate secondo la loro posizione nella competizione prima della permutazione. Il gioco lascia le vincenti di un turno in un ordine suo (prima chi ha vinto una ripetizione ...), quindi un tabellone fisso ha bisogno di quell'ordinamento; le permutazioni daties.csvsono calcolate rispetto all'ordine ordinato. Le voci della 2.0 e dei pacchetti stagione non hanno il flag (invariate). - Ripetizioni. I tornei con fasi
*_replayentrano incoin_ours(sorteggio su una ripetizione pari, "... VINCE AL SORTEGGIO"). - Rose. Nuovo metodo
records: squadre intere da un file di squadre di SWOS o da unCUSTOMS.EDTdi SWOS 2020 (Mondiale 1934: il DLC di Insane). - Test.
classic_wc34(il tabellone reale dopo le ripetizioni, sorteggi, 3° posto, finale),classic_groups(il modello: 2 gironi, semifinali incrociate),classic_tourneys(Mondiale 1982, Mitropa, FA Cup fino alla finale). - Menu. Il pulsante MAGLIE della schermata pre-partita è allineato alle righe dei giocatori e al nome della squadra (x 25..88, y 0..10).
esci_fix(chiamato dahist_namesin ogni elenco di scelta squadre): se una colonna copre ESCI (COMP. PREDEFINITA EUROPA: 14/15/14 paesi), ESCI va nel posto libero sotto la colonna più a destra, con su = l'ultima voce di quella colonna; posizione e collegamenti tornano quelli di prima se il gioco non ridisegna il menu. Il codice dihistoric.py, la correzione e le competizioni dei pacchetti torneo stanno in una pagina loro (0xaa000, o 0xa6000 senza un mondo).
29Mondo 2026-27: il motore della 4.0
Il Mondo 2026-27 è un mondo di carriera dei pacchetti (sezione 23): il suo byte di mondo è someLeaguesTable[1845], i suoi pacchetti sono in packs/, la build è tools/patch.py. Sopra questa base la 4.0 aggiunge una serie di motori condivisi, ognuno fatto di un file C compilato in pagine proprie di obj1 (nasmcave) e di un modulo Python con gli hook. Ognuno lavora sui dati: nessuna competizione ha codice proprio. Le regole di progetto che seguono sono in notes/CONVENTIONS.md (da leggere prima di ogni modifica); le note di lavoro sono in notes/world-2025-26*.md e notes/continental-cups.md.
Il blocco del motore
- Elementi.
engine.pyregistra lo stato che ogni motore tiene con la carriera:engine.save_item(nome, dimensione)piùITEM_AT[nome]durantepatch_exe.trailer.pyscrive tutti gli elementi come un unico blocco concatenato 'EN' dopo il trailer principale del .CAR. Gli elementi della 4.0 sono 'GP' (play-off), 'CT' e 'CE' (coppe continentali), 'RI' (pool fuori file), 'SR' / 'SB' (statali brasiliani) e 'BT_EXT' (classifiche grandi). - Tabelloni della prima stagione.
dt_finddi lib97 (la lettura della tabella dei sorteggi fissi dinc_bye/nc_adv) salta i record filtro del primo club di statespec[2, file, ordinale]come fahist_drawdi historic (historic.cf_on): prima della rc9 la lettura si fermava al primo record di uno statale brasiliano, e 37 coppe del Mondo 2026-27 sorteggiavano a caso i loro tabelloni veri della prima stagione. - Mondo 0. Il mondo originale 1996-97 non ha un pacchetto: il suo codice registra le sue tabelle con
engine.gplay / pgroups / splitprima dipatch_exe, che dimensiona le sue pagine da queste. - Hook di caricamento. Un nuovo hook dopo il caricamento, nella catena di caricamento della carriera, ha rotto la fine stagione successiva (trap all'inizio della terza stagione, 22/10/2026). Fino alla 4.0.1, ogni modifica al percorso di caricamento / salvataggio richiede lo scenario
career_20seasons(C20_SEASONS=2): vedi la regola 19 di CONVENTIONS.
Coppe continentali (conti)
- Dati, non codice.
conti.c+conti.pygestiscono le 11 coppe per club non UEFA e la Coppa Intercontinentale FIFA. Ogni confederazione ha una formula (internal/conti/<conf>.format.json: turni, sorteggi, passaggi tra coppe, nomi in 4 lingue) e un file d'accesso (<conf>.access.json: posti per piazzamento in campionato, vincitrice della coppa, detentrici, il ranking, le partecipanti della prima stagione). I due file sono uniti per chiave di coppa, epython3 tools/conti.py --testesegue il C in modo nativo (ctypes) su un mondo sintetico. - Fine stagione. La fine stagione di un mondo passa per ogni sua nazione.
ct_tabsostituiscecall cseg_927A2(le prime 9 di una divisione) e prima passa act_tablel'intero ordine finale, fino a 16 club.ct_ctrysostituiscecall cseg_93974, che per una nazione fuori dall'Europa esce subito: passa al C la classifica della nazione, le schede delle prime e la vincitrice della coppa, poi prosegue con la routine del gioco. Con questi daticonti.cfa le partecipanti delle edizioni successive con le liste d'accesso, sorteggia (urne per ranking, regole sulle federazioni), simula ogni turno che il club in carriera non gioca (forza = i prezzi dei 16 giocatori, comeuefaq; dalla 4.0.6 circa 2,6 gol a partita, prima 5,2: un bit nell'edizione salvata,ED_G2, così un'edizione di un salvataggio vecchio finisce con il modello con cui è cominciata, harnessworld_ctgoals) e tiene le detentrici e il percorso di ogni club. - Il club in carriera nello slot 3. I turni che il club gioca sono segmenti, ognuno una competizione del gioco costruita nello slot 3 (libero per un club non UEFA) da
ct_buildtramitecseg_8B2D3. Un segmento è un'eliminazione diretta di tipo 1, una fase a gironi di tipo 2 (la lista squadre nell'ordine sorteggiato) o una fase a campionato sul motore di lp36.ct_daily(concatenato auq_dailydi uefaq, prima di ogni partita) passa al C il risultato di uno scontro concluso e costruisce il segmento successivo. Un passaggio tra coppe (la perdente del terzo turno della Libertadores in Sudamericana) è solo il segmento successivo. - Id e stato. Le coppe usano gli id di competizione riservati
conti.IDS(C6–CA, D0, D1, DA, DD–DF, EC–EF; la build verifica che nessun pacchetto li usi). Lo stato è l'elemento 'CT' (struct ct_state, 4 + 16 × 12 byte) più 'CE' (l'edizione,struct ct_ed, 2260 byte): dopo un caricamento il percorso riprende dall'edizione salvata. - Club ospiti.
guests.py: i club veri delle federazioni che non sono nel mondo (partecipanti CAF, AFC, OFC e CONCACAF) hanno file squadra propri, TEAM.191 (CAF), 192 (AFC), 193 (OFC) e 194 (CONCACAF), senza voce di nazione o di campionato e senza classifica. La parola squadra di un ospite èfile | ordinale << 8, il countryNumber della sua scheda è il suo file, ecountriesTable[file]dà l'unica etichetta di nazione mostrata per quel file. - La vista COPPE CONTINENTALI (4.0.6).
ctview.c+ctview.py, in obj3: la voce 9 di VISUAL. COMPETIZ. (VC5_MENU) apre un menu delle confederazioni (prima quella del club della carriera), poi paginefmtpagedelle coppe di quella confederazione. Non tiene copie delle edizioni: il run diconti.cè deterministico a partire da 'CT' (ct_resume), quindi la vista lo ripete e leggeCT_OUT(partecipanti, risultati, vincitori). Un turno compare quando la settimana della carriera arriva al suo sorteggio (meseR[9]→ settimana 8 × (mese − 1), +96 per gennaio–luglio), i suoi risultati 8 settimane dopo; una sfida a eliminazione diretta scrive tra parentesi chi passa, un girone il suo ordine finale, mai i punteggi. La stagione 1 non ha ancora un'edizione in 'CT': mostra solo i sorteggi dei turni principali e una riga per i turni precedenti. I testi (4 lingue) sonoctview.TEXTS; ogni riga sta in 298 px (una sfida lunga va a capo) e usa solo caratteri del font dei menu. Harness:world_contiview(CT_SEG / CT_ED identici byte per byte prima e dopo la vista, ogni pagina, 4 lingue),world_contiview_tie(il club della carriera passa due turni: switch di test CONTI_FORCE / CONTI_KOWIN),world_contiview_old(un salvataggio 4.0.5). - I turni nelle schermate del gioco (4.0.6, opzione C).
ctgame.c+ctgame.py, in obj3 dopoctview. Una confederazione con turni sorteggiati ora apre un menu dei turni (due colonne di 8 pulsanti: nome breve della coppa + turno, ≤ 144 px; RIEPILOGO = la pagina della versione A; ESCI). Un pulsante costruisce quel turno come competizione del gioco in un buffer di lavoro, mai in uno slot della carriera: un turno a eliminazione diretta è una coppa di tipo 1 con i suoi club, una fase a gironi una competizione di tipo 2 (cg_build: la prima metà dicseg_8B2D3, lista squadre e inizializzazione del gioco stesso). Poi inserisce ciò che è stato giocato entro la settimana della carriera (cg_view): andata e ritorno con il totale, supplementari (D.T.S.), gol in trasferta e rigori, classifiche e partite dei gironi per giornata, giocate dalle routine del gioco con i gol di una ripetizione diconti.c(cg_replay: il registrostruct ct_grec, 4 KB in fondo al buffer; il run di fine stagione non cambia). Il risultato si apre con il visualizzatore di VISUAL. COMPETIZ. (cseg_37B74). La fase a gironi in corso del club della carriera mostra il vero slot 3. VISUALIZZA MONDO: ogni continente mostra le sue coppe come pulsanti verdi sopra le nazioni (EUROPA le coppe UEFA, MONDO la coppa FIFA), ognuno apre il menu dei turni di quella coppa; le liste vengono scambiate solo attorno al selettore di VISUALIZZA MONDO (cw_on/cw_off). Protezioni (cg_open/cg_close/cg_guard): il numero di squadre in cache, l'area di lavoro del gioco, D0..A6, i due generatori casuali e le zone che una costruzione scrive vengono salvati e rimessi a posto; una somma di controllo di tutto ciò che un salvataggio scrive deve coincidere alla chiusura, altrimenti nessuna vista fino al riavvio. Un salvataggio o un nuovo giorno chiude prima una vista rimasta aperta. Ripieghi sulla pagina della versione A (cg_viewrestituisce 0,CG_ERR): un club che non è in nessun file squadre del mondo (E_GUEST:CG_FCNT, l'ultimo club di ogni file + una mappa dei file che il mondo carica, verificata in build; un club così farebbe cercareGetTeamPointerall'infinito), un turno giocato senza gol registrati (E_NOREC), la cache squadre piena (E_CACHE), un turno che non è un tipo di competizione (E_KIND: la fase campionato della AFC Champions League Elite), una somma di controllo diversa (E_GUARD), le partite del girone del club della carriera non più nello slot 3 (E_OWN). La stagione 1, ancora senza edizione, mostra subito la pagina. Harness: Tier Btest_ctgame.py(costruzioni, protezioni, viste,test_cg_fallback), DOSBoxworld_cgame_self,world_cgame_guard(i .CAR di due stagioni identici byte per byte con e senza viste),world_cgame_view,world_cgame_fallback,world_cgame_swospp. - Infortuni dei portieri (4.0.6).
gkinj.py, in fondo alla catena di obj3. Dopo una partita tira 1 su 25 per il portiere di ogni squadra (un suo xorshift32, inizializzato al primo tiro dai due stati RNG del gioco, così il replay della stessa partita tira uguale e la sequenza diRanddel gioco non si sposta). Se esce, scrive il livello d'infortunio 40h (fuori la partita successiva) o 60h (le due successive), 50/50, nei bit E0h di cardsInjuries del suo record; il conto alla rovescia del gioco stesso (cseg_2CED3, dopo ogni partita) lo riporta a 20h / 0, entrambi disponibili. Una partita giocata davvero: le quattrocall UpdatePlayerInjuriessono incatenate (allenamenti esclusi); il portiere è lo slot 0 dei PlayerInfo in partita al fischio finale (una sostituzione scambia l'intero PlayerInfo), saltato se.substitutedo.isInjured; il suo record viene daGetPlayer. Un risultato simulato: dopocseg_903B1(incatenato dopocb_903di cpucards), il portiere è lo slot 0 della formazione. Nessun tiro per un portiere che ha già un livello, 20h compreso. Le squadre del computer tirano in ogni competizione (g_gameType>= 1; non le amichevoli) conCC_Idi cpucards attivato. cpucards conta gli infortuni della CPU nei giorni del calendario del menu GIOCA PARTITA (cb_day, stagioni e carriere: harnesscpu_inj_season); una competizione personalizzata o predefinita non ha giorni di calendario, quindi lì i conti alla rovescia dopo ogni partita (guardie 6 / 7) valgono anche per le squadre del computer quandog_gameTypeè 1 / 2 (harnesscpu_inj_preset,cpu_inj_diy: qualche livello della CPU scende). Spento con SWOS++. Opzione: voci 24/25 di OPZIONI, 12 px sopra ROSSI ALLA CPU (incatenate dopocc_init/cc_ret); la wordGI_Wsi salva come item dell'engine 'GI' (2 byte; un salvataggio più vecchio carica 0 = attivata), egk_load/gk_newtengono il valore della sessione. Switch di testGKINJ_FORCE= 1 / 1m / 2m: ogni tiro va a segno (solo build di test). Harness:gk_injcopre la riga e i suoi cambi in 4 lingue, una carriera forzata (il livello del portiere a ogni schermata della squadra: fuori esattamente 1 / 2 partite; il livello del portiere della CPU), la riga disattivata, INFORTUNI ALLA CPU disattivato e un vecchio salvataggio.
UEFA: fase a campionato e preliminari
lp36.pygioca la fase a campionato a 36 come una fase di tipo 2 con 2 gironi da 18.lp_pairprende ogni partita dal calendario sorteggiato (un avversario in casa e uno fuori per ogni urna, nessun club della propria nazione), elp_sortscrive un'unica classifica dei 36 sui due gironi (criteri dell'art. 18 del regolamento UEFA 2025-26). Gli spareggi e il tabellone fisso degli ottavi vengono dalp_gend/lp_draw.uefaq.cgioca i preliminari a fine stagione dalle prime 9 e dalla vincitrice della coppa di ogni nazione, col ranking diuefacoefe gli European Performance Spots, poi riempie le tre fasi a campionato (36 / 36 / 36). Il Liechtenstein (senza campionato nazionale) ha la sua riga della lista d'accesso per federazione (uefaq.cuponly_file: la vincitrice della coppa al primo turno preliminare di Conference League qualunque sia il suo posto); una 44ª federazione con un campionato riceve la riga normale dei posti 43 / 45.
Play-off e regole degli scontri diretti (gplay, dplay)
- dplay (
dplay.c): i play-off e i play-out italiani. Play-off di Serie B (competizione FD: 6 club, la 3ª e la 4ª aspettano, semifinali e finale in andata e ritorno), play-out di Serie B (FE: 17ª contro 16ª) e i play-off di ogni girone di Serie C. - gplay (
gplay.c): tutti gli altri play-off a eliminazione diretta di un mondo, dichiarati nella chiaveko_playoffsdel campionato nel pacchetto.- Tipi:
promotion,europe,placement,playout,title,continentalestage_title(il Trofeo argentino). - Partecipanti:
[div, posto], il miglior club senza Europa, la vincitrice della coppa di lega, il posto o la testa di serie di una fase di uno split. - Turni: gare, serie al meglio delle tre, abbinamenti, campo, regola di parità, distacco in punti, gironi.
gplay.py. - Tipi:
- Hook. A fine stagione (
cseg_91D4D, per struttura di campionato),gp_cap/dp_capsostituisconocall cseg_9221Fe copiano la classifica finale di ogni divisione.gp_end/dp_endsostituisconocall cseg_9228D: giocano i play-off e scrivono gli spostamenti di divisione (con segno) inleaguesTableCopy. Un play-off in cui è il club in carriera viene giocato:gp_lend/dp_lendsostituiscono le duecall cseg_8ECAEdell'ultima giornata e costruiscono la competizione nello slot 4 (cseg_8B2D3, D0 = 4) come il gioco costruisce i suoi play-off nativi. - Un solo insieme di regole di parità (regola 10 di CONVENTIONS), scelto per turno con
level:- andata e ritorno (somma dei gol);
pens/et_pens(supplementari e rigori);et_better/better(supplementari, poi passa la meglio piazzata: i play-off della mod);away_pens/away_better, simulati comeet_pens/better.
gp_draw/dp_drawstanno sul punto "pareggio → ripetizione" dicseg_2AE97: un nostro scontro in parità va alla meglio piazzata.cal_noreplay(lib97.py) toglie da uno slot le voci di calendario di tipo 3 (giorni di ripetizione), così un'eliminazione diretta senza ripetizioni non mostra date di ripetizione. - Due tornei a stagione (Costa Rica, Honduras, Panama; dati
TM_CA_EXACT): la divisione 0 ha una specifica di split astagescon calendario (l'Apertura sul calendario vero, la Clausura coi punti azzerati,reset). All'ultima giornata di ogni fase la sua classifica va inGP_SS0 / 1 (condiviso con l'Argentina: lo scrive solo il campionato della carriera), e viene costruita un'eliminazione direttastage_titlecon partecipanti{"stage_place": 4 | 5, "place", "div"}: la fase finale vera del torneo (la Gran Final del Costa Rica conskip_if_same, le semifinalibest_worstdell'Honduras, le teste di serie per conference di Panama). Gli scenariworld_ca_crc / _hon / _panforzano ogni fase finale. - Switch di test (solo build di test):
GPLAY_FORCE=kmette il club in carriera al posto k a fine campionato (anche nella classifica tenuta di una fase);GPLAY_RLFORCEfissa il suo risultato nel play-off per le righe del palmarès stagionale.
Coppa Italia Serie D (slot 2)
cupd.pygioca l'eliminazione diretta di tutti i club di Serie D (162 nella realtà, 156 nel file del mondo) alle sue date vere, sul motore di gplay. La prima stagione usa il JSON del tabellone della sessione dati (turni, date, gare, campo, partite con le vincitrici vere). Le stagioni successive sono sorteggiate dacd_makedasomeLeaguesTable; gli scontri che nessuno gioca usano forze date dai prezzi dei migliori 11 giocatori (cd_str).- Prima dei trentaduesimi, gli scontri del club in carriera sono competizioni di un solo scontro nello slot 4, costruite all'avanzamento del calendario prima della settimana del turno. Ogni altro scontro è deciso a quell'avanzamento: nella prima stagione col risultato vero quando è noto, altrimenti con le regole di parità di gplay.
- Dai trentaduesimi, la Coppa D è un'eliminazione diretta del gioco a 64 club nello slot 2 (competizione CDS1).
gp_cup12sta sullacall cseg_8B2D3di InitNewSeason per gli slot 1 e 2: un club di Serie D tiene la COPPA ITALIA dello slot 1, simulata per la sua vincitrice e nascosta dal calendario di quel club (regola 11 di CONVENTIONS), e il suo slot 2 diventa la Coppa D. Dopo un caricamento,gp_afterrimette il puntatore alla competizione dello slot 2, che ProcessCareerFile lascia a 0.
Split, classifiche lunghe, colori delle zone e legenda
- Split (
split.py): la specifica di una divisione nel pacchetto è"split": {"games", "groups", "rounds", "points", "home"}(puntifull/half_up/half_down; campobalance/reverse3/seeded). Quattro hook lo gestiscono:sp_initsucseg_2653Baggiunge un ciclo, così la fase non finisce allo split;sp_pairsucseg_89758prende le partite dopo lo split dal nostro calendario. La sua prima chiamata congela i gruppi, dimezza i punti (i punti prima dell'arrotondamento sono il primo criterio di parità) e riscrive il calendario della carriera;sp_countsucseg_8922Btiene i contatori delle giornate;sp_sortsucseg_883DDfa una partizione stabile nei gruppi, cosìDIY+6Dhè sempre la classifica finale in ordine di posto.
gp_hlabel_cdi gplay dazones.header_labels): ZONA A / B … nella lingua dell'exe, i nomi delle conference per i campionati diCONF_PACKS(la MLS e la LPF di Panama, prima l'Est). Lo stato sta nelle righe DIY 48–63, inutilizzate e salvate con lo slot. - Classifiche lunghe (
longtable.py): la schermata della classifica dispone al massimo 24 righe, e una classifica a 30 club (Argentina, MLS) veniva disegnata oltre il buffer dello schermo. Le classifiche a un girone più lunghe diROWS= 22 ora mostrano 22 righe dacurrentDiyLinee scorrono con le frecce (lt_d3,lt_d5,lt_end,lt_down,lt_arrows).lt_plan(gp_hplan_cdi gplay) conta nella stessa finestra le righe d'intestazione e le righe vuote dei gruppi di un campionato diviso. - Coppe nazionali e club in carriera (rc12, CONVENTIONS 11): in una carriera del Mondo 2026-27 le coppe degli slot 1 / 2 che il club in carriera non gioca vengono tolte da VISUAL. COMPETIZ. e dal calendario (gplay
gp_notin: il club tra i club della competizione, DIY +31h / +12Dh; lo usanogp_vc1,gp_vc2,gp_cal1); le coppe si giocano comunque per le loro vincitrici. - Titoli che stanno in VISUAL. COMPETIZ. (rc12):
complist.fit_titlesadatta anche '<nazione> <nome lungo>' ai 158 px del pulsante (VC_PX, font piccolo), tenendo le parole che distinguono (una parola di nazionalità ripetuta tolta, parole generiche abbreviate,VC_ABBR), con i titoli adattati verificati unici per lingua; l'elenco delle competizioni è generato dai nomi adattati. - Colori delle zone (
zones.py):- Palette: azzurro 0Dh (CL / promozione diretta), verde 0Eh (EL / play-off promozione o europeo), blu scuro 08h (Conference League), arancione 0Ch (play-out / play-off salvezza), grigio 02h (retrocessione).
- Hook:
mov ax, [dseg_11F41C]nel ciclo delle righe acseg_49B65(lo stesso punto usato dalp_coldi lp36). I nomi dei club del computer prendono il colore della riga; il riquadro del nome del club in carriera tiene il suo colore senza cornice, e un anello nero di 1 pixel viene disegnato intorno solo quando il suo colore è uguale a quello della zona (zn_ring, nelle pagine di gplay tramitezones.ring_patch). - La classifica è riconosciuta dal mondo della carriera e dal titolo mostrato, con una cache per classifica.
- Le zone vengono dai pacchetti: posti europei, promosse / retrocesse, partecipanti dei
ko_playoffs, i posti italiani di dplay. I posti di uno spareggio europeo sono verdi P.OFF con la loro voce di legenda (rc12, CONVENTIONS 7), non nel colore della coppa a cui portano. Le prime fasi degli statali brasiliani vengono dastate_zones: i posti della fase successiva in verde (P.OFF), chi salta un turno a eliminazione diretta in azzurro, le retrocesse di uno statale a girone unico in grigio; uno statale a più gironi retrocede sulla classifica complessiva, che quindi non è colorata. Le zone sono calcolate per gruppo (il posto nel proprio gruppo) nelle classifiche divise, a zone e dei gironi di coppa.
- Prima della prima partita (4.0 rc7): finché nessun club della classifica (
DIY+31hclub, riga +4 = giocate) ha giocato,zn_colnon colora nulla e non mostra la legenda: i club sono ancora nel loro ordine iniziale. Un campionato la cui prima fase parte dal giorno 0 con gruppi per appartenenza (le conference della MLS, le zone dell'Argentina, Panama) riceve i gruppi e l'ordine diviso per gruppo all'inizializzazione del campionato (sp_pregroupdisplit.py; anchesp_sortdivide prima del congelamento), così le sue righe d'intestazione compaiono dal giorno 0. Scenariozones_preseason. - I riquadri della legenda sono riquadri semplici del colore della zona, compreso il blu scuro della Conference League (
LEG_COLOURè vuoto dalla rc9: il 13h della rc7 dava a quel riquadro una cornice interna). - La legenda (regole 5–6 di CONVENTIONS):
DIY_leagueTournamentMenuviene copiato intero conLEG= 6 riquadri di legenda (sei dalla rc12: l'Olanda usa CL EL CONF P.OFF P.OUT RETR) dopo la sua ultima voce, ezn_legli mostra nella riga sopra l'intestazione della classifica, in alto a sinistra, con la y calcolata dalla barra del titolo. Nella schermata dei gironi di una coppa (byteLEGX= 92 della voce, bit 1; bit 0 = posti contati per girone,LEGX+1= la dimensione del girone), i riquadri vanno nella riga del titolo (yCUPY= 3) e la barra del titolo parte da xCUPT= 70. La legenda elenca solo i colori dipinti:_mergeunisce le serie di posti negli 8 intervalli, e un posto coperto da un'altra zona viene scartato.
La pagina VINCITORI (winners.py)
- VINCITORI / WINNERS / VAINQUEURS / SIEGER è l'8ª voce del menu delle statistiche della vista competizione nelle build con mondi di carriera, disegnata sulla pagina di fmtpage (titolo, righe, PAG. PREC. / PAG. SUCC. / ESCI): per ogni titolo del campionato visto oltre alla classifica, il suo nome e la vincitrice di questa stagione, oppure DA GIOCARE / IN CORSO.
- I titoli sono le voci WIN del file FMTxx[mondo].DAT (
fmtgame.win_lines), una riga ciascuno: il titolo, 01h e la sua fonte:Lla classifica del campionato quando la sua stagione è giocata,Pi play-off di dplay (DP_ST, altrimenti la sua copia salvata DP_SAVE),Cla vincitrice di una competizione a coppa (uno statale brasiliano) o di una competizione a gironi nello slot 3 (la Poule Scudetto della Serie D, PLAYOFF - SCUDETTO SERIE D),Suna classifica di fase (GP_SS: la classifica annuale argentina),D/Ki titoli di fase e i play-off di gplay. - Tutto viene letto da stato che la carriera salva già (il DIY, GP_ST): nessun nuovo elemento di salvataggio e nessuna chiamata dopo il caricamento (CONVENTIONS 19). Un club viene nominato solo se è una riga del campionato visto. I titoli che si decidono a fine stagione (un play-off senza il club in carriera) vengono dall'elemento del motore 'WN' (164 byte, scritto da
gp_seasona fine stagione, azzerato per un salvataggio che non lo ha; nessun hook di caricamento, CONVENTIONS 19): dopo la fine della stagione la pagina elenca le vincitrici della stagione precedente. La pagina della stagione precedente è la divisione in cui il club in carriera HA GIOCATO:gp_seasonscrive anche la voce'M'di WN (la divisione del club e la sua parola squadra, nessun cambio di formato;gp_wn_cla restituisce come squadra | divisione << 16), il testo WIN di ogni campionato inizia con una riga chiave01h 'H'+ file squadra + divisione (non mostrata), ewn_lastdivprende il testo WIN di quella chiave (altrimenti quello della competizione vista): un club promosso dalla Serie D girone A vede SERIE D GIRONE A e la vincitrice della Poule. Ogni riga dice DA GIOCARE prima che la competizione del titolo inizi, IN CORSO quando è iniziata ma non ha ancora una vincitrice. 4.0.2: un play-off del campionato della carriera senza il club in carriera dice DA GIOCARE finché la fine della stagione non lo decide (la 4.0.1 ometteva la riga); un play-off per il titolo nazionale con le teste di serie dititle_seed(Uruguay, Perù: sorgente'Q'+ regola + play-off) nomina il campione appena un club ha vinto entrambi i tornei (il banco delle classifiche di fase del campionato della carriera: la prima dell'Apertura e quella della Clausura sono lo stesso club, quindi niente play-off). Il codice sta nelle pagine di gplay.
Fine stagione veloce (quietend.py)
- A CONTINUA CARRIERA la fine stagione (
cseg_91428) chiamacseg_9153Fper la nazione del club in carriera, poi per ogni nazione della lista di fine stagione.cseg_9153Fsimula i campionati della nazione (cseg_915ED→cseg_3ABB2) e le coppe (cseg_916C2→cseg_3ACAB), e ogni simulazione finisce mostrando la competizione con ShowMenu (ShowDiyLeaguesTournamentMenu/cseg_45B51) per un fotogramma di menu: un DrawMenu + FlipInMenu completo ciascuna. Il gioco originale ne mostra circa 110 (ogni campionato e coppa europei); il Mondo 2026-27 circa 260, minuti su un 486 vero. qe_callsostituisce lacall cseg_9153Fdel ciclo (non quella della nazione del club in carriera prima del ciclo): in una carriera del Mondo 2026-27 la esegue condseg_10E846= 1, l'interruttore del gioco stesso (lo usacseg_8ECAE), che fa uscirecseg_3AE87/cseg_3B18Fprima della visualizzazione. Ogni altro test del flag è in OR condseg_10E848, checseg_91428tiene per tutta la fine stagione, quindi la simulazione non cambia;dseg_DF4F4non viene impostato in nessuno dei due casi.- Riga di avanzamento (rc12, il MiSTer di Davide: il ciclo silenzioso sembrava bloccato per 30-40 s):
qe_show, prima di ogni nazione, scrive SIMULAZIONE ALTRE NAZIONI... / SIMULATING OTHER COUNTRIES... / SIMULATION DES AUTRES PAYS... / SIMULATION ANDERER LAENDER... n/N (N = le nazioni della lista tranne quella del club in carriera) conDrawMenuTextdel gioco (font piccolo) nelle righe 190-199 dello schermo virtuale, poi copia solo quella striscia (3,2 KB) nella memoria video; i registri pseudo vengono salvati intorno. Il codice si è spostato nelle pagine extra. Il .CAR dopo la fine stagione è identico byte per byte con e senza la riga (QE_NOPROG=1costruisce l'exe di controllo). - Verificato (4.0 rc10): lo stato di fine stagione (spostamenti di divisione, liste europee, schede delle squadre) identico con e senza; cambiano solo i sorteggi casuali della stagione successiva (i menu saltati non fanno più avanzare il generatore). Censimento ShowMenu: 5 visualizzazioni (le coppe UEFA, il campionato e la coppa del club in carriera) invece di ~260. Fine stagione 1996-97 e 1984-85 identiche byte per byte.
QUIETEND_OFF=1costruisce l'exe di controllo.
Pool fuori file (ripool)
- L'Eccellenza italiana (i 256 posti dei campionati italiani riempiono il suo file squadra) e le seconde divisioni statali brasiliane (file 161) non possono aggiungere club al mondo. Al loro posto, gli slot si scambiano le identità con pool fuori file
DATA\RS<mondo><file>.DAT(mkseason.rs_files), e nessun club esce dal mondo o vi entra. ri_loadsostituisce lacall SetLoadedTeamsGlobalNumbersdi LoadTeamFile: tiene il file com'è stato letto, legge il suo pool una volta per sessione DOS, eri_applydà a ogni slot rimappato la scheda della sua identità.- A fine stagione
ri_season/ri_after(tramitepgroups.pg_fix) aggiornano le mappe e la cache della carriera, poi svuotano la cache di LoadTeamFile. - Lo stato è l'elemento 'RI'. Regola 13: ogni codice che carica il file di un club passa per questo caricatore condiviso.
Il patcher a cartella con un clic
- Il File System Access di Chrome blocca Programmi e le sue sottocartelle ("la cartella contiene file di sistema"), compresa la cartella predefinita di GOG Galaxy: la pagina mostra un avviso in 4 lingue prima del pulsante della cartella e di nuovo quando la scelta viene rifiutata (un AbortError, indistinguibile da un annullamento) o la cartella non contiene il gioco: copiare la cartella del gioco altrove, applicare la patch alla copia, ricopiarne il contenuto (permesso di amministratore), oppure usare la modalità manuale, i cui passi citano lo stesso permesso.
tools/patcher_template.html→mkpatcher.py(file di uscita compressi in raw deflate) →release/swos-9697-mod-patcher.html. In Chrome o Edge, la modalità cartella (showDirectoryPicker) legge la cartella del gioco scelta (installazione da CD, GOG col gioco in una sottocartella, eXoDOS / DOSBox), oppure prima copia il gioco da una cartella del CD.- La pagina riconosce la versione di ogni file dall'md5 e scrive solo i file diversi. Tiene quelli sostituiti in
MOD_BACKUP\<versione>e scrive la variante SWOS++ solo dove SWOS++ è installato (SWOSPP.BIN/LOADER.BIN). Una seconda esecuzione non scrive nulla. L'interfaccia è in 4 lingue; il download manuale resta per gli altri browser. - Controllo di release:
node tools/patcher_dirtest.mjs PAGINA.html c/RELxx SCRATCH [3.3.6,...]esegue il codice della pagina in Node con handle di cartella simulati, per ogni lingua dell'interfaccia: CD, GOG, dal CD, SWOS++, seconda esecuzione, cartella sbagliata e aggiornamenti dalle versioni precedenti. Ogni file scritto deve essere uguale alla build della release, eMOD_BACKUPdeve contenere i file sostituiti.
Convenzioni e test
notes/CONVENTIONS.md: le regole stabilite (solo caratteri del font, 4 lingue, pagine FORMULA discorsive, una sola legenda in alto a sinistra, legenda = zone dipinte, formule vere esatte, un solo insieme di regole di parità, casi di test forzati, controlli di release) e le trappole note del motore. Va riusato il codice condiviso indicato lì.- L'harness (
tools/swostest.py, sezione 18,notes/harness.md) chiude una run con esito'break'quando unint 3si ferma nel debugger di DOSBox-X: una trap del gioco o un passodumpdello scenario. Lì si legge la memoria. I breakpoint (Session.bp,SWOSTEST_BP) richiedonoCORE=normal. La cartella di una run fallita viene tenuta per decodificarla. - Un gioco che va avanti senza chiedere un tasto (un ciclo infinito, un disegno senza fine, una fine stagione lenta) risulta solo 'timeout':
Session.sample(tasti, secondi)(branch harness-break,notes/harness.md'Breaking a busy game') manda i tasti con un breakpoint sull'interrupt del timer (BPINT 8), restituisce un istogramma degli EIP per offset di obj1 e chiude con unMEMDUMP.BINcompleto all'ultimo tick per l'analisi. - I casi che dipendono dai risultati si forzano con switch di test (
GPLAY_FORCE,GPLAY_RLFORCE,CONTI_GPLACE…), mai rigiocando nella speranza; gli switch non entrano mai nelle build di release. Controlli di release della 4.0: l'intera suite sulla release candidate,career_20seasonse i file di uscita del patcher identici byte per byte alla build.
Aggiunte della 4.0.1
- Più divisioni a fasi in un campionato (Messico: Liga MX + Liga de Expansión): i play-off
stage_titleportano la divisione nel byte di specifica (fase | divisione << 2);GP_ST.dectiene solo la divisione del club in carriera, i titoli di fase delle altre divisioni si simulano a fine stagione;ss_banksdà a ogni divisione a fasi tabelleGP_SSseparate. L'entrantestage_title4 = la vincitrice della seconda fase, conskip_if_same(nessuna partita se la stessa squadra ha vinto entrambe: il Campeón de Campeones). - Perù, Colombia, Uruguay (pacchetto 6): banchi
GP_SSper campionato, entrantititle_seed(semifinale e finale dell'Uruguay con le regole AUF delle coincidenze; i playoff della Liga 1 peruviana), posti espliciti nello split (places/places_snake, flag 20h dello split: le serie a serpentina dell'Intermedio). Paraguay, Guatemala e El Salvador richiedono più di 40 giornate (MAXDAYS): fatto nella 4.0.2. - Nazionalità (
tmmaps): codici 156..213 per le 58 nazioni, aggiunti aNATSHORT(la tabella a cui la 3.1 aveva deviato i tre riferimenti dishortCountryNames). Nessun'altra tabella è indicizzata dal byte della nazionalità;GetNationalTeamNumberrestituisce -1 per un codice senza nazionale. 152 CUS è il codice delle squadre personalizzate, non Cuba (CUB ha il suo). - Installazione incompleta (
instcheck.py): prima cheSelectTeamsFinalMenuelenchi un mondo di CARR. STORICHE, ogni file di quel mondo (file squadre,WORLDnn.TMD,POOLnn.DAT,XTWn.nnn,RSnnnn.DAT) viene aperto e chiuso con DOS 3Dh; se ne manca uno compare la finestra d'errore del gioco in font piccolo e la scelta termina come per unCUSTOMS.EDTmancante. - Acquisto di stranieri (
w_buy,w_lvl): il mercato si apre sui continenti del mondo (più di uno) o sulle sue nazioni (un solo continente: Europa 1984-85), senza la voce CARR. STORICHE davanti. - Titoli:
rn_tfit/rn_tenddirnamesadattano '<competizione> <turno> <gara>' alla barra di 304 px con le larghezze del font piccolo (PXMAX 302; prima erano 40 caratteri),rn_trimtoglie uno spazio iniziale o doppio, e un assert di build controlla il caso peggiore di ogni competizione nei quattro exe. Etichette del calendario:complist.cal_labelverifica ogni etichetta di coppa su due righe entro 70 px (le qualificazioni di uefaq prendono i nomi brevi PRELIM. EL ...). La pagina VINCITORI usa il nome lungo del pacchetto se sta in 298 px. - Patcher: su una cartella GOG con DOSBox e
dosbox_SWOS.confla pagina scrive un avviatore per ogni configurazione di lingua presente ("SWOS Mod - Italiano.bat" ...:cd DOSBOX; DOSBox.exe -conf ..\dosbox_SWOS.conf -conf ..\<conf lingua>), non contato tra i file della mod e senza copia; un nuovo passaggio riscrive quello mancante. Ogni file scritto viene riletto (dimensione + md5): "Fatto: N / N file scritti e verificati" oppure il rosso INSTALLAZIONE INCOMPLETA.
Aggiunte della 4.0.2
- Grafica piena sempre (
fullgfx.py): iljadopocmp g_videoSpeedIndex, 85diventajmpin tutti gli otto exe, quindi la velocità video del SETUP.DAT (quello di fabbrica di GOG ha 10, anche un core MiSTer lento legge basso) non sceglie più la modalità half / EGA./H(half),/Fe la regola della poca memoria restano. In modalità half gli sprite di partita sono a quattro piani di bit (InitGameRestoreTeams/UnchainSprites):shirtnumcostruisce i numeri 17..99 chunky e li rende planari sul posto (area di lavoro propria di 64 byte), eblond.unch_patchesegueUnchainSpritessui set biondi a pelle scura (NEW1 / NEW2), che stanno oltre la prima voce vuota dispritesIndexa cui si fermaUnchainSpritesTilZero(il "blocco di pixel" di Malen). - Coda azzerata (
tailzero.py): la coda non su file di obj2 (i buffer a run-time del mod) non è azzerata dall'avvio Watcom né da DOS/4GW; solo DOSBox-X la consegna a zero. Uno stub prima di__CMainla azzera in tutti gli otto exe. Il flag dei numeri di maglia leggeva spazzatura su GOG / MiSTer, quindi i numeri 17..99 non venivano mai disegnati sul giocatore controllato. - Pagina dei comandi (
controls.py): la voce 19 di OPZIONI diventa COMANDI a y 169, con una pagina obj1 propria e due pagine obj2; nascosta con SWOS++. La pagina modifica una copia disetupDatBuffer; SALVA rilegge SETUP.DAT e sostituisce solo dispositivo, calibrazione (due leve), cicli e tasti. La cattura dei tasti leggelastKeydopo il rilascio del tasto di selezione; i duplicati sono rifiutati. La calibrazione usaReadGamePort(centro + fuoco, angoli + fuoco, almeno 8 conteggi per verso; divisori = distanze, cicli = valore massimo + 1/8, come INSTALL.EXE). Il tedesco è scritto AE / OE / UE: il font piccolo disegna i byte delle dieresi senza puntini. Testi:notes/controls-402.md. - Numeri di maglia:
shirtedit.py(schermata squadra: SINISTRA dopo 8 fotogrammi di menu su una riga senza vicino a sinistra accende la casella del numero; SU / GIÙ numeri liberi, cifre per scan code, scambio con chi lo ha; la prima modifica rende i numeri unici e imposta il bit 7 del byte 23 del record squadra, "fissato"); gli hook dibenchnumsono in ogni build con mondi e rispettano il bit.subsnum.py: nell'elenco della panchina in partita il numero è allineato a destra (centro + 9 - larghezza / 2, finisce a x + 22) e il nome comincia a x + 24.menunum: numeri a due cifre nel campo tattico senza il vuoto di 1 pixel. - Joypad in modalità tastiera (patcher, terza casella
joykey, disattivata di default, con quella GOG): SETUP.DAT solo tastiera (daSETUP.DAT.bak, altrimenti il file di fabbrica GOG incorporato),dosbox_SWOS.confcome prima, emapper-SVN.keys.map= mapper predefinito di GOG + assi della leva e hat 0 sulle frecce, pulsanti 0-5 su Ctrl; anche incloud_saves. Cambiare modalità scambia mapper e SETUP.DAT nei due sensi; togliere la spunta annulla. - Nomi di dispositivo DOS (
devname.py):AddExtensionè riscritta sul posto; il nome completo viene aperto e chiesto con IOCTL 4400h se è un dispositivo (l'estensione non aiuta: CON.CAR è CON); un dispositivo dà la finestra d'errore del gioco (NOME FILE NON VALIDO ...) e si torna alla finestra. - Rose estese e acquisto degli extra (
xtra.py,xbrowse.py,mkworld_tm.py TM_EXTRA=14): fino a 14 giocatori extra (16 + 14 = 30, il tetto di riempimento del gioco). Il mercato nazionale ha voci dall'indice 16 (hook diGetPlayere siti di elenco / riga /AddCareerTeamPlayer); un giocatore comprato va nell'elenco dei venduti (voce di motoreXS, bloccoENdel trailer dopoC7; vecchi salvataggi: vuoto) e non c'èRemovePlayer. La scelta del club ha una seconda pagina per gli extra (xbrowse.py: copia del menu + pulsante) e la vista rosa (STAT, VIS. SQUADRE) un pulsante PAG. SUCC. al posto della voce 6 nascosta (hook diGetPlayerAtIndex, solo visualizzazione: formazioni, panchina e rose di partita intatte). Un salvataggio 4.0.2 con un tale giocatore non si carica nelle versioni precedenti. - Competizioni:
uefaq— il detentore UECL con un posto CL_LS nazionale è 'league' anche lui (UQ_OUT.hkeep[2]: resta nell'elenco CL;w_holderssalta la riga conw_hkeepimpostato; il conteggio dei record prima dei detentori lo ammette,w_chk_tot0q). Livelloconti'away_et_pens' (byte del turno 94h; daticoncacaf.format.jsonccc "extra_time": true; le coppe CAF restano 'away_pens'); nel mondo 2026-27w_away1/w_away3interroganoct_awaysolo dopo i 90 minuti. Opzione C portata sulla punta per Paraguay, Guatemala ed El Salvador (MAXDAYS104,GP_PAGES17, il blocco degli scontri diretti fuori dal DIY;BUILD_AFTERtiene i nomi 'then' di due campionati con gli stessi byte di specifica). VINCITORI: una riga 'K' / 'T' del campionato del club di carriera senza gara del club mostra DA GIOCARE; la nuova sorgente 'Q' (regolapi) indica il campione di un play-offtitle_seedappena una squadra guida entrambi i tornei. Messico: titoli di fase (mex_exact.py). FORMULA:fmtprose.NOPROMOper i play-off di 'piazzamento' di una divisione con posti di promozione. - Menu:
teamstab.pyspostateamsTable(100 byte nel gioco) in un blocco azzerato di 256 byte nella coda di obj2 (quattro riferimenti, tutti e quattro gli exe): l'Italia 2026-27 ha 256 record e i club di Serie D dal 100 in poi leggevanoteamsIndexdopo la tabella (colori dei pulsanti a caso).careerworld.w_viewprende il percorso diw_buy(VISUALIZZA MONDO si apre sui continenti o sulle nazioni del mondo). - Test:
conti.py --test afc caf concacaf conmebol fifa ofcesegue tutte e sei le confederazioni; nuovi scenarifull_graphics,tail_zero,shirt_edit,subs_numbers,controls_menu,controls_calib,save_devname,xtra_*,world_ccc_away,world_mex_titles,world_winners_title,world_viewcont,team_choice_colours,world_uefa_double.
Aggiunte della 4.0.5
- Supercoppe nazionali (
supercup.py,supercups2627.json): per paese i nomi (4 lingue), la data,from_season(1 = invernali, 2 = estive e Brasile), una gara, livello (pens/et_pens), campo neutro, le regole dei partecipanti (campione, vincitore della coppa, finalista, seconda) con l'alternativa per il doblete (if_double: finalista, seconda o terza) efirst_entrantsper la prima stagione.sc_cupsostituisce entrambe le chiamate dicseg_928CCa fine stagione e salva vincitore e finalista di ogni coppa inSC_ST(salvato con la carriera come voce di motore 'SC'; un vecchio salvataggio lo carica vuoto). Le Supercoppe girano nello slot 4 digplayalle settimane vere; le final four costruiscono la finale dopo le semifinali. FORMULA:fmtprose.supercup(). Il Campeón de Campeones messicano è diventato una voce delle supercoppe (title0controtitle1, 25 luglio, dalla stagione 2). - Calendari reali nella prima stagione (
lpreal.py,lgreal.py):LPREAL.DATcontiene gli accoppiamenti reali delle fasi a campionato delle tre coppe UEFA (lr_drawsostituiscelp_mkdrawnella prima stagione di un mondo);LGREAL.DATcontiene i calendari reali dei 31 campionati completi (solo la stagione regolare per i campionati con divisione; una regola di casa dopo la divisione ha una tabella di ospitanti fatta dalle giornate vere,lg_mx). Dalla stagione 2 e per ogni lista che non quadra resta il calendario generato. Le date seguono la cadenza settimanale del gioco. - Panchine lunghe (
benchx.py,bench2627.json): le squadre in partita contengono fino a 26 giocatori (la coda libera dei buffer);bx_maxprende la panchina della competizione (al massimo 15),bx_nextcostruisce i posti; i club del computer aggiungono i loro giocatori in più; solo carriere. Nei menu della rosa, del pre-partita e della tattica le righe 12..17 sono una finestra sulla panchina che scorre (bx_mdir); GIÙ sulla riga 17 a fine finestra torna in cima alla panchina (riga 12), SU sulla riga 12 in cima mantiene la mossa del gioco verso la riga 11. Gli highlights con una panchina oltre 5 richiedono la 4.0.5. - Panchine lunghe in campo (
dugout.py, 4.0.6): le panchine in campo sono tile della mappa (PITCH1-5.DAT, 42 x 55 offset nei motivi 16 x 16 diPITCHn.BLK, al massimo 296); sono entrambe 6 righe di tile più lunghe (quella in alto verso l'alto, quella in basso verso il basso: 18 posti), ogni tile preso dalle panchine originali nella stessa fase delle strisce del prato, una fase mancante ricavata da un tile esistente con l'erba sostituita (PITCH5, strisce diagonali: 3 motivi nuovi). La modalità a 16 colori (EGA) legge inveceSWCPICH1-5.P16(la stessa mappa, il tile nella word alta di ogni dword): lì le stesse righe, nessun motivo nuovo (il suoPITCH5usa già un solo tile centrale in ogni fase). Nell'exe (blocco 2 dibenchx) ogni posto della panchina è seduto in entrambe le panchine (la finestra di 5 non c'è più), la y della panchina in alto passa da 389 a 293 e nel menu delle sostituzioni la telecamera si ferma a metà della propria panchina (benchY + 67: tutta la panchina in uno schermo); mentre entra un sostituto torna alla linea di metà campo come prima. Il campo d'allenamento (PITCH6) non cambia. Il patcher installa le cinque mappe ePITCH5.BLKcome differenze dagli originali. - Giocatori calvi (
bald.c,blond.py): quattro look (stempiato / rasato, pelle chiara / scura) rimodellano lo sprite grezzo del giocatore prima della conversione dei colori; il rasato chiaro usa un nuovo tono della palette (pal_init); in modalità half / EGA le teste rasate chiare tengono il colore pelle; spento con SWOS++. - Colori di zona (
zones.py): le squadre B e le riserve che non possono salire o giocare i play-off vengono saltate e il colore passa alla squadra successiva. - Nomi (
namespr.py): nomi in partita fino a 14 caratteri (ExtractSurnameda 400Bh a 400Eh, 32 sprite di nome nostri da 112 x 6 pixel); il '_' resta il collegamento e si disegna come spazio. - Altro: interruttore SELEZIONA MAGLIE SOLO PARTITA / SEMPRE; voci STAT per le fasi precedenti; play-off per il titolo decisi alla fine del campionato; fase per il titolo e Grand Final della National League neozelandese; Macedonia del Nord a 4 giri; il pacchetto "SWOS 16/17" riconosciuto dal patcher; SWOS++: il pulsante verde CARRIERA 2026-27 resta e la voce di SWOS++ prende il posto di SALVA finché non c'è nulla di caricato.
Novità della 4.1 (le vecchie 4.0.6 e 4.0.7 unite)
- Terzo oggetto (obj3): la cura strutturale per le regole sullo spazio (CONVENTIONS 20 e 22): pagine di codice in un terzo oggetto dopo obj2, così obj2 resta a 213 pagine e obj1 sotto 237. La catena della 4.0.6 in
patch.py:benchx,kittrain,squadnum,mk_keep,oppl,cpucards,whitehair,finance,kbd2(ogni strumento aggiunge le sue pagine dopo la fine del precedente). - Due giocatori sulla stessa tastiera (
kbd2.py): un quarto dispositivo di COMANDI; il secondo gruppo di tasti si legge daCONTROL2.DAT(9 byte: 'K2', versione 1, attivo/no, 5 scancode; di default W S A D e MAIUSC sinistro, mai CTRL). Gancio suSetKeyboardControlFlags, sulla routine di stato del giocatore 2, sui sei azzeramenti e un caricatore agganciato alla correzione del joypad. Spento con SWOS++ o con un dispositivo diverso da tastiera-e-joypad. "Prima la tastiera" (correzione A): una direzione tenuta sulla tastiera vince su un joypad non centrato, nei menu e per la squadra che nessun altro controlla sulla tastiera. - Rossi e infortuni della CPU (
cpucards.py): due righe di OPZIONI (voce di motore 'CC': un bit ciascuna, attive di default, salvate con la carriera). L'originale non ammoniva né espelleva mai un giocatore guidato dal computer e lo saltava nei percorsi dopo la partita; i ganci aprono i percorsi di ammonizione, espulsione, conto alla rovescia delle squalifiche e infortuni alle squadre del computer, con un conto alla rovescia al giorno per i club del computer in cache; la formazione del computer cambia i titolari non disponibili prima della partita e li rimette dopo. Gli interruttori di provaCARDS_FORCE,INJ_FORCEnon sono mai nelle versioni di rilascio. Infortuni dei portieri (406-gkinj): 1 su 25 dopo ogni partita per il portiere in campo al fischio finale, 1-2 partite fuori; i portieri del computer in ogni competizione tranne le amichevoli con INFORTUNI ALLA CPU attivato; le competizioni personalizzate e predefinite ora fanno scendere dopo ogni partita infortuni e squalifiche del computer. - Convocazioni dalla squadra B (
bteam.py): dati per 20 club in 7 paesi (seconda squadra / under 23), limiti di età e finestre di mercato per paese; un pulsante nella schermata della rosa; "solo prossima partita" (fino a 4 giocatori, senza costo né stipendio) e "per la stagione" (fino a 3 per finestra); i convocati hanno il numero di maglia giallo (senza B) e valore PRES.; la banca non cambia mai. Australia e Nuova Zelanda usano la regola australiana di soli under 23 (quella neozelandese è un'approssimazione). - Finanze: l'originale addebita a ogni partita gli stipendi più costi di gestione di circa 3,2 volte gli stipendi e non incassa niente che cresca con il club. La 4.0.6 aggiunge, con ogni addebito di partita, una base per serie (3,0 / 1,2 / 0,5 / 0,2 M a stagione; i gironi paralleli contano come un livello) più 1,1 volte il monte stipendi della stagione, mostrata come SPONSORIZZ.; le spese non cambiano; nel salvataggio non si memorizza niente. L'incasso di una singola partita si ferma al massimo a 16 bit invece di ripartire da zero. Fair play finanziario (opzione in ANDAMENTO CLUB, attiva per le nuove carriere, disattiva per i salvataggi vecchi): all'inizio di ogni stagione, stipendi oltre il 40% dei ricavi della stagione scorsa (senza la parte TV che cresce con il monte ingaggi) chiudono il mercato finché non tornano sotto e costano una multa pari alla metà dell'eccesso.
- Coppe continentali (
406-cgame,406-contiview): la pagina COPPE CONTINENTALI e i pulsanti delle coppe in VISUALIZZA MONDO aprono ogni turno sorteggiato nella schermata di coppa del gioco; resta una pagina di testo per la fase campionato della AFC Champions League Elite e per i turni che non si possono mostrare in sicurezza; guardare ripristina la carriera esattamente com'era (corretto il difetto della 4.0.5 che metteva TRASFERIMENTI in grigio). I punteggi continentali ora sono di circa 2,6 gol a partita; la Supercoppa UEFA, la Recopa Sudamericana, la Supercoppa CAF e la Coppa Intercontinentale FIFA seguono date e formule vere. - Panchina e menu: dugout su due file in partita (il patcher ora installa tutti e cinque i
PITCH1-5.BLK), l'orologio si sposta mentre la panchina è aperta, la telecamera si ferma sulla linea di metà campo; scorrimento degli elenchi lunghi come nel gioco originale (ripristinato l'ordine del cursore nella schermata prima della partita); la rosa dell'avversario dal menu della panchina (sola lettura, spenta con SWOS++); gli allenamenti mantengono la panchina originale su una fila; i nomi negli elenchi partono 2 pixel più a destra. - MODIFICA SQUADRE: aspetto e numeri (
edteam.py, 4.0.6, Marco; obj3 in fondo alla catena). L'editor (editTeamsMenu) modificaeditTeamsTeam(684 byte; OK lo copia nel suo posto di CUSTOMS.EDT). Aspetto: FUOCO su un pulsante faccia (voci 23..38) passa per dieci aspetti: facce 0..3 (bianco, rosso, nero, nero biondo), poi stempiato chiaro / scuro, rasato chiaro / scuro, capelli bianchi chiaro / scuro (byte 25 bit 0 / 0+1 / 2 con faccia 0 o 2, i flag di blond 3 / 2, 5 / 4, 7 / 6; i bit 3..7 restano).et_nextsostituisce l'add word [D0], 1di EditTeamsChangePlayerFace; l'icona di anteprima è quella di blond (icon_d1a/biconleggono il byte 25). Numeri:et_rowsi incatena alcall se_rowdi se_ctl (doposq_rowdi squadnum): un pulsante faccia è una riga (il suo before-draw è EditTeamsPlayersBeforeDraw, SINISTRA = nessuna), quindi il box numero di shirtedit funziona lì senza modifiche: SINISTRA lo accende, SU / GIÙ numeri liberi, cifre per scan code, uno scambio se il numero è occupato, FUOCO / INVIO / SINISTRA / DESTRA chiudono, ESC annulla; la prima modifica rende unici i numeri e mette il pin (byte 23 bit 7, salvato con la squadra).et_hlsostituiscemov [esi + 26h], ax / mov ax, [D7]in EditTeamsPlayersBeforeDraw: la voce 55 (un'unica voce numero disegnata per ogni riga) ha lo sfondo acceso solo sulla riga in modifica. Limiti: sotto SWOS++ (il controlloSPPMMIdi blond) FUOCO passa per le quattro facce e non tocca il byte 25 (SWOS++ non disegna gli aspetti, né nei menu né in partita); un nome di 22 lettere resta alle quattro facce (il byte 25 è il suo terminatore; scrivere un nome di 22 lettere cancella l'aspetto); il gioco originale ignora il byte 25 (l'aspetto è la faccia normale) e tiene i numeri come scritti. Il formato di CUSTOMS.EDT non cambia. Harness:edit_custom_teams(aspetti, box numero, il file salvato, un'amichevole con SQUADRE MODIFICATE: numeri, icone delle facce (una figura per aspetto), uno scambio con la panchina, i flag degli aspetti in partita; SWOSPP_BUILD: SWOS++). - Aspetto: capelli bianchi (Ravanelli) e teste calve / rasate / stempiate / bianche nella schermata delle formazioni.
- Recupero: minuti di recupero con "+N" a 45:00 e a 90:00 (massimo per epoca; giocati al ritmo di una partita da 10 minuti; spento con SWOS++).
- Nomi degli stadi: nomi ufficiali completi (fino a 48 lettere) nel Mondo 2026-27, con 26 soprannomi; nessun nome è inventato.
- Altro: interruttore dei rimpiazzi della CPU in ACQUISTA GIOCATORE (INVENTATI / DALLA ROSA); gli elenchi di mercato ricordano la pagina; numeri di maglia modificabili nella schermata della rosa; correzioni per le frecce SU/GIÙ dopo AVVERSARI, gli acquisti dei giocatori extra della rosa, il turno del giorno di riposo in Nuova Zelanda e una squadra di play-off che rifiuta il posto. Nomi: più caratteri nei nomi digitati (- . / ' ? + ( ) : , e _ mostrato come spazio, con la disposizione della tastiera; anche i nomi dei file di salvataggio accettano - ' ( ) e _; SHIFT scrive il simbolo sul tasto, SINISTRA / DESTRA muovono il cursore del testo; SWOS++ mantiene la sua digitazione). Etichetta della versione in basso a sinistra in grigio. Mondo 2026-27: codici SRB / CZE / MKD / COD / SWZ e nazionali SERBIA / NORTH MACEDONIA / CZECHIA / ESWATINI (rose 1996-97 fino alla 4.4); sette maglie polacche. [Dettagli tecnici di ogni voce: chiedere ai proprietari; questo elenco segue le note di rilascio.]
- Selettore del mondo (
mainbtn.py,swe.py/swe.cin obj4, MC e Marco): un mondo è uno dei tre insiemi di dati che la mod sa giocare: 2026-27, 1996-97 (il gioco originale) ed Europa 1984-85. Un nuovo pulsante del menu principale sostituisce quello verde CARRIERA 2026-27 e cambia il mondo corrente (tenuto inSETUP.DAT, byte +105). Il mondo vale per CARRIERA (la scelta della squadra elenca i club di quel mondo), AMICHEVOLE, COMPET. PERSONALIZZATA (le competizioni su misura del gioco: scegli squadre e formula), COMP. PREDEFINITA e STAGIONE. Dove un mondo non ha niente da offrire, un messaggio lo dice (NAZIONALI NON ANCORA DISPONIBILI PER QUESTO MONDO, AL MOMENTO NON CI SONO COMPETIZIONI PREDEFINITE / STAGIONI PER QUESTO MONDO; le quattro lingue sono inAV_LINESdiswe.py) e un riquadro viola STORICO porta ai tornei e alle stagioni storiche. ESCI accanto a ABBANDONA nel messaggio delle nazionali (4.1esci) torna al menu dei tipi di squadre tenendo le squadre già scelte. - Un solo mondo per competizione (
swe.c, mescolamento «A»): in AMICHEVOLE e nei tre editor delle competizioni personalizzate (torneo, coppa, campionato) un club di un mondo della carriera (2026-27 o 1984-85) può giocare contro club del 1996-97. Il primo club di un mondo della mod impostaSEL_CW(swe_sel_ns, chiamata quando cresce il numero di squadre scelte); da lìlocked(n)(SEL_CW && n && n != SEL_CW) nasconde l'altro mondo della mod e la barra del titolo dice UN SOLO MONDO PER COMPETIZIONE. Niente viene rifiutato; deselezionare tutti i club toglie il blocco; nazionali, squadre personalizzate e la scelta della squadra in CARRIERA non sono mai bloccate. Una competizione personalizzata salvata ricorda il suo mondo (un record «WM», versione 2); i vecchi file si caricano come 1996-97. Funziona con SWOS++ (engine_wmodes_swospp). - Menu principale originale (
mainbtn.py, casella del patcher, Marco): una scelta fatta all'installazione, spenta di default. Con la spunta la patch non mette il pulsante MONDO né la scritta MOD, rimette CARRIERA al centro della sua riga e fa del 1996-97 il mondo predefinito; gli altri mondi restano nella lista di ogni modalità. Togliendo la spunta e rilanciando il patcher tornano il menu della mod e il mondo scelto. I salvataggi non cambiano e la voce di SWOS++ resta dove la mette SWOS++. - Panchine lunghe in amichevoli e competizioni personalizzate (
benchx, Panchina): nel Mondo 2026-27 ogni club usa la panchina della propria lega (da 7 a 15 posti, 5 cambi, uno in più ai supplementari dove la regola lo prevede); tra due panchine diverse entrambi usano la più lunga. I mondi 1996-97 e 1984-85, le nazionali e le squadre personalizzate restano con le 5 riserve del gioco e il suo numero di cambi (2 in amichevole, 3 in campionato o carriera, quello impostato nelle personalizzate). La schermata della formazione scorre fino ai giocatori in più e la formazione mostrata è quella che gioca; i posti dei giocatori in più restano memorizzati per 4 club al massimo. I menu della panchina mostrano una striscia con il valore e le tre abilità migliori della riserva evidenziata (le lettere della schermata della rosa; portieri: solo il valore; due riquadri di confronto nel menu sostituzioni); con SWOS++ non compare. - Offerte per i tuoi giocatori (
406-sellA, Francesco): un club fa un'offerta per un tuo giocatore solo se sarebbe almeno il suo 12° migliore (margine 2); i prezzi non cambiano.
30Limiti e questioni aperte
- Play-off (2.5). NSL Finals e NSSL Playoffs sono eliminazioni dirette a 4: i formati veri (NSL: 6 club; entrambi: la "doppia possibilità" per le prime due) richiedono il controllo dei club turno per turno, cioè un contest di tipo 2 nello slot 4, il cui buffer (443h) è troppo piccolo. Rimandati a una versione futura (
finals97.py, opzione A). La prima della stagione regolare che perde i play-off mostra ancora una piccola icona in cima al registro della stagione (non ancora individuata nel codice). - Gironi di C1/C2. Nel 1996-97 la C1 aveva 2 gironi e la C2 3. Il mod usa un girone unico per serie. L'intera realtà (128 squadre) non entra nel limite di circa 93 squadre per nazione. La C1 su due gironi entrerebbe (92), ma servono promozioni e retrocessioni fra divisioni parallele, verifiche sul limite delle 80 squadre di carriera e sui numeri globali: stima 2–3 sessioni.
- Intercontinentale nello slot 4. Una finalista in una divisione con play-off resta senza Intercontinentale. La routine
cseg_8BF89(chiamata dacseg_8B2D3) non è stata analizzata: se tiene dati legati al numero di slot, lo scambio dei buffer potrebbe lasciarli incoerenti. Nel riepilogo stagionale l'Intercontinentale nello slot 4 non ha nome. - Giocatori inventati e carriere lunghe (1.1). Le rose dei 138 club aggiunti nella 1.1–1.2 sono inventate (mancano le fonti); le novità sono state provate per una stagione. Le stringhe non sono più un limite: i nomi nuovi vanno nella pagina aggiunta a obj2.
- Libertadores 2.0. Nel girone 5 il calendario reale del 1997 non sta in sei giornate: l'ordine è l'adattamento più vicino (Millonarios esatti, le altre squadre invertono 1–2 partite). Le regole della detentrice quando si qualifica anche dal campionato o per la CONMEBOL non sono ancora capitate in una partita di prova. In carriera il tabellone resta quello del 1997 (detentrice contro la 3ª del proprio girone); le edizioni reali successive cambiarono formato.
- Trofei dedicati. Le coppe sudamericane usano i trofei delle coppe europee dello stesso rango.
- Salvataggi vecchi. Tengono in cache i dati delle squadre di quando sono stati creati: le rose nuove si vedono solo in una carriera nuova.
- Doppioni. Restano 5 nomi ripetuti (trasferimenti a metà stagione o omonimi). I dati SWOS originali ne avevano 61.
- Panchina inglese (dopo la 1.0). Nella formazione prima della partita le squadre inglesi mostrano 14 giocatori (11 + 3 in panchina). Succede anche con il gioco originale, e
TEAM.008ha 16 giocatori per club: è una regola del gioco. Da capire da dove venga il numero di riserve (regole a +3Dh…41h del buffer, valori 5/2/8 impostati daInitCareer) per portarlo a 5.
31Storico e prossimi passi
| Sessione | Contenuto | Prova |
|---|---|---|
| 1–2 | Strumenti LE; causa del blocco del 1997; Italia a 4 divisioni con base 1850 | passata |
| 5 | Club reali C1/C2 1996-97 | passata |
| 9 | Coppe sudamericane nei menu e nella vista mondo; pool di stringhe | passata |
| 10 | Club sudamericani nelle coppe in carriera; qualificate dalle classifiche; detentrice | passata |
| 11 | Supercopa nello slot 1; pagina aggiunta all'oggetto 1 | passata |
| 12 | Persistenza delle liste con checksum; scambio CONMEBOL; trofei; Intercontinentale nei menu e nello slot 2 | persistenza, slot 2, CONMEBOL trofei |
| 13 | Finaliste dell'Intercontinentale a fine stagione; formato S2; Intercontinentale nello slot 4 | fine stagione, S2 slot 4 |
| 14 | Rose reali 1996-97 e forza calibrata per tutti i 36 club di C1/C2 | passata |
| 15–16 | Port a ENGLISH/FRENCH/GERMAN; patcher HTML; release 1.0 e 1.0.1 (GOG) | superato |
| 17–20 | Analisi di come si registra una nazione; pagine aggiunte a obj2; Costa Rica; cinque nazioni africane con coppe nazionali; coppe CAF in carriera; coda del salvataggio; release 1.1 | superato (1 stagione) |
| 21–24 | CONCACAF Champions Cup; tutte le liste salvate nella coda del .CAR (numeri globali 1730–1846 liberati); Corea del Sud, Cina, Arabia Saudita e le coppe asiatiche; Guatemala e Honduras; release 1.2 | superato (1 stagione) |
| 25 | Formati a gironi decodificati; Copa Libertadores con 5 gironi da 4 (20 club, prime 3 + migliore quarta), coda 'C5' (segnalazione di Playaveli, Swos2020); release 1.3 | superato (1 stagione) |
| 26 | Tornei storici: Mondiale 1982 (formula vera, 4 gironi da 3), Coppa Mitropa 1934, FA Cup 1871-72 (esenzione, ripetizioni, sorteggio a moneta); rose dai DLC di SWOS 2020 e da fonti d'epoca | superato |
| 27 | Copa Libertadores con il formato reale del 1997: detentrice direttamente agli ottavi, calendario dei gironi e tabellone reali, niente gol in trasferta né supplementari, finale andata e ritorno; coda 'C6' | superato (predefinite, carriera, salvataggi) |
| 28 | Argentina con Apertura/Clausura, classifica complessiva e promedio; Australia NSL 1996-97 con NSL Cup e NSL Finals; Nuova Zelanda NSSL con punto bonus dei rigori e play-off; MLS 1997; finale dei play-off in calendario (correzione del numero di turni); registro: il vincitore dei play-off è il campione, club assente dalla sua coppa; coda 'C7' | superato (IT; da rigiocare la finale NSSL e EN/FR/DE) |
| 29 | Stagioni storiche: DDR 1988-89 (Oberliga, FDGB-Pokal con tabellone reale, coppe europee 1988-89 con partecipanti, tabelloni, rose e allenatori reali) nel nuovo menu STAG. STORICHE della Stagione; Oberliga anche fra i tornei storici; aggiornamento incrementale del patcher (2.5.1) | superato (IT) |
| 30 | Pacchetti stagione: cartelle di dati compilate da mkseason.py (DDR 1988-89 = primo pacchetto), più pacchetti per build, rose explicit, nazioni 101–251; carriere storiche M1: menu CARR. STORICHE, campionati con divisioni | superato (IT) |
| 31 | Catena europea della carriera decodificata (copie delle coppe nel salvataggio, tabelle dei posti, detentori, checksum); mondi delle carriere storiche: byte del mondo, coppe europee del mondo, worldNN.tmd (M2) | superato (IT, 2 stagioni) |
| 32 | Release 2.6.1: una carriera nuova iniziata con un club in una coppa europea viene avviata subito (dalla 1.2 il marchio 'S3' e le liste iniziali delle coppe degli altri continenti si scrivevano solo nell'altro ramo). Carriere storiche M3: anno iniziale del mondo, vista del mondo e ricerca stranieri limitate al mondo, niente panchine delle nazionali, detentori con un posto loro | superato (IT, 2 stagioni) |
| 33 | Release 2.7.0: compatibilità con SWOS++ sull'exe inglese (CD e GOG): tools/swospp.py, uscite del patcher ENGLISH.EXE + SWOS++ | superato (EN, SWOS++ 1.9.2.2) |
| 34 | Release 3.0: carriere storiche Europa 1984-85 (dati DaniSwos), coppe europee fino a 128 club, niente derby nei primi due turni, regola dei detentori, correzione Intercontinentale, editor MAGLIE | superato (banco di prova automatico + prova di Davide) |
| 35 | Release 3.1: banco di prova circa dieci volte più veloce; nazionali dell'Europa 1984-85 (143 squadre, panchine, convocazioni, ciclo Mondiali 1986 / Euro 88 con i gironi reali), nazionalità RDT / URS / RFT | superato (banco di prova automatico + prova di Davide) |
Roadmap
- Carriere storiche: un nome per ogni mondo nei menu, carriere lunghe, altri mondi (per esempio il Sudamerica per le sue nazionali).
- Carriere lunghe: prove di 6–8 stagioni con le novità della 1.1–1.2; rose reali dei club nuovi dalla comunità.
- Europa: Intertoto, Supercoppa Europea, Champions League 1997-98.
- Arretrati: panchina a 5 per le squadre inglesi; prova dell'Intercontinentale nello slot 4; C1 a due gironi.
Crediti: disassemblato e documentazione dei formati da swos-port (zlatkok). Mod: Davide Lorigliola, con Claude.