Skip to content

README.md

Latest commit

 

History

History
94 lines (54 loc) · 3.27 KB

README.md

File metadata and controls

94 lines (54 loc) · 3.27 KB

Discord Bot za Upravljanje Članstvom

Ovaj Discord bot je dizajniran za automatizaciju verifikacije korisnika i upravljanja ulogama na vašem serveru na temelju statusa članstva i sekcijske pripadnosti. Integrira se s vanjskom OAuth uslugom i PostgreSQL bazom podataka kako bi uloge korisnika bile sinkronizirane.

Značajke

  • Verifikacija korisnika putem OAutha: Članovi mogu koristiti slash naredbu /register za pokretanje OAuth procesa, povezujući svoj Discord račun s verificiranom e-mail adresom.

  • Automatsko dodjeljivanje uloga: Automatski dodjeljuje Discord uloge (npr. "Plavi", "Narančasti", "Crveni") na temelju verificiranog statusa članstva korisnika preuzetog iz vanjske usluge.

  • Upravljanje sekcijskim ulogama: Dodjeljuje specifične sekcijske uloge (npr. "Comp", "Tech", "Glazbena", "Foto" itd.) korisnicima na temelju njihove verificirane sekcijske pripadnosti.

  • Dnevne provjere statusa članstva: Planirani zadatak se pokreće svakodnevno kako bi ponovno verificirao status članstva svih registriranih korisnika u odnosu na vanjsku uslugu i ažurira njihove uloge ako se otkriju bilo kakve promjene. Korisnici s ulogom "Crveni" automatski se preskaču iz ovih provjera.

  • Integracija s PostgreSQL bazom podataka: Sigurno pohranjuje verificirane Discord ID-ove korisnika i njihove pridružene privatne e-mail adrese za održavanje trajnih podataka.

Početak rada

Slijedite ove korake za pokretanje vašeg Discord bota za članstvo.

Preduvjeti

Prije nego što počnete, provjerite imate li instalirano i postavljeno sljedeće:

  • Python 3.8+: Preuzmite s python.org.

  • PostgreSQL poslužitelj baze podataka: Provjerite je li PostgreSQL instanca pokrenuta i dostupna.

  • Discord Bot aplikacija i token:

    1. Idite na Discord Developer Portal.

    2. Stvorite novu aplikaciju.

    3. Pod "Bot" dodajte bota i kopirajte njegov token.

    4. Omogućite PRESENCE INTENT i MESSAGE CONTENT INTENT pod odjeljkom "Privileged Gateway Intents".

  • ID Discord poslužitelja: Možete ga dobiti omogućavanjem Developer Modea u Discord postavkama, desnim klikom na vaš poslužitelj i odabirom "Copy ID".

  • Vanjska pozadinska usluga (Backend): Ovaj bot se oslanja na vanjsku uslugu (u kodu nazvanu "backend") koja radi na http://localhost:8000. Ova usluga je ključna za:

    • Generiranje OAuth veza.

    • Rukovanje OAuth povratnim pozivom.

    • Pružanje statusa članstva korisnika i informacija o sekciji na temelju njihove e-mail adrese.

    • Bot neće ispravno funkcionirati bez pokrenute pozadinske usluge.

Instalacija

  1. Stvorite Python virtualno okruženje

    python -m venv venv

  2. Aktivirajte virtualno okruženje:

    • Windows:

      .\venv\Scripts\activate

    • macOS/Linux:

      source venv/bin/activate

  3. Instalirajte ovisnosti: Stvorite datoteku requirements.txt u korijenskom direktoriju vašeg projekta sa sljedećim sadržajem:

    discord.py
aiohttp
psycopg2-binary
python-dotenv

    Zatim ih instalirajte:

    pip install -r requirements.txt