Guide for custom scripting in platformer.md

🎲 Limbo Settings Configuration Guide

For limbo-settings.json in SendTips.js
Last updated: January 2026

This document explains every supported field, action, condition, and value format usable in your limbo-settings.json strategy profiles — including recently added dynamic bet/target rules, maxTarget limits, switchStrategyIndex fallbacks, USD/% parsing, and condition triggers.

---

🔧 Top-Level Structure

{
  "activeProfileIndex": 0,
  "profiles": [ /* array of profile objects */ ]
}

• activeProfileIndex: Integer. Index of the profile to use by default.
• profiles: Array of strategy profile objects (see below).

---

📁 Profile Object

Each profile has two top-level keys:

{
  "name": "My Strategy",
  "strategy": { /* strategy config */ }
}

• name: Human-readable name (for UI only).
• strategy: The actual betting logic configuration.

---

⚙️ Strategy Configuration (strategy)

✅ Core Fields

Field	Type	Description
enabled	boolean	If false, uses static CLI input instead of dynamic strategy.
baseBet	string	Starting bet amount. Supports: "0.01", "1 USD", "2.5%"
maxBetSize	string	Max allowed bet. Same formats as baseBet.
maxBetAction	"stop" or "reset"	What to do when maxBetSize is exceeded. Default: "stop".
maxTarget	number (optional)	Hard ceiling for target multiplier. If a rule tries to set target above this, it resets to baseTarget.

💡 USD & % Support

• "1 USD" → auto-converts to selected currency using live price once per session.
• "2.5%" → uses 2.5% of current balance in that currency (recalculated before each bet).

---

🎯 Target Modes

Field	Type	Options / Notes
targetMode	string	"static", "random_range", "array_random"
staticTarget	string	e.g., "3.5"
randomTargetRange	object	{ "min": 2.0, "max": 10.0 }
targetArray	array	[2.0, 5.0, 10.0, 50.0]

Only one mode is active at a time based on targetMode.
If onWinTarget/onLossTarget rules are defined, they override the mode unless the rule fails its condition.

---

📈 Stop Conditions

Field	Type	Examples
stopOnProfit	string	"5", "10%", "25 USD"
stopOnLoss	string	"3", "15%", "10 USD"
switchStrategyIndex	array of integers	[1, 2, 3] — indexes of fallback profiles

• If stop condition is met and switchStrategyIndex is non-empty → randomly switch to one of the listed profiles.
• If empty → session stops.
• USD-based stop conditions use the same session-wide price fetched at start.

---

🔄 Bet Adjustment Rules

Both onWin and onLoss support identical structure:

"onWin": {
  "action": "...",
  "value": ...,
  "condition": "..."
}

✅ Supported Actions

Action	Description	value Format
"return_to_base"	Reset bet to baseBet	—
"increase_percent"	Multiply current/base bet by (1 + value/100)	number (e.g., 10)
"add_static_amount_to_base_bet"	baseBet += value	"0.5", "1 USD"
"add_static_amount_to_current_bet"	currentBet += value	same
"sub_static_amount_from_base_bet"	baseBet -= value	same
"sub_static_amount_from_current_bet"	currentBet -= value	same

All arithmetic results are clamped to ≥ 0.

---

🎯 Target Adjustment Rules

onWinTarget and onLossTarget follow the same pattern:

"onWinTarget": {
  "action": "...",
  "value": ...,
  "condition": "..."
}

✅ Supported Actions

Action	Description	value Format
"return_to_base"	Reset target to original (static/array/range base)	—
"increase_percent"	Multiply target by (1 + value/100)	number (e.g., 20)
"add_static_amount_to_base_target"	baseTarget += value	number (e.g., 5)
"add_static_amount_to_current_target"	currentTarget += value	same
"sub_static_amount_from_base_target"	baseTarget -= value	same
"sub_static_amount_from_current_target"	currentTarget -= value	same

Targets are clamped to ≥ 1.01.
If maxTarget is set and a rule produces a target > maxTarget, it resets to baseTarget and logs a warning.

---

📊 Condition Syntax

Used in condition field for both bet and target rules.

Format:

• "after_N_wins" → triggers once when total wins ≥ N
• "after_N_lose" → triggers once when total losses ≥ N
• "after_each_N_wins" → triggers every Nth win (4, 8, 12...)
• "after_each_N_lose" → triggers every Nth loss (7, 14, 21...)

Replace N with an integer (e.g., "after_3_wins").
If condition is omitted or null, rule applies every time.
Counts are cumulative across the entire session.

---

🧪 Example Full Profile (with new features)

{
  "name": "Aggressive Recovery TEST",
  "strategy": {
    "enabled": true,
    "baseBet": "0.001 USD",
    "maxBetSize": "0.1 USD",
    "maxBetAction": "reset",
    "maxTarget": 400,
    "stopOnProfit": "10 USD",
    "stopOnLoss": "7 USD",
    "switchStrategyIndex": [],

    "targetMode": "static",
    "staticTarget": "40",
    "randomTargetRange": { "min": 1.5, "max": 5.0 },
    "targetArray": [200, 75, 50, 100],

    "onWin": {
      "action": "add_static_amount_to_current_bet",
      "value": "0.005 USD",
      "condition": "after_each_1_wins"
    },
    "onLoss": {
      "action": "increase_percent",
      "value": 0
    },

    "onWinTarget": {
      "action": "return_to_base",
      "condition": "after_1_wins"
    },
    "onLossTarget": {
      "action": "add_static_amount_to_current_target",
      "value": 4,
      "condition": "after_each_4_lose"
    }
  }
}

---