Über die Datei config.ini kannst du Einstellungen für das ausgeführte Spiel vorgeben. Die Datei muss sich im selben Verzeichnis wie der Player befinden. Beim Erstellen eines Spiels legt Visionaire Studio automatisch eine grundlegende config.ini im Exportordner an.

Bei Parameternamen und -werten spielt Groß- und Kleinschreibung keine Rolle, außer beim Dateinamen (Parameter FILE). Die Reihenfolge der Parameter ist egal.

Eine flexiblere Methode, eigene Einstellungen per Lua aus der config.ini zu lesen und hineinzuschreiben, zeigt dieses Skript. Seit dem Update vom November 2025 gibt es außerdem die Funktionen system.setConfig() und system.getConfig().


Parameter der Datei config.ini

Grundparameter

FILE = {game.ved}

Gibt die Datei an, die der Player beim Start automatisch lädt. Den Dateinamen gibst du entweder hier in der .ini-Datei oder als Befehlszeilenparameter an (das passiert automatisch, wenn du das Spiel aus dem Editor startest). Die Dateiendung spielt keine Rolle, solange es eine gültige Visionaire-Spiel- oder Projektdatei ist. Beim Dateinamen musst du Groß- und Kleinschreibung beachten.


FULLSCREEN = {yes|no}
  • yes: Das Spiel startet im Vollbild.
  • no: Das Spiel startet im Fenster.


RESOLUTION = {Auto|Desktop|Game|Custom}

Schaltet die Unterstützung für Breitbildschirme ein.

  • Game: Das Spiel startet mit der Auflösung, die im Spiel festgelegt ist. Im Vollbild kann das Probleme machen, wenn das Spiel zum Beispiel 1024 x 768 Pixel hat und auf einem Breitbildmonitor läuft (wie das Bild gestreckt wird und ob das Seitenverhältnis erhalten bleibt, hängt von Bildschirm und Grafiktreiber ab). Dann erscheint die ganze Szene verzerrt.
  • Desktop: Im Vollbild wird die aktuelle Desktop-Auflösung verwendet. Die Szene wird nur so weit gestreckt, dass das Seitenverhältnis des Spiels erhalten bleibt; der Rest wird mit schwarzen Balken gefüllt.
  • Auto: Die Breitbildunterstützung (wie bei Desktop) wird eingeschaltet, wenn ein Breitbildschirm erkannt wird.
  • Custom: Nur zusammen mit FULLSCREEN = no, zum Beispiel RESOLUTION = 640x480.


INTRO = {yes|no}
  • yes: Das Intro wird beim Start gezeigt.
  • no: Das Intro wird nicht gezeigt.


Hat das Spiel kein Intro, kannst du diesen Parameter weglassen.


LANGUAGE = {German|English...}

Die Sprache, in der das Spiel startet. Gib den Namen der Sprache genau so ein, wie er im Editor angelegt ist.


LOGLEVEL = {Info|Warning|Error}

Legt fest, welche Meldungen in die Logdatei messages.log geschrieben werden.

  • Error: Nur Fehlermeldungen kommen in die Logdatei.
  • Warning: Fehler und Warnungen kommen in die Logdatei.
  • Info: Alles kommt in die Logdatei.


Erweiterte Parameter

MUSICVOLUME = {0 to 100}

Setzt die Musiklautstärke auf den angegebenen Wert. 


SOUNDVOLUME = {0 to 100}

Setzt die Lautstärke der Soundeffekte auf den angegebenen Wert.


SPEECHVOLUME = {0 to 100}

Setzt die Sprachlautstärke auf den angegebenen Wert. 


MOVIEVOLUME = {0 to 100}

Setzt die Lautstärke von Videos auf den angegebenen Wert.


GLOBALVOLUME = {0 to 100}

Setzt die Gesamtlautstärke auf den angegebenen Wert.


USETEXTUREFORWIDESCREEN = {yes|no}
  • yes: Framebuffer mit Textur verwenden. (Standard)
  • no: Framebuffer ohne Textur verwenden.


RESIZEABLE = {yes|no}
  • no: Die Fenstergröße lässt sich nicht ändern. (Standard)
  • yes: Die Fenstergröße lässt sich ändern.


LOCKCURSOR = {disabled|enabled}
  • disabled: Der Mauszeiger kann das Spielfenster verlassen und auf den Desktop wandern. (Standard)
  • enabled: Der Mauszeiger bleibt im Spielfenster gefangen.


config.ini-Beispiele

FULLSCREEN = no
INTRO = no
LOGLEVEL = Error

Weil kein Dateiname angegeben ist, muss er als Befehlszeilenparameter übergeben werden. Eingestellt sind Fenstermodus und „kein Intro“. Nur Fehler werden in die Logdatei messages.log geschrieben.


FULLSCREEN = yes
INTRO = yes
FILE = demo/demo.vis
LANGUAGE = English
LOGLEVEL = Info

Beim Start des Players wird das Spiel demo.vis im Unterordner demo geladen. Es läuft im Vollbild, die Sprache ist Englisch, und das Intro wird gezeigt. Alle Meldungen kommen in die Logdatei messages.log.


FILE = data.vis
FULLSCREEN = no
RESIZEABLE = yes
RESOLUTION = 640x480
LOGLEVEL = Info

Fenstermodus. Die Fenstergröße lässt sich von Hand ändern, zu Beginn ist sie 640 x 480 Pixel. Alle Meldungen kommen in die Logdatei messages.log.


Befehlszeilenparameter

Außerdem kannst du der visplayer.exe oder der erstellten <game>.exe Parameter mitgeben, entweder beim Start über die Befehlszeile oder in einer Windows-Verknüpfung. Befehlszeilenparameter überschreiben die Werte aus der config.ini.

Die Parameter (Reihenfolge egal):

  • -w|--window: Das Spiel startet im Fenster (ohne diesen Parameter im Vollbild).
  • -ns|--nosounds: Deaktiviert die Tonausgabe.
  • -nv|--novideos: Deaktiviert alle Videos.
  • -r|--resolution=auto|desktop|game: Erklärung siehe Parameter RESOLUTION.
  • -ll|--loglevel=info|warning|error: Erklärung siehe Parameter LOGLEVEL.
  • <ved/vis file>: Der letzte Parameter kann den Dateinamen des Spiels angeben.


Beispiele: 

visplayer.exe -f -ll=warning demogame.ved
demogame.exe -w --resolution=auto