RoM Working with waypoint files - Revision history

Elverion: Reverted edits by 91.121.27.33 (Talk) to last revision by Pumbatoo

2012-07-04T02:52:43Z

Reverted edits by 91.121.27.33 (Talk) to last revision by Pumbatoo

Show changes

91.121.27.33: Love Abacus

2012-07-04T02:07:41Z

Love Abacus

Show changes

Pumbatoo: /* List of functions */ Added __WPL:getFileName() description

2011-08-08T13:40:09Z

‎List of functions: Added __WPL:getFileName() description

Pumbatoo: /* How to use the bot for running between the and NPC blackboard for delivering of daily quests */ replaced WPL:reverse() by WPL:setDirection(..)

2011-08-08T08:33:08Z

‎How to use the bot for running between the and NPC blackboard for delivering of daily quests: replaced __WPL:reverse() by __WPL:setDirection(..)

Pumbatoo: /* List of functions */ added function __WPL:setDirection(..)

2011-08-08T08:30:00Z

‎List of functions: added function __WPL:setDirection(..)

95.115.19.246: /* Automatic leveling with the Bot */

2009-09-29T08:48:14Z

‎Automatic leveling with the Bot

95.115.19.246: /* Automatic leveling with the Bot */

2009-09-29T08:47:12Z

‎Automatic leveling with the Bot

Elverion: /* LUA code within a waypoint file */

2009-09-03T23:14:10Z

‎LUA code within a waypoint file

D003232: New page: Here some examples how to work with waypoint files. It shows examples for different types of waypoint files and some special solutions. == LUA code within a waypoint file == You can use ...

2009-09-03T21:35:57Z

New page: Here some examples how to work with waypoint files. It shows examples for different types of waypoint files and some special solutions. == LUA code within a waypoint file == You can use ...

New page

Here some examples how to work with waypoint files. It shows examples for different types of waypoint files and some special solutions.

== LUA code within a waypoint file ==
You can use you own lua code within the <waypoint></waypoint> tags. By doing that you can do nearly everything. And there are some prefabricated functions:

To use some of that functions, simply put them into the waypoint tag:<source lang="xml"><waypoint x="799" z="-426">player:restrnd(20, 1, 10);</waypoint>
</source>

'''Caution!!! You must place the codes within the '<waypoint></waypoint>' tag. Not before and not after.'''

'''Thats wrong:'''
<source lang="xml"><waypoints type="TRAVEL" >player:harvest();
<waypoint x="-2060" z="-8216"></waypoint>
</waypoints>
</source>

== List of functions ==

<source lang="lua">player:harvest();</source>Scan that waypoint for a harverst node and harvest that (at the moment only working if the RoM window is in foreground)

<source lang="lua">load_paths( [path] [,returnpath] );</source>Load a new waypoint file and if available the default return path to that file. e.g. 'load_paths("l7-9");' will load the waypoint path 'l7-9.xml' and if available the return path 'l7-9_return.xml'.

<source lang="lua">if( player.Level > 9 ) then
printf("do some other coding stuff");
end;
</source>Do something only if you have a given level. Can be usefull to load a new waypoint file only after you get that level.

<source lang="lua">__WPL:reverse();</source>Resort the waypoints. Means after running from 1 to 20 you can now run from 20 - 1. It is usefull to put that at the first and at the last waypoint if you want to run between two places.

<source lang="lua">__WPL:setForcedWaypointType( [["NORMAL"] | ["TRAVEL"] | ["RUN"]]);</source>Set a forced waypoint type. The waypoint type overwrites the type settings within the waypoint file. The forced waypoint type is valid until you load a new waypoint file or you call the function '__WPL:setForcedWaypointType();' without argument.

<source lang="lua">player:restrnd([probability [, minrest [, maxrest]]]);</source>e.g. 'player:restrnd(30, 3, 10);' Rest with a probability from 30% at that waypoint for between 3 and 10 seconds. The bot will fight back if attacked while resting and continue after that. Similar functions are 'stopPE()' and 'player.sleep()'.

<source lang="lua">player:rest( minrest [, maxrest[, time|full[, restaddrnd]]])</source>

minrest ( min time to rest in sec)
maxrest ( max time to in sec)
_resttype ( time | full ) time = rest the given time | full = stop resting after being full / default = time
_restaddrnd ( max random addition after being full in sec)

If using type 'full', the bot will only rest if HP or MP is below a defined level. You define that level in your profile with the options:<source lang="lua"><option name="HP_REST" value="15" />
<option name="MP_REST" value="15" /></source>
Default value if not defined is 15% each.

e.g.
player:rest(20) will rest for 20 seconds.
player:rest(60, 20) will rest between 60 and 80 seconds.
player:rest(90, 40, "full") will rest up to between 90 and 130 seconds, and stop resting if being full
player:rest(90, 40, "time") will rest up to between 90 and 130 seconds, and not stop resting if being full
player:rest(20, 40, "full, 20") will rest up to between 20 and 60 seconds, and stop resting if being full, and wait after that between 1-20 seconds

<source lang="lua">stopPE();</source>Pause the bot at that waypoint. The bot will not react anymore. Press DEL if you want to resume the bot. Similar functions are 'player.restrnd()' and 'player.sleep()'.

<source lang="lua">player:sleep();</source>Pause the bot at that waypoint in a sleep mode. The bot will still fight back attackers and sleep again after doing that. Press DEL if you want to continue. Similar functions are 'player.restrnd()' and 'stopPE()'.

<source lang="lua">player:logout([true])</source>Logout from RoM. With 'player:logout(true)' you will also shutdown your pc after loging out.

<source lang="lua">if( os.difftime(os.time(), player.BotStartTime) > 3600 ) then
printf("do some other coding stuff");
end;
</source>Do something, if the bot is running for more then 1 hour (= 3600 seconds). If you pause the bot, the BotStartTime will be reseted.

<source lang="lua">player:target_NPC( [npc_name] );</source>It will try to target the NPC 'npc_name' and open the dialog window. If it is a merchant and you have a ingame autorepair addon (e.g. [http://rom.curse.com/downloads/rom-addons/details/streamline.aspx Streamline]), it will autorepair.

<source lang="lua">player:mouseclickL(x, y [RoM window wide, RoM window high]);</source>Left click a screen point and by that, interact with a NPC. x, y is relative to the RoM window. So it is your fiddly task to find the right values to click the right buttons. Remember the RoM windows size for that click positions. By doing that, we can later recalculate the mouse click points if we run the bot in a different RoM windows size.

== How to use the bot for running between the and NPC <-> blackboard for delivering of daily quests ==
It starts in Harf. There you have the quest 'Winterspinnenarten' from the blackboard where you deliver 10 winter spider body liquids to the 'Lager im Winternachttal'.

The waypoints are from the blackbard in Harf up to the camp. After each end of the waypoint file is a PAUSE. So you can handle with the NPC/blackboard and after that press 'DEL' to reverse the waypoints and run back.<source lang="xml"><waypoints type="RUN">
<waypoint x="-14389" z="-380" type="TRAVEL">__WPL:reverse();
player:sleep();</waypoint>
<waypoint x="-14531" z="-253"></waypoint>
...
<waypoint x="-18500" z="-2516 type="TRAVEL" >__WPL:reverse();
player:sleep();
</waypoint>
</waypoints></source>
The type of the waypoints is 'RUN' so the bot will not stop and not fight back, if getting aggro. Only the first an the last WP has type TRAVEL to fight back still sticking mobs.

Some hints: If you deliver the quest with a low level char, than set your loot option (<option name="LOOT" value="true" />) in your profile to 'false'. That will prevent from coming closer to mob groups while looting. It also could be helpful, to reduce your option 'WAYPOINT_DEVIATION' or set it to 0 (and set back to a higher value for normal botting).

== Automatic leveling with the Bot ==
Thats an example how to start with level 1 and change the botting place depending from your level.

We start at the spawn point:<source lang="xml"><waypoints type="TRAVEL" >
<waypoint x="-3779" z="-8480"></waypoint>
...
<waypoint x="-3034" z="-9034">load_paths("l2-3.xml");</waypoint>
</waypoints></source>At the last waypoint, we load the waypoint path file 'l2-3.xml' and if available the default returnpath 'l2-3_return.xml" and go to the closest waypoint from that waypoint file. We use waypoint type TRAVEL to not targeting mobs while moving to our area (not really neccessary here :-) )

Now we are at that place:
<source lang="xml"><waypoints type="NORMAL" >
<waypoint x="-2206" z="-9648"></waypoint>
<waypoint x="-2133" z="-9796">player:restrnd(20, 1, 10);</waypoint>
<waypoint x="-2224" z="-9882">player:restrnd(20, 1, 10);</waypoint>
...
<waypoint x="-2391" z="-9639">
if( player.Level > 4 ) then
load_paths("l5_goto_6.xml");
end;
</waypoint>
</waypoints>
</source>
If we reach level 5, we load the next waypoint file.

If you want to autorepair then [url=http://www.solarstrike.net/phpBB3/viewtopic.php?f=21&t=496]read here[/url] for more informations about that.

← Older revision		Revision as of 13:40, 8 August 2011
Line 70:		Line 70:

	<source lang="lua">player:mouseclickL(x, y [RoM window wide, RoM window high]);</source>Left click a screen point and by that, interact with a NPC. x, y is relative to the RoM window. So it is your fiddly task to find the right values to click the right buttons. Remember the RoM windows size for that click positions. By doing that, we can later recalculate the mouse click points if we run the bot in a different RoM windows size.		<source lang="lua">player:mouseclickL(x, y [RoM window wide, RoM window high]);</source>Left click a screen point and by that, interact with a NPC. x, y is relative to the RoM window. So it is your fiddly task to find the right values to click the right buttons. Remember the RoM windows size for that click positions. By doing that, we can later recalculate the mouse click points if we run the bot in a different RoM windows size.
		+
		+	<source lang="lua">__WPL:getFileName();</source>Returns the name of the waypoint file as string (e.g. "l1t_start.xml"). The string will not contain any information about the path of the file.

	== How to use the bot for running between the and NPC <-> blackboard for delivering of daily quests ==		== How to use the bot for running between the and NPC <-> blackboard for delivering of daily quests ==

← Older revision		Revision as of 08:48, 29 September 2009
Line 108:		Line 108:
	If we reach level 5, we load the next waypoint file. Read here for more Informations about [http://www.solarstrike.net/wiki/index.php5?title=RoM_Leveling automatic leveling]		If we reach level 5, we load the next waypoint file. Read here for more Informations about [http://www.solarstrike.net/wiki/index.php5?title=RoM_Leveling automatic leveling]

−	~~If you want to autorepair then~~ [~~url=~~http://www.solarstrike.net/wiki/index.php5?title=RoM_Auto_repair]~~read here[/url] for more informations about that~~.	+	Read here for further informations [http://www.solarstrike.net/wiki/index.php5?title=RoM_Auto_repair about autorepair].

@@ Line 75: / Line 75: @@
 The waypoints are from the blackbard in Harf up to the camp. After each end of the waypoint file is a PAUSE. So you can handle with the NPC/blackboard and after that press 'DEL' to reverse the waypoints and run back.<source lang="xml"><waypoints type="RUN">
-	<!-- # 1 --><waypoint x="-14389" z="-380" type="TRAVEL">__WPL:reverse();
+	<!-- # 1 --><waypoint x="-14389" z="-380" type="TRAVEL">__WPL:setDirection( WPT_FORWARD );
 	player:sleep();</waypoint>
 	<!-- # 2 --><waypoint x="-14531" z="-253"></waypoint>
 	...
-	<!-- #21 --><waypoint x="-18500" z="-2516 type="TRAVEL" >__WPL:reverse();
+	<!-- #21 --><waypoint x="-18500" z="-2516 type="TRAVEL" >__WPL:setDirection( WPT_BACKWARD );
 	player:sleep();
 	</waypoint>
@@ Line 86: / Line 86: @@
 Some hints: If you deliver the quest with a low level char, than set your loot option (<option name="LOOT" value="true" />) in your profile to 'false'. That will prevent from coming closer to mob groups while looting. It also could be helpful, to reduce your option 'WAYPOINT_DEVIATION' or set it to 0 (and set back to a higher value for normal botting).
 == Automatic leveling with the Bot ==

@@ Line 27: / Line 27: @@
 </source>Do something only if you have a given level. Can be usefull to load a new waypoint file only after you get that level.
-<source lang="lua">__WPL:reverse();</source>Resort the waypoints. Means after running from 1 to 20 you can now run from 20 - 1. It is usefull to put that at the first and at the last waypoint if you want to run between two places.
+<source lang="lua">__WPL:reverse();</source>Resort the waypoints. Means after running from 1 to 20 you can now run from 20 - 1. It is strongly recommended to use '__WPL:setDirection(..)' instead of this function.
 <source lang="lua">__WPL:setForcedWaypointType( [["NORMAL"] | ["TRAVEL"] | ["RUN"]]);</source>Set a forced waypoint type. The waypoint type overwrites the type settings within the waypoint file. The forced waypoint type is valid until you load a new waypoint file or you call the function '__WPL:setForcedWaypointType();' without argument.

@@ Line 106: / Line 106: @@
 </waypoints>
 </source>
-If we reach level 5, we load the next waypoint file.
+If we reach level 5, we load the next waypoint file. Read here for more Informations about [http://www.solarstrike.net/wiki/index.php5?title=RoM_Leveling automatic leveling]
-If you want to autorepair then [url=http://www.solarstrike.net/phpBB3/viewtopic.php?f=21&t=496]read here[/url] for more informations about that.
+If you want to autorepair then [url=http://www.solarstrike.net/wiki/index.php5?title=RoM_Auto_repair]read here[/url] for more informations about that.

@@ Line 10: / Line 10: @@
 '''Caution!!! You must place the codes within the '<waypoint></waypoint>' tag. Not before and not after.'''
-'''Thats wrong:'''
+'''This is wrong:'''
 <source lang="xml"><waypoints type="TRAVEL" >player:harvest();
 	<!-- # 1 --><waypoint x="-2060" z="-8216"></waypoint>
 </waypoints>
 </source>
 == List of functions ==

RoM Working with waypoint files - Revision history

Elverion: Reverted edits by 91.121.27.33 (Talk) to last revision by Pumbatoo

91.121.27.33: Love Abacus

Pumbatoo: /* List of functions */ Added __WPL:getFileName() description

Pumbatoo: /* How to use the bot for running between the and NPC blackboard for delivering of daily quests */ replaced __WPL:reverse() by __WPL:setDirection(..)

Pumbatoo: /* List of functions */ added function __WPL:setDirection(..)

95.115.19.246: /* Automatic leveling with the Bot */

95.115.19.246: /* Automatic leveling with the Bot */

Elverion: /* LUA code within a waypoint file */

D003232: New page: Here some examples how to work with waypoint files. It shows examples for different types of waypoint files and some special solutions. == LUA code within a waypoint file == You can use ...

Pumbatoo: /* How to use the bot for running between the and NPC blackboard for delivering of daily quests */ replaced WPL:reverse() by WPL:setDirection(..)