> For the complete documentation index, see [llms.txt](https://tne.gitbook.io/tne-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tne.gitbook.io/tne-docs/intro/breakdown-of-main-currency-configuration-file.md). # Breakdown of Main Currency Configuration File This document provides a detailed explanation of all the configuration settings available in the main currency configuration file (e.g., USD.yml) in TheNewEconomy. ### **1. Config Version** * **Key**: `config-version` * **Description**: Specifies the version of the configuration file for compatibility purposes. * **Default**: `2` * **Recommendation**: Do not modify unless necessary. *** ### **2. Basic Currency Information** #### **Info** Configurations related to the basic properties of the currency. | Key | Description | Example | | -------------- | ------------------------------------------------------------------------- | --------------- | | `Server` | The name of the server this currency belongs to (used for data saving). | `"Main Server"` | | `Identifier` | The unique identifier for the currency used in commands. | `"USD"` | | `UUIDAsId` | Whether to use the `Identifier` as the currency's UUID (not recommended). | `false` | | `Icon` | The material name to use as the icon for plugin menus. | `"PAPER"` | | `Major_Single` | Singular form of the currency's major denomination. | `"Dollar"` | | `Major_Plural` | Plural form of the currency's major denomination. | `"Dollars"` | | `Minor_Single` | Singular form of the currency's minor denomination. | `"Cent"` | | `Minor_Plural` | Plural form of the currency's minor denomination. | `"Cents"` | | `Symbol` | The character used as the currency symbol. | `"$"` | *** ### **3. Currency Options** #### **Options** Settings related to regions, global usage, limits, and initial balances. **MultiRegion** * **Description**: Settings for enabling the currency in multiple regions or worlds. | Key | Description | Example | | --------------- | ----------------------------------------------- | --------------- | | `Regions.world` | Whether the currency is the default in a world. | `Default: true` | **Global** * **Description**: Configurations for global availability. | Key | Description | Example | | --------- | ------------------------------------------- | ------- | | `Enabled` | Whether the currency is usable globally. | `true` | | `Default` | Whether the currency is the global default. | `true` | **Other Options** | Key | Description | Example | | --------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------- | | `Disabled` | Whether the currency is disabled. | `false` | | `Sync` | Whether the currency is synced across servers. | `true` | | `MaxBalance` | The maximum balance allowed for the currency. | `900000000000000000000000000000000000000000000` | | `Balance` | The initial balance for accounts (used if no world-specific configurations are found). | `200.0` | | `Decimal` | The character used as the decimal separator. | `"."` | | `DecimalPlaces` | The number of digits displayed after the decimal separator (maximum: 4). | `2` | | `Type` | The currency type (`virtual`, `item`, `experience`, `mixed`). | `"virtual"` | | `Minor_Weight` | The number of minor units required to equal one major unit. | `100` | *** ### **4. Formatting** #### **Formatting** Settings for displaying the currency in chat and GUI elements. | Key | Description | Example | | ----------------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------- | | `Format` | The format string for displaying the currency (variables include ``, ``, etc.). | `""` | | `Prefixes` | SI prefixes for shortened amounts. | `"kMGTPEZYXWVUN₮"` | | `JPrefixes` | Japanese-style prefixes for powers of 10. | `"万億兆京垓𥝱穣溝澗正載"` | | `Major_Separate` | Whether to separate major values every three digits. | `true` | | `Major_Separator` | The separator used for major values. | `","` | | `Balance` | Whether the currency appears in balance commands. | `true` | *** ### **5. Item Currency Options** #### **Item** Configurations for currencies based on physical items. | Key | Description | Example | | ------------- | ------------------------------------------------------------------------------------------------ | ------- | | `EnderChest` | Whether to check a player’s Ender Chest for item balances. | `true` | | `EnderFill` | Whether item balances are deposited into the Ender Chest when inventory is full. | `true` | | `ImportItems` | Whether to import existing item currencies into a player's balance on their first balance check. | `true` | *** ### **6. Notes** #### **Note** Settings for currency notes (physical representations of money). This is only used with the /money note command, not for physical currency items, that's in your denomination's file. | Key | Description | Example | | --------- | ------------------------------------------------ | ------- | | `Notable` | Whether this currency can be converted to notes. | `false` | | `Fee` | The fee for creating a note. | `0.00` | | `Minimum` | The minimum amount required to create a note. | `0.00` | **Item** | Key | Description | Example | | -------------- | -------------------------------------------------------------- | ---------- | | `Material` | The material to use for notes. | `"PAPER"` | | `Texture` | The base64 texture for notes if the material is `PLAYER_HEAD`. | `` | | `Enchantments` | A list of enchantments applied to notes (optional). | `[]` | | `Flags` | A list of item flags applied to notes (optional). | `[]` | *** ### **7. Currency Conversion** #### **Converting** | Key | Description | Example | | --------- | ------------------------------------------------------------------------- | ------- | | `Example` | Conversion rate from this currency to another (e.g., 1 USD = 2 Examples). | `2.0` |