# For Translators

All localization files are in a separate archive from the rest of the mod. It is located in:

```
archive/pc/mod/Dark Future Localization.archive
archive/pc/mod/darkfuture_module_consumableanims_localization.archive
```

These archives include copies of every supported language's localization .json file, and these files are already being loaded by darkfuture\_localization.archive.xl, you do not have to modify it.

Permissions:

* *<mark style="color:orange;">**DO NOT**</mark>* <mark style="color:orange;"></mark><mark style="color:orange;">redistribute the entire mod! Only distribute the updated localization archive.</mark>
* *<mark style="color:orange;">**DO NOT**</mark>* <mark style="color:orange;">translate or redistribute the localization files in darkfuture.archive.xl, with the file name darkfuture\_interactions\_donotmodify.json!</mark> These files are already pre-translated for each supported language, and their strings must be left *exactly as they are*, or the mod will not function correctly. Thank you!

### <mark style="color:yellow;">Notes on Dark Future vs. Dark Future Core</mark>

Dark Future and Dark Future Core utilize the same localization file (`archive/pc/mod/Dark Future Localization.archive`). Any up-to-date translation of Dark Future will function as a fully-functional translation for Dark Future Core.

Dark Future Core does not include the Consumable Animations module archive.

### Differences between 2.0.2 and 2.0.3 Localization Files

<details>

<summary>archive\darkfuture\localization\&#x3C;LANG>\onscreens\darkfuture.json</summary>

*<mark style="color:yellow;">**Added**</mark> the following keys:*

`DarkFutureSettingNeedPositiveSFXEnabledDesc_Core`

`DarkFutureSettingNeedNegativeSFXEnabledDesc_Core`

`DarkFutureSettingCriticalNeedVFXEnabledDesc_Core`

`DarkFutureSettingMainSystemEnabledDesc_Core`

*<mark style="color:yellow;">**Updated**</mark> the following keys:*

`DarkFutureSettingRandomEncounterChanceBadlandsDesc`

`DarkFutureSettingBasicNeedThresholdValue1`

`DarkFutureSettingBasicNeedThresholdValue1Desc`

`DarkFutureSettingBasicNeedThresholdValue2`

`DarkFutureSettingBasicNeedThresholdValue2Desc`

`DarkFutureSettingBasicNeedThresholdValue3`

`DarkFutureSettingBasicNeedThresholdValue3Desc`

`DarkFutureSettingBasicNeedThresholdValue4`

`DarkFutureSettingBasicNeedThresholdValue4Desc`

`DarkFutureSettingShowHUDUIDesc`

`DarkFutureSettingNeedHUDUIAlwaysOnThresholdDesc`

`DarkFutureSettingNeedNegativeEffectsRepeatEnabled`

`DarkFutureSettingNeedNegativeEffectsRepeatEnabledDesc`

`DarkFutureSettingNeedNegativeEffectsRepeatFrequencyModerateInRealTimeSeconds`

`DarkFutureSettingNeedNegativeEffectsRepeatFrequencyModerateInRealTimeSecondsDesc`

`DarkFutureSettingNeedNegativeEffectsRepeatFrequencySevereInRealTimeSeconds`

`DarkFutureSettingNeedNegativeEffectsRepeatFrequencySevereInRealTimeSecondsDesc`

`DarkFutureSettingNeedNegativeSFXEnabled`

`DarkFutureSettingNeedPositiveSFXEnabled`

`DarkFutureSettingNeedMessagesEnabled`

`DarkFutureSettingNeedMessagesEnabledDesc`

</details>

### Differences between 2.0.0 and 2.0.2 Localization Files

<details>

<summary>archive\darkfuture\localization\&#x3C;LANG>\onscreens\darkfuture.json</summary>

*<mark style="color:yellow;">**Added**</mark>* *the following keys:*

`DarkFutureHydrationPenalty02Desc_Core`

`DarkFutureHydrationPenalty03Desc_Core`

`DarkFutureHydrationPenalty04Desc_Core`

`DarkFutureNutritionPenalty02Desc_Core`

`DarkFutureNutritionPenalty03Desc_Core`

`DarkFutureNutritionPenalty04Desc_Core`

`DarkFutureEnergyPenalty02Desc_Core`

`DarkFutureEnergyPenalty03Desc_Core`

`DarkFutureEnergyPenalty04Desc_Core`

`DarkFutureSystemicDecay01Name`

`DarkFutureSystemicDecay02Name`

`DarkFutureSystemicDecay03Name`

`DarkFutureSystemicDecay04FemaleName`

`DarkFutureSystemicDecay04MaleName`

`DarkFutureSettingsModName_Core`

`DarkFutureSettingNutritionLossIsFatal`

`DarkFutureSettingNutritionLossIsFatalDesc`

`DarkFutureSettingHydrationLossIsFatal`

`DarkFutureSettingHydrationLossIsFatalDesc`

`DarkFutureSettingEnergyLossIsFatal`

`DarkFutureSettingEnergyLossIsFatalDesc`

`DarkFutureTutorialCombinedNeeds_Core`

`DarkFutureTutorialActivate_Core`

`DarkFutureConditionSystemicDecay`

`DarkFutureConditionSystemicDecayDesc`

`DarkFutureConditionSystemicDecay01Desc` (No content, placeholder)

`DarkFutureConditionSystemicDecay02Desc` (No content, placeholder)

`DarkFutureConditionSystemicDecay03Desc` (No content, placeholder)

`DarkFutureConditionSystemicDecay04Desc` (No content, placeholder)

`DarkFutureCodex_BasicNeeds_Content_Core`

*<mark style="color:yellow;">**Renamed and Updated**</mark>* *the following keys:*

`DarkFutureCriticalNerveHighNotification` -> `DarkFutureCriticalNeedHighNotification`

`DarkFutureCriticalNerveLowNotification` -> `DarkFutureCriticalNeedLowNotification`

`DarkFutureSettingCriticalNerveVFXEnabled` -> `DarkFutureSettingCriticalNeedVFXEnabled`

`DarkFutureSettingCriticalNerveVFXEnabledDesc` -> `DarkFutureSettingCriticalNeedVFXEnabledDesc`

*<mark style="color:yellow;">**Updated**</mark> the following keys:*

`DarkFutureVehicleNotificationUnauthorized`

`DarkFutureSettingVehicleSleepQualityCityDesc`

`DarkFutureSettingVehicleSleepQualityBadlandsDesc`

`DarkFutureSettingNeedNegativeSFXEnabledDesc`

`DarkFutureSettingNeedPositiveSFXEnabledDesc`

`DarkFutureTutorialNerve`

`DarkFutureTutorialSleepingInVehicles`

`DarkFutureCodex_SleepingInVehicles_Content`

</details>

<details>

<summary>archive\darkfuture_module_consumableanims\localization\&#x3C;LANG>\onscreens\darkfuture_module_consumableanims.json</summary>

*<mark style="color:yellow;">**Added**</mark>* *the following keys:*

`ConsumableAnimSettingLootActionBehavior`

`ConsumableAnimSettingLootActionBehaviorDesc`

`ConsumableAnimSettingLootActionManualKeyKBM`

`ConsumableAnimSettingLootActionManualKeyKBMDesc`

`ConsumableAnimSettingLootActionManualKeyController`

`ConsumableAnimSettingLootActionManualKeyControllerDesc`

`ConsumableAnimChoiceDrinkAnimated`

`ConsumableAnimChoiceDrinkChugAnimated`

`ConsumableAnimChoiceEatAnimated`

`ConsumableAnimChoiceConsumeAnimated`

`ConsumableAnimChoiceSmokeAnimated`

</details>

### Differences between 1.4 and 2.0 Localization Files

Open the .html file contained in the zip file below in a web browser to view the localization file differences between Dark Future 1.4 and 2.0.

Note that there are now <mark style="color:yellow;">**3 files that must be localized**</mark>:

* darkfuture\localization\\\<LANG>\onscreens\darkfuture.json
* <mark style="color:yellow;">**(NEW)**</mark> darkfuture\localization\\\<LANG>\subtitles\quest\darkfuture\_subtitles.json
* <mark style="color:yellow;">**(NEW)**</mark> darkfuture\_module\_consumableanims\localization\\\<LANG>\onscreens\darkfuture\_module\_consumableanims.json

{% file src="/files/et6INGYDZk0qobMSAKzg" %}

### Differences between 1.3 and 1.4 Localization Files

<details>

<summary>Click To Expand</summary>

*<mark style="color:yellow;">**Added**</mark>* *the following keys:*\
`DarkFutureConsumableUIDescriptionEnergizedCaffeine1Stack`\
`DarkFutureConsumableUIDescriptionEnergizedCaffeineMultiStack`\
`DarkFutureConsumableUIDescriptionEnergizedStimulantMultiStack`\
`DarkFutureConsumableEnergizedEffectDesc`\
`DarkFutureConsumableUIDescriptionMaxHealth`\
`DarkFutureConsumableUIDescriptionNerveNoCombat`\
`DarkFutureSettingItemsAmmoHandicapDrops`\
`DarkFutureSettingItemsAmmoHandicapDropsDontModify`\
`DarkFutureSettingItemsAmmoHandicapDropsDisabled`\
`DarkFutureSettingItemsAmmoHandicapDropsEnabled`\
`DarkFutureSettingItemsAmmoHandicapDropsDesc`

*<mark style="color:yellow;">**Modified**</mark> the following keys:*\
`DarkFutureConsumableItemMrWhiteyDesc`\
`DarkFutureConsumableStatusEffectMrWhiteyDesc`\
`DarkFutureConsumableItemGlitterDesc`\
`DarkFutureConsumableStatusEffectGlitterDesc`\
`DarkFutureConsumableBlackLaceStatusEffectDesc`\
`DarkFutureCyberwareEndorphinRegulatorAlcoholNumbStacksDesc`\
`DarkFutureCyberwareEndorphinRegulatorNarcoticsDesc`\
`DarkFutureAlcoholItemNumbedDesc`\
`DarkFutureNumbedDesc`\
`DarkFutureSettingItemsNerveNarcoticsWeak`\
`DarkFutureSettingItemsNerveNarcoticsPotent`\
`DarkFutureSettingItemsHydrationTier1`\
`DarkFutureSettingItemsEnergyTier1`\
`DarkFutureSettingItemsRestorationEnergyDesc`\
`DarkFutureSettingVehicleSleepQualityCityDesc`\
`DarkFutureSettingVehicleSleepQualityBadlandsDesc`\
`DarkFutureTutorialSleepingInVehicles`

*<mark style="color:yellow;">**Deleted**</mark> the following keys:*\
`DarkFutureConsumableUIDescriptionStimulant`\
`DarkFutureConsumableStimulantEffectName`\
`DarkFutureConsumableStimulantEffectDesc`\
`DarkFutureConsumableStatusEffectNarcoticNerveChangeName`\
`DarkFutureConsumableStatusEffectNarcoticNerveChangeDesc`\
`DarkFutureConsumableUIDescriptionNarcoticNerveChange`\
`DarkFutureSettingItemsRestorationNerveNarcoticsDesc`\
`DarkFutureSettingItemsEnergyTier2`\
`DarkFutureSettingItemsEnergyTier3`

</details>

### Differences between 1.2 and 1.3 Localization Files

<details>

<summary>Click To Expand</summary>

*<mark style="color:yellow;">**Added**</mark>* *the following keys:*

* DarkFutureInjuryAllCuredNotification

*<mark style="color:yellow;">**Modified**</mark> the following keys:*

* DarkFutureSettingReducedCarryWeightDesc
* DarkFutureHydrationPenalty04Desc
* DarkFutureNutritionPenalty04Desc
* DarkFutureEnergyPenalty04Desc
* DarkFutureInjury01Desc
* DarkFutureTutorialInjury
* DarkFutureSettingInjuryAfflictionEnabledDesc
* DarkFutureSettingInjuryAccumulationRateDesc
* DarkFutureConsumableInjuryRestoreItemDesc
* DarkFutureNutritionPenalty01Desc
* DarkFutureNutritionPenalty02Desc
* DarkFutureNutritionPenalty03Desc
* DarkFutureNutritionPenalty04Desc

*<mark style="color:yellow;">**Deleted**</mark> the following keys:*

* DarkFutureSettingBackpackUIScale
* DarkFutureSettingBackpackUIScaleDesc
* DarkFutureSettingBackpackUIPosX
* DarkFutureSettingBackpackUIPosXDesc
* DarkFutureSettingBackpackUIPosY
* DarkFutureSettingBackpackUIPosYDesc

</details>

### Differences between 1.1 and 1.2 Localization Files

<details>

<summary>Click To Expand</summary>

This version bump had minimal changes to localization files.

*<mark style="color:yellow;">**Added**</mark>* *the following keys:*

* DarkFutureSummonCarPopUpTotalCredits
* DarkFutureSummonCarPopUpNextCreditTime
* DarkFutureSummonCarPopUpLimitReached
* DarkFutureSummonCarPopUpUnavailable
* DarkFutureSummonCarPopUpTimeHourAbbreviation
* DarkFutureSummonCarPopUpTimeMinuteAbbreviation
* DarkFutureSummonCarPopUpTimeLessThanOneMinuteAbbreviation

*<mark style="color:yellow;">**Modified**</mark>* *the following keys:*

* DarkFutureNervePenalty02Desc

</details>

### Differences between 1.0 and 1.1 Localization Files

Open the .html file contained in the zip file below in a web browser to view the localization file differences between Dark Future 1.0 and 1.1.

{% file src="/files/ZTkcqR8y5CboVn6G1kbc" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.darkfuture2077.com/for-translators.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.