CoreBot/Plugin maken: verschil tussen versies
docs>wiki-docs Geïmporteerd vanaf de pc van DieOuwe (wiki-docs) |
k 1 versie geïmporteerd |
| (6 tussenliggende versies door 2 gebruikers niet weergegeven) | |
(geen verschil)
| |
Huidige versie van 19 okt 2026 23:20
DieOuwe-ecosysteem: Hoofdpagina · Ecosysteem overzicht · Websites en adressen · Infrastructuur · Controlepaneel · Werkwijze · Roadmap en taken
AI: SBWebUI · Open WebUI en Ollama · Stemserver · SearXNG · Beeldgeneratie · Muziekgeneratie
Discord: CoreBot · CoreBot/Plugins · CoreBot/Plugin maken · Corebot Radio · CoreBot-site · Testomgeving
Websites en CMS: ScriptSpace CMS · Blueprint CMS · Websites (WordPress) · FastTrack Soundtracker · Aprende Papiamentu
WoW: WoW-addons en CurseBot · DieOuweUI · NodeHound
Tools en apps: SBserv · PanicRoom · SpotFam · Project Brain
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_ongeldt als corebot.info voor die server niets over de plugin zegt.- Zet een nieuwe plugin ook in
CB_PLUGINSvan 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.