Mirage Source

This tutorial will guide you through adding more layers to a vanilla MS4(3.68) and try and give an explanation as to what is doing what.

*Adding this will require you to delete all your maps. If you want to save them then you will need to create a converter. I am not telling you how to create a converter.

So when I go to add something new, regardless of what it is I like to start in the server .

Server Side

The next thing I like to do is add whatever I am adding to the UDT which needs it. A UDT is a User Defined Type. That's all those Type PlayerRec, Type UserRec, TypePlayerInvRec and so on. These are all in modTypes, duh.

modTypes
Under the TileRec UDT add in the new layers you want. I am going to add in two new ones. Mine looks like this now.


So honestly, the next place to go I don't really know xD so I am going to use the search option(Ctrl + F) and type in Ground and press search till something obvious comes up. Seems as if our next place is:

modHandleData
If you don't know, modHandleData does exactly what it's name says. Handles data. All the incoming packets from the client are sorted here and then just done whatever with.

So find the HandleMapData sub.
In this sub you will have to add your new layers in which you added to the TileRec UDT in the last step. Why? Because later you will edit the client side which sends the data to the server, it needs to be received somehow. Anyways, you can see the code that looks like this:


It's probably pretty obvious what you need to do here right? I like to keep things organized myself, so instead of being lazy and adding them to the bottom I added them to the same spots that the UDT has them sorted out. I advise you do the same. If you are adding more than two layers ensure you change all the n + # to the correct ones, don't forget the n = n + #. Mine looks like this now.


Wow this is fun haha. We are learning something I hope? Next step...

modServerTCP
Find the MapCache_Create sub.
Find this line:


Once again, you will need to add your new layers names in here someplace. As previous, I recommend keeping everything in the same order. So add your new layers in here. Mine looks like this.


Notice how it is all in order. This is important when sending/receiving packets.

Client Side

modTypes
Add your new types to the UDT. Keep them in the same order as the server!

modHandleData
Find the HandleMapData sub.
You should already know how to do this part. Add your new layers in here. Once again, keep it in order. Don't forget to change the n + # and n = n + # to their new appropriate values.

modClientTCP
Sub SendMap.
Remember this:


Make it work. Keep it in order! xD.

frmMirage
Add however many new options to the map editor as you need. I only need two so I am putting a new option called optMask2 and one called optAnim2.

modGameEditors
Find the MapEditorMouseDown sub.
If you look at it it should be pretty obvious what needs to happen.


Add in your new layers to this section. I have a new layer called Mask2 and one called Anim2 so I would add these lines.


Scroll down some till you find this:


This section checks if you are pressing the right click button on the mouse, or Button 2. You need to do basically the same thing here as you did in the last step, just without so much stuff. Got it? Good. Now scroll down past a few other subs until you find...

Sub MapEditorClearLayer
Add your new layers in here so they can get cleared properly if you press the clear button.

modDirectDraw7
This module handles all the games drawing procedures. This includes drawing layers to the game screen . Scroll down till you find...

Sub BltMapTile.
I am going to explain something here quickly, I honestly don't know exactly why (maybe somebody could tell me haha) but the way Mirage draws things to the screen is in an order of first to last. The last things are drawn above everything before it. Get it? So if you look at the BltMapTile sub you can see that first the ground is drawn, then the Mask. So since I am just adding a new mask layer (Mask2) I will add it underneath the code for the first mask layer. Follow? This will allow for the Mask2 layer to be drawn over the regular, default Mask layer.


I am going to add my new layer, Mask2 right underneath this code. So now this part in my BltMapTile sub looks like this:


It's pretty straight forward and shouldn't be too difficult. The same goes for the Anim layers. Just duplicate the current one and change the names accordingly. One more thing though, if you are adding an extra fringe layer then you will have to find...

Sub BltMapFringeTile
This sub is where all the Fringe layers are drawn so if you want to add another Fringe layer you would go about doing the same thing here as you did with the previous mask layer.

Now you are ready to test it! Delete all the maps in your client folder and your server folder. Start the server. Start the client. Enjoy.

This is my first tutorial for MS4. Horrah. I tested this and it works. Post if you have any problems or questions.

Should work for Animation 2 right? :S Well, it is overwriting Animation 1, supposed to? Or is it just supposed to blend with it? :S

Your code looks right but I believe the two animation layers aren't really necessary. They would sort of cancel each other out and be useless.

The way it works is similar to the Mask and Mask2 layers. Mask goes below Mask2. Anim will appear underneath Anim2. Get it?

So maybe if you wanted o have a animated 32x32 tile with say, a 16x16 flashing light on top of it or something it would be useful.

You could go into the GameLoop and find the MapAnimTimer (I think?) code and create a new way to animate. Having two different animation times would allow things to not look so "flash. flash. flash" you know?

Thought so, thanks.

Also, how do I make a Fringe Animation?

Have a slight problem
When I login and it goes onto the game screen
its error and says
Compile Error:

Method or data member not found
at this bit

_________________
ﾝﾗｽﾅ ﾗﾉﾁﾓﾆ

I'm getting a wierd error when I try to enter my game.

"End With without With"

_________________
I is back!

It's exactly what it says. There is an End With without a With.

Look at your code and find out where the With is missing or remove the End With if it's not needed.

add and end if before else just after end with

_________________
Fuck? I really joined in 2006.
Spirea, Chat Rooms, Discussions, Help. everything you need in one spot.
http://spirean.com
I love my computer, you never ask for more, you can be my princess or be my whore

Hello, I am French I have a hard time understanding your tutorial , a Persson to integrate it in my source?
(I translated into French MS4)

http://www.megaupload.com/?d=YJUWEFV9

Thx , PIx€L

Wouldn't the old "extra layers" tutorial still work? I don't see a real difference...

This is slightly more updated but it doesn't really matter.

At the time people were asking for a tutorial that worked with the current MS4 without having to think about it and just able to copy and paste. So I made this.

This post is old and dead anyways. You look like you're trying to start conflict.

The entire system for blitting the layers and stuff has been changed.