View source for Actor Auto Battle A.I. (YEP)

{{MvPlugin
|preview = <youtube>https://www.youtube.com/watch?v=A9eDXWBHriw</youtube>
|link1 = <html><iframe src="https://itch.io/embed/398296" height="167" width="552" frameborder="0"></iframe></html>
|link2 = [http://yanfly.moe/plugins/en/YEP_X_ActorAutoBattleAI.js Mirror]

}}
[[Category:RPG Maker MV Battle Plugins]]

{{RequiredPluginsMV}}
* [[Battle A.I. Core (YEP)|Battle A.I. Core]]

{{Yanfly Engine Plugins}}

== Introduction ==

 <nowiki>
This plugin requires YEP_BattleAICore. Make sure this plugin is located
under YEP_BattleAICore in the plugin list.

By default, if an actor has the auto battle trait, it will cycle through
each one of its learned skills (whether or not it has access to the skill
type doesn't matter) and selects the hardest hitting skill of them all. This
setup may work for some auto-battlers but not all of them. What this plugin
does is it incorporates the A.I. Priority system from the YEP Library's
Battle A.I. Core for actor auto-battlers.

If you don't have YEP_BattleAICore yet, please download it from here:
http://yanfly.moe/2015/10/19/yep-16-battle-a-i-core/
</nowiki>

{{Plugin Parameters MV}}

 <nowiki>
Default AI Level:
- See 'Actor AI Level' in the Notetags section below.

Bypass Requirement:
- This is a list of the skills that bypass that requirement to have learned
the skill in order to use it. This is namely for skills like 'Attack' and/or
'Guard' that aren't normally learned by actors, but are available to them
through the command window.

Curate Skill List:
- Skills used for Auto Battle can only be skills accessible through
available skill types. This is a selectable option because sometimes, skills
that are learned by actors can be used through auto battle despite not
having access to that skill type. An example of this would be an actor that
has learned skills in the Knight class, but upon switching to the Mage class
the actor loses the Knight skill type. Yet, despite that, auto battle would
let the Mage class use skills from the Knight skill type if it's a part of
the setup. Turning this on to curate the skill list will remove the ability
use skills outside of available skill types.

Undecided AI:
- If no skill is determined through the A.I. Priority list, the actor will
use the default Auto Battle AI to determine which skill to use. Otherwise,
the actor perform only a basic attack if the setting is false.
</nowiki>

{{Notetags}}

 <nowiki>
The notetags to setup the auto battle A.I. will go into the class noteboxes.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Actor AI Level
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Actor AI levels do not determine how smart they are. Instead, they determine
how strictly they will follow the <AI Priority> lists. An AI Level of 80
means it has an 80% chance of following the prioritized action on the AI
Priority list before moving onto the next one where there will be another
80% chance and so on. If the AI level is lower, the chance is lower, making
the AI to be more random.

Class Notetag:

  <AI Level: x>
  Sets the actor's AI level to x. The lower x, the more random the actor.
  The higher for x, the more strict the actor is about following the AI
  Priority list found in its notebox, too.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Actor AI Priority
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

If a class has an AI Priority list, the actor will go down that list from
top to bottom (giving the actions at the top more priority than the ones at
the bottom) looking for any actions whose conditions are fulfilled. If that
condition is fulfilled, then that action will be the action the actor will
partake in.

To set up a Priority List for the actor, you must place inside the class's
notebox notetags that match the following format:

  <AI Priority>                      <AI Priority>
   condition: SKILL x, target   or    condition: skill name, target
   condition: SKILL x, target         condition: skill name, target
  </AI Priority>                     </AI Priority>

Any number of conditions and skills can be placed in between the two
<AI Priority> tags. You can choose to use skill ID's or the skill names.
However, if you use the skill names, keep in mind that it is not case
sensitive and if any skills in your database have matching names, the skill
with the larger skill ID will be the action used.
</nowiki>

=== Conditions ===

 <nowiki>
The conditions to be used for the <AI Priority> notetag are the same as the
ones from the YEP_BattleAICore plugin. Please refer to the YEP_BattleAICore
help file for which conditions can be used with the A.I. setups.
</nowiki>

== Changelog ==

 <nowiki>
Version 1.01:
- Fixed a bug that made curated skill types not work.

Version 1.00:
- Finished Plugin!

</nowiki>

<!-- This is a comment, remove the arrows surrounding this for the categories you want to show -->
<!-- [[Category: RPG Maker MV Core Plugins]] -->
<!-- [[Category: RPG Maker MV Battle Plugins]] -->
<!-- [[Category: RPG Maker MV Item Plugins]] -->
<!-- [[Category: RPG Maker MV Skill Plugins]] -->
<!-- [[Category: RPG Maker MV Equip Plugins]] -->
<!-- [[Category: RPG Maker MV Status Menu Plugins]] -->
[[Category: RPG Maker MV Gameplay Plugins]]
<!-- [[Category: RPG Maker MV Movement Plugins]] -->
<!-- [[Category: RPG Maker MV Quest Plugins]] -->
<!-- [[Category: RPG Maker MV Options Plugins]] -->
<!-- [[Category: RPG Maker MV Eventing Plugins]] -->
<!-- [[Category: RPG Maker MV Utility Plugins]] -->
[[Category: RPG Maker MV Mechanical Plugins]]
<!-- [[Category: RPG Maker MV Visual Plugins]] -->
<!-- [[Category: RPG Maker MV Menu Plugins]] -->
<!-- [[Category: RPG Maker MV Message Plugins]] -->
<!-- [[Category: RPG Maker MV Quality of Life Plugins]] -->
<!-- [[Category: RPG Maker MV Plugin Tips & Tricks]] -->
<!-- [[Category: Action Sequences (MV)]] -->
<!-- [[Category: Comment Tags (MV)]] -->
<!-- [[Category: Main Menu Manager Integration (MV)]] -->
<!-- [[Category: Notetags (MV)]] -->
<!-- [[Category: Options Core Integration (MV)]] -->
<!-- [[Category: Plugin Commands (MV)]] -->
<!-- [[Category: Script Calls (MV)]] -->
<!-- [[Category: Text Codes (MV)]] -->