Skip to content

Commit 0dbfb3c

Browse files
0x1NotMeclaude
andcommitted
docs: clarify bonded shMON is for auto-defense, not just deletion prevention
- Bonded shMON enables auto-defense when attacked by other players - Without it, character cannot defend itself when offline - Updated all references to use "bonded shMON" consistently - Added Auto-Defense Mechanism section to economy guide - Fixed misconception that it's just to prevent deletion 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 59c16a3 commit 0dbfb3c

File tree

3 files changed

+22
-13
lines changed

3 files changed

+22
-13
lines changed

docs/game/game-economy-guide.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,17 @@ Battle Nads uses **shMON** (staked MON) to demonstrate a functional blockchain g
88

99
- **shMON** = Staked MON locked in the game
1010
- **Character Balance**: Earned by defeating enemies, lost on death
11-
- **Bonded Balance**: Minimum 0.05 shMON required for gameplay
11+
- **Bonded Balance**: Minimum 0.05 shMON required for auto-defense
1212
- **Yield Distribution**: 25% of defeated player balances boost yield for all holders
1313

14+
### Auto-Defense Mechanism
15+
16+
Your bonded shMON enables automatic defense when attacked:
17+
- Other players can attack you even when offline
18+
- Your character automatically defends using bonded shMON
19+
- Without sufficient bonded shMON, you cannot defend yourself
20+
- Keep bonded shMON funded to protect your earned character balance
21+
1422
### Cost Structure
1523

1624
**Starting Costs**

docs/game/player-guide.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Battle Nads uses a sophisticated economic model based on shMON (staked MON) toke
9797
#### Key Economic Concepts
9898

9999
- **Buy-in Amount**: 0.1 shMON required to create a character
100-
- **Bonded Balance**: Minimum 0.05 shMON must stay bonded for task execution
100+
- **Bonded Balance**: Minimum 0.05 shMON required for auto-defense when attacked
101101
- **Yield Boosting**: 25% of defeated player balances boost yield for all holders
102102
- **Balance Distribution**: 75% to players, 20% to monsters, 5% system fees
103103

@@ -395,7 +395,7 @@ Gameplay Actions via Session Key:
395395
When you initiate an action (movement, combat, ability):
396396

397397
1. **Session key sponsors the transaction** - No wallet popup
398-
2. **shMON is deducted** from your bonded balance for Task scheduling
398+
2. **shMON is deducted** from your bonded shMON for Task scheduling
399399
3. **Gas is partially refunded** to session key (efficient gas usage)
400400
4. **Task Manager executes** the action through execution services
401401
5. **Unused gas is redirected** through paymaster contracts
@@ -468,7 +468,7 @@ Battle Nads uses a sophisticated task system for autonomous character operation:
468468

469469
#### Task Economics
470470

471-
- **Task Costs**: Each task execution costs MON from your bonded balance
471+
- **Task Costs**: Each task execution costs MON from your bonded shMON
472472
- **Scheduling**: Tasks are scheduled for future block execution
473473
- **Priority**: Task execution follows priority and gas availability
474474
- **Failure Handling**: Failed tasks may be rescheduled or cancelled
@@ -486,7 +486,7 @@ Session key sends transaction (gas paid)
486486
487487
Task Manager creates combat task
488488
489-
shMON deducted from bonded balance
489+
shMON deducted from bonded shMON
490490
491491
Combat task executes every turn:
492492
• Calculate damage
@@ -519,15 +519,16 @@ Each stage is a separate task execution, demonstrating:
519519

520520
Players need to understand task implications:
521521

522-
#### Bonded Balance Requirements
522+
#### Bonded shMON Requirements
523523

524-
- Characters need sufficient bonded MON to maintain task schedule
525-
- Low balance characters risk task cancellation and character deletion
526-
- Recommended balance: Minimum 0.05 shMON + 32x estimated task costs
524+
- Characters need sufficient bonded shMON for auto-defense
525+
- Without bonded shMON, your character cannot defend when attacked
526+
- Low bonded shMON = defenseless character that others can freely attack
527+
- Recommended: Keep well above 0.05 shMON for continuous protection
527528

528529
#### Task Monitoring
529530

530-
1. **Balance Tracking**: Monitor your bonded balance regularly
531+
1. **Balance Tracking**: Monitor your bonded shMON regularly
531532
2. **Task Costs**: Understand approximate costs for different actions
532533
3. **Failure Recovery**: Know how to handle task scheduling failures
533534
4. **Emergency Funding**: Have backup MON available for emergency funding
@@ -666,9 +667,9 @@ As an early alpha product:
666667
#### Gameplay Issues
667668

668669
- **Movement Restrictions**: Cannot move while in combat
669-
- **Task Failures**: Check bonded balance and session key balance
670+
- **Task Failures**: Check bonded shMON and session key balance
670671
- **Combat Delays**: Combat actions are automated, expect delays
671-
- **Balance Depletion**: Monitor bonded balance to prevent character deletion
672+
- **Balance Depletion**: Keep bonded shMON funded for auto-defense
672673
- **Combat Task Broken**: UI will indicate - refund session key or bonded balance
673674
- **No Transaction Spam Needed**: Combat runs automatically via Task Manager
674675

docs/game/quick-start-guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ You need approximately **0.15 MON** to start:
6868

6969
### Economic Management
7070
- **Death = loss of all balance** to the victor
71-
- Keep minimum **0.05 MON bonded** to prevent character deletion
71+
- Keep minimum **0.05 MON bonded** for auto-defense when attacked
7272
- Each action costs small amount of gas/MON
7373
- **Balance vs Risk** - don't risk more than you can afford to lose
7474

0 commit comments

Comments
 (0)