Una guía sobre cómo crear su primer complemento.
Información
Probablemente necesitará Visual Studio 2019 Community Edition. Además de eso, esta guía no le dice cómo configurar primero su proyecto. Aquí hay un video sobre cómo hacerlo (también puede ver la serie de tutoriales realizada por ese creador):
Creando su primer complemento
La creación de complementos para Unturned requiere un conocimiento general de C#. Si actualmente no tiene ningún conocimiento detrás de C#, consulte Introducción de Microsoft al lenguaje.
Todos los complementos normalmente comienzan con la clase que hereda la clase `RocketPlugin`. A continuación se muestra un ejemplo de cómo implementar esto correctamente:
utilizando Rocket.API; usando Rocket.Core.Plugins; espacio de nombres ExamplePlugin { public class ExamplePlugin : RocketPlugin { } }
¿Te das cuenta de que la clase `ExamplePlugin` es pública? Esto es para que podamos hacerlo accesible para RocketMod.
Continuando, ahora puede anular los métodos `Cargar` y `Descargar` contenidos dentro de la clase `RocketPlugin` para registrar la carga y descarga de su complemento:
utilizando Rocket.API; usando Rocket.Core.Plugins; usando Rocket.Unturned; usando Rocket.Unturned.Chat; usando Rocket.Unturned.Player; usando Rocket.Core.Logging; espacio de nombres ExamplePlugin { public class ExamplePlugin : RocketPlugin { protected override void Load() { Logger.Log("Ejemplo de complemento cargado!"); } protected override void Unload() { Logger.Log("¡Complemento de ejemplo descargado!"); } } }
El complemento ahora registrará en la consola del servidor que el complemento se ha cargado y descargado.
También puede suscribirse y cancelar la suscripción a eventos cuando el complemento se carga y descarga:
utilizando Rocket.API; usando Rocket.Core.Plugins; usando Rocket.Unturned; usando Rocket.Core.Logging; espacio de nombres ExamplePlugin { public class ExamplePlugin : RocketPlugin { protected override void Load() { Logger.Log("Ejemplo de complemento cargado!"); U.Events.OnPlayerConnected += OnPlayerConnected; } protected override void Unload() { Logger.Log("¡Complemento de ejemplo descargado!"); U.Events.OnPlayerConnected -= OnPlayerConnected; } public void OnPlayerConnected (reproductor UnturnedPlayer) { } } }
El complemento ahora se suscribe y cancela la suscripción al evento `U.Events.OnPlayerConnected` al cargar y descargar.
Ahora también puedes saludar al jugador cuando se conecta al servidor:
utilizando Rocket.API; usando Rocket.Core.Plugins; usando Rocket.Unturned; usando Rocket.Core.Logging; espacio de nombres ExamplePlugin { public class ExamplePlugin : RocketPlugin { protected override void Load() { Logger.Log("Ejemplo de complemento cargado!"); U.Events.OnPlayerConnected += OnPlayerConnected; } protected override void Unload() { Logger.Log("¡Complemento de ejemplo descargado!"); U.Events.OnPlayerConnected -= OnPlayerConnected; } public void OnPlayerConnected(UnturnedPlayer player) { // Hacer algo cuando un jugador se conecta a UnturnedChat.Say(player, "¡Bienvenido al servidor!"); } } }
Para concluir, este complemento registrará un mensaje cuando se cargue y descargue, y saludará a los jugadores cuando se conecten al servidor. Por supuesto, puede personalizar el complemento para que haga lo que quiera que haga.
Eso es todo lo que estamos compartiendo hoy para este No cesado guía. Esta guía fue originalmente creada y escrita por jdance. En caso de que no actualicemos esta guía, puede encontrar la última actualización siguiendo este liga.