Een gids voor het maken van uw eerste plug-in.
Informatie
Je hebt waarschijnlijk Visual Studio 2019 Community Edition nodig. Daarnaast vertelt deze gids je niet hoe je eerst je project moet opzetten. Hier is een video over hoe je dat doet (je kunt in plaats daarvan ook de tutorialserie bekijken die door die maker is gemaakt):
Uw eerste plug-in maken
Het maken van plug-ins voor Unturned vereist een algemene kennis van C#. Als je momenteel geen kennis hebt van C#, kijk dan eens Microsoft's inleiding tot de taal.
Alle plug-ins beginnen normaal gesproken met een klasse die de `RocketPlugin`-klasse overerft. Hieronder ziet u een voorbeeld van hoe u dit op de juiste manier implementeert:
met behulp van Rocket.API; met behulp van Rocket.Core.Plugins; namespace ExamplePlugin { public class ExamplePlugin : RocketPlugin { } }
Zie je hoe de klasse `ExamplePlugin` openbaar is? Dit is zodat we het toegankelijk kunnen maken voor RocketMod.
Verderop kunt u nu de methoden `Load` en `Unload` in de klasse `RocketPlugin` overschrijven om het laden en lossen van uw plug-in te loggen:
met behulp van Rocket.API; met behulp van Rocket.Core.Plugins; met behulp van Rocket.Unturned; met behulp van Rocket.Unturned.Chat; Rocket.Unturned.Player gebruiken; met behulp van Rocket.Core.Logging; namespace ExamplePlugin { public class ExamplePlugin : RocketPlugin { beschermde override void Load() { Logger.Log("Voorbeeld plug-in geladen!"); } beschermde override leegte Unload() { Logger.Log("Voorbeeld plug-in verwijderd!"); } } }
De plug-in logt nu in op de serverconsole dat de plug-in is geladen en verwijderd.
U kunt zich ook abonneren op en afmelden voor evenementen wanneer de plug-in wordt geladen en verwijderd:
met behulp van Rocket.API; met behulp van Rocket.Core.Plugins; met behulp van Rocket.Unturned; met behulp van Rocket.Core.Logging; namespace ExamplePlugin { public class ExamplePlugin : RocketPlugin { beschermde override void Load() { Logger.Log("Voorbeeld plug-in geladen!"); U.Events.OnPlayerConnected += OnPlayerConnected; } beschermde override leegte Unload() { Logger.Log("Voorbeeld plug-in verwijderd!"); U.Events.OnPlayerConnected -= OnPlayerConnected; } openbare leegte OnPlayerConnected(UnturnedPlayer-speler) { } } }
De plug-in schrijft zich nu in en uit voor het evenement `U.Events.OnPlayerConnected` bij laden en lossen.
Je kunt de speler nu ook begroeten wanneer hij verbinding maakt met de server:
met behulp van Rocket.API; met behulp van Rocket.Core.Plugins; met behulp van Rocket.Unturned; met behulp van Rocket.Core.Logging; namespace ExamplePlugin { public class ExamplePlugin : RocketPlugin { beschermde override void Load() { Logger.Log("Voorbeeld plug-in geladen!"); U.Events.OnPlayerConnected += OnPlayerConnected; } beschermde override leegte Unload() { Logger.Log("Voorbeeld plug-in verwijderd!"); U.Events.OnPlayerConnected -= OnPlayerConnected; } public void OnPlayerConnected(UnturnedPlayer player) { // Doe iets wanneer een speler UnturnedChat.Say(player, "Welcome to the server!") verbindt; } } }
Tot slot zal deze plug-in een bericht loggen wanneer deze wordt geladen en gelost, en spelers begroeten wanneer ze verbinding maken met de server. Natuurlijk kunt u de plug-in aanpassen om te doen wat u maar wilt.
Dat is alles wat we hiervoor vandaag delen ongekeerd gids. Deze handleiding is oorspronkelijk gemaakt en geschreven door Jdans. Als we deze handleiding niet kunnen bijwerken, kunt u de laatste update vinden door deze te volgen link.