Anything can be an svg if you try hard enough.
# WarpFlow - Space Combat Tactics Game
WarpFlow is a blockchain-based strategic space combat game where players command fleets of customizable ships in tactical battles across carefully designed maps. Built on Flow blockchain, the game combines real-time strategy with NFT ship ownership and turn-based combat mechanics. The entire frontend has been vibe-coded for maximum development velocity and creative flow.
## Game Overview
### Core Gameplay
- Fleet Management: Build and customize fleets of unique ships with different weapons, armor, shields, and special abilities
- Strategic Combat: Engage in turn-based tactical battles on grid-based maps with various terrain types
- Ship Customization: Each ship has unique traits (accuracy, hull strength, speed) and equipment configurations
- Map Variety: Battle across carefully designed maps with nebula clouds, scoring positions, and strategic obstacles
- Real-time Events: Watch battles unfold with live event tracking and ship movement animations
### Ship Types & Equipment
- Ship Variety: Diverse ship classes with unique base stats and equipment slots
- Leveling System: Ships gain experience and level up through combat, improving their core attributes
- Equipment Combinations: Mix and match weapons, armor, shields, and special abilities to create specialized builds
- Main Weapons: Various weapon types with different damage, range, and accuracy characteristics
- Armor Systems: Defensive equipment that reduces incoming damage with different protection types
- Shield Generators: Energy-based protection systems with varying strength and recharge rates
- Special Abilities:
- EMP: Disables enemy systems and disrupts operations
- Repair: Heals friendly ships and restores hull integrity
- Flak: Area-of-effect anti-aircraft weaponry for crowd control
- Ship Traits: Accuracy, Hull Strength, and Speed determine combat effectiveness and can be enhanced through leveling
- Build Diversity: Create specialized fleets with tank ships, glass cannons, support vessels, and hybrid combinations
### Game Mechanics
- Turn-Based Combat: Players alternate turns, moving ships and executing actions
- Line of Sight: Ships must have clear line of sight to target enemies (except for special abilities)
- Damage Calculation: Complex damage system with armor reduction
- Movement System: Ships can move and act in the same turn
- Threat Allocation: Build fleets within threat limits - powerful ships cost more threat, allowing fewer ships, while cheaper ships cost less threat but are less capable
- Ship Experience: Ships gain experience by destroying enemy ships, becoming more powerful without increasing their threat cost
- Ship Destruction: NFT ships can be permanently destroyed in combat, forcing players to choose between tactical objectives and ship preservation
- Risk vs Reward: Players must decide whether to sacrifice valuable ships to achieve victory or protect their fleet at the cost of tactical advantage
- Scoring System: Control strategic positions to earn victory points
- Fleet Deployment: Pre-battle ship positioning and formation planning
### Blockchain Integration
- NFT Ships: Each ship is a unique NFT with procedurally generated attributes
- Marketplace Trading: Search and acquire ships on NFT marketplaces like OpenSea to find the perfect ships for your fleet
- On-Chain Game State: All game data stored on Flow blockchain for transparency
- Real-Time Updates: Live event streaming from blockchain transactions
- Fleet Management: Create and manage fleets of your NFT ships
### Technical Features
- Real-Time UI: Live updates during battles with smooth animations
- Image Caching: Optimized ship image loading and caching system
- Event Tracking: Comprehensive game event logging and display
- Audio Integration: Immersive sound effects and background music
Summary of Work Since October 1, 2025 20 commits from October 2025. Major features Assist feature (latest) Fixed assist UI/UX with blue "Assist:" labels Target panel buttons (blue assist, red enemy) Submit button shows "(Move + Assist)" or "(Assist Only)" Clickable ship names in the details panel Distance-based assist (adjacent only) Fleet selection and placement Fleet placement on the map Position selection UI Visual confirmation of ship placement Fleet management updates Game events and history Real-time event tracking Historical event fetching Event formatting with ship names Timeline display Fixes and improvements Loading and image bugs Fixed flash of loading on ship movement Image caching with retries Performance tuning Transaction button states Clear pending state after transactions Free ship claiming disabled state handling Audio and sounds Turn notification (alert.mp3) Background music Immersive sound effects Build and linting Fixed build errors Linting cleanup ESLint rule compliance HTML entity escaping File changes GameDisplay.tsx: +1,158 additions, main gameplay logic Lobbies.tsx: Major fleet selection rework ShipAttributes.tsx: Ship attribute display and management MapDisplay.tsx: Map rendering and interaction GameEvents.tsx: Added event logging Various hooks: Updates for image caching and attributes Contracts: Updated to match latest smart contracts Key patterns Vibe-coded frontend Blue theme for friendly/support actions Red theme for enemy/attack actions Consistent UI/UX patterns Performance-focused image caching Summary of Work Since October 1, 2025 October 17, 2025 - Latest Bugfix and Redeploy Fixed FlakArray arithmetic overflow in Game.sol Updated test expectations in Game.test.ts Redeployed contracts with bug fixes Updated README.md with warning about active development October 16, 2025 - Updates and Deployment Added healthcheck script (scripts/healthcheck.ts) for post-deployment verification Updated ShipAttributes.sol with attribute improvements Redeployed contracts with latest changes Updated README.md October 15, 2025 - Fix Attributes Bugs Major refactor of ShipAttributes.sol (154 lines changed) Updated IShipAttributes.sol interface (39 lines changed) Fixed attribute calculation bugs Updated Types.sol with new structures Comprehensive test updates in Game.test.ts and Ships.test.ts (292 lines changed) Massive deployment update (82 files changed, 794 insertions, 803 deletions) October 11, 2025 - Updates General updates and improvements October 9, 2025 - Deployment Choices Merged PR #8: Added deployment choices Updated deployment configuration to custom settings Improved deployment flexibility October 8, 2025 - Map Size Change Changed map dimensions (likely from 30x20 to 25x13 based on our current work) Updated grid-related logic October 7, 2025 - Major System Improvements Merged PR #7: Combined costs and traits system Improved Attributes system with better organization Updated README.md with documentation October 6, 2025 - Economic and Bug Fixes Added 1/4 recycle fee to ship destroyer (economic incentive) Fixed FlakArray bugs Added ERC-5192 support (NFT locking standard) October 4, 2025 - Code Quality Improvements Fixed failing tests Refactored for contract size optimization Added better events for moves (but was too big, likely reverted)
Not ready to fundraise, but willing to have conversations