Creating Your Custom Boss

Welcome to the custom boss creation guide! Follow the steps below to create your own boss, customize attacks, set up dialogs, and more.

This page aims to help you create your own custom boss for Battletale!

Step 1: Setting Up the Boss

In this section, you'll learn how to configure the basic settings of your custom boss. This setup includes defining the boss's identity, difficulty, visual appearance, and behavior during the battle.

Step 2: Adding Dialogs

Dialogs are the text messages that the boss says before starting their attacks. They set the tone and provide context to the battle, enhancing the player’s experience. Follow the steps below to add, edit, and manage dialogs for your boss.

Step 4: Adding Attacks

Choose from existing attacks or create your own custom attack for your boss.

Going to attacks is where you add what attacks the boss should use

Select from most of the existing attacks from all the bosses or create your own.

• Select from which boss you want to use attacks
• Select the attack you want to use
• Press the 'add' button to add it to the list
• Removing an attack: Swipe right or left on an attack in the list to remove it.
• Reordering attack: Press and hold on a attack item in the list to move it to a new position.

The attacks will come in the order they are added unless 'random order' is selected

Settings

• Random order: the attacks order is randomized
• Boss attacks first: the boss will attack without giving the player a turn
• Karma: the attacks will deal karma (poison) attacks, dealing a small bit of damage over time
• Auto attack on: This will skip the players turn and the boss will keep attacking

Special attacks

In the boss list there are special 'bosses'

• Other: Contains some special attacks
  • Only talk: No attack, just dialog
  • End in Victory: the boss ends with victory
  • End in Gameover: the boss ends with gameover
  • Cut scene: like only talk but removes UI elements
• Modifier: Contains some special commands that affect the battle
  • Next upside down: makes the next attack be upside down
  • Activate Al: Activates the Al drone from Neo 2 battle
  • Destroy Al: Destroy the Al drone from Neo 2 battle
  • Al missile: Makes the Al drone shoot missile
  • Al bullets: Makes the Al drone shoot bullets
  • Al saws: Makes the Al drone shoot saws
  • Orange instead of red: replaces red soul with orange
  • Red instead of orange: replaces orange soul with red
  • Auto attack on: turn auto attacking on
  • Auto attack off: turn auto attacking off
• Custom: If you have any custom attacks they will appear here

Step 5: Creating a Custom Attack

For more information go Here

Details on configuring custom attacks, including spawners and projectile behaviors.

The first part of a custom attacks is the Attack itself, this contains basic information like name, ending time etc.

Buttons

• Save: It is important to save when you make changes, it will not autosave
• Export: Export the attack as a file, to share or use with other bosses
• Preview: Start the battle with this attack only
• Spawners: Opens the page for managing Spawners

Attributes

• Attack name: The name of the attack, shows in the list and makes it easier to find
• End when finished: Will try to end the attack if all the spawners are finished(might not work for all scenarios)
• End in seconds: After how many seconds the attack should end
• Soul color: What color the soul should start in
• Box Width: Set the size of the box
• Box Height: Set the size of the box

Step 6: Setting Up Spawners

An attack can have multiple spawners, a spawner is something that creates(spawn) something other. Most of the time it creates projectiles

In the most simple attacks you will have 1 spawner which creates a simple projectile like a fireball, but it more advanced attacks you might have several spawners creating different types of projectiles. Like Fireballs and Gaster Blasters

IMPORTANT!: Always save after you have made some changes

Attributes

• Spawner name: Set this to easier find what spawner is doing what
• Disabled: if the spawner should be disabled from the start
• Start time: seconds before the spawner starts acting
• Position X: The start position of the spawner
• Position Y: The start position of the spawner
• Spawn position X: Where projectiles will be spawned(If not set the Position X will be used)
• Spawn position Y: Where projectiles will be spawned(If not set the Position Y will be used)
• Drawings: Add draw behaviors to the spawner
• Movement: Add move behaviors to the spawner
• Behaviors: Add other behaviors to the spawner
• Type:
  • Simple: Spawn a projectile every x frames
  • Timeline(advanced): Fine tune behaviors, projectiles and other things where you specify the time on a timeline

Lets explain spawner types a bit

Simple

A simple spawner creates a single type of projectile every x frame

• Rate: Every x frame a projectile will be created
• Waves: How many projectiles the spawner can create
• Projectile: Setup the projectile that the spawner will create

Timeline

A timeline is an advanced and powerful spawner where you can create fine tuned patterns. When you add something to the timeline you will set a time when the object will be created

You can add 3 types of things to the timeline

• Projectile: A normal projectile
• Spawner: You can add another spawner
• Behavior: To make something happen, like playing a sound effect

After an item have been placed on the timeline you can see them in the list in the order that they will be executed

In the list you can click on them to edit them, or LONG PRESS to clone them (this makes it easy to copy an item and set a new time for the copy)

Attributes

• Debug: Will show you the timeline when playing.
• Autostart: Will start the timeline immediately
• Loop count: If the timeline should loop, -1 for infinite loops, 0 for no loops and 1 or more for x number of loops

Step 7: Setting Up Projectiles

Set up projectiles with behaviors, conditions, and colliders to enhance your boss's attacks.

A projectile is something that is usually used to hurt the player, it can be flying, moving, or just existing. It can for example be a fireball, a bone, or a wall. Possibilities are endless

Attributes

• Name: name your projectile
• Damage: Set the damage the projectile deals
• Color: Set the color of the projectile.
  • Default: Normal deal damage on hit
  • Green: Heals the player
  • Blue: Player needs to stand still to avoid damage
  • Orange: Player needs to move to avoid damage
• Projectile type:
  • Custom: Create your own projectile
  • Existing: choose from some existing projectiles

Existing projectile

The simplest way to get started, select one of the existing projectile like Gaster blaster, bones and add some parameters

The parameters that you can select depends on the projectile that you select, if you do not set parameters then a default value will be used

Custom

This is where the fun begins, create the projectile yourself gives you the ability to create something truly unique, a projectile is built on behaviors and defining those will shape how it behaves

Attributes

• Starting rotation: Set the start rotation
• Sprite rotation: Rotates the sprite, might be needed for alignments
• Alpha:Starting alpha value
• Drawings: Add drawing behaviors
• Movement: Add movement behaviors
• Colliders: Add colliders
• Behaviors: Add other behaviors