Headless Client/Configuration File

From Neos Wiki
Revision as of 09:26, 24 October 2021 by ProbablePrime (talk | contribs) (Created page with "Headless Clients have a lot of configuration potential. To achieve this a configuration file is used. Configuration files are written in JSON. == Default Configuration File =...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Headless Clients have a lot of configuration potential. To achieve this a configuration file is used. Configuration files are written in JSON.

Default Configuration File

A default configuration file can be found within the Headless Client installation directory's "Config" subdirectory. It is named "DefaultConfig.json".

Creating your own Configuration File

To get started configuring things, copy the "DefaultConfig.json' file to a new file called "Config.json". This will be automatically picked up when you run a Headless Client. Once copied we recommend editing the "comment" property to be something which describes the function of this file. Its value from the default file is incorrect so give it a comment which reflects what you intend to use it with.

After this you can proceed to edit your configuration file.

Using multiple configuration files

When running Neos.exe you can use the command line option -c to specify a configuration file. This lets you maintain multiple configuration files for multiple projects or events. For example you could create and use:

  • Neos.exe -c Config/CoolConvention.json - For a large Convention or event
  • Neos.exe -c Config/SeriousBusinessMeeting.json - For a very serious business meeting.

It's up to you but feel free to write and use as many files as you'd like.