📊 How does REPOConomy work?

Pretty simple — here's a detailed explanation:

🧩 1. Economy appearance & UI

At the start of each level (only levels — not shop!), the host and all players (if they also have this mod installed) see the UI with the current economy:

💡 Example of the interface screenshot:

The UI consists of 4 lines:

Line 1 — Name of the current economy event

• Displays the active economic mode. Example: Stable
• Stable means the default mode is active:
  • Only the values from the config + level scale (LevelScale) are used
• Deflation — an event that affects valuable prices, and so on...

Line 2 — Value Range (Range)

Example: –5% to +10%

• These are the limits within which each valuable can drop or increase in price
• For example, a valuable might get +3.7% or –2.1% — randomly picked

Line 3 — Level and LevelScale

Example: Level 4 (–3% - +3%)
This shows how much level scaling affects the economy:

• LevelScaleMin and LevelScaleMax are set in the config (default: 1%)
• They're added to the current Range
  → Example: if base Range was –5% ~ +10%, then on level 4 it becomes:
  –8% ~ +13%

Line 4 — Description of the current event (Flavor)

Example:

• Stable → Economy by default
• Deflation → Market Crash
• It's just flavor text explaining the "feel" of the current economic situation

• ✅ The UI automatically hides after 8 seconds
• You can toggle it manually anytime using the G key

💰 2. How is the economy applied to valuables?

Each valuable gets a unique price modification percentage.
Here's how it works:

• The current Range is used, for example:
  –5% min — +10% max

• The mod picks a random value within this range.
  Example:

  • Valuable A gets +1.43%
  • Valuable B gets –2.41%

• This means:

  • A increases in price by 1.43%
  • B drops in price by 2.41%

• These values are independent and unique for each valuable

• The logic is fully randomized, but limited by the Range

🖼 Screenshot showing how the mod changes valuable prices:

So each level creates a new economic situation where some valuables become more valuable, while others become less valuable.

🎯 3. What do events do?

Events begin appearing from level 2, with a 50% chance.
Events modify the value Range for valuables.

Examples:

• 🟢 Inflation:

  • Adds +0% to the min value
  • Adds +10% to the max value
  • → New Range becomes: –5% → –5%, +10% → +20%

• 🔻 Deflation:

  • Decreases min value by –10%
  • Decreases max value by –5%
  • → New Range becomes: –5% → –15%, +10% → +5%

Each event affects how much valuables can rise or fall in value, making the game more interesting, harder, or more profitable.

⚠️ Important to know:

• REPOConomy does NOT affect shop!
  It only works in levels, and only on valuables.
• Events are triggered starting from the level set in EventsStartLevel (default: 2), and appear with a 50% chance.
• All of this can be configured in .cfg or via the REPOConfig GUI.

✅ Summary:

• 🎲 Economy is random, but controlled via config and events
• 💸 Each valuable gets its own price within the current rules
• 📈 Events can boost, weaken, or break the economy
• 🧠 The UI shows everything: event name, range, level impact, and description

We hope now you understand how REPOConomy works — and how it makes every run unique!

1️⃣ JSON STRUCTURE

Each file must be a valid JSON containing an array of CustomEconomyData objects:

[
  { /* Event 1 */ },
  { /* Event 2 */ }
]

Fields:

2️⃣ EXAMPLE: TWO EVENTS IN ONE FILE

[
  {
    "id": "soft_inflation",
    "name_en": "Soft Inflation",
    "name_ru": "Мягкая инфляция", // Optional: remove this if you don’t want Russian name
    "desc_en": "Slight price increase for a gentle economy shift.",
    "desc_ru": "Небольшой рост цен для плавного изменения экономики.", // Optional: remove this if you don’t want Russian description
    "min": -2.0, // Attention: To add to a negative value, simply place a "-" before the numbers | example: -2.0 |
    "max": 5.0, // Attention: To add to a positive value, simply leave the value without signs: minus or plus example: 5.0
    "color": [255,200,100],
    "useDelta": true
  },
  {
    "id": "hard_deflation",
    "name_en": "Hard Deflation",
    "name_ru": "Жесткая дефляция", // Optional: remove this if you don’t want Russian name
    "desc_en": "Sharp drop in prices for a tough challenge.",
    "desc_ru": "Резкое падение цен для серьёзного испытания.", // Optional: remove this if you don’t want Russian description
    "min": 15.0, // Attention: To reduce a negative value, simply leave the value without signs: minus or plus  example: 15.0
    "max": -5.0, // Attention: To reduce a positive value, simply add a "-" before the numbers  example: -5.0
    "color": [100,150,255],
    "useDelta": true
  }
]

• ⚠️ Warning: Remove everything related to // in the JSON file. If you don't, there will be an error during loading. ⚠️

• If you want to add a third event and beyond, simply copy the first event from { to } and don't forget to put a comma , at the end of }. Example: },

3️⃣ STEP-BY-STEP: CREATE YOUR OWN EVENT

1. Open folder: BepInEx/config/CustomEvents.
2. Create my_events.json file or any other name without spaces.
3. Paste JSON array with objects as in example above.
4. Fill in fields: id, name_en, name_ru, desc_en, desc_ru, color, min, max, useDelta.
5. Save the file.
6. Restart the game — the mod will auto-load new events.

• ✅ That's it! Now you can share your custom events with other players!

💡 Tip: Validate your JSON syntax at jsonlint before saving.

РУССКИЙ ГАЙД

1️⃣ СТРУКТУРА JSON

Файл должен содержать массив объектов CustomEconomyData:

[
  { /* Ивент 1 */ },
  { /* Ивент 2 */ }
]

Поля:

2️⃣ ПРИМЕР: ДВА СВОИХ ИВЕНТА В ОДНОМ JSON

[
  {
    "id": "soft_inflation",
    "name_en": "Soft Inflation", // Внимание: данную строку не обьязательно добавлять если вы не хотите имя для английского языка
    "name_ru": "Мягкая инфляция",
    "desc_en": "A slight increase in prices for a smooth economic adjustment.", // Внимание: данную строку не обьязательно добавлять если вы не хотите описание для английского языка
    "desc_ru": "Небольшой рост цен для плавного изменения экономики.",
    "min": -2.0, // Внимание: Чтобы прибавить к минусовому значению просто добавьте перед цифрами - |пример: -2.0|
    "max": 5.0, // Внимание: Чтобы прибавить к плюсовому значению просто оставьте значение без знаков: минуса - плюса |пример: 5.0|
    "color": [255,200,100],
    "useDelta": true
  },
  {
    "id": "hard_deflation",
    "name_en": "Hard Deflation", // Внимание: данную строку не обьязательно добавлять если вы не хотите имя для английского языка
    "name_ru": "Жесткая дефляция",
    "desc_en": "A sharp decline in prices for a serious challenge.", // Внимание: данную строку не обьязательно добавлять если вы не хотите описание для английского языка
    "desc_ru": "Резкое падение цен для серьёзного испытания.",
    "min": 15.0, // Внимание: Чтобы уменьшить минусовое значение просто оставьте значение без знаков: минуса - плюса |пример: 15.0|
    "max": -5.0, // Внимание: Чтобы уменьшить плюсовое значение просто добавьте перед цифрами: - |пример: -5.0|
    "color": [100,150,255],
    "useDelta": true
  }
]

• ⚠️ Внимание: удалите все что связанное с // в Json файле, если не удалите то будет ошибка с загрузкой ⚠️

• Если хотите добавить 3 ивент и так далее просто скопируйте первый ивент с { до } и не забудьте в конце } поставить , Пример: }, и измените поля под свой вкус.

3️⃣ ПОРЯДОК ДЕЙСТВИЙ:

1. Открой BepInEx/config/CustomEvents.
2. Создай my_events.json файл, или любое другое название Без Пробелов.
3. Вставьте массив JSON с кастомными событиями, как в примере выше.
4. Отредактируй все поля: id, name_en, name_ru, desc_en, desc_ru, color, min, max, useDelta.
5. Сохрани файл.
6. Перезапустите игру — мод автоматически загрузит новые события.

• ✅ Вот и все! Теперь вы можете делиться с другими игроками со своими кастомными ивентами!

💡 Совет: Проверьте синтаксис на jsonlint перед сохранением файла.