5 replies to this topic

[SUCCESSOR]

https://dl.dropboxus...cripts/items.zh

 

https://1drv.ms/u/s!...pd1bZWFoFLq6x_Q
 
Update 3/26:
-some function name fixes
-added GetActiveEquipmentOfFamily()
-added demo script EquipmentSlotX
 
A header for managing and using Equipment as well as other item related functions.
This is a header I have been working on for a while. It started out as just some functions I made for my quest but when interest in those functions grew(and the quest died) I decided to make it into a header. It is still a WIP. Also even though I am pretty sure there is no items.zh already the name could change if needed.

The biggest part of this header is the ability to use Equipment on Inputs other than A and B. I wanted to make that very simple to do. I really want this to get plenty of testing so if you try it out please post some feedback. I am also sorry for it's state. Some organization, commenting, refining, and possibly renaming of some functions are still in order. I am also working on some example scripts to help people who are not scripters get some use out of this.
 
This script allows you to use
 

Use hardcoded equipment on all extra buttons

All Extra inputs including L & R have been hardcoded to use an item if acquired

import "items.zh"
import "std.zh"

global script UseEquipmentOnExInput{
    void run(){
        while(true){
            //UseEquipmentOnExInput(Ex1, Ex2, Ex3, Ex4, L, R);
            UseEquipmentOnExInput(I_CANDLE2, I_BRANG1, I_WAND, I_HOOKSHOT1, I_ARROW1, I_BOMB);
            Waitframe();
        }
    }
}

Use hardcode equipment on one button

Pressing Ex1 will use the Roc's Feather making Link Jump

import "items.zh"
import "std.zh"

global script UseEquipment{
	void run(){
		while(true){
			ResetEquipment();
			UseEquipmentOnInput(I_ROCSFEATHER, EQP_INPUT_EX1);
			Waitframe();
		}
	}
}

 
Script that creates an Ex1 Equipment slot that functions like A and B
This one is a little more involve. You will need to make a new equipment slot
on you subscreen and then figure out the coordinates for Zscript and put it in the constants.
To select equipment for Ex1 press L and R. Demo file

Equipment Slot X

import "items.zh"
import "std.zh"

const int XSLOT_X = 100;
const int XSLOT_Y = -24;

//Equipment Slot Ex1
int EquipmentX[4];
	const int EX1_ID 	= 0;
	const int EX1_OLDID = 1;
	const int EX1_TILE 	= 2;
	const int EX1_CSET 	= 3;
	

global script EquipmentSlotX{
	void run(){
		
		while(true){
			ResetEquipment();
			EquipmentX();
			
			Waitframe();
		}
	}
	bool EquipmentXIsValid(){
		return (EquipmentX[EX1_ID] > 0 && EquipmentX[EX1_ID] < 256);
	}
	void ShiftEquipmentX(int dir){
		if(EquipmentXIsValid()){
			int storeB = EquipmentB();				//save EquipmentB value
			SwapEquipmentB(EquipmentX[EX1_ID]);		//Change EquipmentB to EquipmentX[EX1_ID]
			Link->SelectBWeapon(dir);				//Adjust EquipmentB as directed
			if(EquipmentB() == storeB)Link->SelectBWeapon(dir); //make sure we don't set X to B
			EquipmentX[EX1_ID] = EquipmentB();		//set X
			SwapEquipmentB(storeB);					//reset B
		}
	}
	void UpdateEqupimentX(){
		//Makes sure the value of EquipmentX is in inventory or another item of the same family is in inventory
		if(EquipmentXIsValid()){
			int get = GetActiveEquipment(EquipmentX[EX1_ID]); 			//Confirm EquipmentX or Equipment in the same family is in inventory
			if(get == -1) get = GetActiveEquipmentOfFamily(EquipmentX[EX1_ID]); //Link does not have that Equipment try Equipment of Family
			if(get == -1) EquipmentX[EX1_ID] = 0;						//Link does not have that Equipment 
			else if(get != EquipmentX[EX1_ID]) EquipmentX[EX1_ID] = get; //Equipment found set it to X
		}
		
		//If EquipmentX has no value
		else if(CountActiveEquipment() > 2) {
			EquipmentX[EX1_ID] = EquipmentB();
		}
		//change EquipmentX if it it already on A or B and we are not using EquipmentX
		if( (EquipmentX[EX1_ID] == EquipmentB() || EquipmentX[EX1_ID] == EquipmentA())  && !Link->Misc[EQP_LINK_MISC]){
			ShiftEquipmentX(DIR_RIGHT);			
		}
		//if EquipmentX has changed update draw variables
		if(EquipmentX[EX1_ID] != EquipmentX[EX1_OLDID]){
			GetItemTileAndCSet(EquipmentX[EX1_ID]);
			EquipmentX[EX1_OLDID] = EquipmentX[EX1_ID];
		}
		
		//Press L or R to change EquipmentX
		if(Link->PressL  && CanUseEquipment()){
			//if there are only 3 Active Equipment swap X and B
			if(CountActiveEquipment() == 3){
				EquipmentX[EX1_ID] = EquipmentB();
				Link->SelectBWeapon(DIR_LEFT);
			}
			else ShiftEquipmentX(DIR_LEFT);
		} 
		else if(Link->PressR  && CanUseEquipment()) {
			//if there are only 3 Active Equipment swap X and B
			if(CountActiveEquipment() == 3){
				EquipmentX[EX1_ID] = EquipmentB();
				Link->SelectBWeapon(DIR_RIGHT);
			}
			else ShiftEquipmentX(DIR_RIGHT);
		}
		Link->InputL = false; //Disable L and R to prevent them from Shifting EquipmentB
		Link->InputR = false;		
	}
	//get tile and cset of our equipment to draw
	void GetItemTileAndCSet(int it){
		item get = Screen->CreateItem(it);
		EquipmentX[EX1_CSET] = get->CSet;
		EquipmentX[EX1_TILE] = get->Tile;
		Remove(get);
	}
	void EquipmentX(){
		//makes sure we have a good equipment ID and it's not a duplicate
		UpdateEqupimentX();
		//make sure we have a good Item ID before drawing or attempting to use Equipment
		if(EquipmentXIsValid()){
			//draw item tile to subscreen
			Screen->FastTile(7, XSLOT_X, XSLOT_Y, EquipmentX[EX1_TILE], EquipmentX[EX1_CSET], 128);
			//Use our equipment with with the right input
			UseEquipmentOnInput(EquipmentX[EX1_ID], EQP_INPUT_EX1);
		}
	}
}

Edited by SUCCESSOR, 10 October 2017 - 01:24 PM.

[Twilight-Prince]

This has a LOT of potential for future quests that utilize a ton of items. It's essentially adding the C-Buttons to Zelda Classic! Bravo!

[SUCCESSOR]

It's essentially adding the C-Buttons to Zelda Classic! Bravo!

I wish it were that simple. Unfortunately since scripts stop running when the Active Subscreen opens creating extra "Equipment Slots" that function like A and B do is more involved. Which is why the example for that is not done yet and won't be functionally complete. Sad to say if you want that it comes down to scripting your own subscreen, which is what I was/am doing for my quests, to make it so you can select any item on A, B, X(Ex1), Y(Ex2). Once I do get that quest out I will release the scripts in full so people can see how I made my subscreen. I will also help anyone who wants to use this header, for any reason, if they need it.

Edited by SUCCESSOR, 23 March 2015 - 10:08 PM.

[Russ]

Sad to say if you want that it comes down to scripting your own subscreen

This one's not nearly as hard as it seems though. I did it before with gratuitous use of DrawScreen and DrawTile, and now that Tango.zh exists, the whole process if even easier. I think one could feasibly write a simple tutorial on how to script a subscreen.

Now with that said, this header's amazing. I can foresee a lot of use from it in the future, so thanks for putting it together. By the way, would you like me to add it to the header index, or would you rather wait until it's not longer a WIP?

[SUCCESSOR]

This one's not nearly as hard as it seems though. I did it before with gratuitous use of DrawScreen and DrawTile, and now that Tango.zh exists, the whole process if even easier. I think one could feasibly write a simple tutorial on how to script a subscreen.

Now with that said, this header's amazing. I can foresee a lot of use from it in the future, so thanks for putting it together. By the way, would you like me to add it to the header index, or would you rather wait until it's not longer a WIP?

 

Scripting a subscreen can be easy but it is almost always tricky. You are right though and maybe after I get some more time and no one has done it I may make such a tutorial.

 

You can add this to the header index, that will be great. As long as you link to my dropbox file as it may change frequently. When it stops changing so frequently I will submit it to the script database.

 

Edit: I should have actually looked at that thread I would have seen that you would link to this thread. :tard:

Edited by SUCCESSOR, 23 March 2015 - 11:49 PM.

[SUCCESSOR]

A few small updates to the header. Nothing to get all worked up about.
 
I completed the example script for creating a new item slot. It of course requires you to have a space for it to draw on the subscreen. You adjust where it goes with the constants XSLOT_X and XSLOT_Y. Unfortunately it seems the coordinates for Y in the subscreen editor are a little different than Zscript so a little guesswork and trial and error goes into that. I made a little demo quest for this one. Use L and R to change the equipment in the X Slot.
 
The demo file
The script file


EDIT: Going to update this demo file a bit. Also need to add a bit to the code to make sure that L and R won't change EquipmentB if "Can select A-button Weapon on subscreen" rule is not enabled.
 
Currently working on detecting if the "Can select A-button Weapon on subscreen" rule is not enabled to manage functions that need or expect it.

EDIT AGAIN: Updated demo file. Fixed L and R shifting Equipment B, made it so if there are only 3 Active Equipment B and X will swap(instead of doing nothing).

Edited by SUCCESSOR, 26 March 2015 - 05:33 PM.