docs: update game documentation with technical context #205
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add unique game approach section highlighting FastLane tech demo - Add technical context explaining Gas Abstraction and RPC policy - Fix ability cooldowns to match smart contract values - Update status effects for accuracy - Remove fixed Phantom wallet issue from known problems 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Deploying battle-nads-frontend with
|
| Latest commit: |
1c14ebf
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://f66d242e.battle-nads-frontend.pages.dev |
| Branch Preview URL: | https://docs-update-game-docs.battle-nads-frontend.pages.dev |
- Drastically simplified PvP manual (400+ lines to 49 lines) - Removed elaborate checklists and esports-like content - Simplified equipment and economy guides - Updated all guides to emphasize blockchain tech demonstration - Removed competitive gaming language and meta analysis - Focused on explaining how the tech works rather than min-maxing 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Added explanation that combat/abilities run automatically via Task Manager - Clarified session keys sponsor all game actions (movement, combat, abilities) - Explained no transaction spam needed - just initiate combat once - Added notes about UI indicating when tasks fail due to low balance - Updated troubleshooting for session key balance issues 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Removed maintenance and writing style sections from game README - Added documentation maintenance guidelines to CLAUDE.md - Added writing style guide emphasizing tech demo nature - Cleaned up game README to focus on player resources 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Removed references to interactive tutorials, calculators, and combat simulator - These features don't exist in the current implementation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Class selection is random, not player choice - Session keys are automatically created with Privy wallets - Clarified manual session key setup only needed for non-Privy wallets 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
0x1NotMe
force-pushed
the
docs/update-game-docs
branch
from
e86379c to
a897309
Compare
- Explained Privy creates managed wallet (session key) from external wallets - Added flow diagrams for wallet setup and transaction execution - Clarified one-click character creation handles all deposits and funding - Added Combat & Ability demonstration sections - Fixed block times (0.5 seconds, not minutes) - Detailed how shMON funds tasks and gas refunds work 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Players only have 14 stat points to allocate, not 32 - Updated Quick Start, Player Guide, and FAQ - The total 32 likely includes base stats that aren't player-allocated 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
…vention - 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>
- Converted wallet/session key flow to flowchart - Added sequence diagram for transaction flow - Converted combat automation to flowchart with loop - Added multi-stage ability flowchart with interruption - Added economic flow diagram for shMON distribution 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Depth 1→2: (25, 25) - Always at center - Depth 2→3: (35, 15) - Southeast quadrant - Depth 3→4: (15, 35) - Northwest quadrant - Depth 4→5: (14, 14) - Southwest quadrant Updates player-guide.md with correct staircase coordinates as requested. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
…gation - Add stat allocation recommendations for each class: - Warrior: STR/VIT focus (4/3) - Rogue: DEX/QCK focus (4/3) - Monk: Balanced with STU/LCK emphasis (3/3) - Sorcerer: Magic-focused build - Bard: Balanced to offset penalties - Remove stair location derivation formula - Keep only first 4 stair locations with exploration hint - Clarify that discovering the pattern is part of the challenge 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Replace duplicate sections with cross-references: - Character creation → Quick Start Guide - Equipment details → Equipment Guide - Economic details → Economy Guide - Troubleshooting → FAQ Guide - Combat mechanics → Combat Analysis Guide - Update aggro system with correct slot-based mechanics: - Each area has 64 slots (0-63) - Aggro range = number of slots checked - Bosses check all 64 slots (guaranteed aggro) - Multiple entities can occupy same coordinates - Add clear examples of how slot-based aggro works - Improve navigation strategies with slot awareness This reduces documentation duplication while maintaining comprehensive coverage through cross-references, and accurately documents the slot-based aggro system. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Clarify offensive vs non-offensive abilities: - Offensive: Shield Bash, Apply Poison, Smite, Fireball, Do Dance - Non-offensive: Shield Wall, Evasive Maneuvers, Pray, Charge Up, Sing Song - Explain that offensive abilities auto-initiate combat - Add detailed status effect modifiers: - Blocking: 75% damage reduction (Warrior) or 67% (others) - Evading: Increased dodge chance - Charged Up: +50% damage + 10 flat - Praying: -33% damage while healing - Add ability cooldowns for all classes - Explain why players might not see immediate damage: - Windup stages on most offensive abilities - Task delays between stages - Non-offensive abilities never deal damage - Update combat flow to show how abilities modify regular attacks This helps players understand the tactical importance of ability timing and why some abilities don't show immediate damage effects. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Update Bard abilities to reflect they currently do nothing - Remove Do Dance from offensive abilities list - Move both Bard abilities to 'No Effect' category - Clarify Bard is challenge mode with stat penalties only 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Replace detailed combat formulas with player-friendly overview - Keep only essential concepts (turn order, hit chance, damage factors) - Add reference to Combat Analysis Guide for detailed mechanics - Simplify staircase movement explanation - Remove unnecessary technical details from player guide Players can refer to the Combat Analysis Guide or read the code for detailed formulas and calculations. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Replace Solidity code snippets with player-friendly summaries - Remove function implementations and technical details - Keep practical information about how stats affect gameplay - Simplify explanations to focus on what players need to know Players interested in technical implementation can read the smart contracts directly. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
SalixDev
approved these changes
Jul 15, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Changes Made
New Sections Added
Unique Game Approach - Explains how Battle Nads demonstrates:
Technical Context - Details:
Fixes and Updates
Test Plan
🤖 Generated with Claude Code