SoulWars Overview

Welcome to SoulWars

SoulWars is a battle royale game combining competitive gameplay with customizable themes and a comprehensive progression system. Players create Heroes, participate in epic battles, and compete for glory across multiple seasons.

Purpose

SoulWars is the world's first cross-platform interactive streaming game built to take advantage of the massive monetization capabilities of player ownership, tokenized gameplay, and audience mechanics.

It's meant to be played on game and variety streamers' screens any time, or even 24/7! It's a great way to play with your audience, distribute rewards, and have some fun.

Core Gameplay

Battle Royale Format

SoulWars features classic battle royale mechanics with a unique twist:

8-1000 players per match (configurable)
Multiple battlefield maps with different themes and layouts
Last-player-standing victory condition
Real-time combat with strategic positioning
Dynamic battlefield that evolves as players are eliminated

Game Modes

Standard Battle: Classic battle royale experience
Custom Matches: Player-configured battles with specific settings
Seasonal Events: Special competitions with unique rewards
Tournament Mode: Competitive matches with rankings (coming soon)

Combat System

Real-time action: Immediate response to player actions
Strategic positioning: Use battlefield terrain to your advantage
Resource management: Collect food, weapons, and items
AI-driven opponents: Sophisticated AI provides challenging gameplay

Hero System

Creating Your Hero

Every player starts by creating their first Hero - a customizable battle avatar that grows stronger over time:

Unique naming: Choose a distinctive name for your Hero
Base attributes: All Heroes start with 10 points in each of six core attributes
Hero Frequency: Control how often your Hero is selected for battles
Progression: Heroes earn XP and level up through battle participation

Core Attributes

Your Hero's performance is determined by six key attributes:

Attribute

Effect

Best For

Strength

Melee damage, health bonus

Warriors, damage dealers

Endurance

Maximum health, stamina, armor requirements

Tanks, survivability builds

Coordination

Defense, ranged accuracy

Rangers, defensive fighters

Quickness

Movement speed, attack speed

Fast, aggressive fighters

Focus

Mana, magic damage (coming soon)

Future spellcasters

Self

Mana, magic defense (coming soon)

Magic-resistant builds

Equipment System

Enhance your Hero's combat effectiveness with weapons and armor:

Weapons

Melee Weapons: Swords, daggers, axes with different damage/speed profiles
Ranged Weapons: Bows and crossbows requiring ammunition
Requirements: Each weapon has minimum attribute requirements

Armor

Protection: Reduces incoming damage
Speed Trade-offs: Heavier armor slows movement
Multiple Slots: Head, chest, and leg armor pieces

AI Strategy Configuration

Customize how your Hero behaves in battle with five strategy sliders:

Combat Style (0-100): How aggressively your Hero engages in combat
Resource Priority (0-100): Balance between survival and resource collection
Battle Position (0-100): Preference for center vs. edge positioning
Combat Range (0-100): Preference for melee vs. ranged combat
Item Usage (0-100): How frequently to use consumable items

Hero Frequency System

Control how often your Heroes are selected for battles:

Never (Red): Hero will never be selected for battles
Seldom (Orange): Low priority - Hero is rarely selected
Often (Yellow): Default setting - Normal selection frequency
Frequent (Green): High priority - Hero is frequently selected

Battle Experience

Pre-Battle Setup

Before each battle, you can:

Configure Settings: Adjust player count, selection mode, and theme
Join via Chat: Type "join" or "play" in chat to enter the battle
Automatic Selection: Heroes can be automatically chosen based on frequency settings

During Battle

Experience intense real-time combat with:

Dynamic Combat: Your Hero's attributes directly affect performance
Strategic Positioning: Use battlefield terrain and positioning
Resource Gathering: Collect food, weapons, and items
Elimination System: Last player standing wins

Gameplay Mechanics

Loot and Item System

Loot Drops: Items spawn randomly across the battlefield
Item Types: Weapons, armor, potions, and consumables
Rarity System: Common, Uncommon, Rare, Epic, Legendary, and Unique items
Death Drops: Players drop inventory items when eliminated (25% chance per item)
Performance Rewards: Better performance increases loot chances and quality

Food and Healing

Food Spawns: Healing items appear throughout the battlefield
Health Management: Collect food to restore health during battle
Consumable Items: Use potions and healing items strategically
Item Effects: Various items provide temporary boosts (strength, speed, etc.)

Chat Commands

Players can use chat commands to influence gameplay:

Battle Commands:

join     or play   - Join the current battle
heal                 - Seek healing items and instant heal (60s cooldown)
attack  or a         - Prioritize attacking enemies
rage                 - Consume rage point for 5 seconds of fast attacks
run     or r         - Run away from enemies temporarily

Social Commands:

hi      or hello  - Wave emote (👋)
love    or heart  - Heart emote (❤️)
skull             - Skull emote (💀)
blood             - Blood emote (🩸)
show              - Highlight your player with yellow glow

Game Modes:

Free-for-All: Classic battle royale (everyone vs everyone)
Team vs Team: Organized team battles
Squad Battle: Small team battles (2v2, 3v3, 4v4, 5v5)
PvE Mode: Players vs AI enemies (coming soon)

Post-Battle Rewards

After each battle, enjoy spectacular reward animations showing:

XP Earned: Experience points based on performance
Level Ups: Dramatic level-up celebrations
Loot Items: Equipment and items found during battle
Special Finds: Rare discoveries with unique announcements

XP and Progression

Earn experience through:

Base Participation: 500 XP for joining a battle
Eliminations: 200 XP per enemy defeated
Placement Bonus: 1,000-15,000 XP based on final ranking
Token Holder Bonus: 1.5x XP multiplier for SOULWARS token holders

Customization & Themes

Theme System

SoulWars features a comprehensive theme system that allows complete visual customization.

Available Themes

Default Theme: Always accessible, classic SoulWars aesthetic
Custom Themes: Community-created themes with unique art and music
Premium Themes: Special themes available through entitlements

Theme Components

Each theme includes:

Battlefield Maps: Custom battle environments
Player Sprites: Unique character appearances
Music Tracks: Themed background music
UI Elements: Custom interface styling
Intermission Screens: Story and information displays

Theme Creator Tool

For content creators, SoulWars provides a powerful Theme Creator.

Asset Requirements

Cover Images: 2:1 aspect ratio promotional images
Battlefield Maps: Square maps (1024x1024px minimum)
Player Images: Square PNG sprites with transparency
Music Tracks: MP3 files up to 10MB
Screen Images: Square images for intermissions

Advanced Features

Player Classes: Organize characters by type (Warrior, Mage, etc.)
Taunt System: Add personality with character-specific dialogue
Intermission Screens: Create narrative moments between battle phases
Trigger Conditions: Control when screens appear based on game state

Taunt System

Add personality to battles with the chat bubble taunt system.

Taunt Types

Event-Specific: Taunts triggered by combat actions, eliminations, item pickups
Generic Taunts: General personality expressions
Visual Design: Comic-style speech bubbles with black borders

Taunt Events

Combat: Attack, hit, hurt, killed, death
Behavior: Threaten, seek food, flee, collect items
Timing: 2.5-second display duration with cooldown system

Progression & Rewards

Seasonal Competition

Heroes compete in quarterly seasons with:

Seasonal Leaderboards: Rankings based on XP earned during the season
All-Time Leaderboards: Lifetime achievements across all seasons
Fresh Competition: Each season provides new opportunities

Reward Distribution

Experience spectacular reward animations featuring:

XP Count-up: Smooth counting animation showing earned experience
Level Up Celebrations: Dramatic "LEVEL UP!" announcements
Loot Reveals: Color-coded items by rarity (Common to Unique)
Special Discoveries: Unique item announcements with special effects

Attribute Progression

Spend XP to improve your Hero's attributes:

Cost Scaling: 1,000-25,000 XP per point depending on current level
Strategic Planning: Choose between specialization and balanced builds
Permanent Investment: Attributes cannot be reset (plan carefully!)

Community Features

Chat and Communication

Stay connected with other players:

Real-time Chat: Communicate during battles and waiting areas
Marquee System: Scrolling notifications for important events
Join Confirmations: Visual feedback for player actions

Marquee Notifications

Stay informed with the scrolling notification system:

Join Events: See when players join or leave battles
Game Updates: Important battle state changes
System Messages: Tips, warnings, and announcements
Color Coding: Different colors for different message types

Getting Started

First Steps

Connect your wallet, create a Hero, and join your first match.

Connect Wallet: Link your Solana wallet to access the game
Create Hero: Design your first battle avatar
Set Frequency: Choose how often your Hero participates in battles
Join Battle: Type "join" in chat to enter your first match
Customize Strategy: Adjust your Hero's AI behavior
Explore Themes: Try different visual themes

Account Setup

Wallet Connection: Required for blockchain integration
Entitlements: Access to features based on permissions
Profile Management: Customize your player profile

Learning Resources

In-Game Tutorials: Built-in guidance for new players
Community Discord: Connect with other players for tips
Documentation: Comprehensive guides for all systems

Advanced Features

Entitlements System

Control access to premium features:

Game Access: Core gameplay permissions
Theme Creator: Access to content creation tools
Premium Themes: Special theme access
Admin Tools: Administrative capabilities

Battle Simulator

Test and debug battle scenarios:

Custom Configurations: Set up specific battle conditions
Performance Testing: Analyze battle mechanics
Reward Testing: Verify reward calculations

Account Linking

Connect multiple accounts:

Wallet Integration: Link Solana wallets
Cross-Platform: Access from different devices
Data Synchronization: Maintain progress across platforms

Support & Resources

Documentation

Comprehensive guides available for:

Hero System: Complete attribute and progression guide
Theme Creator: Asset requirements and creation process
Entitlements: Access management and permissions
Army System: Community integration setup
Rewards System: Understanding progression and rewards

Community Support

Discord Community: Real-time help and discussion
Developer Support: Technical assistance for advanced features
Bug Reports: Report issues and request features

Best Practices

Hero Building: Focus on 2-3 core attributes for effectiveness
Theme Creation: Maintain consistent art style and optimize assets
Battle Strategy: Balance aggression with survival tactics
Community Engagement: Participate in seasonal competitions

Future Roadmap

Planned features include:

Multiple Heroes: Create and manage multiple battle avatars
Skill Trees: Specialized progression paths
Guild System: Team-based competitions
Advanced Equipment: More weapons, armor, and items
Audio Taunts: Voice-based character personality
Tournament Mode: Competitive ranked play

Welcome to SoulWars — where Heroes are forged, battles are legendary, and every victory tells a story. Join the battle today and begin your journey to greatness!

NextProject Roadmap

Last updated 1 hour ago