Scripts - Revision history

Notnabbith: /* Understanding Conditions */

2025-11-28T11:32:47Z

Understanding Conditions

← Older revision		Revision as of 11:32, 28 November 2025
Line 135:		Line 135:

	Starting from the 1st step the conditions will be tested to see if your character will perform the action for this step or not. You can add multiple conditions and they will be evaluated one after the other, additively (AND operator), from top to bottom. If that set of conditions is met, the related action will be performed. If not, the script will move to the next step, and check the conditions for it. If the conditions on all steps are not met, and they all get skipped, the character will perform an idle action.		Starting from the 1st step the conditions will be tested to see if your character will perform the action for this step or not. You can add multiple conditions and they will be evaluated one after the other, additively (AND operator), from top to bottom. If that set of conditions is met, the related action will be performed. If not, the script will move to the next step, and check the conditions for it. If the conditions on all steps are not met, and they all get skipped, the character will perform an idle action.


	The are two kinds of conditions boolean (true/false) and filters.		The are two kinds of conditions boolean (true/false) and filters.

Notnabbith: /* Understanding Conditions */

2025-11-28T11:32:33Z

Understanding Conditions

← Older revision		Revision as of 11:32, 28 November 2025
Line 138:		Line 138:

	The are two kinds of conditions boolean (true/false) and filters.		The are two kinds of conditions boolean (true/false) and filters.

	Filter conditions stack with each other, they will refine the subset of characters/enemies with each subsequent condition.		Filter conditions stack with each other, they will refine the subset of characters/enemies with each subsequent condition.
	For example, let's say you have conditions "foe: nearest" + "foe: is air-week" + "foe: highest current HP".		For example, let's say you have conditions "foe: nearest" + "foe: is air-week" + "foe: highest current HP".

	The first condition will first select all of the nearest enemies, then the second condition will select air-week enemies from the nearest and the last condition will select the highest current HP one from those.		The first condition will first select all of the nearest enemies, then the second condition will select air-week enemies from the nearest and the last condition will select the highest current HP one from those.

	The step will be skipped if there aren't air-weak enemies in the nearest group.		The step will be skipped if there aren't air-weak enemies in the nearest group.

	Boolean conditions are simple true false check.		Boolean conditions are simple true false check.

	For example, let's say you have conditions "foe: nearest" + "foe: more than X+", where X = 3.		For example, let's say you have conditions "foe: nearest" + "foe: more than X+", where X = 3.
	The first condition will first select all of the nearest enemies and only then check if there are 3 of them amongst those nearest.		The first condition will first select all of the nearest enemies and only then check if there are 3 of them amongst those nearest.

	In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.		In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.

Notnabbith: /* Example healing and resurection priorities */

2025-11-28T11:31:00Z

Example healing and resurection priorities

← Older revision		Revision as of 11:31, 28 November 2025
Line 187:		Line 187:
	===Example healing and resurection priorities===		===Example healing and resurection priorities===

	Healing the lower HP allies if multiple allies are under a % HP threshold		'''Healing the lower HP allies if multiple allies are under a % HP threshold'''

	For this we will require multiple steps with a scaling % priority		For this we will require multiple steps with a scaling % priority

	1st step - target Ally		1st step - target Ally

	- ally: HP lower than X% (30) - first it will target allies below 30% HP		- ally: HP lower than X% (30) - first it will target allies below 30% HP

	2nd step - target Ally		2nd step - target Ally

	- ally: HP lower than X% (50) - second it will target allies below 50% HP		- ally: HP lower than X% (50) - second it will target allies below 50% HP

	3nd step - target Ally		3nd step - target Ally

	- ally: HP lower than X% (80) - third it will target allies below 80% HP		- ally: HP lower than X% (80) - third it will target allies below 80% HP

	Healing always a character before the others		'''Healing always a character before the others'''

	1st step - target Ally		1st step - target Ally
	- ally: class is priest - ~~this will~~ check the priest in the party
			- ally: class is priest - first check the priest in the party

	- ally: HP lower than X% (80) - check if the priest is lower than 80% HP		- ally: HP lower than X% (80) - check if the priest is lower than 80% HP

	2nd step - target Ally		2nd step - target Ally

	- ally: HP lower than X% (30) - target allies below 30% HP		- ally: HP lower than X% (30) - target allies below 30% HP

	...		...

	Resurrect before healing		'''Resurrect before healing'''

	1st step - target Ally		1st step - target Ally

	- ally:is knocked-out - this will check if there are KO characters		- ally:is knocked-out - this will check if there are KO characters

	2nd step - target Ally		2nd step - target Ally

	- ally: class is priest - this will check the priest in the party		- ally: class is priest - this will check the priest in the party

	- ally: HP lower than X% (80) - check if the priest is lower than 80% HP		- ally: HP lower than X% (80) - check if the priest is lower than 80% HP

	3rd step - target Ally		3rd step - target Ally

	- ally: HP lower than X% (30) - target allies below 30% HP		- ally: HP lower than X% (30) - target allies below 30% HP

	...		...

Notnabbith: /* Example AOE targeting */

2025-11-28T11:30:07Z

Example AOE targeting

Notnabbith: /* Example 1 AOE targeting */

2025-11-28T11:27:50Z

Example 1 AOE targeting

← Older revision		Revision as of 11:27, 28 November 2025
Line 147:		Line 147:
	In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.		In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.

	===Example 1 AOE targeting===		===Example AOE targeting===

	Using AOE only if the enemy count is above X		Using AOE only if the enemy count is above X

Notnabbith: /* Understanding Conditions */

2025-11-28T11:27:37Z

Understanding Conditions

← Older revision		Revision as of 11:27, 28 November 2025
Line 147:		Line 147:
	In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.		In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.

	~~Examples:~~		===Example 1 AOE targeting===

	Using AOE only if the enemy count is above X		Using AOE only if the enemy count is above X
Line 174:		Line 174:
	- foe: is air-weak - filter only the air-weak ones from the ones in range		- foe: is air-weak - filter only the air-weak ones from the ones in range
	- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement		- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement

			===Example healing and resurection priorities===

	Healing the lower HP allies if multiple allies are under a % HP threshold		Healing the lower HP allies if multiple allies are under a % HP threshold

Notnabbith: /* Understanding Conditions */

2025-11-28T11:26:40Z

Understanding Conditions

← Older revision		Revision as of 11:26, 28 November 2025
Line 133:		Line 133:

	==Understanding Conditions==		==Understanding Conditions==

			Starting from the 1st step the conditions will be tested to see if your character will perform the action for this step or not. You can add multiple conditions and they will be evaluated one after the other, additively (AND operator), from top to bottom. If that set of conditions is met, the related action will be performed. If not, the script will move to the next step, and check the conditions for it. If the conditions on all steps are not met, and they all get skipped, the character will perform an idle action.


			The are two kinds of conditions boolean (true/false) and filters.
			Filter conditions stack with each other, they will refine the subset of characters/enemies with each subsequent condition.
			For example, let's say you have conditions "foe: nearest" + "foe: is air-week" + "foe: highest current HP".
			The first condition will first select all of the nearest enemies, then the second condition will select air-week enemies from the nearest and the last condition will select the highest current HP one from those.
			The step will be skipped if there aren't air-weak enemies in the nearest group.
			Boolean conditions are simple true false check.
			For example, let's say you have conditions "foe: nearest" + "foe: more than X+", where X = 3.
			The first condition will first select all of the nearest enemies and only then check if there are 3 of them amongst those nearest.
			In an example where you invert the logic and have "foe: more than X+", where X = 3, and then "foe: nearest", it will first check if there are 3 foes on the battlefield and if there are 3+ foes, it will check for nearest foes, which might be less than 3.

			Examples:

			Using AOE only if the enemy count is above X

			- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.
			- foe: X or more enemies - check if the number of enemies in range is above a minimum requirement

			Using AOE only if the enemy count is above X, but exclude gathering nodes

			- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes
			- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.
			- foe: X or more enemies - check if the number of enemies in range is above a minimum requirement

			Using AOE only if the enemy count is above X, but exclude gathering nodes and the enemy must be air-weak

			- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes
			- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.
			- foe: is air-weak - filter only the air-weak ones from the ones in range
			- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement

			Using AOE only if the enemy count is above X, but exclude gathering nodes and the enemy must be air-weak and the character must have at least 50% MP

			- self: MP higher than X% (50) - start the step by checking the mp requiremt, this works even if the target is '''Foe'''
			- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes
			- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.
			- foe: is air-weak - filter only the air-weak ones from the ones in range
			- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement

			Healing the lower HP allies if multiple allies are under a % HP threshold

			For this we will require multiple steps with a scaling % priority

			1st step - target Ally
			- ally: HP lower than X% (30) - first it will target allies below 30% HP

			2nd step - target Ally
			- ally: HP lower than X% (50) - second it will target allies below 50% HP

			3nd step - target Ally
			- ally: HP lower than X% (80) - third it will target allies below 80% HP

			Healing always a character before the others

			1st step - target Ally
			- ally: class is priest - this will check the priest in the party
			- ally: HP lower than X% (80) - check if the priest is lower than 80% HP

			2nd step - target Ally
			- ally: HP lower than X% (30) - target allies below 30% HP
			...

			Resurrect before healing

			1st step - target Ally
			- ally:is knocked-out - this will check if there are KO characters

			2nd step - target Ally
			- ally: class is priest - this will check the priest in the party
			- ally: HP lower than X% (80) - check if the priest is lower than 80% HP

			3rd step - target Ally
			- ally: HP lower than X% (30) - target allies below 30% HP
			...

Notnabbith at 10:59, 28 November 2025

2025-11-28T10:59:36Z

← Older revision		Revision as of 10:59, 28 November 2025
Line 131:		Line 131:

	You can also set up a cooldown for a step. Even if the conditions are triggered the script will skip the step if it is in cooldown. Every round the cooldown goes down by 1 and a new ecounter resets it to 0.		You can also set up a cooldown for a step. Even if the conditions are triggered the script will skip the step if it is in cooldown. Every round the cooldown goes down by 1 and a new ecounter resets it to 0.

			==Understanding Conditions==

Notnabbith: /* Scripting tips */

2025-11-28T10:58:26Z

Scripting tips

@@ Line 68: / Line 68: @@
 The '''Select script for character''' button allows you to assign a different script to the selected character. First, select the character at the top, then select the desired script from the list on the left. Finally, click the '''Select script for character''' button to equip the new script.
-==Scripting tips==
+==The Also Basics==
-Lorem ipsum

Notnabbith: /* Creating your own scripts */

2025-11-28T10:31:53Z

Creating your own scripts

@@ Line 25: / Line 25: @@
 |}
-==Creating your own scripts==
+==The Very Basics==
-Lorem ipsum
+In the Character AI menu, you can configure the "Battle Behavior" for various characters. You can use the default scripts provided by the game, or you can create new scripts from scratch or by modifying the default ones. Additionally, you can import and export scripts to share with other players—if you need help, feel free to ask in Discord!
 ==Scripting tips==
 Lorem ipsum

← Older revision		Revision as of 11:30, 28 November 2025
Line 149:		Line 149:
	===Example AOE targeting===		===Example AOE targeting===

	Using AOE only if the enemy count is above X		'''Using AOE only if the enemy count is above X'''

	- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.		- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.

	- foe: X or more enemies - check if the number of enemies in range is above a minimum requirement		- foe: X or more enemies - check if the number of enemies in range is above a minimum requirement

	Using AOE only if the enemy count is above X, but exclude gathering nodes		'''Using AOE only if the enemy count is above X, but exclude gathering nodes'''

	- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes		- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes

	- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.		- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.

	- foe: X or more enemies - check if the number of enemies in range is above a minimum requirement		- foe: X or more enemies - check if the number of enemies in range is above a minimum requirement

	Using AOE only if the enemy count is above X, but exclude gathering nodes and the enemy must be air-weak		'''Using AOE only if the enemy count is above X, but exclude gathering nodes and the enemy must be air-weak'''

	- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes		- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes

	- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.		- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.

	- foe: is air-weak - filter only the air-weak ones from the ones in range		- foe: is air-weak - filter only the air-weak ones from the ones in range

	- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement		- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement

	Using AOE only if the enemy count is above X, but exclude gathering nodes and the enemy must be air-weak and the character must have at least 50% MP		'''Using AOE only if the enemy count is above X, but exclude gathering nodes and the enemy must be air-weak and the character must have at least 50% MP'''

	- self: MP higher than X% (50) - start the step by checking the mp requiremt, this works even if the target is '''Foe'''		- self: MP higher than X% (50) - start the step by checking the mp requiremt, this works even if the target is '''Foe'''

	- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes		- foe: is gathering node NOT - selecting Not checkbox it will exclude gathering nodes

	- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.		- foe: at range X or less - filter only the foes which are in range for the skill you plan to use, usually 1 or 3.

	- foe: is air-weak - filter only the air-weak ones from the ones in range		- foe: is air-weak - filter only the air-weak ones from the ones in range

	- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement		- foe: X or more enemies - check if the number of enemies in range and air-weak is above a minimum requirement