[FM27] BepInEx 6 IL2CPP for macOS — Apple Silicon, Latest macOS, No Game Files Modified

Ciao a tutti,

Sono riuscito a far girare BepInEx nativamente su Football Manager 27 sui Mac con Apple Silicon. È basato sulla build macOS di FM26 di sptndc, con le correzioni che FM27 richiede per la sua versione più recente di Unity (6000.3).

Questo permette ai plugin di BepInEx per FM27 realizzati per Windows di funzionare anche su Mac. Per esempio, FM Manager Photo di FM Tigrotto, che ufficialmente supporta solo Windows, funziona su Mac con questo pacchetto.

L'intera configurazione si trova nella sua cartella e non tocca mai i file originali del gioco. Per tornare alla versione originale, basta cancellare l'opzione di avvio in Steam.

━━━━━━━━━━━━━━━━━━━━
REQUISITI
━━━━━━━━━━━━━━━━━━━━
• Mac con Apple Silicon (M1 o successivo)
• L'ultima versione di macOS (testato su macOS 27.0.1). Aggiorna prima il tuo Mac.
• FM27 su Steam
• Connessione internet al primo avvio (BepInEx scarica le librerie Unity una sola volta)
• Circa 1 GB di spazio libero su disco (la copia del gioco è un clone APFS, quindi solo i file modificati occupano spazio aggiuntivo)

Non supportato: Mac Intel, versioni di macOS più vecchie, versione Epic Games.

━━━━━━━━━━━━━━━━━━━━
INSTALLAZIONE
━━━━━━━━━━━━━━━━━━━━
1. Decomprimi e metti la cartella FM27-BepInEx dentro la cartella di gioco di FM27 (accanto a fm.app).
Steam → clic destro su FM27 → Gestisci → Sfoglia i file locali.

2. Apri il Terminale (Applicazioni → Utility → Terminale), incolla questo comando e premi Invio:

chmod +x "$HOME/Library/Application Support/Steam/steamapps/common/Football Manager 27/FM27-BepInEx/run_fm27_bepinex.sh"

Nessun output significa che ha funzionato. (Se la tua libreria Steam si trova su un altro disco, digita chmod +x seguito da uno spazio, poi trascina
run_fm27_bepinex.sh dal Finder nella finestra del Terminale e premi Invio.)

3. In Steam → FM27 → Proprietà → Generale → Opzioni di avvio, incolla il percorso completo dello script, tra virgolette, seguito da %command%:
"/Users/YOURNAME/Library/Application Support/Steam/steamapps/common/Football Manager 27/FM27-BepInEx/run_fm27_bepinex.sh" %command%
(Suggerimento: clic destro sullo script nel Finder, tieni premuto Option e scegli "Copia come nome percorso".)

4. Avvia il gioco da Steam. Il primo avvio richiede alcuni minuti mentre tutto viene generato. Il gioco potrebbe sembrare bloccato; per favore non chiuderlo.

Per verificare che funzioni, apri FM27-BepInEx/BepInEx/LogOutput.log e cerca "Chainloader startup complete". Su macOS non si apre nessuna finestra della console; tutto va nel file di log.

━━━━━━━━━━━━━━━━━━━━
DOVE VANNO I PLUGIN?
━━━━━━━━━━━━━━━━━━━━
A differenza di una normale installazione di BepInEx, i file di BepInEx NON vanno direttamente nella cartella del gioco. Tutto si trova nella sottocartella FM27-BepInEx.

Quindi, quando le istruzioni di un plugin dicono "copia in BepInEx/plugins", usa:
FM27-BepInEx/BepInEx/plugins/

I file di configurazione dei plugin si trovano in FM27-BepInEx/BepInEx/config/.

━━━━━━━━━━━━━━━━━━━━
AGGIORNAMENTI DEL GIOCO
━━━━━━━━━━━━━━━━━━━━
Nessuna azione richiesta. Quando Steam aggiorna FM27, il successivo avvio lo rileva automaticamente, ricrea la copia del gioco e rigenera i file di BepInEx. Anche quel primo avvio richiede di nuovo alcuni minuti. I tuoi plugin e le loro impostazioni vengono conservati.

(Disinstallare il gioco in Steam elimina l'intera cartella di gioco, incluso FM27-BepInEx, quindi fai prima un backup dei plugin.)

━━━━━━━━━━━━━━━━━━━━
PLUGIN TESTATI
━━━━━━━━━━━━━━━━━━━━
✅ FM Manager Photo di FM Tigrotto — https://fmtigrotto.com/tools/manager-photo
Copia la cartella FMManagerPhoto in FM27-BepInEx/BepInEx/plugins/. Le foto sono salvate in
FM27-BepInEx/BepInEx/plugins/FMManagerPhoto/managers.

La maggior parte dei plugin scritti interamente in .NET dovrebbe funzionare come su Windows. I plugin che includono librerie native solo per Windows (file .dll extra che non sono assembly .NET) non funzioneranno su Mac. Se provi un altro plugin, per favore segnala se funziona, così posso aggiungerlo a questa lista.

━━━━━━━━━━━━━━━━━━━━
COSA È STATO CORRETTO PER FM27
━━━━━━━━━━━━━━━━━━━━
La build di FM26 non riusciva ad avviarsi su FM27 per quattro motivi. Ognuno è corretto qui:
• Doorstop non riusciva ad agganciarsi a UnityPlayer di Unity 6.3. Sostituito con un piccolo loader compatibile con Unity 6.3 che usa dyld interpose.
• Cpp2IL andava in crash sul GameAssembly universale. Il launcher usa invece una copia solo arm64, creata in una copia ombra locale dell'app.
• libcapstone mancava per macOS. Incluso Capstone 4.0.2 (arm64).
• Il2CppInterop non riusciva a trovare GenericMethod::GetMethod su FM27. Un piccolo patcher preloader (FM27HookFix) lo trova automaticamente dal codice macchina, quindi dovrebbe sopravvivere agli aggiornamenti del gioco.

Non serve nessuno strumento Xcode. Tutto il codice sorgente è incluso nella cartella source/.

━━━━━━━━━━━━━━━━━━━━
RISOLUZIONE DEI PROBLEMI
━━━━━━━━━━━━━━━━━━━━
• Il gioco non si avvia → controlla FM27-BepInEx/launch.log
• Il gioco si avvia ma non c'è LogOutput.log → controlla FM27-BepInEx/fm27_doorstop.log
• Avviso "non può essere aperto" → Impostazioni di Sistema → Privacy e sicurezza → "Apri comunque"
• Sembra bloccato dopo un aggiornamento → elimina la cartella FM27-BepInEx/shadow; viene ricreata al prossimo avvio.

Se hai problemi, per favore pubblica questi file di log.

━━━━━━━━━━━━━━━━━━━━
CREDITI
━━━━━━━━━━━━━━━━━━━━
• sptndc, per il lavoro su macOS su BepInEx IL2CPP / Il2CppInterop / Dobby su cui questo progetto è basato
• FM Tigrotto, per FM Manager Photo
• I team e i contributori di BepInEx, HarmonyX, MonoMod, Il2CppInterop, Cpp2IL, Cecil, Dobby, UnityDoorstop e Capstone

Buon divertimento! 🍎⚽