EconomyOverride.json - SCUM

Introduction - EconomyOverride.json

Le fichier

/SCUM/Saved/Config/WindowsServer/EconomyOverride.json

contrôle tout ton système économique (l’économie des commerçants) sur ton serveur SCUM.

Tu peux t’en servir pour définir comment fonctionnent les commerçants, comment les prix changent, quand le stock se remplit,

et si les points de célébrité ou les prix dynamiques sont actifs.

Si une entrée n’est pas dans ce fichier ou est définie à -1,

le serveur utilise automatiquement la valeur par défaut du jeu.

Le fichier se charge quand tu démarres le serveur - donc si tu le modifies, tu dois redémarrer,

comme ça tous les commerçants et les cycles des prix se mettent à jour.

Astuce : Garde economy-logging = 1 activé pendant que tu fais des tests.

Comme ça tu peux voir exactement comment les prix, les fonds et les rotations réagissent dans le journal du serveur.

=== Réglages globaux de l'économie ===

economy-reset-time-hours

• Description : Temps (en heures) après lequel toute l'économie (prix, argent, stockage) est réinitialisée.

• Valeurs : -1.0 (pas de réinitialisation), 0.0–168.0+

• Défaut : -1.0

• Recommandation : -1.0 ou 72.0 (tous les 3 jours pour une économie propre)

prices-randomization-time-hours

• Description : Fréquence à laquelle les prix des commerçants sont recalculés au hasard.

• Valeurs : -1.0 (pas de changements), 0.0–168.0+

• Défaut : -1.0

• Recommandation : 48.0–96.0 pour une rotation légère des prix

tradeable-rotation-time-ingame-hours-min

• Description : Nombre d'heures minimum en jeu avant que le marchand rafraîchisse son stock.

• Valeurs : 0,0–9999,0

• Par défaut : 48,0

• Recommandation : 48,0 (2 jours en jeu)

tradeable-rotation-time-ingame-hours-max

• Description : Nombre d'heures maximum en jeu avant la rotation.

• Valeurs : >= valeur min, 0,0–9999,0

• Par défaut : 96,0

• Recommandation : 96,0 (4 jours en jeu)

tradeable-rotation-time-of-day-min

• Description : Heure la plus tôt de la journée (heures en jeu, 0–24) pour la rotation des objets.

• Valeurs : 0.0–24.0

• Par défaut : 8.0

• Recommandation : 8.0 (matin)

tradeable-rotation-time-of-day-max

• Description : Heure la plus tardive de la journée (heures en jeu, 0–24) pour la rotation des objets.

• Valeurs : 0.0–24.0

• Par défaut : 16.0

• Recommandation : 16.0 (après-midi)

fully-restock-tradeable-hours

• Description : Temps (en heures) avant que le stock d’un objet soit totalement réapprovisionné.

• Valeurs : 0,1–9999,0

• Par défaut : 2,0

• Recommandation : 1,0–3,0 (dépend de la vitesse du serveur)

trader-funds-change-rate-per-hour-multiplier

• Description : Vitesse à laquelle les traders récupèrent leurs fonds.

• Valeurs : 0,0–10,0

• Par défaut : 1,0

• Recommandation : 1,0 (réaliste), >2,0 (recharge rapide)

prices-subject-to-player-count

• Description : Les prix varient selon le nombre de joueurs actifs.

• Valeurs : 0 (désactivé), 1 (activé)

• Par défaut : 0

• Recommandation : 0 pour la stabilité

gold-price-subject-to-global-multiplier

• Description : Les prix de l'or suivent le multiplicateur de l'économie globale.

• Valeurs : 0 ou 1

• Par défaut : 1

• Recommandation : 1 (comportement par défaut)

gold-base-price

• Description : Valeur de base d'une unité d'or.

• Valeurs : -1 (par défaut), 1–1 000 000

• Par défaut : -1

• Recommandation : À changer seulement si tu utilises une économie personnalisée.

gold-sale-price-modifier

• Description : Multiplicateur pour le prix de vente de l'or.

• Valeurs : -1.0 (par défaut), 0.0–10.0

• Défaut : -1.0

• Recommandation : 1.0 (taux standard)

gold-price-change-percentage-step

• Description : Changement de prix en pourcentage à chaque étape d'ajustement.

• Valeurs : -1.0 (par défaut), 0.0–100.0

• Défaut : -1.0

• Recommandation : 5.0–10.0 (fluctuation modérée)

gold-price-change-per-step

• Description : Changement de prix absolu par étape.

• Valeurs : -1.0 (par défaut), 0.0–10 000.0

• Par défaut : -1.0

• Recommandation : Utilise ça seulement si aucun changement en pourcentage n'est actif.

economy-logging

• Description : Active la journalisation pour toutes les actions de trade.

• Valeurs : 0 (désactivé), 1 (activé)

• Par défaut : 0

• Recommandation : 1 (debug & équilibrage)

traders-unlimited-funds

• Description : Les traders ont de l'argent illimité.

• Valeurs : 0 (normal), 1 (illimité)

• Par défaut : 0

• Recommandation : 0 (réaliste), 1 (serveur de test)

traders-unlimited-stock

• Description : Les marchands ont un stock illimité.

• Valeurs : 0 (normal), 1 (illimité)

• Par défaut : 0

• Recommandation : 0 (recommandé), 1 (serveur test)

tradeable-rotation-enabled

• Description : Active ou désactive la rotation des objets pour les marchands.

• Valeurs : 0 (désactivé), 1 (activé)

• Par défaut : 1

• Recommandation : 1 (plus de variété)

enable-fame-point-requirement

• Descriptiona: Active la nécessité de Points de Renommée pour certains achats.

• Valeursa: 0 (désactivé), 1 (activé)

• Défauta: 0

• Recommandationa: 1 (plus de progression)

=== Remplacements d’objets de commerçant ===

tradeable-code

• Descriptiona: Nom interne de l’objet (ID Blueprint, ex. "Weapon_AK47").

• Valeursa: Chaîne (ID objet correct)

• Recommandationa: Nom interne exact, sinon l’objet est invalide.

base-purchase-price

• Descriptiona: Prix de vente du commerçant (pour le joueur).

• Valeursa: -1 (défaut), ≥1

• Recommandationa: -1 (garde les valeurs par défaut)

base-sell-price

• Description : Prix d'achat du vendeur (ce que les joueurs reçoivent).

• Valeurs : -1 (par défaut), ≥0

• Recommandation : -1 (par défaut)

delta-price

• Description : Variation de prix (offre/demande).

• Valeurs : -1.0 (par défaut), 0.0–1.0 (0–100 %)

• Recommandation : 0.2 pour une variation de ±20 %

can-be-purchased

• Description : Si l'objet peut être vendu par le vendeur.

• Valeurs : "default", "true", "false"

• Recommandation : default (le serveur décide)

required-famepoints

• Description : Points de réputation minimum nécessaires pour acheter.

• Valeurs : -1 (ignorer), 0–10000+

• Suggestion : 0–2000 pour les objets de haut niveau

Note technique

• Toutes les valeurs numériques peuvent être écrites comme chaînes ("1.0") ou comme nombres (1.0).

• Les valeurs négatives (-1, -1.0) = valeurs du jeu par défaut.

• Si tu mets plus que 9999.0, le jeu peut ignorer ou réinitialiser la valeur.

• 0/1 sont lus comme Booleans, pas comme chaînes "true"/"false".

• Les clés inconnues sont juste ignorées, ça ne fait pas planter le jeu.

• Des temps de rotation trop courts (< 12h) ou de réassort (< 0.5h) peuvent rendre l’économie instable.

• Active le log (economy-logging = 1), quand tu testes ou modifies des valeurs.

• Fais valider ton fichier .json, par exemple avec https://jsonlint.com/