CPPI Graphic 2.5 v2

  1. Introduction
  2. Setup
  3. Setup Example
  4. Instructions
  5. Example
  6. Colors
  7. Feedback
  8. Other INFORMATION
  9. Where's the Options Menu?
  10. Many More Setup

Introduction

Hello, how's it going?

This is my plugin. I made it because I wanted graphical meters, but zMUD really didn't have anything I wanted.
So, I made this :)
Feel free to use it however you like, and to give it to whom ever.
The only thing I ask is if you post it on a web page, give me credit!
*Please note* I have not made any advancements to this project in over two years. I am still answering questions, but I probably will not revisit the code. I can be reached at skaarak@akamail.com


Setup

There is one very importing thing that must be done before this program will work.

And that is... you MUST already have variables that you wish to display!
This program does not parse any command lines! This program does not set up any scripts! What it will do is give you and easy way to graphically view variables you have set up already. Although some might see this as a short coming, it could be one of this programs greatest assets because it can be used on many different MUD's with many different configurations.

Setup Example

So for example. If you have a status line that looks like this: [ hp: 20/20 mana: 10/15 ] you might set up a script like this: #TRIGGER {[ hp: (%d)/(%d) mana: (%d)/(%d)} {#VA HP %1; #VA HPMAX %2; #VA MANA %3; #VA MAXMANA %4;} Stats I feel I should expand on this a little since many people are having trouble with what is said here. The #TRIGGER function can be found in the Zugg Help Files. The short of it is you just need to map (%d)'s to numbers you wish to capture. So if you want the 20/20 (for the HP) and the 10/15 (for the mana) you make a replica of the command line (or any line) with (%d) replacing the numbers. Now with this method the first number captured becomes %1, the second %2, etc. So in the second part of the #TRIGGER you can then issue commands to ZMudd. The #VA command sets variables. So you set the first to HP, second to HPMAX, etc. The last part is a group catagory you can use to mass turn on or off these variables. As a general rule it is not needed. Another quick example: [*]<932hp 960sp 920st> Your trigger line would look like this: #TRIGGER {*<(%d)hp (%d)sp (%d)st>} {#VA HP %1; #VA SP %2; #VA ST %3;} Stats Now, in this example the Max is not shown so you would have to set this yourself (or use another trigger) for the guages to work properly. There is an example below the instruction on what you might do with these numbers:


Instructions

This program is very easy to use!

Basically what you do is type in what you want it to say and CPPI Graphic will show it to you!

First- the background color of the window is set by the Bkgrnd Color box.
There is a COLOR chart below, colors must be entered in EXACTALLY or they will not work. The default color is black. So if you type in a color and it comes up black your spelling is probably wrong.
Okay, next lets do the text lines. There are 7 text lines. They show up in the program window starting in the upper left and going down for each line. In each text line you can choose 3 things. The text (ie what name you see). Examples would be like: HP, or EXP, etc...
Next you have the formula. This is like using the %expand command from zMUD. So if @hp = 5 and @hpmax = 10 so a formula like this "@hp / @hpmax" would end up like this "5 / 10".
The last line in text is the Color. The color only extends to the formula part of the line. The text color is altered by the Text Color box.
Okay, next is the columns. There are 5 columns. 4 Vertical and one horizontal. They are all controlled by the same items
The first box is the name assigned to the column. The vertical columns probably cannot have more than 2 or 3 characters. The horizontal column probably cannot have more than about 5 characters.
The next part is the MAX and CURRENT. The MAX is the MAX value of the item. The CURRENT is the current value of the item. These are variable that you enter yourself. They are evaluated so if @HP = 5 then "@hp + 1" = "6".
After the MAX and CURRENT is the color. This is the color of the TEXT ABOVE the columns and to the left of the horizontal column.
Now below each column are 5 items. A Main Color, Percent 2, Color, Percent 3, and Color. This part is pretty easy. If the CURRENT divided by the MAX is less than Percent three the far right color is used. If CURRENT/MAX is less than Percent 2 the middle color is used. IF CURRENT/MAX is greater than Percent 2 it used the main color.
If you have any questions you can send them to me! My e-mail is in the feedback area.


Example

Using the example from above on capturing variables (and using those names) you might do something like this.
You want to display your hit points in the first column window. When you are feeling good you'll use light green, when your less than half your HP you'll use yellow and when your at or below 10 percent you'll use red!

 The column setup would kinda look like this:
     Col 1: HP       MAX: @hpmax          CURRENT: @hp       Color: Blue
  Main Color: lime   Percent 2: 50  Color: yellow   Percent 3: 10  Color: red

*NOTE*
Col 1: HP  -> The "HP" appears ABOVE the column!  It's not any kind of identifier.
Color (on the Col 1 line) is the text color of "HP" not of the column.
Main Color: lime  -> lime is ALL LOWER CASE!  Also, lime is like a light green.

Color Names

black   -> black
maroon  -> dark red
green   -> dark green
olive   -> brown
navy    -> dark blue
purple  -> dark purple
teal    -> blue/green
gray    -> gray
silver  -> light gray
red     -> light red
lime    -> light green
yellow  -> yellow
blue    -> light blue
aqua    -> light blue/green
white   -> white
fuchsia -> light purple

Feedback

You can drop me a line at Skaarak.
I'm not sure if there will be any upgrades. But if you have a question feel free to ask.

Other Useful Information

The NL box = New Line (It puts the verticle guages on a new line)
The ACTIVE box = Turn on or off a guage or text line.
The Verticle Box = Turn A guage verticle or horizontal!
To get to the OPTIONS Menu you go to "Plug-Ins" (in the ZMudd window), then go "CPPIG", then to "Options" (Its something like that).

A Whole Slew Of Setup Examples

Example #1
Your health is Poor.
Your health is Good.
#TRIGGER {Your health is (%a).} {#VA HEALTH %1;}
Note- This would be good for a text line.

Example #2
You are being attacked by a bear.
You are being attacked by an orc.
#TRIGGER {You are being attacked by (*).} {#VA Attacker %1;}
Note- Also good for a text line, also you put the * to capture
all letters betten the word 'by' and the period.  You do this because
'a' or 'an' may be used in front of the creatures name.

Example #3
You have 56 gold.
#TRIGGER {You have (%d) gold.} {#VA GOLD %1;}

Example #4
<55/55hp 25mp 25st>
#TRIGGER {<(%d)/(%d)hp (%d)mp (%d)st>} {#VA HP %1; #VA HPMAX %2; #VA MP %3; #VA ST %4;}

Example #5 (a small snippit)
<150hp 68mn> health
Your health is 150/200.
Your mana is 68/120.
<150hp 68mn>

#TRIGGER {Your health is (%d)/(%d).} {#VA HP %1; #VA HPMAX %2}
#TRIGGER {Your mana is (%d)/(%d).} {#VA MANA %1; #VA MANAMAX %2;}
#TRIGGER {<(%d)hp (%d)mn>} {#VA HP %1; #VA MANA %2;}

Note- Here is a script that will pull the current state
of your mana & HP whenever your prompt is updated, and when you
type 'health' to list your maximums it will update that as well.