CoreClr (.NET Core Common Language Runtime) module
Only use the beta versions when you use the beta server from https://altv.mp/#/downloads
Download from https://altv.mp/#/downloads, you can select stable or beta and windows or linux.
Folder Structure
modules/
└── csharp-module.dll
└── node-module.dll
resources/
└── my-example-csharp-resource/
├── Alt.Net.Example.dll
├── resource.cfg
└── ... (any .dll dependency like "AltV.Net.dll" or "mysql.dll")
└── my-example-client-resource/
├── index.mjs
├── client.mjs
└── resource.cfg
AltV.Net.Host.dll
AltV.Net.Host.runtimeconfig.json
server.cfg
altv-server.exe
- Add csharp-module to server.cfg
...
modules: ["csharp-module"]
...
or with node-module
...
modules: [
"csharp-module"
"node-module"
]
...
resource.cfg:
type: "csharp",
main: "AltV.Net.Example.dll"
(empty index.mjs) resource.cfg:
type: "js",
main: index.mjs
client-main: "client.mjs",
client-files: [ "client.mjs" ]
client-files specify files downloaded by the client
client-files: [
"file1.mjs"
"file2.mjs"
index.html
image.png
]
"" around files are optional
wildcards are also supported
client-files: [
"client/*"
]
server.cfg:
resources: [
"login-screen"
]
client file imports are based on ecmascript2015 imports https://developer.mozilla.org/de/docs/Web/JavaScript/Reference/Statements/import
but require full path import like import * as auth from 'client/auth.mjs'; (relative from resource folder)
- https://www.nuget.org/packages/AltV.Net
- optional async module https://www.nuget.org/packages/AltV.Net.Async
.NET Core SDK can be found here. You have to install the sdk, the runtime isn't needed.
- Go to "File -> New -> Project..." now the Project Wizard should appear.
- In the left Column select "Installed -> Visual C# -> .NET Core".
- Now select "Class Library (.NET Core)" and choose "Name", "Location" and the "Solution name".
- To setup the correct NuGet Packages open the Manager under "Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution..."
- Select Browse and search for AltV.Net and install the packages "AltV.Net", ("AltV.Net.Async" when you need async thread save api access)
- Now go to "Project -> {Your Project Name} Properties... -> Build", here you can select the Output path where the dll should be saved.
To get the Resource running on the server, you have to create a "resource.cfg" file. Copy the resource.cfg, AltV.Net.dll and all other dependencied with your resource dll file to altv-server/resources/{YourResourceName}/.
Boilerplate AltV.Net.Example.csproj:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp3.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<!--Use latest version from https://www.nuget.org/packages/AltV.Net-->
<PackageReference Include="AltV.Net" Version="1.13.0" />
</ItemGroup>
<!--This copies the publish directory to the resource folder which is named "my-server"-->
<ItemGroup>
<AllOutputFiles Include="$(OutputPath)\publish\*.*" />
</ItemGroup>
<Target Name="CopyFiles" AfterTargets="publish">
<PropertyGroup>
<CopiedFiles>$(OutputPath)\publish\*.*</CopiedFiles>
<TargetLocation Condition=" '$(Configuration)' == 'Release' ">../../my-server/</TargetLocation>
</PropertyGroup>
<Copy Condition=" '$(TargetLocation)' != '' " SourceFiles="@(AllOutputFiles)" DestinationFolder="$(TargetLocation)" SkipUnchangedFiles="false" />
</Target>
</Project>
MyResource.cs
using System;
namespace My.Package
{
internal class MyResource : Resource
{
public override void OnStart()
{
Alt.OnServerEvent += (name, args) => { Alt.Log(name + " " + args.Length); };
Alt.Emit("test");
Console.WriteLine("Started");
}
public override void OnStop()
{
Console.WriteLine("Stopped");
}
}
}Alt.OnPlayerConnect += OnPlayerConnect;
Alt.OnPlayerDisconnect += OnPlayerDisconnect; (play disconnected)
Alt.OnPlayerRemove += OnPlayerRemove; (player entity removed from memory)
Alt.OnVehicleRemove += OnVehicleRemove;
Alt.OnConsoleCommand += (name, args) => { };
Alt.OnPlayerEvent += (player, name, args) => { Alt.Log("event:" + name); }; (generic event handler for all event names)
...(and a lot more)
Alt.Emit is used to illustrate event triggering from server -> server, in most use cases the client would trigger the events.
null, bool, int, uint, long, ulong, double, string, object, float
All types above as an array, eg. int [], string[], ....
Furthermore Dictionaries with string-Type as Key, eg. Dictionary<string, object>
But also all interfaces of the AltV API or extend these, eg. IEntity, IVehicle, IBlip, ICheckpoint, MyVehicle ...
Alt.On("test", args => { Alt.Log("args=" + args[0]); });
Alt.Emit("test", "bla");Alt.On<string>("test", str => { Alt.Log("str=" + str); });
Alt.Emit("test", "bla");Alt.On("test", delegate(string str){ Alt.Log("str=" + str); });
Alt.Emit("test", "bla");Alt.On<string>("test", bla);
void bla(string str) {
Alt.Log("str=" + str);
}
Alt.Emit("test", "bla");The first Generics (in our example below int and string) are the Types for the parameters, the last generic (bool) is the return-type.
Note: Return types are optional at events
Alt.On<int, string, bool>("test", (number, str) => {
Alt.Log("str=" + str + " - " + number);
return true;
});You can send objects when the objects are implementing IWritable.
e.g.
List<WritableObject> objects;
player.Emit("objects", objects);WritableObject.cs:
public class WritableObject : IWritable
{
private readonly string test;
public WritableObject()
{
test = "123";
}
public void OnWrite(IMValueWriter writer)
{
writer.BeginObject();
writer.Name("test");
writer.Value(test);
writer.EndObject();
}
}Needed when you want to improve performance by not using entity.GetData(..), entity.SetData(...) but entity.MyData... instead
SampleResource.cs:
public class SampleResource : Resource
...
public override IEntityFactory<IVehicle> GetVehicleFactory()
{
return new MyVehicleFactory();
}
...(also supports player, blip, checkpoint, ....)MyVehicleFactory.cs:
namespace My.Package
{
public class MyVehicleFactory : IEntityFactory<IVehicle>
{
public IVehicle Create(IntPtr vehiclePointer, ushort id)
{
return new MyVehicle(vehiclePointer, id);
}
}
}MyVehicle.cs
namespace AltV.Net.Example
{
public class MyVehicle : Vehicle, IMyVehicle
{
public int MyData { get; set; }
public MyVehicle(IntPtr nativePointer, ushort id) : base(nativePointer, id)
{
MyData = 6;
}
}
}All entity apis can be found in the interfaces of the entities IPlayer IVehicle IBlip ICheckpoint
https://fabianterhorst.github.io/coreclr-module/articles/colshapes-example.html
https://fabianterhorst.github.io/coreclr-module/articles/entity-sync.html