Tokei

July 16, 2021

You'd still need to modify your source to do that. You can be more restrictive as well and attach more "parameters". killerid won't work as it isn't added to the script yet. So something like...

	if (src && src->type == BL_PC && bl->type == BL_MOB && damage > 0) {
		struct mob_data *md = (struct mob_data *)bl;
		mapreg_setreg(reference_uid(add_str("$@attacked_mid"), 0), md->id);
		mapreg_setreg(reference_uid(add_str("$@attacked_gid"), 0), md->bl.id);
		npc_event_do_id("MyNPC::OnEvent", src->id);
	}

OnEvent:
	switch($@attacked_mid) {
		case 1002:
			if (rand(100) < 5) {
				getitem 501, 1;
			}
			
			break;
	}
	
	end;

July 15, 2021

It's possible, but it's also... very intensive for your server and I would highly recommend against it.

In battle.cpp, in battle_calc_damage, add the NPC call:

	if (bl->type == BL_PC) {
		npc_event_do_id("MyNPC::OnEvent", bl->id);
	}

And with the matching script:

-	script	MyNPC	-1,{
	end;
OnEvent:
	//callfunc("F_Function");
	dispbottom "You have attacked.";
	end;
}

It would be much better to add code in the source for what you want to do instead.

July 15, 2021

3 hours ago, Last said:

It's arug_cas02 from BG conquest. The normal version (woe) work fine, but in bg I can't even walk.

flatmapbg.rar 74.91 kB · 0 downloads

I loaded the maps you provided and there are no objects. So nothing to do with GRF Editor, but an issue with your local files or your client.

July 14, 2021

Heya,

You would have to share the map files you're trying to modify as there should be no issues with the settings you've picked.

June 21, 2021

Well, the question is hard to answer because there is nothing wrong with the script. The announcements are clearly wrong, and it doesn't account for server reboots where the rates would be reset to Friday's rates, but besides that... it works as you'd expect. What issue do you have in particular?

May 27, 2021

The job sprite does not get smaller. Neither in-game nor in Act Editor. The wing size has gotten smaller, though.

May 27, 2021

Have you tried using Magnify (with anchor points)? If that's not what you're looking for, you'll have to use math to do what you want. Act files only use 1 anchor per frame.

May 27, 2021

Well you can get the full command used with something like:

OnNavigate:
	.@cmd$ = implode(.@atcmd_parameters$, " ");

	if (isloggedin(getcharid(3, .@cmd$)) != 1) {
		message strcharinfo(0), "Target player '" + .@cmd$ + "' is offline or do not exist.";
	}

	sleep2 1;
	unitwalkto getcharid(3), getcharid(3, .@cmd$);
	end;

Though, unitwalkto is very limited and will most likely fail in most scenarios.

May 26, 2021

Heya,

Have you tried Scripts > Magnify?

Use 0.5 to reduce the size by half. It's a decimal value that has no range limit; you can use -0.5 if you wanted to reduce by half and inverse the image too.

May 26, 2021

Well, they are misaligned in the RSW file because RSM models are centered using a bounding box, while RSM2 are not centered by their bounding box. So to align them within the RSW file, you need to calculate the difference between the two.

Calculate the bounding box for the RSM2 file, calculate the offset between the center of it with the location in the RSW.
Calculate the bounding box for the RSM file, add the previous offset to the RSW file to re-align the model.

But technically speaking, the converted RSM model is working as intended.

May 26, 2021

1 hour ago, Emistry said:
true, but its not really an ideal solution.

why? although the emulator is kinda updated but the emulator still assume array value 0 still exists.
.array[4001] = 999999;
debugmes ".array size = " + getarraysize(.array); // output: .array size = 4002
this meant, your current array total size is 4002, which wasted the memory the allocated for the total of 4001 data from index 0 to 4000, and you dont even need it.

dont forgot that card_id could be above 5 digits or even 6 digits ID nowadays, which will end up wasting even more than we expected..

Heya,

I just wanted to add there that this is actually incorrect (unless there was a major update on rAthena I'm not aware of). The script engine does not allocate memory for the 0 to 4000 values in your example. Technically speaking, arrays are emulated and not actually arrays in the source. When you use ".array[4001]", the engine does the following:

".array" is a string that gets indexed. The string is given a unique number, say 9048. From then on, everytime the string ".array" is used, it will be refered to as 9048. This is called the id.
4001 is the index.
uid (id and index): Both of the values above combined as one (32bit for the id, 32bit for the index, making up 64bit for the uid).

The uid with its value is then stored in a big collection for the whole NPC script. This big collection also contains the values of other non-array variables such as ".temp = 20;". They are all stored in the same place. If you had written the variable as ".array_4001", it would have created a new unique value for the string such as 9049 and the index would have been 0. As you need to index the string everytime you create a new variable, using setd with a big amount of variables is usually not a good practice. Using .array[4001] is handled better source wise.

Quick note, but this is also why .@var = 5 is identical to .@var[0] = 5 and both would return the same value. They have the same uid.

What rAthena also does when you use an index greater than 0 is that it starts keeping track of the array keys (members). So say you used .array[4001], it will keep track that 4001 is a member of the array for the .array variable.

As for getarraysize(), it should be used very carefully and never in the condition of the for loop. getarraysize() does the following:

Checks if the .array value exists in the big collection. If not, adds 0 as a member of the array. (This is more of a hack, as it's impossible to know otherwise if [0] is part of the array or not.)
Go through all the members of the array and find the highest key, then does + 1.

So in your case, using getarraysize(.array) would indeed return 4002 as 4001 is the only member of the array. Using arrays instead of getd/setd would be much faster (and cleaner) in your script sample as a result:

prontera,155,181,5	script	Card Buyer	757,{
	mes "["+strnpcinfo(1)+"]";
	mes "You have any card to sell ? <3";
	next;
	getinventorylist;
	for (.@i = 0; .@i < @inventorylist_count; .@i++) {
		.@price = .card[@inventorylist_id[.@i]];
		if (.@price)
			.@menu$ = .@menu$ + getitemname(@inventorylist_id[.@i]) + " ^FF0000"+F_InsertComma(.@price)+" Zeny^000000";
		.@menu$ = .@menu$ + ":";
	}
	.@i = select(.@menu$) - 1;
	clear;
	.@price = .card[@inventorylist_id[.@i]];
	mes "["+strnpcinfo(1)+"]";
	mes "Sell "+getitemname(@inventorylist_id[.@i])+" for ^FF0000"+F_InsertComma(.@price)+" Zeny^000000?";
	if (select("Confirm", "Cancel") == 1) {
		delitem @inventorylist_id[.@i], 1;
		Zeny += .@price;
		clear;
		mes "["+strnpcinfo(1)+"]";
		mes "You have sold "+getitemname(@inventorylist_id[.@i])+" for ^FF0000"+F_InsertComma(.@price)+" Zeny^000000.";
	}
	close;
function	AddCard	{
	.@price = getarg(0, 0);
	.@getargcount = getargcount();
	
	for (.@i = 1; .@i <= .@getargcount; .@i++)
		.card[getarg(.@i, 0)] = .@price;
	return;
}

OnInit:
	// AddCard( <zeny>, <card_id>...);
	AddCard( 10000, 4001, 4002, 4003, 4004);
	AddCard(100000, 4011, 4012, 4013, 4014);
	AddCard(500000, 4021, 4022, 4023, 4024, 4025);
	AddCard(999999, 4031, 4032, 4033, 4034, 4035, 4036);
	end;
}

Edit: This of course doesn't hold true if you would start iterating through the whole array with for (.@i = 0; .@i < getarraysize(.array); .@i++). This would give horrendous performance. We use the array there as a dictionary rather than a list.

May 23, 2021

You have a few ways of doing that. Your script doesn't cover all possible abusable ways even with logout. It is possible to cancel a script without logging out. One trick is to "abuse" the addtimer behavior. While a script is running, the timed event will not run until the current script is finished (it is queued). As for the logging out issue, you can simply use OnPCLogoutEvent. One drawback from this is that you need to delete the timer as otherwise it will revert whenever you exit the NPC. So I added another menu option to confirm your style, " ~ I want this style". I'd probably remove the " ~ Revert to original" if I were you as it's not needed at all. Cancelling will do that for you and that way you can keep 4 menu options and keep things clean.

prontera,76,96,1	script	Stylist#custom_stylist	122,{
	setarray .@Styles[1],
		getbattleflag("max_cloth_color"),
		getbattleflag("max_hair_style"),
		getbattleflag("max_hair_color");
	setarray .@Look[1],
		LOOK_CLOTHES_COLOR,
		LOOK_HAIR,
		LOOK_HAIR_COLOR;
	set .@s, select(" ~ Cloth color: ~ Hairstyle: ~ Hair color");
	set .@Revert, getlook(.@Look[.@s]);
	set .@Style,1;
	
	@stylist_look_type = .@Look[.@s];
	@stylist_look_value = getlook(@stylist_look_type);
	addtimer 1, strnpcinfo(0) + "::OnPCLogoutEvent";
	
	while(1) {
		setlook .@Look[.@s], .@Style;
		message strcharinfo(0),"This is style #"+.@Style+".";
		set .@menu$, " ~ Next (^0055FF"+((.@Style!=.@Styles[.@s])?.@Style+1:1)+"^000000): ~ Previous (^0055FF"+((.@Style!=1)?.@Style-1:.@Styles[.@s])+"^000000): ~ Jump to...: ~ I want this style";
		switch(prompt(.@menu$)) {
		case 1:
			set .@Style, ((.@Style != .@Styles[.@s]) ? .@Style+1 : 1);
			break;
		case 2:
			set .@Style, ((.@Style != 1) ? .@Style-1 : .@Styles[.@s]);
			break;
		case 3:
			message strcharinfo(0),"Choose a style between 1 - "+.@Styles[.@s]+".";
			input .@Style,0,.@Styles[.@s];
			if (!.@Style)
				set .@Style, rand(1,.@Styles[.@s]);
			break;
		case 4:
			// You have to set the values to 0 and remove the timer event once the colors are chosen and confirmed
			// Your code currently doesn't have a way out of your loops, so I added this one.
			@stylist_look_type = @stylist_look_value = 0;
			deltimer strnpcinfo(0) + "::OnPCLogoutEvent";
			end;
		default:
			set .@Style, .@Revert;
			setlook .@Look[.@s], .@Revert;
			end;
		}
	}
	
	end;
OnPCLogoutEvent:
	if (@stylist_look_type != 0) {
		setlook @stylist_look_type, @stylist_look_value;
	}
	
	deltimer strnpcinfo(0) + "::OnPCLogoutEvent";
	end;
}

May 23, 2021

Heya,

The Reins of Mount has special exceptions in the source. By default, while you are on a mount, you cannot use any item, and this includes the Reins of Mount itself. That is why there is an exception made for the item, and why you need to add an exception for your custom item as well.

In pc.cpp, look for "ITEMID_REINS_OF_MOUNT" in the pc_useitem function. Change

if( nameid != ITEMID_REINS_OF_MOUNT && sd->sc.data[SC_ALL_RIDING] )

to

if( nameid != ITEMID_REINS_OF_MOUNT && nameid != 33014 && sd->sc.data[SC_ALL_RIDING] )

(Or in any other way you'd prefer, this is the most straightforward one I suppose.)

You may also want to look at other exceptions from ITEMID_REINS_OF_MOUNT and apply them too for yours. Goodluck!

May 13, 2021

Well, that's because of how you described your event. You want the rates to change on the hour at 00, but you want the event to start when the goal is reached. Both of these are impossible as the event has to end on the hour as well. So you have to choose, if the event starts at say... 3:44, does it end the next day at 4:00 or 3:00? That's how I understood it.

If... you want the event to run for 24 hours and announce at non-00 intervals from when the goal is first reached, that's a different story entirely.

As for the first time the script is loaded, that's normal. I was too lazy to resolve that point and since it would only happen once, I didn't care much for that.

May 12, 2021

Heya,

Well normally you'd just do a initnpctimer, but since your event needs to run for 24 hours, you can't really expect it to work correctly as a lot can happen in those 24 hours. You need a different approach in that case to survive a server restart/crash or a script reload.

//===== rAthena Script =======================================
//= Floating Server Rates
//===== By: ==================================================
//= Lupus
//===== Current Version: =====================================
//= 1.0
//===== Compatible With: =====================================
//= rAthena Project
//===== Description: =========================================
//= It's a simply example of setbattleflag
//= This script will change your server rates from 1x to 1.5x every 6 hours
//= Note: It doesn't affect Card granted drops, MVP & Treasure Chests drops ^_-
//=       It also doesn't affect CARD drops, because they are just 0.01%
//===== Additional Comments: =================================
//= You can make incredible scripts with 'setbattleflag'!
//============================================================

prontera,123,209,6	script	Broker#FloatingRates	84,{
	if ($floating_rates_hours_left > 0) {
		.@seconds_left = 3600 - (gettime(2) * 60 + gettime(1));
		.@hours_left = ($floating_rates_hours_left - 1) * 3600;
		.@time_left = .@seconds_left + .@hours_left;
		
		.@dun_d = .@time_left / 86400;
		.@dun_h = (.@time_left / 3600) % 24;
		.@dun_m = (.@time_left / 60) % 60;
		.@dun_s = .@time_left % 60;
		
		if (.@dun_d > 0) {
			.@remaining$ = .@dun_d + " day" + (.@dun_d > 1 ? "s" : "") + " and ";
		}
		
		.@remaining$ = .@remaining$ + (.@dun_h < 10 ? "0" : "")+.@dun_h+":"+(.@dun_m < 10 ? "0" : "")+.@dun_m+":"+(.@dun_s < 10 ? "0" : "")+.@dun_s;
		
		mes "[Broker]";
		mes "The event will end in";
		mes .@remaining$;
		mes "Current rates are: "+($@brate/100)+"."+($@brate-$@brateminus)+"x "+($@jrate/100)+"."+($@jrate-$@jrateminus)+"x";
		close;
	}
	
	mes "[Broker]";
	mes "Our server's current fund is:";
	mes "" + callfunc("F_InsertComma",$fr_zeny) + " Zeny";
	next;
	mes "[Broker]";
	mes "Would you like to make a donation?";
	next;
	
	switch(select("Yes:No")) {
		case 1:
Change_Amount:			
			mes "[Broker]";
			mes "Please input your donation amount.";
			next;
			input .@fr_zeny;
			
			if (.@fr_zeny < 1) {
				mes "[Broker]";
				mes "Input number greater than 0.";
				end;		
			}
			
			mes "[Broker]";
			mes "Please confirm Zeny transfer..";
			next;
			
			switch(select("Cancel:Change Amount:Confirm")) {
				case 1:
					end;
				case 2:
					.@fr_zeny = 0;
					next;
					goto Change_Amount;
					end;
				case 3:
					if (Zeny < .@fr_zeny) {
						mes "[Broker]";
						mes "Sorry, but you don't have enough";
						mes "zeny to proceed on payment.";
						end;
					}
					
					mes "[Broker]";
					mes "Zeny has succesfully transfered.";
					Zeny -= .@fr_zeny;
					$fr_zeny += .@fr_zeny;
					
					if ($fr_zeny >= .fr_targetdonation) {
						$fr_zeny = 0;
						
						// Up to you whether you want to add an extra hour or not, as otherwise the event will be below 24 hours.
						$floating_rates_hours_left = 25;
						donpcevent strnpcinfo(0) + "::OnMinute00";
					}
					
					end;
			}
			
			break;
		case 2:
			break;
	}
	
	end;
OnInit:
	.fr_targetdonation = 5000;
OnMinute00:
	if (gettime(2) == 0) {
		$floating_rates_hours_left--;
	}
	
	if ($floating_rates_hours_left < 0) {
		end;
	}
	else if ($floating_rates_hours_left == 0) {
		$floating_rates_hours_left = -1;
		.@default_brate = 100;
		.@default_jrate = 100;
		
		if (getbattleflag("base_exp_rate") != .@default_brate) {
			setbattleflag("base_exp_rate", .@default_brate);
		}
		
		if (getbattleflag("job_exp_rate") != .@default_jrate) {
			setbattleflag("job_exp_rate", .@default_jrate);
		}
		
		announce "Event is over, rates were changed back to: "+(.@default_brate/100)+"x "+(.@default_jrate/100)+"x ",bc_all,0xFF6060;
		end;
	}
	
	$@brate = rand(500,800);
	$@jrate = rand(500,599);
	//$@drate = rand(100,150);
	//Base exp
	setbattleflag("base_exp_rate",$@brate);
	//Job exp
	setbattleflag("job_exp_rate",$@jrate);
	$@brateminus = ($@brate/100) * 100;
	$@jrateminus = ($@jrate/100) * 100;
	announce "Current rates are: "+($@brate/100)+"."+($@brate-$@brateminus)+"x "+($@jrate/100)+"."+($@jrate-$@jrateminus)+"x ",bc_all,0xFF6060;
	
	if ($floating_rates_hours_left == 1) {
		announce "There is one hour left!",bc_all,0xFF6060;
	}
	
	end;
}

May 10, 2021

Heya,

Well, considering the error that is given to you, I'd assume this is the issue:

OnEventAnnounce:
	.status = 1;
	for(.@i = .countdown; i > 0; i--) {

The variable i should be .@i

May 10, 2021

Heya,

The issue is from your char-server. "intif" is for "interserver" and "interface", intif_parse_StorageReceived (which is for all storages, including inventory, etc) is a packet the char-server sends to the map-server, type 3 is TABLE_STORAGE. Long story short, it means it failed to load the storage data for your character. The char-server logs should give you more information about the issue, though. The... fact that you aren't seeing more information is strange. It's not an invalid storage index as you'd get an error such as "Invalid storage with id #". So this only leaves an invalid SQL query. Your storage table doesn't seem to match what the char-server is expecting. Make sure your storage table matches with what rAthena is using. You should have received an SQL error, though.

March 26, 2021

3 hours ago, Radian said:

Hey @Tokei how are you doing?

Im just having issues with encrypted files atm while using a 2018-06-20eRagexeRE client date exe

What im getting is queryRegionInfo or the client cant read when its encrypted i tried running it without encryption and its working fine.

I made new GRF's change the cpp.dll name into something else, create new patch of client and still not working. Any idea what mistake i made on encrypting it?

Newer clients reference cps.dll twice; so keep the name to cps.dll instead of changing it to cpp.dll.

March 18, 2021

Just make sure you're using 1.2.1.0 from the mediafire link.

March 15, 2021

Hm, well the map-server is indeed the one struggling there. The easy solution is to upgrade your CPU to something better, but... you'd have to figure out what's draining so much power from the emulator. It feels rather high for such a population. The usual culprits are SQL usage (which doesn't appear to be case here? mysqld would show a spike there too) or bad scripts/instances. It'll be almost impossible to pinpoint your issue from the forums though.

March 15, 2021

Well, htop would be more helpful here and you keeping an eye on it to see which process uses all your CPU.

March 15, 2021

Heya,

This setting has no impact on the map-server. The character saving process is handled on the char-server, not the map-server. Anything SQL related is handled on the char-server to prevent "lagging" the map-server (and should be kept this way).

I wouldn't recommend increasing this value either. Anything past 5 minutes (300 seconds) can make you more vulnerable to "rollbacks" if the map-server crashes. If your character data hasn't been saved for more than X minutes, that can be annoying to deal with.

March 9, 2021

10 hours ago, tibbersx said:

@Tokei having same problem. also cannot extract a certain Act/Spr file then something will pop up
"An unhandled exception has been thrown

Generic failure: a task in the thread pool has failed to finish properly. The current operation will be cancelled."

You should open a new thread/question, as this is from 2017. Anyway, it simply means the entry is corrupted or encrypted, most likely encrypted.

March 8, 2021

Heya,

The ground unit IDs for skills are within the client itself, they are not found in lub files and you cannot add new ones. These IDs are mostly meant to display a visual effect on the client though. Therefore... if you want a custom ground skill to show an effect, you'll have to use a pre-existing ID from those currently defined in rAthena and work your way around that. Otherwise, if you want to display a custom effect, you'll have to use "dirty tricks". Either way, what you're looking for simply doesn't exist.

But I'll say, what you've described so far is unclear. Most custom skills do not require an unit ID to begin with.

March 6, 2021

Heya,

This post is meant to explain the file format of RSM2 for those who are interested and want to play with them. I haven't seen many projects exploring the topic and I've finished digging through the file for GRF Editor. I shared some of the structure pubicly in BrowEdit's Discord almost a year ago, but the fields were still unknown at that point. Also before anyone asks, no I am not making a public converter for RSM2 > RSM1. That's not fully possible anyway.

General
The structure of a RSM file is quite simple. It's a list of mesh data with transformations applied to them. Each mesh has a transformation matrix, a position, a parent, etc. Then you have the transformation components on the mesh:

Offset/Translation
RotationAngle
RotationAxis
Scale

And at last, you have the animation components on the mesh:

RotationKeyFrame
ScaleKeyFrame

All the code presented below comes from GRF Editor. Also the structure varies quite a bit even among the 2.2 version and the 2.3 version. I was unable to find any model using versions 2.0 or 2.1. I'd guess they were only used internally...? Who knows.

Animation duration changes
In previous versions, below 2.2, the AnimationLength field and the frame animation field represented time in milliseconds. So a model such as ps_h_01.rsm has 48000 as a value for AnimationLength, which means the animation lasts for a whole 48 seconds before it resets. The key frames for the transformations work in the same manner.

In version 2.2 and above, the AnimationLength field reprensents the total amount of frames in the model. So a model such as reserch_j_01.rsm2 has a value of 300. The keyframes would therefore range between 0 and 300. The duration is given by the new FramesPerSecond field, which is 30 for almost all 2.0 models currently existing. The delay between frames would then be 1000 / FramesPerSecond = 33.33 ms. The duration would be 1000 / FramesPerSecond * AnimationLength = 1000 / 30 * 300 = 10000 ms in our example.

Shading
Nothing new there, but I thought I'd go over the topic quickly. The ShadeType property is used to calculate the normals. There are three types that have been found in models to this day:

0: none; the normals are all set to (-1, -1, -1).
1: flat; normals are calculated per triangle, with a typical cross product of the 3 vertices.
2: smooth; each face of a mesh belongs to a smooth group, the normal is then calculated by adding the face normal of each connected vertices.

In the real world, most models end up using the smooth shading type. The smooth group is a bit confusing at first if you've never heard of it, but some reading on the topic will help you. These are common techniques.

Textures
In previous versions, below 2.3, the textures were defined at the start of the file. Each mesh then defines a list of indices. So for example, a mesh could define these indices: "2, 5, 0" which means the mesh has 3 textures. Each face of the mesh then has a TextureId property from 0 to 2 in our example. If the face TextureId is 1, it would refer to the second indice previously defined, which is 5. This means that the texture used for this face would be the 5th texture defined at the start of the model.

In version 2.3 and above, the textures are defined per mesh instead. There are no longer using texture indices. The TextureId defined for each face refers directly to the texture defined of that particular mesh. So say the TextureId for a face is 1, then the first texture defined on the mesh is the corresponding one.

Transformation order
In version 2.2 and above, the Scale/Offset/RotationAngle/RotationAxis properties were removed. Instead, it relies on animation frames or the TransformationMatrix.

The order looks as such:

/// <summary>
/// Calculates the MeshMatrix and MeshMatrixSelf for the specified animation frame.
/// </summary>
/// <param name="animationFrame">The animation frame.</param>
public void Calc(int animationFrame) {
	MeshMatrixSelf = Matrix4.Identity;
	MeshMatrix = Matrix4.Identity;

	// Calculate Matrix applied on the mesh itself
	if (ScaleKeyFrames.Count > 0) {
		MeshMatrix = Matrix4.Scale(MeshMatrix, GetScale(animationFrame));
	}

	if (RotationKeyFrames.Count > 0) {
		MeshMatrix = Matrix4.Rotate(MeshMatrix, GetRotationQuaternion(animationFrame));
	}
	else {
		MeshMatrix = Matrix4.Multiply2(MeshMatrix, new Matrix4(TransformationMatrix));

		if (Parent != null) {
			MeshMatrix = Matrix4.Multiply2(MeshMatrix, new Matrix4(Parent.TransformationMatrix).Invert());
		}
	}

	MeshMatrixSelf = new Matrix4(MeshMatrix);
	
	Vertex position;

	// Calculate the position of the mesh from its parent
	if (PosKeyFrames.Count > 0) {
		position = GetPosition(animationFrame);
	}
	else {
		if (Parent != null) {
			position = Position - Parent.Position;
			position = Matrix4.Multiply2(new Matrix4(Parent.TransformationMatrix).Invert(), position);
		}
		else {
			position = Position;
		}
	}

	MeshMatrixSelf.Offset = position;

	// Apply parent transformations
	Mesh mesh = this;

	while (mesh.Parent != null) {
		mesh = mesh.Parent;
		MeshMatrixSelf = Matrix4.Multiply2(MeshMatrixSelf, mesh.MeshMatrix);
	}

	// Set the final position relative to the parent's position
	if (Parent != null) {
		MeshMatrixSelf.Offset += Parent.MeshMatrixSelf.Offset;
	}

	// Calculate children
	foreach (var child in Children) {
		child.Calc(animationFrame);
	}
}

The original vertices are then multiplied by MeshMatrixSelf for their final positions. MeshMatrix is the resulting transformation matrix of a particular mesh only, without taking into account its parents matrixes or the mesh position. The MeshMatrixSelf is the final transformation matrix that will be applied to the vertices. Contrary to previous versions, the TransformationMatrix is applied all the way to the children. The matrix invert function may not be available in all common librairies, so here is the implementation used:

public Matrix4 Invert() {
	if (this.IsDistinguishedIdentity)
		return this;
	if (this.IsAffine)
		return this.NormalizedAffineInvert();
	float num1 = this[2] * this[7] - this[6] * this[3];
	float num2 = this[2] * this[11] - this[10] * this[3];
	float num3 = this[2] * this[15] - this[14] * this[3];
	float num4 = this[6] * this[11] - this[10] * this[7];
	float num5 = this[6] * this[15] - this[14] * this[7];
	float num6 = this[10] * this[15] - this[14] * this[11];
	float num7 = this[5] * num2 - this[9] * num1 - this[1] * num4;
	float num8 = this[1] * num5 - this[5] * num3 + this[13] * num1;
	float num9 = this[9] * num3 - this[13] * num2 - this[1] * num6;
	float num10 = this[5] * num6 - this[9] * num5 + this[13] * num4;
	float num11 = this[12] * num7 + this[8] * num8 + this[4] * num9 + this[0] * num10;
	if (IsZero(num11))
		return false;
	float num12 = this[0] * num4 - this[4] * num2 + this[8] * num1;
	float num13 = this[4] * num3 - this[12] * num1 - this[0] * num5;
	float num14 = this[0] * num6 - this[8] * num3 + this[12] * num2;
	float num15 = this[8] * num5 - this[12] * num4 - this[4] * num6;
	float num16 = this[0] * this[5] - this[4] * this[1];
	float num17 = this[0] * this[9] - this[8] * this[1];
	float num18 = this[0] * this[13] - this[12] * this[1];
	float num19 = this[4] * this[9] - this[8] * this[5];
	float num20 = this[4] * this[13] - this[12] * this[5];
	float num21 = this[8] * this[13] - this[12] * this[9];
	float num22 = this[2] * num19 - this[6] * num17 + this[10] * num16;
	float num23 = this[6] * num18 - this[14] * num16 - this[2] * num20;
	float num24 = this[2] * num21 - this[10] * num18 + this[14] * num17;
	float num25 = this[10] * num20 - this[14] * num19 - this[6] * num21;
	float num26 = this[7] * num17 - this[11] * num16 - this[3] * num19;
	float num27 = this[3] * num20 - this[7] * num18 + this[15] * num16;
	float num28 = this[11] * num18 - this[15] * num17 - this[3] * num21;
	float num29 = this[7] * num21 - this[11] * num20 + this[15] * num19;
	float num30 = 1.0f / num11;
	this[0] = num10 * num30;
	this[1] = num9 * num30;
	this[2] = num8 * num30;
	this[3] = num7 * num30;
	this[4] = num15 * num30;
	this[5] = num14 * num30;
	this[6] = num13 * num30;
	this[7] = num12 * num30;
	this[8] = num29 * num30;
	this[9] = num28 * num30;
	this[10] = num27 * num30;
	this[11] = num26 * num30;
	this[12] = num25 * num30;
	this[13] = num24 * num30;
	this[14] = num23 * num30;
	this[15] = num22 * num30;
	return this;
}

New transformation animations

TranslationKeyFrames
- In version 2.2 and above, PosKeyFrames are added. If you've seen the previous formats, you may be confused by this. I've seen PosKeyFrames in many implementations, but version 1.6 adds ScaleKeyFrames, not TranslationKeyFrames. The name is self-explanatory: it translates the mesh.
TextureKeyFrames
- In version 2.3 and above, TextureKeyFrames are added. Similar to other transformations, they are defined as:
```
struct TextureKeyFrame {
	public int Frame;
	public float Offset;
}
```

The TextureKeyFrames target a specific texture ID from the mesh and have different animation types. The Offset affects the UV offsets of the textures. The animation types are:

0: Texture translation on the X axis. The texture is tiled.
1: Texture translation on the Y axis. The texture is tiled.
2: Texture multiplication on the X axis. The texture is tiled.
3: Texture multiplication on the Y axis. The texture is tiled.
4: Texture rotation around (0, 0). The texture is not tiled.

Main mesh
In previous versions, below 2.2, there could only be one root mesh. This is no longer the case with newer versions.

Code
And those were all the changes! Here is a full description of the structure (which is again based on GRF Editor).

#
#  RSM structure
#
private Rsm(IBinaryReader reader) {
	int count;
	
	// The magic of RMS files is always GRSM
	Magic = reader.StringANSI(4);
	
	MajorVersion = reader.Byte();
	MinorVersion = reader.Byte();
	
	// Simply converting the version to a more readable format
	Version = FormatConverters.DoubleConverter(MajorVersion + "." + MinorVersion);
	
	// See "Animation duration changes" above for more information.
	AnimationLength = reader.Int32();
	ShadeType = reader.Int32();
	Alpha = 0xFF;
	
	// Apparently this is the alpha value of the mesh... but it has no impact in-game, so...
	if (Version >= 1.4) {
		Alpha = reader.Byte();
	}
	
	if (Version >= 2.3) {
		FrameRatePerSecond = reader.Float();
		count = reader.Int32();
		
		// In the new format, strings are now written with their length as an integer, then the string. In previous versions, strings used to be 40 in length with a null-terminator.
		// The syntax below may be a bit confusing at first.
		// reader.Int32() reads the length of the string.
		// reader.String(int) reads a string with the specific length.
		for (int i = 0; i < count; i++) {
			MainMeshNames.Add(reader.String(reader.Int32()));
		}
		
		count = reader.Int32();
	}
	else if (Version >= 2.2) {
		FrameRatePerSecond = reader.Float();
		int numberOfTextures = reader.Int32();
		
		for (int i = 0; i < numberOfTextures; i++) {
			_textures.Add(reader.String(reader.Int32()));
		}
		
		count = reader.Int32();
		
		for (int i = 0; i < count; i++) {
			MainMeshNames.Add(reader.String(reader.Int32()));
		}
		
		count = reader.Int32();
	}
	else {
		// Still unknown, always appears to be 0 though.
		Reserved = reader.Bytes(16);
		count = reader.Int32();
		
		for (int i = 0; i < count; i++) {
			_textures.Add(reader.String(40, '\0'));
		}
		
		MainMeshNames.Add(reader.String(40, '\0'));
		count = reader.Int32();
	}
	
	// The Mesh structure is defined below
	for (int i = 0; i < count; i++) {
		_meshes.Add(new Mesh(reader, Version));
	}
	
	// The rest of the structure is a bit sketchy. While this is apparently what it should be (some models do indeed have those), they have absolutely no impact in-game and can be safely ignored when rendering the model.
	if (Version < 1.6) {
		count = reader.Int32();
		
		for (int i = 0; i < count; i++) {
			_scaleKeyFrames.Add(new ScaleKeyFrame {
				Frame = reader.Int32(),
				Sx = reader.Float(),
				Sy = reader.Float(),
				Sz = reader.Float(),
				Data = reader.Float()
			});
		}
	}
	
	count = reader.Int32();
	
	for (int i = 0; i < count; i++) {
		VolumeBoxes.Add(new VolumeBox() {
			Size = new Vertex(reader.Float(), reader.Float(), reader.Float()),
			Position = new Vertex(reader.Float(), reader.Float(), reader.Float()),
			Rotation = new Vertex(reader.Float(), reader.Float(), reader.Float()),
			Flag = version >= 1.3 ? reader.Int32() : 0,
		});
	}
}

#
#  Mesh structure
#
public Mesh(IBinaryReader reader, double version) {
	int count;

	if (version >= 2.2) {
		Name = reader.String(reader.Int32());
		ParentName = reader.String(reader.Int32());
	}
	else {
		Name = reader.String(40, '\0');
		ParentName = reader.String(40, '\0');
	}

	if (version >= 2.3) {
		count = reader.Int32();

		for (int i = 0; i < count; i++) {
			Textures.Add(reader.String(reader.Int32()));
		}

		// This is more so for backward compatibility than anything. The texture indices now refer to the texture list of the mesh directly.
		for (int i = 0; i < count; i++) {
			_textureIndexes.Add(i);
		}
	}
	else {
		count = reader.Int32();

		for (int i = 0; i < count; i++) {
			_textureIndexes.Add(reader.Int32());
		}
	}

	// The TransformationMatrix is 3x3 instead of 4x4 like everything else in the universe.
	TransformationMatrix = new Matrix3(
		reader.Float(), reader.Float(), reader.Float(), 
		reader.Float(), reader.Float(), reader.Float(), 
		reader.Float(), reader.Float(), reader.Float());


	if (version >= 2.2) {
		// In 2.2, the transformations are already applied to the mesh, or calculated from the animation key frames. None of these properties are used anymore.
		Offset = new Vertex(0, 0, 0);
		Position = new Vertex(reader);
		RotationAngle = 0;
		RotationAxis = new Vertex(0, 0, 0);
		Scale = new Vertex(1, 1, 1);
	}
	else {
		// The Offset is the translation vector for the mesh. translated > scaled > rotated >TransformationMatrix.
		Offset = new Vertex(reader.Float(), reader.Float(), reader.Float());
		
		// Position is the distance between the mesh and its parent.
		Position = new Vertex(reader.Float(), reader.Float(), reader.Float());
		RotationAngle = reader.Float();
		RotationAxis = new Vertex(reader.Float(), reader.Float(), reader.Float());
		Scale = new Vertex(reader.Float(), reader.Float(), reader.Float());
	}

	count = reader.Int32();

	for (int i = 0; i < count; i++) {
		_vertices.Add(new Vertex(reader.Float(), reader.Float(), reader.Float()));
	}

	count = reader.Int32();

	for (int i = 0; i < count; i++) {
		_tvertices.Add(new TextureVertex {
			Color = version >= 1.2 ? reader.UInt32() : 0xFFFFFFFF,
			U = reader.Float(),
			V = reader.Float()
		});
	}

	count = reader.Int32();

	// A face has changed a little in the new version. The SmoothGroup isn't only bound to the face itself, but can be bound to the vertex itself instead.
	for (int i = 0; i < count; i++) {
		Face face = new Face();
		int len = -1;

		if (version >= 2.2) {
			len = reader.Int32();
		}

		face.VertexIds = reader.ArrayUInt16(3);
		face.TextureVertexIds = reader.ArrayUInt16(3);
		face.TextureId = reader.UInt16();
		face.Padding = reader.UInt16();
		face.TwoSide = reader.Int32();

		if (version >= 1.2) {
			face.SmoothGroup[0] = face.SmoothGroup[1] = face.SmoothGroup[2] = reader.Int32();

			if (len > 24) {
				// It is unsure if this smooth group is applied to [2] or not if the length is 28. Hard to confirm.
				face.SmoothGroup[1] = reader.Int32();
			}

			if (len > 28) {
				face.SmoothGroup[2] = reader.Int32();
			}
		}

		_faces.Add(face);
	}

	// This was weirdly predicted to be in model version 1.6... which never existed? Either way, it is safe to set it as >= 1.6
	if (version >= 1.6) {
		count = reader.Int32();

		for (int i = 0; i < count; i++) {
			_scaleKeyFrames.Add(new ScaleKeyFrame {
				Frame = reader.Int32(),
				Sx = reader.Float(),
				Sy = reader.Float(),
				Sz = reader.Float(),
				Data = reader.Float()	// Useless, has in impact in-game
			});
		}
	}

	count = reader.Int32();

	for (int i = 0; i < count; i++) {
		_rotFrames.Add(new RotKeyFrame {
			Frame = reader.Int32(),
			// Qx, Qy, Qz, Qw
			Quaternion = new TkQuaternion(reader.Float(), reader.Float(), reader.Float(), reader.Float())
		});
	}

	if (version >= 2.2) {
		count = reader.Int32();

		for (int i = 0; i < count; i++) {
			_posKeyFrames.Add(new PosKeyFrame {
				Frame = reader.Int32(),
				X = reader.Float(),
				Y = reader.Float(),
				Z = reader.Float(),
				Data = reader.Int32()	// Useless, has in impact in-game
			});
		}
	}
	
	// Texture animations, look at "Textures" above for more information
	if (version >= 2.3) {
		count = reader.Int32();

		for (int i = 0; i < count; i++) {
			int textureId = reader.Int32();
			int amountTextureAnimations = reader.Int32();

			for (int j = 0; j < amountTextureAnimations; j++) {
				int type = reader.Int32();
				int amountFrames = reader.Int32();

				for (int k = 0; k < amountFrames; k++) {
					_textureKeyFrameGroup.AddTextureKeyFrame(textureId, type, new TextureKeyFrame {
						Frame = reader.Int32(),
						Offset = reader.Float()
					});
				}
			}
		}
	}
}

I'm also sharing the program I used to test the RSM2 files. It's a bit messy, but it does the job and might help someone. This testing program no longer has any purpose to me as it's been merged into GRF Editor already.

https://github.com/Tokeiburu/RSM2/tree/master/Rsm2

The provided model is the following (it contains all the new features of RSM2):

test.gif.4f825b0e9a7180ad7191a55116502429.gif

The chain on the right as well as the lights use these new texture animations. The red ball uses the translation key frames.

This test project can read any RSM or RSM2 file as well as save them (you can edit RSM/RSM2 models via source). Changing the header version to change the output file will cause issues depending on which version you go from and to. With that said, have fun...! One day I'll make GRF Editor sources public again, one day.

Sign In

Profiles

Forums

Downloads

Jobs Available

Server Database

Third-Party Services

Top Guides

Store

Posts posted by Tokei