Creation/Dev/Basics of NPC-Control: Difference between revisions

Latest revision as of 22:16, 11 September 2009

What is NC?

NC stands for NPC-Control, which allows server administrators to control the NPC Server, and to add, edit, update and delete scripts on a server.

NC is a part of RC (the tool which server staff use to administrate servers), and requires the "NPC-Control" right on the server. When NC is active, you will find five NPC-Server related buttons inside your RC.

What are these buttons?

Class list

The Class list brings up a list of all the classes currently saved on the NPC-Server. Classes are scripts on a server which can be brought into any other script, such as a level NPC, or a Putnpc2 NPC.

You can add scripts to the server by clicking the Add button, at which you will be asked to name the class. When you have named the class, you will then be given a window to put your script into. Clicking Apply will save your script, and place it in the Classes list, where you can return and modify your script at any time.

If you want to delete a class, select it in the Class list and then press the Delete button.

NPC Level list

The NPC Level list shows an editable list of levels, which are being served by the NPC-Server.

Local NPC list

The Local NPC list button, when clicked, asks for a level name. After entering a level name, the NC will give you information and statistics on NPCs in that level. A typical NPC may look like this.

Variables dump from npc Control-Train

Control-Train.type: OBJECT
Control-Train.scripter: Skyld
Control-Train.level: era_skyldoffice.nw

Attributes:
Control-Train.image: 
Control-Train.script: size: 1042
Control-Train.visibility flags: visible
Control-Train.id: 1008
Control-Train.head: 
Control-Train.xprecise: 30.5
Control-Train.yprecise: 30
Control-Train.timeout: 0.22192
Control-Train.scripttime (in the last min): 0.003244
Control-Train.scriptcalls: 60

These are all details related to the given NPC, such as it's present image, any visual statistics such as head, body, and colours, timeout, script size, timeouts and position. Variables in the NPC that were set on the serverside may also be shown here.

This is quite a useful way of finding out details for NPCs in a level, in case you need to debug them.

Database NPC list

The Database NPC list gives a list of Database NPCs on the server. Database NPCs have the capability to be anywhere on a server, they have their own identity (#N) and have the ability inside NC to allow the user to modify its flags and script.

Like classes, you can add a new Database NPC by clicking the Add button, which will present you with a screen like this.

Here, you can specify various things about the NPC, such as it's Name ID, it's script ID, the type of NPC (mainly for identification purposes), the scripter's name and it's default level, X and Y.

The names and IDs must be unique when creating a Database NPC.

When you create your NPC, it will be added to the Database NPC list, and from here, you can start to work with it. Right-clicking a Database NPC will give you a menu that looks like this.

From here, you can:

View Attributes which shows attributes of the NPC, like the Local NPC list does
Edit Script which allows you to edit the script for the database NPC
Edit Flags which allows you to modify the this. flags for the database NPC
Reset which clears the this. flags of the NPC, warps it to it's default location and restarts script execution
Delete which removes the Database NPC and its flags from the server
Warp which asks for a new location to position the Database NPC at
Update Level which instructs the server to update the level that the Database NPC is in.

Weapon NPC list

The weapons list contains a list of all the weapon scripts on the server. Weapon NPCs can be added to players, and appear in the Weapon Select.

Like Classes, you can add new weapons by clicking Add and specifying a name. Then you can save a script into NC and add it into the player's attributes.

You can re-edit a weapon NPC by selecting it in the Weapons list and clicking Edit, or deleting by clicking Delete.

Weapon NPCs also accept an Image, which can be set at the top of the Script Editing window, and will give the weapon an icon to display in the player's Weapon Select.

RC Commands

There are a couple of "RC Commands" which allow control over the NPC-Server. To use them, simply type them into RC. The main ones are as follows:

/savenpcs which saves a copy of NPC-Server NPCs into the database. The NPC-Server must be online for this command to work.
/npcstart which instructs the NPC-Server to start, if it has not done so already.
/npcshutdown which instructs the NPC-Server to shut down, say, for a restart.
/npckill can be used to kill the NPC-Server in case there was a scripting problem that completely froze the server or /npcstart is not working. Using this command will mean that the data of the last few minutes will be lost, so it is preferred to use /npcshutdown if possible.

@@ Line 1: / Line 1: @@
-'''http://www.antiunixmad.com/'''
+[[Category:Scripting Reference]]
+[[Category:Scripting Tutorials]]
+== What is NC? ==
+[[NC]] stands for NPC-Control, which allows server administrators to control the [[NPC Server]], and to add, edit, update and delete scripts on a server.
-'''[[Viper]]'s [[Graal]] Issues.'''
+[[NC]] is a part of [[RC]] (the tool which server staff use to administrate servers), and requires the "NPC-Control" right on the server. When NC is active, you will find five NPC-Server related buttons inside your RC.
-Hello everyone, as of late, many people have been attacking me on the issues and matters, trying to lie about things, bend the truth, and downright spin to make me and others of my cause look bad, in this text document i will discuss and lay to rest the issues that matter.
+== What are these buttons? ==
+=== [[Image:rc_classlist_normal.png]] Class list ===
+[[Image:Class_list.PNG]]
-I have been involved [[Graal]] for over three years now, and i used to really like [[Graal]] and its admins alot, then slowly after about a year [[Graal]] and its admins went in a bad downward spiral, i still stuck with [[Graal]] in hopes [[Graal]] would pull itself out of this hole and [[Unixmad]] would go back to the right path, this however did not happen, instead [[Unixmad]] and even [[Stefan]] went fouler and lower than i could have imageined, First with fireing [[Pachuka]] and [[Fuitad]], two of the BEST [[Graal]] admins ever in my view for no other reason than disagreeing with his future plans, then if just fireing them was not bad enough, he threatend to sue them and kill they're families, this was so wrong and bad [[Fuitad]] even said he would punch [[Unixmad]] in the face for saying that if he met him in real life, but that was just the beginning of the downward spiral [[Unixmad]] foolishly invoked onto [[Graal]], he then blatantly STOLE a domain name [[Graal]].net from Owl Shimy which costed over 30$ US Dollars, and never gave it back to him and never paid him for the cost of the domain, he also threatend to sue Owl Shimy and kill his family although it was [[Unixmad]] which stole the domain from Owl Shimy, then around [[Graal]]1.3.1 he blocked off [[GServer]]s officially and threatend to sue anyone that ran the former [[GServer]]s, although they were released as "Freeware" and actually used to encourage people to use the [[GServer]]s, this was a blatant attempt to monopolise , threaten, and intemidate that players that actually helped [[Graal]] and supported him, he then made claims he copyrighted "[[Graal]]" and would contact so called "Lawres" about anyone that used the name "[[Graal]]" or had "[[Graal]] Files" on there websites, although [[Graal]] was distributed as "Freeware" or "Shareware" and had no official software copyrights related to it, and that the name "[[Graal]]" was actually the name of a holy sacred golden cup used in some religion, and in that he has commited blasphemy against whatever religion has the so called "Holy [[Graal]]", then later on [[Unixmad]] fired SuperNick, because of his country and his origion and called him an American Asian slut, this was the first sign of racism on the part of [[Unixmad]], towards [[Graal]]1.4.1 [[Unixmad]] was secretly unwrapping his sadistic plans, he then started claiming credit and claiming to own the copyrights to [[Graal]], although [[Unixmad]] has done nothing but host some stupid weak as servers, and yet [[Stefan]] Knorr has done all the real work for [[Graal]], and was the one to make ZeldaOnline , [[Graal]]Online in the first place and has written every bit of codeing for the [[Graal]] Client , [[GServer]], RC, ect, yet [[Unixmad]] the worthless pile of trash that he is steals all credit for [[Graal]], then in February 2001, [[Unixmad]] and Antago release [[Graal]]2001 and the start of the "Pay to Play" system, now i have no problem with the fact that it is pay to play, the issue is when you PAY for something you actually expect to get the worth while of your money in this product, but instead they got a shittily made level generated land that was 99% empty, the NPCs were and are laggy as hell, and there were no quests, and there is only two shitty things today for hearts that suck so much i refuse to even call them quests, and to add to that about 40% of everyone that paid and gave [[Unixmad]] there credit card number NEVER got the accounts they paid 27$ or more for, and those that did clearly got chumped out by a cheap peice of crap that aint worth paying for, it sucked so badly that most people played on [[Graal]] Classic still, even those that foolishly paid for pay to play accounts, and in an attempt to "FORCE" people to pay for a shitty product they do not want against they're will [[Unixmad]] hired "Tyhm" to deface and ruin [[Graal]]Classic in an attempt to make it buggier and less fun than even [[Graal]]2001, about this time i was disgusted with [[Unixmad]] and most of the other admins and decided to downright turn against [[Graal]] and for the most part stop playing the peice of crap in general. People starting getting angry, complaining, asking for help, and asking for refunds, of coarse [[Unixmad]] gave noone a cash refund, and simply deleted and banned "PAID ACCOUNTS" of those who complained, asked for help, or asked for a refund these are PAYING CUSTOMERS, they have the rights of basic service that they PAID for, [[Unixmad]] promises pay to play players a quality product and customer service, but instead gives them a grade F product and ripps off his customers and delete they're accounts that they PAID HIM money for, his excuse? Credit card fraud, when infact at least 90% of the people he bans for credit card fraud pay legitamately with there OWN credit cards or pay via paypal by check, and yet [[Unixmad]] has stolen and used others credit card numbers to buy things for himself on several occassions, he also claims he needs pay to play money to keep [[Graal]] alive and running, yet there has been evidence that he makes at least 90% profit out of the monies he gets, and that he uses illegal porn ad banners and illegal cookie style web tracking and giveing email adresses of the players and even phone numbers of every player to spam and telemarketting companies without there permission, he even keeps personal player info, includeing email, adress, and phone number on unsecure servers which have already been leaked out, such info about people should not be on a public webserver accessable to the internet in anyway, then after all that [[Unixmad]] starts banning african american people, asians, koreans, and or people with images of people of that race from the [[Graal]]2001 forums and [[Graal]] itself, yet again they are paying customers and this is another sickening act of racism on the part of [[Unixmad]] and [[Graal]]Online, and then even more disgusting is what [[Stefan]] posts on the [[Graal]]2001 forums, he makes several anti american, racist, pro terrorist, pro nazi, and pro taliban comments on that post and goes on and on several pages bashing americans, this post was offense, obcene, and disgusting to many people includeing myself . If all that does not make you sick to your stomache or dislike [[Unixmad]] yet, i am far from done, then [[Unixmad]] proceeds to illegally DDOS webservers of mafukie and make threats to him over the phone, and has phone assaulted me over 40 times a day between midnight and 5am, and has made threats to sue dozens of people, kill there families, and shut down innocent websites and servers, while hosting illegal stuff and doing illegal things himself with the use of his own wanadoo.fr servers, stuff which includes child porn, bestiality porn, DVD Piracy, DDOS Attacks, theft of copyrighted materials from gameing companies such as nintendo, Credit Card fraud, theft, spamming, phone harrassment, useage of illegal pirated corperate softwares, all this just to start the list of what [[Unixmad]]', [[Stefan]], and they're servers are doing 24/7 for nearly 4 years now , anyone that likes [[Unixmad]] or thinks he is a good person even after all this is clearly a fool, everything in this document is the truth and why i hate [[Unixmad]] so much, if you like [[Unixmad]] after all these sickening things he does, then you are no better than a KKK or Neo Nazi member and should go kill yourselfs, i do not tolerate facists, racists, or nazis, they are all bad people, and [[Unixmad]] is one of the worst of the worst, and no person with any morales could tolerate or support such a person like Stephane Portha or [[Stefan]] Knorr. The people that spin, lie and bend the truth in support of [[Unixmad]] will always exist, but i will always reveal the truth about [[Unixmad]], and EVERYTHING said in this document is true, despite what any assclowns try and say about this, and this supriseingly enough is only 1% of the bad things [[Unixmad]] has done, how some people even tolerate, none the less support such a bad person is beyond me... I fight against bad people like [[Unixmad]], why? Because unlike many others in this world i actually care about other people, and i will do everything in my power to stop [[Unixmad]] from hurting [[Graal]] or its innocent players, many say i want to destroy and kill [[Graal]], this is NOT true, i used to love [[Graal]], i only wish to stop [[Unixmad]]'s evil sadistic illegal actions and restore [[Graal]] to the great game it used to be when it was "for the players, by the players" , but if i have to destroy [[Graal]]Online in exchange to stop [[Unixmad]]'s tyranny, it will be regreteable, but sometimes some sacrifices have to be made for the greater good, lets just hope that [[Unixmad]] drops dead and that sacrifice never has to be made... I love [[Graal]] and lots of its players, and i wish to someday restore it to the grandness it once had, but bad people like [[Unixmad]] must be gotten rid of if that is to be achieved...
+The ''Class'' list brings up a list of all the classes currently saved on the NPC-Server. Classes are scripts on a server which can be brought into any other script, such as a level NPC, or a [[Putnpc2]] NPC.
+You can add scripts to the server by clicking the '''Add''' button, at which you will be asked to name the class. When you have named the class, you will then be given a window to put your script into. Clicking '''Apply''' will save your script, and place it in the Classes list, where you can return and modify your script at any time.
+If you want to delete a class, select it in the Class list and then press the Delete button.
+=== [[Image:rc_levellist_normal.png]] NPC Level list ===
+The NPC Level list shows an editable list of levels, which are being served by the NPC-Server.
+=== [[Image:rc_localnpcs_normal.png]] Local NPC list ===
+The Local NPC list button, when clicked, asks for a level name. After entering a level name, the NC will give you information and statistics on NPCs in that level. A typical NPC may look like this.
+<pre>Variables dump from npc Control-Train
+Control-Train.type: OBJECT
+Control-Train.scripter: Skyld
+Control-Train.level: era_skyldoffice.nw
+Attributes:
+Control-Train.image:
+Control-Train.script: size: 1042
+Control-Train.visibility flags: visible
+Control-Train.id: 1008
+Control-Train.head:
+Control-Train.xprecise: 30.5
+Control-Train.yprecise: 30
+Control-Train.timeout: 0.22192
+Control-Train.scripttime (in the last min): 0.003244
+Control-Train.scriptcalls: 60</pre>
+These are all details related to the given NPC, such as it's present image, any visual statistics such as head, body, and colours, timeout, script size, timeouts and position. Variables in the NPC that were set on the serverside may also be shown here.
+This is quite a useful way of finding out details for NPCs in a level, in case you need to debug them.
+=== [[Image:rc_npclist_normal.png]] Database NPC list ===
+The Database NPC list gives a list of [[Database NPCs]] on the server. Database NPCs have the capability to be anywhere on a server, they have their own identity (#N) and have the ability inside NC to allow the user to modify its flags and script.
+Like classes, you can add a new Database NPC by clicking the '''Add''' button, which will present you with a screen like this.
+[[Image:Dbnpc_addwindow.PNG]]
+Here, you can specify various things about the NPC, such as it's ''Name'' ID, it's script ID, the type of NPC (mainly for identification purposes), the scripter's name and it's default level, X and Y.
+The names and IDs '''must''' be unique when creating a Database NPC.
+When you create your NPC, it will be added to the Database NPC list, and from here, you can start to work with it. Right-clicking a Database NPC will give you a menu that looks like this.
+[[Image:Dbnpc_selectmenu.PNG]]
+From here, you can:
+* '''View Attributes''' which shows attributes of the NPC, like the Local NPC list does
+* '''Edit Script''' which allows you to edit the script for the database NPC
+* '''Edit Flags''' which allows you to modify the ''this.'' flags for the database NPC
+* '''Reset''' which clears the ''this.'' flags of the NPC, warps it to it's default location and restarts script execution
+* '''Delete''' which removes the Database NPC and its flags from the server
+* '''Warp''' which asks for a new location to position the Database NPC at
+* '''Update Level''' which instructs the server to update the level that the Database NPC is in.
+=== [[Image:rc_weaponlist_normal.png]] Weapon NPC list ===
+[[Image:Weapons_list.PNG]]
+The weapons list contains a list of all the weapon scripts on the server. Weapon NPCs can be added to players, and appear in the Weapon Select.
+Like Classes, you can add new weapons by clicking '''Add''' and specifying a name. Then you can save a script into NC and add it into the player's attributes.
+You can re-edit a weapon NPC by selecting it in the Weapons list and clicking '''Edit''', or deleting by clicking '''Delete'''.
+Weapon NPCs also accept an '''Image''', which can be set at the top of the Script Editing window, and will give the weapon an icon to display in the player's Weapon Select.
+== RC Commands ==
+There are a couple of "RC Commands" which allow control over the NPC-Server. To use them, simply type them into RC. The main ones are as follows:
+* '''/savenpcs''' which saves a copy of NPC-Server NPCs into the database. The NPC-Server must be online for this command to work.
+* '''/npcstart''' which instructs the NPC-Server to start, if it has not done so already.
+* '''/npcshutdown''' which instructs the NPC-Server to shut down, say, for a restart.
+* '''/npckill''' can be used to kill the NPC-Server in case there was a scripting problem that completely froze the server or /npcstart is not working. Using this command will mean that the data of the last few minutes will be lost, so it is preferred to use /npcshutdown if possible.