Party Select screen

[Peridot Gaming]

Party Selector v1.3.1
​

by
Peridot Gaming
​

 
Introduction
A visual, configurable, party selection screen for adding actors to your current party.
 
I had the need for a party select screen that allowed me to pass the actor ids into it so that at different stages of my game I could have a completely different set of actors available for selection.  And so, this script was created.
 
Hopefully someone else might find it as helpful as I did when I made it, so I thought it would be a good idea to give back to the community where I found the majority of the answers to issues I was having in developing my game.
 
Features
- Actors to be used are passed in via the simply script call, allowing different sets of actors to be selectable each time you call the screen.
- Easy to use with a single script call.

Versions/Changelog


   1.3.1 - 30 March 2016
           Fixed bug when using right cursor to move to the current party and hitting enter when there are no party members in current party

   1.3.0 - 26 June 2014
           Removed the global variables that I had been using since I started writing the script.

1.2.4 - 06 April 2014
           Added levelling up of any locked actors, unless it is the actor to be levelled up to match.

   1.2.3 - 14 March 2014
           Change to the positioning of the character stats and class as long versions of either caused overlaps.

   1.2.2 - 03 January 2014
           Added a new parameter and functionality to allow the selectable actors to all be levelled up to the same level as a passed in actor id (level_up_to_actor_id).

   1.2.1 - 17 November 2013
           Added module PSConst to hold constants that cannot be changed when calling the script.

   1.2.0 - 10 November 2013
           Added new functionality:
           - Pressing Enter (OK button) in Current Party (right hand) window removes character from the party (if not a locked character).

   1.1.0 - 02 November 2013
           Tidied code
           Added new functionality:
           - Pressing RIGHT arrow in Party Select (left hand) window moves focus to the Current Party (right hand) window.
           - Pressing LEFT arrow in Current Party (right hand) window moves focus to the Party Select (left hand) window.
           - Current Party window is now scrollable.

   1.0.0 - 06 July 2013
           Initial party selector





Screenshots


Standard selection screen.

 
When you have not selected the minimum number of party members: 

How to Use
Simply copy and paste the script contents into a new slot below Materials and above Main.
Calling the script is as easy as doing a single line script call like this:


@partySelect = PartySelector.new([1], [2, 3, 4, 5], 1, 4, 1)
 


Syntax of the call:


@partySelect = PartySelector.new([locked_actors_ids], [selectable_actor_ids], min_party_members, max_party_members, level_up_to_actor_id)


Explanation of the syntax:
 [locked_actor_ids]:
 This will make the actor with id 1 (from the actor database) to be "locked" (ie: required for the party, and cannot be removed from the party) and therefore displayed in the current party window of the selector.  This can be multiple ids separated by commas (eg: [1, 3, 8])

 [selectable_actor_ids]:
 This will make the actors with these ids (from the actor database) be selectable on the left side of the screen.  This can be multiple ids separated by commas (eg: [5, 9,12])

 min_party_members:
 The minimum number of actors there is allowed to be in the party.  This overrides the @MIN_PARTY_MEMBERS variable, but is optional.  If not used when calling the script, then the default @MIN_PARTY_MEMBERS is used.

 max_party_members:
 The maximum number of actors there is allowed to be in the party.  This overrides the @MAX_PARTY_MEMBERS variable, but is optional.  If not used when calling the script, then the default @MAX_PARTY_MEMBERS is used.

 level_up_to_actor_id:
 This will be the actor id to be checked, and all selectable, and locked, actors will have their level set to the same as this actor (provided this actor has a higher level).  If not set, then no leveling up will be done.
 
Demo
Get the demo here (requires RTP)
 
Script
Get it here


Known Bugs
None that I am aware of.
Please let me know if you run into any.
 
FAQ
Q: I'm having difficulty getting this to work.
A: Post your problem here and I will try to help you out.
 
Q: Is this compatible with other scripts.
A: I am running several and haven't found any problems.  But let me know if you find an incompatibility and I will look into it.

Q: I can't access the download site.
A: Whoops! I'll look into that for you. Just let me know that you can't get the script or the demo.
 
Credit and Thanks
This is free for commercial and non-commercial use.  Just remember to credit me.
- Peridot Gaming
 
Author's Notes
- Do NOT post this script on any other sites.  Instead just post a link to this topic.
- If you have any questions, just ask here.
- Unless there are breaking bugs, or incompatibilities with other scripts, I doubt that I will be updating the script much (if at all) as it does everything that it had to when I came up with the need for it.

 

[Clord]

This script would be quite cool actually for a game where you just make party like in FF1.

 

[Diretooth]

This would be useful for a game I just started conceptualizing.

 

[Sacranym]

Is there a simple way to arrange it so the Actor_ID for the party select is put into a pool of available actors or allowed certain actors via triggers or Key Items?

I was planning on making a guild like scenario but some of the actors I didn't want available until question had been done for them but to still use this for the same process. I realize I could have the even edit who was available and who was not but that is quite tedious and would make the single event a monster.

Thank you for you help and for the wonderful script.

 

[infamous0ne]

Hey! Brand new to RPGMaker and am creating a game with looks and plays like FF1 but more depth and a sanity type system. Your script is perfect for my game and I have gotten it to work flawlessly, my only question is if it is possible to add a splash screen of some type when selecting a party member? Or some way to convey a bit of information about each hero? Something like:

"A ranged hero, specializes in bows and deception."
"A hearty hero who can use most weapons and armor."


"Mage who throws fireballs and stuff yo."


"Ect."


Willing to do work for it but at the very least need some guidance haha

 

[Peridot Gaming]

Oh boy, had to go looking at my own script to see what it actually does.  Haven't had to look at this for a long time.


Anyway the only thing I can think of off the top of my head would be to have another setting in the script as either: 1. a parameter passed to it; 2. a static value that you set in the script directly; or 3. a variable that you can set and the script checks against.  This new setting would be something to show the party person description.  If this is set to true then both party windows (the left of selectable actors, and the right of the current party actors) would be drawn a bit shorter than the current heights for them, and a new window would be drawn at the bottom of the screen.  This new window would hold the description, and when you move up and down through either list, it could show the description for that actor.  This could just be the description that you can see if you open up the normal Status screen for the party member.


Not sure if that is helpful, but if you wanted I could probably look at adding this feature if you like.  Just let me know.

 

[infamous0ne]

I really have 0 coding experience with Ruby. I am ok with changing the code that is already there, or copy and paste inbetween pre-existing code, or even modifying lines of code with new formulas or such. What you mentioned with having a screen at the bottom display the Actor information would be perfect. If you would be willing to do that for me I would be beyond grateful.


Also, I found a potential bug with your script! When using the party selection, if you haven't selected a party member yet, and move the cursor right, and then hit enter, it will crash the game with the following error:


"Script 'Game_Actors' line 19: TypeError occured.


no implicit conversion from nil to integer"


looking into it this actually points to a core script, and not yours, so i don't know if its the core script causing the problem or something in your script pointing to the core script? Gosh I really need to learn how to do this scripting stuff. So much power!

 

[Peridot Gaming]

I really have 0 coding experience with Ruby. I am ok with changing the code that is already there, or copy and paste inbetween pre-existing code, or even modifying lines of code with new formulas or such. What you mentioned with having a screen at the bottom display the Actor information would be perfect. If you would be willing to do that for me I would be beyond grateful.


Also, I found a potential bug with your script! When using the party selection, if you haven't selected a party member yet, and move the cursor right, and then hit enter, it will crash the game with the following error:


"Script 'Game_Actors' line 19: TypeError occured.


no implicit conversion from nil to integer"


looking into it this actually points to a core script, and not yours, so i don't know if its the core script causing the problem or something in your script pointing to the core script? Gosh I really need to learn how to do this scripting stuff. So much power!

I probably didn't take in to account that someone would not have at least one person already in the party.  I guess that when I was creating and testing the script I always had a single person locked into the party.  That should be a simple fix to stop you moving to the right if you haven't got anyone in your party yet.  Will put it on my to-do list for tonight.


I started on the extra window, but have not really done much on it other than make it appear if you need it to.  It currently doesn't get the information from the actor description yet as I was having a bit of trouble with one of the controls.


I will put a new version up with the bug fix, and then will carry on with trying to figure out the actor description part of it.

 

[infamous0ne]

Awesome! Thanks

 

[Peridot Gaming]

First post has been updated with the latest version (v1.3.1) that fixes the bug you raised.


I have been having a bit of trouble with the information section, so have removed what I had done in the last couple of days so I can look at it again.

 

[infamous0ne]

Can confirm bug is quashed.

 

[GMKProductions]

Hey
I'm not that used to using rpg maker vx ace
where do i find materials and main?

 

[Roninator2]

Follow the links in my signature block

below this text.