Naar inhoud springen

CoreBot/Plugin maken: verschil tussen versies

Uit Scriptspace Wiki
docs>wiki-docs
Geïmporteerd vanaf de pc van DieOuwe (wiki-docs)
k 1 versie geïmporteerd
 
(2 tussenliggende versies door dezelfde gebruiker niet weergegeven)
(geen verschil)

Huidige versie van 19 okt 2026 23:20

Een CoreBot-plugin maken

[bewerken]

Een plugin is een map in plugins/ van de bot met twee bestanden: plugin.json en main.py. De bot laadt alle plugins bij het starten. Een kapotte plugin houdt de rest niet tegen; na 10 fouten in 10 minuten gaat alleen die plugin uit.

plugin.json

[bewerken]
{
  "name": "mijnplugin",
  "title": "Mijn plugin",
  "version": "1.0.0",
  "tier": "free",
  "default_on": true,
  "min_bot": "0.6.1",
  "description": "Wat hij doet, in één zin."
}
  • name = mapnaam (kleine letters, cijfers, _).
  • default_on geldt als corebot.info voor die server niets over de plugin zegt.
  • Zet een nieuwe plugin ook in CB_PLUGINS van corebot.info, anders verschijnt hij niet op de pagina Plugins.

main.py

[bewerken]
from discord import app_commands
import discord

def setup(p):
    @app_commands.command(name='hallo', description='Zegt hallo')
    async def hallo(inter: discord.Interaction):
        await inter.response.send_message('Hallo!', ephemeral=True)
    p.slash(hallo)

Wat een plugin kan gebruiken

[bewerken]
Onderdeel Wat
p.slash(cmd) slash-commando, groep of rechtsklikmenu toevoegen (altijd alleen in servers)
@p.on('member_join') / 'member_remove' gebeurtenis met het lid
@p.every taak, elke ~20 seconden aangeroepen met de tijd
@p.component knoppen met custom_id = p.cid(...), blijven werken na een herstart
@p.action('soort') opdracht van corebot.info uitvoeren (bijv. embed plaatsen), geeft een resultaat terug
p.enabled(gid), p.cfg(gid) aan/uit en instellingen van de site voor die server
p.store(gid) eigen opslag per server (.data en .save())
p.ask_ai(vraag) korte vraag aan de eigen AI (met DeepSeek-reserve)
p.bot, p.tz, p.log de bot, de tijdzone, een logger

Hulpjes uit pluginhost: make_embed, parse_color, safe_url (alleen https), bot_can_post (uitleg als de bot ergens niet mag schrijven), MENTIONS (leden en rollen pingen, @everyone nooit).

Regels

[bewerken]
  • Een plugin is gewone Python-code in de bot: alleen plugins die je vertrouwt.
  • Bewaar zo min mogelijk over leden, en zet het in de privacyverklaring op corebot.info.
  • Schrijf tests in test_plugins.py (nep-Discord, zonder te verbinden) en probeer het met de testbot.
  • Later (fase 3): plugins downloaden van de site, alleen ondertekende pakketten.