Party Select screen

じ☆ve冰风

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.


本贴来自国际rpgmaker官方论坛作者:Peridot Gaming处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/party-select-screen.30909/