ACS Prefab Database

[Apothem]

As I said in my previous post, the official ACS prefab database has begun!
Tutorials on specific commands are appreicated!

RULES:
The scripts must be properly commented and documented so anyone can use them.
The TID number must be assigned to a variable in order to be submitted so a simple enter/open script will assign the proper numbers to the variable so TID's etc will work properly.
Document all sector tags, TID's, and line ID's used so mappers know where they go.
Scripts must be easy to implement and practical to use.
Post your contribution here so it can be rated. If you want to put your script into a sample wad, you are free to do so.

If your script requires it's own graphics and/or sound effects for whatever reason, please make sure to post a wad with the script that has the gfx inside and directions on where to put them in the wad!!!

Judges:
Sir_Alien
SolarSnowfall
Jallamann
Nmn

Things that will be judged:
Functionality
Documentation
Ease of implementation
Support
Bug free

Everything will be graded on a 5 point scale and the overall score will be the average of the scores.

If you score lower than a 4 on the bug free section you may resubmit. Also, if you do score lower than a 4, you are required to fix any and all bugs before we can continue to judge your script.

If you dont agree with, or have any other ideas as to what other features that should be judged, please post here and make it known!

[Shadelight]

heh, I've got a neat idea for a camera cutscene script.

Code: Select all

//*******************
//neat camera effects( I think)
//by KingofFlames
//********************
script 50 (void)
{
//change the camera so it views over doomguy's right shoulder.
changecamera(45, 1 ,0);
delay(40);
//change the camera so it views over doomguy's left shoulder.
changecamera(41);
delay(40);
//change the camera so it views over the Imp's left shoulder.
changecamera(42);
delay(40);
//change the camera so it views over the Imp's right shoulder.
changecamera(43);
delay(40);
//move on to the next acs demonstration.
thing_changetid(0,1337);
delay(20);
thing_move(1337, 50);
}

what you have to do first, is that you have to place the cameras, and change the Z-height to what you think is the shoulder height for the player and the monster. Then you have to place 2 cameras behind the player start spot. Remember to freeze the Imp by making it dormant. You then place 2 cameras behind the Imp, or whatever monster you using. Then you write out the script as I showed you. But! remember to put in delays while making the changecamera script. Ignore the thing_changetid and the thing_move. That's just for the demonstration wad.

how does that look apothem? I have no demo map, but I'm using this for cutscenes in my level. So it can be used for this demonstration level. I edited it, now what do you think?

[Apothem]

You have very little documentation, you lack an explanation for the TID's, this is not practical to use because it takes about 3 seconds to do in notepad. We're looking for things that are kinda advanced or hard to make as to make it easier for people to modify or enhance their levels. Cutscene scripts will not help anyone because most of the time they only work for the level SPECIFICALLY designed for them. So please, try to create something that can be used no matter where you put it and have proper documentation on TID's and functionality.

[Shadelight]

sorry about that, I just thought it would be a good idea for a cutscene

[Apothem]

sorry about that, I just thought it would be a good idea for a cutscene

Thank you for trying. If you could clean it up a bit and possibly use a camera cycle loop, it'd prolly be worthy of being used.

[Shadelight]

only thing is, is that I don't know how to do a camera cycle loop

[Necromage]

Security Camera Change

---

#include "zcommon.acs"
//=============================================================
//
//Security Camera Change by NecroMage
//
//=============================================================


//The MinCamera sets the begining tid of the cameras
int MinCamera = 1;
//The mapper must include the number of cameras that there is by
//changing the value that max cameras is
int MaxCamera = 2;
//This is an iterator that will go through the list of cameras
int CameraID = MinCamera;

//Change the script number as needed
script 1 (void)
{
switch (CameraID)
{
//This is the last case, it resets the loop back to the beginning.
Case (MaxCamera+1):
ChangeCamera(0,0,0);
CameraID = MinCamera;
break;
//This shows the camera that the iterator is up to
Default:
ChangeCamera(CameraID,0,1);
Break;
}
//Increase the iterator so the next camera is shown
CameraID++;
}

---

Security Camera Change

Ever want that effect of going through the security cameras like Duke Nukem? This simple code will do it for you. First you have to place cameras in the level. Refer to the zdoom wiki if you are unsure how. Then you need to give the cameras tids. You can start with any number but any camera that you want to come after it has to have the next tid. Example: you have three cameras. The first tid is 5. The next two should 6 and 7.

Next paste the code into the scipts lump. Change the MinCamera to the tid of the first camera. In the example above the first tid is 5 so the line of code should read: int MinCamera = 5; Then you need to change the MaxCamera to the tid of the last camera. In the example above the last camera is 7 so the line should read: int MaxCamera = 7;

The only other thing you might need to change is the script number so that it is not the same as another one. The last thing you need to do is give a switch (or what ever you want to use to execute the scipt) linedef action 80 (asc_execute). The first argument should be the number of the script.

The only other thing you might need to know is if you want to have multiple switches. You do the same above but you need to change all the varibles. Here is an example of two different camera changes: (notice how all the variables in the second one have a "2" at the end.

//=============================================================
//
//Security Camera Change by NecroMage
//
//=============================================================


//The MinCamera sets the begining tid of the cameras
int MinCamera = 1;
//The mapper must include the number of cameras that there is by
//changing the value that max cameras is
int MaxCamera = 2;
//This is an iterator that will go through the list of cameras
int CameraID = MinCamera;

//Change the script number as needed
script 1 (void)
{
switch (CameraID)
{
//This is the last case, it resets the loop back to the beginning.
Case (MaxCamera+1):
ChangeCamera(0,0,0);
CameraID = MinCamera;
break;
//This shows the camera that the iterator is up to
Default:
ChangeCamera(CameraID,0,1);
Break;
}
//Increase the iterator so the next camera is shown
CameraID++;
}//=============================================================
//
//Second Security Camera Change
//
//=============================================================


//The MinCamera sets the begining tid of the cameras
int MinCamera2 = 1;
//The mapper must include the number of cameras that there is by
//changing the value that max cameras is
int MaxCamera2 = 2;
//This is an iterator that will go through the list of cameras
int CameraID2 = MinCamera2;

//Change the script number as needed
script 1 (void)
{
switch (CameraID2)
{
//This is the last case, it resets the loop back to the beginning.
Case (MaxCamera2+1):
ChangeCamera(0,0,0);
CameraID2 = MinCamera2;
break;
//This shows the camera that the iterator is up to
Default:
ChangeCamera(CameraID2,0,1);
Break;
}
//Increase the iterator so the next camera is shown
CameraID2++;
}

[chaoscentral]

Ive got a somewhat difficult one, I'll post it in about 5 min though... anyways, I remember when I had a hard time setting up a thing where when you kill a certain number of monsters something happens... so I thing I might submit that if thats good enough

[Shadelight]

cool, I've always wanted a demonstration for that. That'd be great cc

[chaoscentral]

Alright, here is that script I said I would write... here ya go, complete with easy to understand comments

Code: Select all

//***********The Input-Output thingy*************\\
//***********By ChaosCentral*********************\\
#include "zcommon.acs"

   Script 1 (void) //Note that any script number can be used, as long as you activate it just once
   {
         int mc; //initializes the variable we will use to keep track of how many monsters there are

         mc = ThingCount('Monster', 'tid'); //Assigns the number of monsters marked with a certain thing id

         While(mc >= 1) //If monsters are alive, place your filler here ex. a health counter
         {
                  Delay(1); //This is required before a restart, or the script will go into an infinite loop
                  Restart; //This will restart the script so it will constantly update the monster count
         }

         If(mc == 0) //If the monsters are all dead your script goes here
         {	//You're stuff here
                  Terminate; //This is very important, or the script will go into and infinite loop
         }
   }

[Dr_Ian]

That can be simplified a bit:

Code: Select all

#include "zcommon.acs"

script 1 (void)
{
	while (ThingCount(type, tid) > 0)
		delay(1);
	
	// your stuff here
}

If you want to search any monsters with a tid, use monster type of T_NONE. Specific types are here.

[chaoscentral]

youre also missing a bunch of stuff, mainly the restart and the terminate... also some brackets and the monster count part... who cares how short it is as long as it gets the job done right

[Dr_Ian]

You don't need that stuff.

[Shadelight]

yeah.... you do.

[Dr_Ian]

No you really don't.