On our server, the DMs don't always want to be logged into the game using the DM client. It is offen much more useful to be running about as a "mortal" character. Thus Tink, the DM listener, was created. She gives us access to some of the more useful DM client commands while logged in as a normal player.
Tink is a "listener". A creature that "listens" to everything you speak out loud and reacts to certain, pre-programmed, phrases. So you can be anywhere in game and Tink can execute a command on a player without you being close enough to aim an item at them. They can be on a completely different map and as long as you spell their character name correctly, Tink can find them. For us, this is a *huge* improvement over an item that you have to be close enough to aim at a player for it to work.
Detailed instructions for use included and the scripts are well documented.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
She has been trained to "listen" for the following commands:
Tink control options:
- tink listen: Tell her to start listening to you.
- tink stop: Tell her to stop listening to you.
- tink bye: Tell her to go away.
- tink follow: Tell her to follow you or stop following you.
- tink help: Tell her to display a list of all the commands she will respond to.
Creation options:
- item: Create an item in your inventory. Item ResRef required.
- place: Drop a placeable next to you. Placeable ResRef required.
- spawn: Spawn a creature next to you. Creature ResRef required.
Transportation options:
- bring: Move a player from anywhere in the game to your side.
- goto: Move yourself to any player anywhere in the game.
- map: Move yourself to any map in the game. Map tag required.
- wp: Move yourself to the first waypoint in the game that matches the spoken tag.
Give and Take options:
- give gp: Give a player a specific amount of gold.
- give level: Give a player enough XP to hit the next level.
- give xp: Give a player a specific amount of XP.
- take gp: Take a specific amount of gold from a player.
- take level: Take away enough XP to drop a player down a level.
- take xp: Take a specific amount of XP from a player.
Player Punishment options:
- boot: Boot a player from the server.
- freeze: Freeze a player in place by setting them uncommandable.
Misc. Player Functions:
- exa: Short for "Examine". Displays lots of information about the player. Like CD key, ip address, age, deity, race, carried weight, classes, AC, HP, alignment, saves, stats, etc.
- feats: Displays the player's feats.
- getps: Displays the player's GP and XP.
- equips: Displays a list of names of the player's equipped gear and how much it is worth.
- fullheal: Cure, heal and res the player.
- heal: Set the player's hit points to full health.
- skills: Displays the player's skills
- where: Reports back the location of all players or a specific player.
Misc. DM Functions:
- hour: Advance time in hours.
Each command has built in help. Simply type the command (for example: give xp) in without any variables and Tink will explain how to use it.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Credits and Honors
There are two people in particular that we need to thank and give credit for. Without them, Tink wouldn't exist.
First is Nereng, a great guy and (to us) the leading vault expert on listeners. If you haven't seen his "The Invisible Listener v2.0" package it is spectacular.
Second is Sir Elric, whom we have never met but his "Sir Elric's Verbal Mob Spawner v1.1" provided the foundation for Tink. Her "spawn" command was the first thing Tink learned how to do and the list rapidly expanded from there.
We referenced the time functions in the DMFI for the AdvanceTimeByHour function.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
How to use:
Assumption: You have tag based item activation enabled.
1. Import i_dm_tink.erf into your module file
2. Edit the l_tink_funcs script.
- locate the is_a_DM function - starts on line 89
- You *MUST* add the login ID and public CD key for EACH login ID you want Tink to listen to. This is the *only* thing that keeps her from responding to anyone. You don't (typically) want your players to be able to give themselves unlimited gold and xp.
- Follow the directions that start on line 113 to add in the login ids.
- If you skip this step, Tink WILL NOT WORK. At all.
3. Compile the scripts. If you skip this step, Tink WILL NOT WORK. At all.
4. Run the module in game and have fun seeing what Tink can do. Use "Tink's Bottle" on the ground at your feet to spawn up Tink. It takes a couple seconds after she appears at your side for her to start listening to your voice commands.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Updates:
6-1-08 - Removed account information from screenshot.
Thanks for the kind words, Sharona Curves, Korbin and crazedmages.
Tink is still learning how to do things on our server. When she feels like it, naughty little pixie that she is! Feel free to send us an email if you have specific things you would like her to learn how to do.
*grins and hugs Nereng some more.*
ladyalatariel45: Could you be a BIT more specific as to why it will not let you compile the code? Does it give you an error message? If so what does it say?
Library files can be a bit of a pain sometimes. Try having the l_tink_funcs as well as the n_tink_conv scripts open in the script editor. Make your changes to l_tink_funcs, save the file, then add a space to the n_tink_conv file. I usually do that in the header. Just something enough to change the file without REALLY changing it. Save (and thus compile) n_tink_conv. See if that helps to force a save/compile of the l_tink_funcs file.
Hi. I just recently downloaded the Tink system. I followed all of the directions. Added the login and key. I tried to compile the scripts. I was not allowed to compile the script. Why is this?
Posted by nereng at 2008-07-26 19:35:15 Voted 10.00 on 07/26/08
And a big huggle from me as well! :)
Posted by crazedmages at 2008-06-30 07:30:00 Voted 10.00 on 06/30/08
This is a cool script/tool from a very helpful team. _________________________ People react violently to fur rather than leather because it is easier to pick on rich chicks with bad taste than biker gangs.
Posted by Korbin at 2008-06-17 00:39:51 Voted 10.00 on 06/17/08
I am highly impressed, it is operating in a 1.69 patch 9 enviroment pretty seamlessly. This will indeed prove a boon whether or not is gets reworked to fully intregrate to 1.69. _________________________ Webmaster of Shadowhome
Member of Door of Dream Development and building team.
Posted by Sharona Curves at 2008-06-03 19:01:08 Voted 10.00 on 06/03/08
Skitzo: "Are you going to re-code this to not use a listener but use the new 1.69 chat functions?"
I haven't looked into the new 1.69 goodies at all yet. So at present, I have no plans to adjust Tink to use a different system. She works great and has been tested for over a year. I have plenty more scripts on my todo list to mess with one that isn't broken. ;)
FuzzMD: over_my_head beat me to the answer. *smiles at over_my_head*
This is the one part of Tink I expect to get bug reports on. Since you actually have to edit code for the system to function.
KD! *grins and noogies*
-- Mistress
Posted by KansasDark at 2008-05-31 06:14:53 Voted 10.00 on 05/31/08
Another excellent script package Mistress, and the rest of the RoM crew, thanks for sharing.
Should make it very easy to playtest development from within a mod as a player.
@ FuzzMD: You *MUST* add the login ID and public CD key for EACH login ID you want Tink to listen to. This is the *only* thing that keeps her from responding to anyone. You don't (typically) want your players to be able to give themselves unlimited gold and xp.
Should be clear. Seems like a very interesting system. I will have a look, and see if this can be adapted for NWN2.