Welcome to PGMV! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.
FTKR Search Party Param - FTKR_SearchPartyParam.js
Plugin desc : v1.0.1 Plugin that implements scripts related to party parameters
License : MIT License
Author : Futokoro
Desc page : https://github.com/munokura/futokoro-MV-plugins
Download Page : https://raw.githubusercontent.com/munokura/futokoro-MV-plugins/refs/heads/master/FTKR_SearchPartyParam.js
File name : FTKR_SearchPartyParam.js
Help of plugin :
@plugindesc v1.0.1 Plugin that implements scripts related to party parameters
@author Futokoro
@url https://github.com/munokura/futokoro-MV-plugins
@license MIT License
@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help，
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/futokoro-MV-plugins ).
Original plugin by Futokoro.
Please check the URL below for the latest version of the plugin.
URL https://github.com/futokoro/RPGMaker
-----
-----------------------------------------------------------------------------
Overview
-----------------------------------------------------------------------------
Implementing this plugin implements scripts related to party parameters and status.
-----------------------------------------------------------------------------
Setup
-----------------------------------------------------------------------------
1. Add this plugin to the "Plugin Manager".
-----------------------------------------------------------------------------
What the script can be used for
-----------------------------------------------------------------------------
Change the capitalized script strings to the following depending on what you want to query.
<GROUP>
Replace with the following:
1. Party
$gameParty
2. Troops (*1)
$gameTroop
3. Party and Troops (*2)
$gameMember
(*1) Only available during Battle
(*2) Only available to party members outside of Battle
Note that member IDs overlap between party and Troops，
so when using this function， be sure to also perform a process to determine whether the member is an actor.
<MEMBER>
Replace with the following:
1. All members in the GROUP (*3)
members()
2. Alive members in the GROUP
aliveMembers()
3. Dead members in the GROUP
deadMembers()
(*3) During battle， only members participating in battle are returned.
[Input Example]
Alive members in the party
$gameParty.aliveMembers()
Dead members in the Troops
$gameTroop.deadMembers()
All members in battle， both friendly and enemy
$gameMember.members()
-----------------------------------------------------------------------------
Script Command
-----------------------------------------------------------------------------
<Script for Retrieving Parameter Values>
1. Retrieve the sum of the specified parameter
GROUP.MEMBER.sumParam('param')
: Enter the parameter name (in English) in param.
: Example)
: $gameParty.members().sumParam('trg')
: Retrieves the total target rate for the party.
2. Get the average value of a specified parameter
GROUP.MEMBER.averageParam('param')
: Enter the parameter name (in English) in param.
: Example)
: $gameParty.members().averageParam('hp')
: Gets the average current HP value within the party.
3. Get the maximum value of a specified parameter
GROUP.MEMBER.maxParam('param')
: Enter the parameter name (in English) in param.
: Example)
: $gameParty.members().maxParam('atk')
: Gets the maximum attack power value within the party.
4. Get the minimum value of a specified parameter
GROUP.MEMBER.minParam('param')
: Enter the parameter name (in English) in param.
Example:
$gameParty.members().minParam('hit')
Gets the minimum hit rate within the party.
<Script to get member IDs>
1. Get the member ID with the highest value for a specified parameter.
GROUP.MEMBER.isHighestParam('param')
: Enter the parameter name (in English) in param.
: If there are multiple matching members， the ID of the member who comes first in the sort order will be retrieved.
Example:
$gameParty.members().isHighestParam('atk')
: Gets the actor ID with the highest attack power within the party.
2. Get the member ID with the lowest value for a specified parameter.
GROUP.MEMBER.isLowestParam('param')
: Enter the parameter name (in English) in param.
: If there are multiple matching members， the ID of the member who comes first in the sort order will be retrieved.
Example:
$gameParty.members().isLowestParam('atk')
Gets the ID of the actor with the lowest attack power in the party.
3. Gets the ID of the member wearing the specified equipment.
GROUP.MEMBER.isEquipped(equip)
GROUP.MEMBER.isEquippedWeapon(weaponId)
GROUP.MEMBER.isEquippedArmor(armorId)
:For 'equip'， enter '$dataWeapons[weaponId]' for weapons.
:For armor， enter '$dataArmors[armorId]'.
:If there is no matching member， returns false.
:If there are multiple matching members， gets the ID of the member who is ahead in the order.
Example:
$gameParty.members().isEquipped($dataWeapons[10])
$gameParty.members().isEquippedWeapon(10)
Retrieves the IDs of actors in the party equipped with weapon ID 10.
4. Retrieves the IDs of members who have learned a specified skill.
GROUP.MEMBER.isLearnedSkill(x)
: Enter the skill ID in x.
: Returns false if no matching member exists.
: If multiple matching members exist， retrieves the ID of the member who comes first in the list.
Example:
$gameParty.members().isLearnedSkill(5)
: Retrieves the IDs of actors in the party who have learned skill ID 5.
5. Retrieves the IDs of members who have been granted a specified state.
GROUP.MEMBER.isStateAffected(x)
: Enter the state ID in x.
: Returns false if no match is found.
: If multiple matched members exist， retrieves the ID of the member who is in front of them in the order.
: Example)
: $gameParty.members().isStateAffected(5)
: Retrieves the ID of the actor in the party with state ID 5.
6. Randomly select a surviving member and retrieve that member's data.
GROUP.randomTarget()
: Add the following to the end of this script to retrieve various values.
: Example)
: 1. Determine if the target is an actor.
: GROUP.randomTarget().isActor()
: 2. Retrieve the ID.
: GROUP.randomTarget().memberId()
7. Randomly select a defunct member and retrieve that member's data.
GROUP.randomDeadTarget()
: Same usage as GROUP.randomTarget() in 6.
<Script to get a list of member IDs>
1. Get a list (array) of IDs of members whose specified parameter exceeds a certain value.
GROUP.MEMBER.isHigherParam('param'， x)
: Enter the parameter name (in alphabetical characters) in param.
: Enter the test value in x.
: Note that members with a parameter equal to x will not be counted.
: If there are no matching members， an empty array will be returned.
: Example)
: $gameParty.members().isHigherParam('atk'， 100)
: Get a list of IDs of actors in the party whose attack power exceeds 100.
: Advanced)
: $gameParty.members().isHigherParam('atk'， 100).length
: Get the number of actors in the party whose attack power exceeds 100.
2. Get a list (array) of IDs of members whose specified parameter is below a certain value.
GROUP.MEMBER.isLowerParam('param'， x)
: Enter the parameter name (in alphabetical characters) in param.
: Enter the judgment value in x.
: Note that members with a parameter equal to x are not counted.
: If there are no matching members， an empty array is returned.
: Example)
: $gameParty.members().isLowerParam('atk'， 100)
: Get a list of IDs of actors in the party whose attack power is below 100.
: Advanced)
: $gameParty.members().isLowerParam('atk'， 100).length
: Get the number of actors in the party whose attack power is below 100.
-----------------------------------------------------------------------------
License for this plugin
-----------------------------------------------------------------------------
This plugin is released under the MIT License.
Copyright (c) 2017 Futokoro
http://opensource.org/licenses/mit-license.php
----------------------------------------------------------------------------
Change History
----------------------------------------------------------------------------
v1.0.1 - 2017/04/14: Bug fixes， script additions， help revisions
1. Fixed a bug where an error occurred when using isLowerParam() and isHigherParam() on enemies.
v1.0.0 - 2017/04/09: First version released
-----------------------------------------------------------------------------