Grouping and Details

[DerVVulfman]

Grouping and Details
Version: 8.1

Introduction
This system rewrites the Item and Skill and Equipment menus (and Item and Skill Battle Menus) to subdivide them into smaller categories (Fire spells, Healing Spells, Limit Break skills... or Battle Items, Armor, Keys and Potions). This system also permits you to have an extra pop-up display that delivers MORE information on each item, which may include additional lines of detailed information from a custom .rxdata file

Basic Overview

Basic overview of the system's features

The original KGC_ItemGrouping script translated by Mr. DJ allows you to subdivide the item menu, allowing you to view items, key items, healing items, armors and the like in their own windows. The only tweaking required in this script were to edit the elements (Fire, Ice, vs Darkness) in the RMXP Database, and have matching categories in the ItemGrouping script's opening section.

The original KGC_SkillGrouping script that has two translated versions (one by Mr. DJ & one by Armor Nick) allows you to subdivide the skill menu, allowing you to view healing magic, attack spells, and the like in their own windows. The only tweaking required in this script were to edit the elements (Fire, Ice, vs Darkness) in the RMXP Database, and have matching categories in the SkillGrouping script's opening section.

The Item Detail script, provided by jackatrades (no longer supported), allows you to press the "Shift" key on a highlighted item in the Item Menu and it accesses a text file (named Item_Detail.rxdata) to retrieve data about the item for a more detailed description. Additional text files (Armor_Detail.rxdata, Weapon_Detail.rxdata) provide additional data as required.

The Skill Detail script, reworked by Me?, allows you to press the "Shift" key on a highlighted skill in the Skill Menu and it accesses a text file (named Skill_Detail.rxdata) to retrieve data about the skill for a more detailed description.

The original scripts required use of various overlapping scripts... you couldn't just paste these scripts into your project and expect all of them to work. But... that's where I came in and reworked them.

What was missing from the original system was the new Equip Menu Detail script, based on the Item Detail script which allows you to see Weapon & Armor Details in the Equip Menu. Also, you can turn Weapons and Armor subgroups OFF in the Item menu.

Screenshots

You got a couple

This detail window is old...

Demo
Grouping AND Details Demo
(or one that's 'encrypted' to show it working in the compressed format)
Grouping AND Details Encrypted
(Includes Guillaume777's Multi-Slot Equipment Script... no real coding required to get 'em to work together.)

Instructional Manual
The newly revised configuration system is VERY easy to understand.

Some stuff on how it works...

In the demo, I had left most of the comments in the script as provided by the original authors, RMXP's coders whenever possible. Also, I had made the system ohh... so much easier...

If you want to make a "Recovery" item subgroup in your Item menu. Add the element "Recovery" in your RMXP Database (like, where you have fire, water, etc.), and add it into your ITEM_ARRAY array (along with the menu heading, description and icon).

Then, just click "Recovery" in your Items database... That's it. Again, you don't need to edit the script.

Weapons and Armors already have their own subgroup, so you do not need to make an element for them.

Likewise, if you want to make a "Healing" skill subgroup in your Skill menu. Add the element "Healing" in your RMXP Database (again, where you have fire, water, etc.).

And of course, you're not limited to just one element per item to tag. Not bad, eh?

Oh, and the details files (Item_Detail.rxdata and etc) are merely text files the system reads. You can set how many lines each item/weapon/etc. uses and how many leader spaces you use.

Main Topics in the Config section

SYSTEM CHECK ROUTINES
There are two switches here that turn on the resource checkers. One checks to see if you have adequate ICON files. The other if you have adequate picture files.

Note that if you are using ICONS in your project and you are missing some, the system will crash. This routine looks for the ones you are missing. The pictures are nice, but not necessary. The system will not crash if you are missing a 'picture' file for the details screen.

SYSTEM ENABLING SWITCHES
These on/off switches activates the system you want to use.

MASS ELEMENT ARRAYS
These are two arrays that allow you to perform element tagging in-script. Definitely useful if you want to flag large quantities of items at a time.

GROUPING CONFIGURATION
Split into two sections (one for Items, and the other for Skills), here you can configure the layout of your Grouping system... whether the Grouping Header (at the top) uses Icons, or even ONLY icons... and in the ITEM case, whether any items are hidden from the item menu.

As a note, elements need not be created for Armor, Weapons or the 'All' category for items as you can see in the example. The numeric values (0,-1 and -2) are already available for your use.

DETAIL FILES
The DETAIL FILES (ItemDetail.rxdata, etc...) are actual rxdata files in the same file format as your Actor.rxdata files and so forth. They are required to be exacting formats so they can work and be compressed with your game... even encrypted.

The DETAIL SCREEN FONTS section allows you to customize the detail screen
s font and fontsize, as well as custom colors for element/status texts.

The DETAIL PICTURES section merely allows you to set the beginning of the picture filenames (the rest of the filename is merely the item/skill id number). The pics still need to be in the Graphics\Pictures folder.

The DETAIL TEXT settings only holds the text that is presented when the detail text file is in use.

And ELEMENT & STATUS DETAILS settings determines if you're using ICONS or TEXT in the details screen, and what elements are not shown.

DEFAULT TEXT SETTINGS
Okay... these are too many.

But what I WILL say is that the text that was normally hard-coded in the system is now available for you to change here. Yep, every bit of text shown in the details screen is now available for you to replace in the configuration file.

Great if you're programming for a different langage.

Permissions
^_^ I got in touch with jackatrades for permission to use his script, as well as Armor Nick and Me?.. I didn't realize I was using Mr. DJ's translation at the time of the first posting, though this ERROR has obviously been corrected :whistle: And as far as the KGC scripts themselves? Hardly any of the key material would resemble the original sourcecode by now. Practially an original work now.

But, for those who want a learning experience I highly recommend examining and/or trying out the original scripts just to see how these scripts WERE merged.

Compatability
This script is not FULLY SDK compatable (just mostly compatible), because four defs within the system could 'not' be ALIASed. It was necessary as these are required in the item and skill seperation routines for the Grouping system.


Compatability
Text to RGSS will be required to convert properly formatted .txt files into the used .rxdata files. The new system allows your details data to be encrypted with the rest of your game.

Terms and Conditions
This system is available royalty-free, and is permitted for commercial use. However, no warranty on this system is expressed or implied.

What is required as conditions for use is due credit. Not only for myself as the lead scripter for this script but credit for other scripters who had a hand. Jackatrades for the initial development of the details system, Me™ for graphic support in this system. And to dj Marimba, Allerka (of Creation Asylum), Zafrod, Landarma and Cloud500 for system design, development and beta-testing. And to Panchokoster for finding a few compatability bugs.


My References:

Item Detail View by jackatrades
Skill Detail by Me™
KGC_SkillGrouping translated by Armor Nick or Mr DJ (they both worked on their own versions).
KGC ItemGrouping translated by Mr DJ

Image has link to Enterbrain's Download Page

[xuroth]

Hey dude,
I think your Mulit Slots! script is incompatible with this one. following your suggestion, GnD is above Multi Slots!, but if I go into the menu to equip a character with an item, it only allows the details to be shown after you select a slot to equip with. When you do get to the display page, the Stats modification window stays visible over top of your Details page. I worked around this by formatting my details.rxdata files, but I figured you should know.

Also, is there some way to increase capability of the Details and your Muilti Slots! to show custom colors for items, weapons, and armors? For instance, I use a script by game_guy called Item Quality that lets you tag items in the database to demonstrate different variations of a weapon item or armor. For instance

a gold colored font for a Spear indicates that it is much higher quality than a normal Spear.

how can I modify the script to show the custom colors for the item name?

Here is a link to game_guy's topic at Chaos-Project

I have asked game_guy if he could figure this out, and I believe he may be too busy with other projects. If you have time, perhaps you could look at his script and suggest an edit for either his script or yours?

I thank you for your time

[DerVVulfman]

That is extremely odd that you are having such issues, because I am currently using GnD with the newest version of MultiSlots and am not having any of the problems you describe. (even with my rewritten Mog menus) I am able to see details on items within the selectable ITEMS window in the Equip menu by use of the Shift key and the details window vanishes properly when I press Shift again.

EDIT: Correction.
Go to Grouping & Details
Go to Module 4: Windows
Go to line 457.
Change

Code:

self.z += 10

to

Code:

self.z += 1000

That should fix an overlap issue that isn't visible in my current project (er... using mog menus).

Insofar as changing the color of the weapon's name based on quality... It sounds interesting. The color may be visible within the ITEM SELECT menu (for both Item and Equip menus) and/or the CURRENTLY EQUIPPED menu. But that would be the discussion for another topic (either script request or RGSS support). *hint hint*

[xuroth]

thanks for the suggestion. im currently on my ipod, so i will attempt that solution when i log back in on my main computer.

and i will follow your advise and post my item quality issues in the correct forum topic. thanks for the advice.

EDIT: That fixed the overlapping issue *facepalm* i should have thought of that... im learning (or trying to) scripting by tinkering with other people's scripts as the tutorials are far too boring and i never remember them. I may re organize the window and clean it up a little. Now to post about the item color script...

[DerVVulfman]

It was my 2nd massive compilation. The first being a complete RM2K styled Faceset/Message/Windowskin thingie. Since then, I've been making my windows have more configurables (like the z depth). But... hehe... this one hasn't been changed for virtually 3 years.

[DerVVulfman]

After a grand two years, I have finally
bumped
this script to
version 8.0

I've been wanting to do this for a while... never satisfied with the notion that the details files were nothing more than .txt files that anyone could edit with notepad and read what stuff was there. But after crafting 'Text to RGSS', I did it.

Now, instead of plain .txt files, you will use actual .rxdata files to store your information details. But it does take a bit of efford to make a details file.

The demo includes a readme file that describes both converting older Item_Details detail files into the newer format, so you don't lose anything in transition. As well as how to start off if you're new to making a details file.

And like before, there is an encrypted demo that shows that the detail files work... encrypted!

[DerVVulfman]

Minor bump to version 8.1

Eep. I forgot to change a condition with the Armor Detail screen and the optional graphic image that can be shown. Fixed now.