The structure of this project

This project is in two parts mainly

• Unity game and CosmicAPI (this repo) - https://github.com/LagomInteractive/outlaws
• Server and website - https://github.com/LagomInteractive/cosmic-server
• Outdated, but with old Git history CosmicAPI - https://github.com/LagomInteractive/CosmicAPI

This is an overview of the structure of this project

This flowchart shows a basic view of how a game can look.

CosmicAPI class diagram

Code

• CosmicAPI.cs - Is the main part of this project. It handles the communcation between the server and the game. It's structured like an API with all events and functions needed to play. It's a big file but it's suppoesed to be independent and work by itself.

• WorldCard.cs - This script creates and acts for all cards in the game. Units, Hand cards, Deck builder, Credits

• MenuSystem.cs - This is our navigation system for our menus, it works great!

• EffectsManager.cs - EffectsManager manages effects, VFX and SFX, often combined. It's a great way to pair our particle effects and sound effects.

• Battlefield.cs - Handles all the units on the battlefield, adds them and removes then when needed.

• AttackLine.cs - The AttackLine is the red arrow that you use to attack, cast and sacrifice with.

• HandPlacement.cs - Handles the cards in the hand

Dependencies

All dependencies are using upm and will automatically imported with a setup project.

• NativeWebSocket - For the socket connection to the server
• Newtonsoft - For parsing and packing data over the sockets (JSON)

Github Issues

We used Github's bug and feature tracking system Issues At this link you can see some of the bigger bugs that we have SQUASHED! https://github.com/LagomInteractive/outlaws/issues?q=is%3Aissue+is%3Aclosed

Card creation and balancing

We have custom, internal tools for our designers to create, test and balance cards for the game. This is done via the Outlaws website.

Every part of every card is created and can be tweaked on here. Card stats, events and functions are loaded from the server to the game client and always up to date with the server.

This allows us to tweak and balance the game while people are playing it without issuing a new game build. The card images are downloaded via a script and included in the game build.

There are three types of cards: Minion, Target Spell & AOE (Area Of Effect) Spell

Minion or Unit as they are referred to in-game (for legal reasons) can be spawned to the battlefield. They have a mana cost as all cards, damage and health. Minions have a lot more events since they persists in the game for longer. Efter round after their spawn, they can attack once. If they have a onPlayedTarget event they will be able to use it immediately when they spawn.

All cards can any element: Lunar, Solar, Zenith, Nova. Some cards are Neutral, Neutral with Rush or Neutral with Taunt. If the card is not neutral it will give you a buff in a certain way depending on it's element upon being sacrificed.

If a unit with Taunt is present, the enemy can only attack the units with taunt.

If a unit has Rush they can attack immediately on being spawned.

Spells The spells do note have damage or HP, and they are only played once, then they disappear. AOE spells are played like a minion but only run their functions. The Target spell acts like an attack when played and can be used to target any minion or player on the battlefield.

Card events

Every card can have events, that can be triggered throughout a game. Events can later be filled with functions that take one integer parameter.

Event	Description	Allowes Target function
onPlayed	When a unit is spawned	Depends
everyRound	Every round a unit is alive for	Depends
onDeath	When a unit dies	Depends
onAttacked	When a unit takes any damage	Depends
onPlayedTarget	When a unit is played, this will allow it one target play	Yes
action	When a spell is played (Can use target functions if card is of type Target Spell)	Depends

Card Functions

Functions can be devided into targeted and non-targered. Targeted functions need a target to work, they can only be placed in a onPlayedTarget (minion) or a Target Spell.

Function	Description	Value	Target
damageTarget	Deals damage to the target	Damage amount	Yes
damageRandomAlly	Deals damage to a random friendly (unit or player)	Damage amount	No
damageEveryOpponent	Deals damage to every opponent (unit and player)	Damage amount	No
spawnMinion	Spawns a friendly minion (no cards used from deck)	Minion card ID	No
gainMana	Gives player more mana (cannot exceed max mana)	Mana amount	No
drawAmountCards	Draws cards from deck	Amount of cards	No
drawCard	Draws a card (not from deck)	Card ID	No
damageTargetUnit	Deals damage to target (can only be a unit)	Damage amount	Yes
damageOpponent	Deals damage to the opponent player	Damage amount	No
damageRandomOpponent	Deals damage to random opponent (unit or player)	Damage amount	No
damageRandomEnemyUnit	Deals damage to random enemy unit (not player)	Damage amount	No
damageRandomAllyUnit	Deals damage to random friendly unit (not player)	Damage amount	No
healTarget	Heals the target (respects max HP)	Health amount	Yes
healEveryAlly	Heals every friendly (unit and player)	Health amount	No
healRandomAlly	Heals a reandom friendly (unit or player)	Health amount	No
healPlayer	Heals the player (friendly, respects max HP)	Heal amount	No
changeTargetAttack	Changes the target attack value (Only unit)	Attack change+-	Yes
changeTargetMaxHp	Buffs or nerfs the targets max HP	Health amount+-	Yes
changeAllyUnitsMaxHp	Changes (not heals) the max HP for all allies units	MaxHP +-	No
damageAllUnits	Deals damage to all units on the battlefield	Damage amount	No
damageRandomUnit	Deals damage to random Unit (any team)	Damage amount	No
changeAlliesMaxHp	NEEDS DOCUMENTATION	Health amount	No
damageRandomAnything	Damange any player or unit on the board	Damage amount	No

XP System

Every time a user levels up, they get 1x "All pack" that when opened gives the user 5 random cards. When the user levels up depends on how much experience points (XP) they gain. This amount is calculated like this:

XP Rewards

Action	XP Reward
Win a game	500
Round played	5
Kill a unit	30
Gain sacrifice buff	100
Achive passive reward	25

Level ladder

Level	XP needed to level up
1	100
2	250
3	500
4	750
5+	1000