Tutorial How to write a Game Plugin for SimTools 1.0 - API documentation

Game documentation, game support forum, contact with the developer, published literature, Google, monitoring known API calls, trial-and-error, previously published titles, etc…

Sorry for not fully understanding but when it comes to memory hooks with

Memory Hook Variables _Is_MemoryHook – if it is a memory hook game set to true. (See example plugin)
_MemoryHook_Roll – if it is a memory hook game; enter the memory location for roll.
_MemoryHook_Pitch – if it is a memory hook game; enter the memory location for pitch.
_MemoryHook_Heave – if it is a memory hook game; enter the memory location for heave.
_MemoryHook_Yaw – if it is a memory hook game; enter the memory location for yaw.
_MemoryHook_Sway – if it is a memory hook game; enter the memory location for sway.
_MemoryHook_Surge – if it is a memory hook game; enter the memory location for surge.
_MemoryHook_Extra1 – if it is a memory hook game; enter the memory location for surge.
_MemoryHook_Extra2 – if it is a memory hook game; enter the memory location for surge.
_MemoryHook_Extra3 – if it is a memory hook game; enter the memory location for surge.

If I have a game which has Roll for instance at memory location Example.exe+3806A4 and Pitch at Example.exe+557F68 would I enter it like this?

PrivateConst _Is_MemoryHook AsBoolean = True 'Is a Memory Hook Required for this game?
PrivateConst _MemHook_Roll AsUInteger = &3806A4
PrivateConst _MemHook_Pitch AsUInteger = &557F68
PrivateConst _MemHook_Heave AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Yaw AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Sway AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Surge AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Extra1 AsUInteger = 0
PrivateConst _MemHook_Extra2 AsUInteger = 0
PrivateConst _MemHook_Extra3 AsUInteger = 0

The pluguins soport dk2 To No Limits Rollercoaster Simulation 2.0.3

I'll ask again as i didnt get an answer. I know im pretty stupid

I'll slightly change my question

Memory Hook Variables _Is_MemoryHook – if it is a memory hook game set to true. (See example plugin)
_MemoryHook_Roll – if it is a memory hook game; enter the memory location for roll.
_MemoryHook_Pitch – if it is a memory hook game; enter the memory location for pitch.
_MemoryHook_Heave – if it is a memory hook game; enter the memory location for heave.
_MemoryHook_Yaw – if it is a memory hook game; enter the memory location for yaw.
_MemoryHook_Sway – if it is a memory hook game; enter the memory location for sway.
_MemoryHook_Surge – if it is a memory hook game; enter the memory location for surge.
_MemoryHook_Extra1 – if it is a memory hook game; enter the memory location for surge.
_MemoryHook_Extra2 – if it is a memory hook game; enter the memory location for surge.
_MemoryHook_Extra3 – if it is a memory hook game; enter the memory location for surge.

If I have a game which has Roll for instance at memory location 230654 and Pitch at 230543 would I enter it like this?

PrivateConst _Is_MemoryHook AsBoolean = True 'Is a Memory Hook Required for this game?
PrivateConst _MemHook_Roll AsUInteger = 230654
PrivateConst _MemHook_Pitch AsUInteger = 230543
PrivateConst _MemHook_Heave AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Yaw AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Sway AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Surge AsUInteger = 0 'Not Used = 0
PrivateConst _MemHook_Extra1 AsUInteger = 0
PrivateConst _MemHook_Extra2 AsUInteger = 0
PrivateConst _MemHook_Extra3 AsUInteger = 0

Pretty please can I get some help here

Essentially yes.

Ok cool thanks

Gives me something to try tonight then

well I tried and it doesn't work for me, I added 3 different addresses to 3 different forces but when I try to compile it gives an error

PrivateConst _MemHook_Roll AsUInteger = 206ECB30

is what I posted but it says Exponent is not valid

any ideas please

Looks like your variable is recognised as a number, you may want to use quotes around?

When you write hex numbers you must write
PrivateConst _MemHook_Roll AsUInteger = &H206ECB30

Yep sorry I got it sorted earlier

Sooooooooo ..... after the annoucement of PS4 UDP telemetry on Projet Cars, I'm now onto plugin development
I'm starting to study the LFS, which is UDP based.
Expect some stupid/dummy questions from me soon
First stupid question: as the PS4 is a remote system, with no simengine running on it, what shall I put on the process trigger ? "notepad.exe" so the Simengine becomes active when I fire-up a notepad ?

Starting to get mad

When I build and run the plugin in debug , I get the OK window.


If I add the DLL using game plugin updater (just drag/drop the DLL on the icon), it looks good:


Now, I start Game Engine and select my plugin, "et là, c'est le drame" :







unable to load file or assembly blabla.dll or one of its dependencies. Specified file is not found.

Then gameengine and game manager are crashing.

When switchinf to "release" build, same error. But whan clicking start, it triggers an error :


Is there an issue with my environment ?
What have I missed ?

Thanks for your help.

We all have our busy time, including me
Thanks ! You were right, I had a name mismatch. It works now. Can the debug DLL be used, or should it be the release DLL (which cant be run from visual studio)

Here is my roadmap:
- Make a VB UDP receiver that output decoded data to a flat file
- Integrate the UDP receiver in the plugin
- Test/Test/Test

If I understand correctly, the UDP listener is already included in the plugin:
Sub Process_PacketRecieved(Text As String) Implements IPlugin.Process_PacketRecieved

So when I get my simple code working, I would just have to integrate the decoding based on the Text variable of the Sub; that is this block code mainly :

With MyOutsim_Internal
Roll_Output = (.sngOrientation2 * 180 / 3.14159)
Pitch_Output = (.sngOrientation1 * 180 / 3.14159) * -1
Yaw_Output = (.sngOrientation0 * 180 / 3.14159)
Heave_Output = (System.Math.Cos(.sngOrientation2) * .sngAcceleration2)
Sway_Output = ((System.Math.Cos(.sngOrientation0) * .sngAcceleration0) + (System.Math.Sin(.sngOrientation0) * .sngAcceleration1))
Surge_Output = ((-System.Math.Sin(.sngOrientation0) * .sngAcceleration0) + (System.Math.Cos(.sngOrientation0) * .sngAcceleration1))
Extra1_Output = (((System.Math.Sin(.sngOrientation0) * .sngAcceleration0) + (System.Math.Sin(.sngOrientation0) * .sngAcceleration1)) * -1)
End With

Correct ?

Having crash issues with my plugin, I took the LFS sample, compiled it (without changing anything) and I get the same crash problem as soon as I send a UDP packet
I'm using Visual Studio Community 2015
The app is as follow:



Tried debug/release : same problem.
To install the game plugin, only the DLL needs to be dragged/dropped or should the whole directory be zipped and dragged/dropped onto the game plugin updater ?

Thanks for your help.

I like to study to make a plugin for gta5...
What kind of way does gta5 give its telemetry??

I read the post thoroughly.. but still don't know how to write a plugin... hahahahaha.. uhm.. I am so sad that I cannot understand it at all... so... could I get more tutorial or..explanation for code..line by line???

Hallo, very nice Tutorial, it really helped a lot.

I somehow cant compile it however, I get this:

Hi folks.

I'm looking for a bit (a lot) of programming help here please! I'm building a sim with four actuators similar to a D-Box system. I'm hoping to get a direct translation of the individual suspension travel for each of the actuators to more accurately model the movement of the car (my theory is that for motion cueing, rather than g-force simulation, this will give a more realistic feel to the drive of the vehicle).

I know that F1 2015 has data in its API showing the suspension position and velocity, but I'm struggling to work out how to access the UDP data within the sample plugin for LFS. I think I have found the variables I need to alter, but any help on where / how I should do this would be greatly appreciated!

Cheers,

Dave

SimEngine works with position (yaw/pitch/roll) and forces (heave/sway/surge).
So you will have to convert the suspension position to yaw/pitch/roll (which can make sense but you should endup with the same results given by the telemetry data ayway) , and do again some funny match to compute some heave/sway/surge (which can be strange for surge as suspension shouldnt show a great amount of surge for example). A sim with no forces will defenetly lack something (gear change, acceleration,....) and suspension will not give you accurate forces I think.
Back to your question now. I was in the same situation a couple of month ago. I finally ended by making a standalone app in VB that receives and parses the received UDP data. It is much more easy to dev/test a small standalone app in a console than going for the big picture. Learn to walk (even stand-up) before you run
This small UDP app will also speed-up the dev of new plugins. Once you small app gives the result you want, integrate it into the plugin

Code:

Imports System.Xml.Serialization
Imports System.Runtime.InteropServices
Imports System.IO
Imports System.Net.Sockets
Imports System.Net
Imports System.Text

Module Module1
Sub Main()
Dim UDPlistener As New UdpClient(5606)
Dim RemoteIpEndPoint As New IPEndPoint(IPAddress.Any, 0)
Dim UDPBytes As Byte()
Dim UDPSize As Int32
'File output handler
Dim oFileStream As System.IO.FileStream
oFileStream = New System.IO.FileStream("d:\bytes.bin", System.IO.FileMode.Append)
While (True)
If (UDPlistener.Available > 0) Then
Try
UDPBytes = UDPlistener.Receive(RemoteIpEndPoint)
oFileStream.Write(UDPBytes, 0, UDPBytes.Length)
oFileStream.Flush()
UDPSize = UDPBytes.Length
Console.WriteLine(("UDP message sent from " + RemoteIpEndPoint.Address.ToString() + " on their port number " + RemoteIpEndPoint.Port.ToString()))
For Each UDPbyte As Byte In UDPBytes
Console.Write(Hex(UDPbyte))
Console.Write(" ")
Next
Catch e As Exception
Console.WriteLine(e.ToString())
End Try
End If
End While
oFileStream.Close()
End Sub
End Module