Bonsaibauer: Importing a new version from external source

2026-11-07T01:34:40Z

Importing a new version from external source

New page

<languages />



[[File:ShroudForge-Wiki-game-profile-discovery.svg|thumb|left|600px|Automatic beta game profiles]]

 

Optionele bètadetectie vergelijkt een nieuwe gamebuild met een opgeslagen, ondersteunde versie. Er wordt alleen een volledig bètaprofiel gemaakt wanneer het vereiste bewijs beschikbaar is. Passende reguliere gameprofielen hebben voorrang.


== Voorbereiden vóór een game-update ==

De module is standaard ingeschakeld en kan worden uitgeschakeld. Een expliciet opgeslagen uitgeschakelde instelling blijft uitgeschakeld. De schakelaar staat onder '''Settings → General → Game profile''', naast de profielkeuze.

# Controleer of '''Dynamic game profile creation (Beta)''' is ingeschakeld. Schakel dit zo nodig in.
# Start de game of dedicated server volledig opnieuw terwijl er nog een passend regulier profiel beschikbaar is.
# ShroudForge controleert het exacte huidige uitvoerbare bestand en slaat dit in de cache op als vergelijkingsbasis. Je hoeft geen historisch uitvoerbaar bestand te downloaden.
# Na een latere game-update start het nieuwe gameproces automatisch de vergelijking en gebruikt het de opgeslagen basis.

De client en dedicated server bewaren afzonderlijke basisversies. Een client kan geen serverbasis vervangen. Als de module pas na een update voor het eerst wordt ingeschakeld en er geen passende basis is opgeslagen, kan de vorige versie niet worden gereconstrueerd.


== Wat gebeurt er bij het starten van de game? ==

De analyse wordt tijdens het starten van de game uitgevoerd. De game wacht op het resultaat voordat het opstarten wordt voortgezet. Voor deze stap hoeft er geen wereld te zijn geladen.

ShroudForge zoekt eerst naar een regulier profiel dat bij het exacte actieve uitvoerbare bestand past. Als dit bestaat, gebruikt de automatische selectie dat profiel. Als detectie is ingeschakeld, wordt ook het ondersteunde uitvoerbare bestand in de cache opgeslagen voor toekomstige updates.

Als er geen passend regulier profiel bestaat, controleert de module de nieuwste geschikte reguliere basis voor hetzelfde doelproces en KFC-formaat. Het eerder opgeslagen uitvoerbare bestand moet exact met die basis overeenkomen. De vergelijking controleert code, verwijzingen, geregistreerde typen en vereiste structuurcontracten aan de hand van vergelijkingsafbeeldingen. Doeladressen moeten vanuit de nieuwe afbeelding worden vastgesteld.

Het resultaat behoudt het volledige contract van het vorige profiel, inclusief de functievlaggen. Onopgelost of tegenstrijdig bewijs verhindert publicatie van het volledige bètaprofiel. De diagnostiek vermeldt de reden. Langer wachten of een wereld betreden lost ontbrekend statisch bewijs niet op.


== Opslag en selectie ==

Reguliere en gegenereerde profielen delen de geconfigureerde profielmap. De standaardpaden zijn:

{| class="wikitable"
! Inhoud !! Locatie
|-
| Clientprofielen || <code>shroudforge/runtime/profiles/enshrouded/client/</code>
|-
| Serverprofielen || <code>shroudforge/runtime/profiles/enshrouded/server/</code>
|-
| Opgeslagen vergelijkingsafbeeldingen en bewijs || <code>shroudforge/cache/game-profile-discovery/</code>
|}

Gegenereerde profielen beginnen met <code>beta_</code>. De selectie '''Automatic''' kan een volledig geverifieerd passend bètaprofiel gebruiken als er geen passend regulier profiel beschikbaar is. De profielkeuze toont de beschikbare profielen. Een later toegevoegd passend regulier profiel krijgt voorrang.

Als je de schakelaar of profielkeuze wijzigt, moet je de betreffende game of server volledig opnieuw starten. Het Modloader-venster opnieuw openen start de runtime niet opnieuw.


== Detectie, profielen en een actieve wereld onderscheiden ==

De blauwe melding '''Dynamic profile search in progress''' geeft aan dat er actief naar een profiel wordt gezocht. '''Workflow and help''' opent deze handleiding. Als de zoekactie zonder passend profiel eindigt, wordt het probleem rood weergegeven. De oranje melding '''Experimental game profile active''' geeft aan welk bètaprofiel daadwerkelijk is geselecteerd. Echte runtimefouten blijven als fouten zichtbaar.

Structurele controles van uitvoerbare bestanden vereisen geen geladen wereld. Voor wereldbewerkingen zijn daarnaast de bijbehorende livecontexten, registraties en runtimeveiligheidscontroles nodig. Een gegenereerd profiel bewijst niet dat gameopdrachten zijn uitgevoerd of zichtbare effecten hebben gehad. Functionele controles moeten client en server ook afzonderlijk testen.

Als er geen profiel wordt gegenereerd, lees dan de gemelde reden en technische details. Een ontbrekende opgeslagen basis, een ongeschikt bronprofiel of onopgelost bewijs over code en indeling vereist elk de relevante invoer of verdere analyse. Een passend regulier profiel of een geschikte ShroudForge-update kan ondersteuning bieden.


== Gedetailleerde logboekregistratie ==

Debug Console toont detectieberichten uit het hoofdlogboek met de bron <code>game-profile-discovery</code>. Stel '''Settings → General → Logging → Minimum level''' in op '''Diagnostic''' om alle vergelijkingen en rebasevelden te zien. '''Advanced''' toont aanvullende samenvattingen.

De rode runtimebanner en de logboekregel <code>[compatibility-check] check=runtime</code> komen van dezelfde runtimecontrole. De bestaande UI-verversing registreert de statuswijziging voordat dezelfde status naar Modloader wordt verzonden. Debug Console past de bestaande pop-upinstelling toe op waarschuwingen en fouten uit dat hoofdlogboek.

Bij een fout geeft het hoofdlogboek het pad naar het huidige rapport <code>''.v2.unresolved.json</code> of <code>''.v2.error.json</code>. Bij succes geeft het het pad naar het <code>''.v2.proof.json</code>-bewijs en het volledige opslagpad van het gegenereerde <code>beta_''.json</code>-profiel. Rapporten worden in de detectiecache opgeslagen.


== Linux en Proton ==

Detectie wordt uitgevoerd in de native runtimemodule en vereist geen externe PowerShell- of Python-programma's. Deze workflow is nog niet live getest onder Proton.

Raadpleeg [[Special:MyLanguage/Engine|Engine]] voor uitleg over runtime, mod-API en parser.

[[Category:guide:Shroudforge]]

Automatic beta game profiles/nl - Revision history

Bonsaibauer: Importing a new version from external source