Differences

This shows you the differences between two versions of the page.

--- legacy:tsbs:getting_started [2025/01/13 16:14] – removed - external edit (Unknown date) 127.0.0.1
+++ legacy:tsbs:getting_started [2025/01/13 16:14] (current) – ↷ Page moved from tsbs:getting_started to legacy:tsbs:getting_started superadmin
@@ Line 1: / Line 1: @@
+====== Getting Started ======
+This page will guide you how to install Theolized SBS into your VX Ace. This tutorial is written for TSBS version 2.
+**Disclaimer:** Theolized SBS is an advanced battle system which at some point, you're required to know how to edit Ruby script. That said, this system is __neither plug and play or newbie-friendly__. You're expected to familiar with some of the things and configure how the script behaves before even getting started. If you're just starting with RPG Maker and not familiar with everything, please take a look into the [[https://forums.rpgmakerweb.com/index.php?threads/a-starting-point-for-new-users-v1-2.14727/|starting point for new users]].
+**Disclaimer 2:** This wiki is under construction as we're migrating the [[https://github.com/theoallen/TSBS/wiki/Getting-Started|original TSBS wiki]] into this site and to accommodate the upcoming TSBS version 2
+===== Installing the script =====
+Generally, in order to make this script works, it has to be put under everything else. Theolized SBS is no different unless stated otherwise. If you're using [[https://yanflychannel.wordpress.com/|Yanfly's script]]. Put mine under them. The general order is:
+  * Theo's Basic Module
+  * Sprite Extension
+  * <Yanfly's script>
+  * <Other scripts>
+  * TSBS - Config 1
+  * TSBS - Config 2
+  * Implementation
+  * (Optional) Compatibility Patch
+  * (Optional) TSBS Addons
+The order in the script list should be like this
+[{{https://i.imgur.com/XXpxc2c.jpg|The image is subject to change}}]
+===== Spriteset Rules =====
+TSBS will not magically work just by plugging into your system. The user of the script has to do themselves a favor by __deciding which sprite format they want to use__.
+**Disclaimer:** The users are also the one that is responsible to provide their own sprite sheet material. This system will __NOT__ provide any!
+==== Deciding the dimension ====
+TSBS is able to use any kind of sprite sheet format. However, due to technical reasons, once you have chosen the format, <fc #ff0000>**all of the battlers must follow the same format**</fc>. In other words, you can not use [[https://animatedbattlers.wordpress.com/|Holder Battler]] together with RPG Maker MV sprite sheet format. You have to choose from either.
+For example, you want to choose 3x4 as your sprite sheet size. Go to config 1. And change MaxRow and MaxCol to 4 and 3 respectively
+[{{https://i.imgur.com/nS62E2f.jpg}}]
+That means you have chosen to use this kind of sprite to use in your project
+[{{https://i.imgur.com/8xJRdfZ.jpg}}]
+==== Sprite Naming & Placement ====
+You can not go anarchy with the sprite naming. It has own rules to follow. Unless you like to get yourself into trouble. That said, here are the rules.
+  - The actor sprite has to have the same name as your actor in the database
+  - The filename must be followed by ''_number'', for example, ''Eric_1'', __even if you only use one sheet__.
+  - All of the battler sprites must be placed in ''Graphics/Battlers''
+For example, you have this Eric actor in database
+[{{https://i.imgur.com/iCTX0rG.jpg}}]
+So you will need this sprite sheet placed in the folder
+[{{https://i.imgur.com/3WLrAAq.jpg}}]
+===== Animation Sequence =====
+TSBS (in version 2) comes with a blank canvas. You need to configure the animation yourself for each of the poses. There're several animations poses you need to configure. They are:
+  * Idle
+  * Pinch (When the battler HP stays at 25% or lower)
+  * Evade (for the actor)
+  * Evade (for the enemy)
+  * Hurt (When the battler takes damage)
+  * Return (When the battler done taking their action)
+  * Dead (When the actor is knocked out)
+  * Escape (When the actor is escaping)
+  * (Optional) Victory pose
+  * (Optional) Intro pose