MxmsSettings.json

An example mxmsSettings.json file open in Visual Studio

Welcome to the configuration manual for MXMS. To provide a flexible and scalable environment, we use JSON (JavaScript Object Notation) for all system settings and user preferences. JSON is a lightweight, text-based data format that is easy for humans to read and write, and easy for machines to parse and generate. By modifying the configuration file, you can customize the behavior of the application without needing to touch the underlying source code.

Why JSON

Structured Data: Organizes complex settings into clear, nested hierarchies. Universal Support: Compatible with almost every modern programming language and tool. Lightweight: Minimal overhead ensures that your application loads settings instantly.

The Golden Rules of JSON Syntax

JSON is a "strict" format. Even a tiny typo can prevent the application from starting. When editing your configuration, keep these rules in mind:

   Double Quotes Only: All keys and string values must be wrapped in double quotes ("key": "value"). Single quotes (') will cause an error.
   No Trailing Commas: Never place a comma after the last item in a list or an object.
   Case Sensitivity: "SettingName" is not the same as "settingname". Ensure you use the exact casing required.
   Value Types:
       Strings: "Text"
       Numbers: 100 (no quotes)
       Booleans: true or false (no quotes, lowercase)
       Null: null (no quotes)
   Brackets Matter: Use curly braces { } for objects (groups of settings) and square brackets [ ] for arrays (lists of items).