Um breve tutorial sobre a utilização da include y_hooks para a modularização de sistemas no SA-MP.
Repositório: https://github.com/Gomaink/Tutorial-Y-Hooks
1. Instalação
Na instalação é onde muitos se perdem, porém é algo muito simples de ser feito.
Acesse o GitHub do Y_Less e baixe a biblioteca YSI.
Link do GitHub: https://github.com/pawn-lang/YSI-Includes<br>
Link para download direto: https://www.mediafire.com/file/koiqd2q9m...s.zip/file
Se optou em baixar pelo GitHub, clique em Code e depois em Download Zip como na imagem.
![[Imagem: ezF5hRB.png]](https://i.imgur.com/ezF5hRB.png)
Caso contrário e você tenha optado pelo mediafire, apenas clique no botão download como na imagem.
![[Imagem: svJ60iA.png]](https://i.imgur.com/svJ60iA.png)
Após a instalação, extraia o arquivo após isso irá lhe dar uma pasta com o nome "YSI-Includes" ou algo parecido.
![[Imagem: mHVoy3i.png]](https://i.imgur.com/mHVoy3i.png)
Clique sobre a pasta, pressione o botão direito do mouse e clique em copiar, após isso vá até a pasta de seu gamemode e cole em pawno/includes.
2. Utilizando
Primeiro de tudo, precisamos criar uma pasta onde se localizará os módulos de seu Gamemode, ele deve estar na pasta principal de seu GM e não pode conter espaços ou números, você pode optar por algo como: modulos ou modules.
![[Imagem: vHojpTR.png]](https://i.imgur.com/vHojpTR.png)
Após a criação da pasta, devemos criar os seus módulos, use uma extensão como .pwn/.inc/.sys.
![[Imagem: ajOKS0N.png]](https://i.imgur.com/ajOKS0N.png)
Dentro do arquivo criado, podemos começar definindo o uso da include y_hooks que será responsável pela modularização de seu Gamemode, use:
#include <YSI-Includes\YSI_Coding\y_hooks>
![[Imagem: gBBUmHW.png]](https://i.imgur.com/gBBUmHW.png)
Após isso, você precisa vincular o módulo ao Gamemode, você pode usar:
#include "../suapastademodulos/nomedoseumodulo"
Você deve fazer isso antes da main ou no final do gamemode.
![[Imagem: Zx7spjj.png]](https://i.imgur.com/Zx7spjj.png)
IMPORTANTE: Você deve definir a include y_hooks em todos os seus módulos!
3. Callbacks
Para a utilização de callbacks em módulos é bem simples, você deve apenas trocar o nome "public" por "hook" em seu módulo, algo como:
![[Imagem: NvQCI8Q.png]](https://i.imgur.com/NvQCI8Q.png)
Após isso você pode utilizar a callback dentro de seu módulo sem problemas.
IMPORTANTE: A ordem em que você declara seu módulo no seu GM principal vai interferir na ordem de acontecimentos, por exemplo: Você criou um módulo onde dá pontos para uma pessoa ao matar alguém e também cria um módulo onde salva as contas ao desconectar, se você declarar o módulo de salvar ao desconectar antes do módulo de dar pontos a pessoa, não irá salvar os pontos pelo fato da ordem (Espero que isso tenha ficado claro pois é muito importante).
4. Útil
Algumas informações úteis.
Includes - Ao declarar uma include no GM principal, ela será vinculada a todos os módulos, por tanto não é necessário declarar uma include duas vezes.
Comandos - A utilização de comandos é totalmente permitida nos módulos, você pode utilizar tanto a Callback nativa quanto um processador de comandos como ZCMD ou Pawn.CMD, basta declara-lo no GM principal.
Órdem dos módulos: Já citei antes mas é importante; A ordem em que você declara seu módulo no seu GM principal vai interferir na ordem de acontecimentos, por exemplo: Você criou um módulo onde dá pontos para uma pessoa ao matar alguém e também cria um módulo onde salva as contas ao desconectar, se você declarar o módulo de salvar ao desconectar antes do módulo de dar pontos a pessoa, não irá salvar os pontos pelo fato da ordem.
Exagear - Provavelmente a biblioteca YSI não será compilada no Exagear, impossibilitando o uso da modularização pelo y_hooks
Erros: Qualquer erro ortográfico ou alguma dúvida na utilização, me contate em meu discord: gomaink#3403
Repositório: https://github.com/Gomaink/Tutorial-Y-Hooks
1. Instalação
Na instalação é onde muitos se perdem, porém é algo muito simples de ser feito.
Acesse o GitHub do Y_Less e baixe a biblioteca YSI.
Link do GitHub: https://github.com/pawn-lang/YSI-Includes<br>
Link para download direto: https://www.mediafire.com/file/koiqd2q9m...s.zip/file
Se optou em baixar pelo GitHub, clique em Code e depois em Download Zip como na imagem.
Caso contrário e você tenha optado pelo mediafire, apenas clique no botão download como na imagem.
Após a instalação, extraia o arquivo após isso irá lhe dar uma pasta com o nome "YSI-Includes" ou algo parecido.
Clique sobre a pasta, pressione o botão direito do mouse e clique em copiar, após isso vá até a pasta de seu gamemode e cole em pawno/includes.
2. Utilizando
Primeiro de tudo, precisamos criar uma pasta onde se localizará os módulos de seu Gamemode, ele deve estar na pasta principal de seu GM e não pode conter espaços ou números, você pode optar por algo como: modulos ou modules.
Após a criação da pasta, devemos criar os seus módulos, use uma extensão como .pwn/.inc/.sys.
Dentro do arquivo criado, podemos começar definindo o uso da include y_hooks que será responsável pela modularização de seu Gamemode, use:
#include <YSI-Includes\YSI_Coding\y_hooks>
Após isso, você precisa vincular o módulo ao Gamemode, você pode usar:
#include "../suapastademodulos/nomedoseumodulo"
Você deve fazer isso antes da main ou no final do gamemode.
IMPORTANTE: Você deve definir a include y_hooks em todos os seus módulos!
3. Callbacks
Para a utilização de callbacks em módulos é bem simples, você deve apenas trocar o nome "public" por "hook" em seu módulo, algo como:
Após isso você pode utilizar a callback dentro de seu módulo sem problemas.
IMPORTANTE: A ordem em que você declara seu módulo no seu GM principal vai interferir na ordem de acontecimentos, por exemplo: Você criou um módulo onde dá pontos para uma pessoa ao matar alguém e também cria um módulo onde salva as contas ao desconectar, se você declarar o módulo de salvar ao desconectar antes do módulo de dar pontos a pessoa, não irá salvar os pontos pelo fato da ordem (Espero que isso tenha ficado claro pois é muito importante).
4. Útil
Algumas informações úteis.
Includes - Ao declarar uma include no GM principal, ela será vinculada a todos os módulos, por tanto não é necessário declarar uma include duas vezes.
Comandos - A utilização de comandos é totalmente permitida nos módulos, você pode utilizar tanto a Callback nativa quanto um processador de comandos como ZCMD ou Pawn.CMD, basta declara-lo no GM principal.
Órdem dos módulos: Já citei antes mas é importante; A ordem em que você declara seu módulo no seu GM principal vai interferir na ordem de acontecimentos, por exemplo: Você criou um módulo onde dá pontos para uma pessoa ao matar alguém e também cria um módulo onde salva as contas ao desconectar, se você declarar o módulo de salvar ao desconectar antes do módulo de dar pontos a pessoa, não irá salvar os pontos pelo fato da ordem.
Exagear - Provavelmente a biblioteca YSI não será compilada no Exagear, impossibilitando o uso da modularização pelo y_hooks
Erros: Qualquer erro ortográfico ou alguma dúvida na utilização, me contate em meu discord: gomaink#3403
