I have released InSim.NET 2.0.0 Beta to CodePlex project site. The download link can be found here:
http://insimdotnet.codeplex.com/releases/
Features in this release
- Full InSim, InSim Relay, OutSim and OutGauge support
- Better support for .NET languages other than C#
- Improvements to string encoding/decoding
- General API improvements
- Mercurial source control repository
Changes
There are quite a few changes in this release, although most stuff will be familiar to people who have used to library before. There are too many changes to recount from the top of my head but I'll try to give the bullet-points.
InSim
Firstly the biggest change you'll notice is that you now initialize the InSim connection differently. To initialize the connection you now use the new InSim.Initialize(InSimSettings) method. Like so:
using System;
using InSimDotNet;
class Program
{
static void Main()
{
// Create new InSim object.
using (InSim insim = new InSim())
{
// Initialize InSim.
insim.Initialize(new InSimSettings
{
Host = "127.0.0.1",
Port = 29999,
Admin = String.Empty,
});
// Send message 'Hello, InSim!' to the game chat.
insim.Send("/msg Hello, InSim!");
// Stop program from exiting.
Console.WriteLine("Press any key to exit...");
Console.ReadKey(true);
}
}
}
Also the way in which you bind packets has changed slightly, as you now must always specify a InSim parameter on the packet handler. Like this:
using System;
using InSimDotNet;
using InSimDotNet.Packets;
class Program
{
static void Main()
{
using (InSim insim = new InSim())
{
// Bind packet handler.
insim.Bind<IS_MSO>(MessageOut);
insim.Initialize(new InSimSettings
{
Host = "127.0.0.1",
Port = 29999,
Admin = String.Empty,
});
// Stop program from exiting.
Console.WriteLine("Press any key to exit...");
Console.ReadKey(true);
}
}
// Packet handler now must specify a InSim parameter.
static void MessageOut(InSim insim, IS_MSO mso)
{
Console.WriteLine(mso.Msg);
}
}
With the changes to the way you initialize InSim, you can now specify a separate UDP port for MCI and NLP updates.
using System;
using InSimDotNet;
using InSimDotNet.Packets;
class Program
{
static void Main()
{
using (InSim insim = new InSim())
{
insim.Bind<IS_MCI>(MultiCarInfo);
insim.Initialize(new InSimSettings
{
Host = "127.0.0.1",
Port = 29999,
Admin = String.Empty,
UdpPort = 30000, // Specify UDP port
Interval = 1000, // Update interval (milliseconds)
Flags = InSimFlags.ISF_MCI, // Enable MCI updates
});
// Stop program from exiting.
Console.WriteLine("Press any key to exit...");
Console.ReadKey(true);
}
}
// Handle MCI packet.
static void MultiCarInfo(InSim insim, IS_MCI mci)
{
foreach (CompCar car in mci.Info)
{
// Do something with CompCar.
}
}
}
InSim Relay
InSim relay works exactly as before, except now you initialize it by setting the InSimSettings.IsRelayHost property to true.
using System;
using InSimDotNet;
class Program
{
static void Main()
{
using (InSim insim = new InSim())
{
insim.Initialize(new InSimSettings
{
IsRelayHost = true, // Initialize InSim Relay.
});
// Stop program from exiting.
Console.WriteLine("Press any key to exit...");
Console.ReadKey(true);
}
}
}
When IsRelayHost is set all other settings are ignored.
OutGauge and OutSim
There is now full OutSim and OutGauge support. Here is an example of using OutSim.
using System;
using InSimDotNet.Out;
class Program
{
static void Main()
{
// Create new OutSim object.
using (OutSim outsim = new OutSim())
{
// Bind OutSim packet event.
outsim.PacketReceived += new EventHandler<OutSimEventArgs>(outsim_PacketReceived);
// Start listening for packets sent from LFS.
outsim.Connect("127.0.0.1", 30000);
// Stop program from exiting.
Console.WriteLine("Press any key to exit...");
Console.ReadKey(true);
}
}
static void outsim_PacketReceived(object sender, OutSimEventArgs e)
{
// Do something with packet.
OutSimPack packet = e.Packet;
}
}
Download
You can download the
InSim.NET 2.0.0 Beta from CodePlex right now!
Is this a bug or some kind of a limit by you?