D4rkst3r/d4rkbot
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

Community-Paket: Playtester-Programm, Starboard, Screenshot-Galerie

Browse Source 
- Playtester: /playtester-setup postet Bewerbungs-Embed mit 🧪-Button;
  Toggle vergibt Rolle + DB-Eintrag; Liste + Rollen-Auswahl auf der Setup-Seite
- Starboard: ab konfigurierbarem ⭐-Schwellwert Repost als Embed in den
  Best-of-Kanal (Dedupe, kein Selbst-Boarding); neue Intents/Partials für Reaktionen
- Galerie: Bilder aus dem Screenshot-Kanal lokal archiviert (live + /galerie-backfill,
  Delete-Sync, Bot reagiert mit ⭐) → öffentliche /galerie-Seite mit Hover-Grid
- Setup-Seite: Sektion // Community (Rolle, Starboard-Kanal + Schwellwert, Screenshot-Kanal)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
D4rkst3r
2026-07-23 12:34:34 +02:00
co-authored by Claude Opus 4.8
parent 6d8f383aed
commit a3c47656c5
13 changed files with 563 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/bot/client.js
+41 -4
View File
@@ -1,14 +1,18 @@
// Discord-Client: Commands laden, registrieren und Interactions verarbeiten
import { Client, Collection, Events, GatewayIntentBits, MessageFlags, Partials, REST, Routes } from 'discord.js';
import { config } from '../config.js';
import { devlogChannelId, devlogPingRoleId } from '../runtime-settings.js';
import { devlogChannelId, devlogPingRoleId, playtesterRoleId } from '../runtime-settings.js';
import { archiveDevlogMessage, removeDevlog } from './devlog-archive.js';
import { registerCommunityListeners } from './community.js';
import { addPlaytester, removePlaytester } from '../db.js';
import * as ping from './commands/ping.js';
import * as devlogBackfill from './commands/devlog-backfill.js';
import * as bug from './commands/bug.js';
import * as playtesterSetup from './commands/playtester-setup.js';
import * as galerieBackfill from './commands/galerie-backfill.js';
// Alle Commands hier eintragen — jedes Modul exportiert { data, execute }
const commandModules = [ping, devlogBackfill, bug];
const commandModules = [ping, devlogBackfill, bug, playtesterSetup, galerieBackfill];
export async function startBot() {
const client = new Client({
@@ -18,9 +22,11 @@ export async function startBot() {
// (erfordert aktivierten "Message Content Intent" im Developer Portal!)
GatewayIntentBits.GuildMessages,
GatewayIntentBits.MessageContent,
// Für das Starboard (⭐-Reaktionen)
GatewayIntentBits.GuildMessageReactions,
],
// Partials, damit MessageDelete auch für ungecachte (ältere) Nachrichten feuert
partials: [Partials.Message],
// Partials, damit Delete/Reaction-Events auch für ungecachte Nachrichten feuern
partials: [Partials.Message, Partials.Reaction],
});
// Commands in Collection ablegen für schnellen Zugriff im Interaction-Handler
@@ -91,6 +97,35 @@ export async function startBot() {
return;
}
// 🧪-Button: Playtester-Rolle + Liste togglen
if (interaction.isButton() && interaction.customId === 'playtester_toggle') {
const roleId = playtesterRoleId();
try {
if (!roleId || !interaction.inGuild()) throw new Error('Keine Playtester-Rolle konfiguriert');
const member = interaction.member;
const hasRole = member.roles.cache.has(roleId);
if (hasRole) {
await member.roles.remove(roleId);
removePlaytester(interaction.user.id);
} else {
await member.roles.add(roleId);
addPlaytester(interaction.user.id, interaction.user.username);
}
await interaction.reply({
content: hasRole
? '🚪 Von der Playtester-Liste **abgemeldet**.'
: '🧪 **Willkommen im Playtest-Team!** Du stehst auf der Liste — sobald es losgeht, meldet sich der Bot per DM.',
flags: MessageFlags.Ephemeral,
});
} catch (error) {
console.error('[playtester] Toggle fehlgeschlagen:', error);
await interaction
.reply({ content: '❌ Konnte die Rolle nicht ändern — Rechte/Rollen-Reihenfolge prüfen.', flags: MessageFlags.Ephemeral })
.catch(() => {});
}
return;
}
if (!interaction.isChatInputCommand()) return;
const command = client.commands.get(interaction.commandName);
@@ -109,6 +144,8 @@ export async function startBot() {
}
});
registerCommunityListeners(client);
await client.login(config.discordToken);
return client;
}
src/bot/commands/galerie-backfill.js
+41
View File
@@ -0,0 +1,41 @@
// /galerie-backfill — bestehende Screenshots aus dem Kanal nacharchivieren (Admin)
import { SlashCommandBuilder, PermissionFlagsBits, MessageFlags } from 'discord.js';
import { screenshotChannelId } from '../../runtime-settings.js';
import { archiveGalleryMessage } from '../community.js';
export const data = new SlashCommandBuilder()
.setName('galerie-backfill')
.setDescription('Archiviert alle bisherigen Screenshots aus dem Galerie-Kanal')
.setDefaultMemberPermissions(PermissionFlagsBits.Administrator);
export async function execute(interaction) {
await interaction.deferReply({ flags: MessageFlags.Ephemeral });
const channelId = screenshotChannelId();
if (!channelId) {
await interaction.editReply('❌ Erst auf der Setup-Seite einen Screenshot-Kanal wählen.');
return;
}
const channel = await interaction.client.channels.fetch(channelId);
if (!channel?.isTextBased()) {
await interaction.editReply('❌ Screenshot-Kanal nicht gefunden.');
return;
}
let scanned = 0;
let saved = 0;
let before;
for (;;) {
const batch = await channel.messages.fetch({ limit: 100, before });
if (batch.size === 0) break;
for (const message of batch.values()) {
scanned++;
if (await archiveGalleryMessage(message)) saved++;
}
before = batch.last().id;
}
await interaction.editReply(
`✅ Galerie-Backfill fertig: ${scanned} Nachrichten gescannt, **${saved} Screenshots archiviert**.`
);
}
src/bot/commands/playtester-setup.js
+44
View File
@@ -0,0 +1,44 @@
// /playtester-setup — postet das Bewerbungs-Embed mit Button in den aktuellen Kanal (Admin)
import {
SlashCommandBuilder, PermissionFlagsBits, MessageFlags,
ActionRowBuilder, ButtonBuilder, ButtonStyle, EmbedBuilder,
} from 'discord.js';
import { playtesterRoleId } from '../../runtime-settings.js';
export const data = new SlashCommandBuilder()
.setName('playtester-setup')
.setDescription('Postet das Playtester-Bewerbungs-Embed in diesen Kanal')
.setDefaultMemberPermissions(PermissionFlagsBits.Administrator);
export async function execute(interaction) {
if (!playtesterRoleId()) {
await interaction.reply({
content: '❌ Erst auf der Setup-Seite eine Playtester-Rolle wählen.',
flags: MessageFlags.Ephemeral,
});
return;
}
const embed = new EmbedBuilder()
.setColor(0xf5c518)
.setTitle('🧪 Playtester werden')
.setDescription(
'Du willst **EcoGame** vor allen anderen spielen und mit deinem Feedback ' +
'die Entwicklung mitgestalten?\n\n' +
'Ein Klick auf den Button setzt dich auf die Playtester-Liste — ' +
'sobald die Alpha startet, bekommst du deinen Zugang direkt per DM. ' +
'Abmelden geht jederzeit mit einem zweiten Klick.'
)
.setFooter({ text: 'D4RKST3R // PLAYTEST' });
const row = new ActionRowBuilder().addComponents(
new ButtonBuilder()
.setCustomId('playtester_toggle')
.setStyle(ButtonStyle.Success)
.setLabel('Als Playtester bewerben')
.setEmoji('🧪')
);
await interaction.channel.send({ embeds: [embed], components: [row] });
await interaction.reply({ content: '✅ Bewerbungs-Post erstellt.', flags: MessageFlags.Ephemeral });
}
src/bot/community.js
+135
View File
@@ -0,0 +1,135 @@
// Community-Features: Starboard (⭐ → Best-of-Kanal) + Screenshot-Galerie
import { mkdirSync } from 'node:fs';
import { writeFile, rm } from 'node:fs/promises';
import { join, dirname, resolve } from 'node:path';
import { EmbedBuilder, Events } from 'discord.js';
import {
hasStarboard, saveStarboard,
saveGalleryItem, hasGalleryItem, deleteGalleryItem,
} from '../db.js';
import { starboardChannelId, starboardThreshold, screenshotChannelId } from '../runtime-settings.js';
import { config } from '../config.js';
const BRAND_YELLOW = 0xf5c518;
const MAX_GALLERY_IMAGES = 4;
// Galerie-Bilder liegen neben der SQLite: data/gallery/
export const galleryDir = join(dirname(resolve(config.dbPath)), 'gallery');
mkdirSync(galleryDir, { recursive: true });
/* ── Screenshot-Galerie ────────────────────────────── */
/**
* Nachricht aus dem Screenshot-Kanal archivieren (Bilder lokal speichern).
* @returns {Promise<boolean>} true, wenn neu gespeichert
*/
export async function archiveGalleryMessage(message) {
if (hasGalleryItem(message.id)) return false;
const files = [];
for (const att of message.attachments?.values?.() ?? []) {
if (files.length >= MAX_GALLERY_IMAGES) break;
if (!att.contentType?.startsWith('image/')) continue;
const ext = (att.name?.split('.').pop() || 'png').toLowerCase().replace(/[^a-z0-9]/g, '') || 'png';
const file = `${message.id}_${files.length}.${ext}`;
try {
const res = await fetch(att.url);
if (!res.ok) continue;
await writeFile(join(galleryDir, file), Buffer.from(await res.arrayBuffer()));
files.push(file);
} catch (error) {
console.error(`[galerie] Bild-Download fehlgeschlagen: ${error.message}`);
}
}
if (files.length === 0) return false;
return saveGalleryItem({
message_id: message.id,
author_name: message.member?.displayName ?? message.author?.username ?? 'unbekannt',
images: JSON.stringify(files),
posted_at: message.createdAt.toISOString(),
});
}
/** Galerie-Eintrag inkl. Bild-Dateien entfernen */
export async function removeGalleryMessage(messageId) {
const { deleted, images } = deleteGalleryItem(messageId);
for (const file of images) {
await rm(join(galleryDir, file), { force: true });
}
return deleted;
}
/* ── Starboard ─────────────────────────────────────── */
async function handleStarReaction(reaction) {
const boardChannelId = starboardChannelId();
if (!boardChannelId) return;
if (reaction.emoji.name !== '⭐') return;
if (reaction.partial) await reaction.fetch();
let message = reaction.message;
if (message.partial) message = await message.fetch();
// Nicht das Starboard selbst boarden, Dedupe, Schwellwert
if (message.channelId === boardChannelId) return;
if (hasStarboard(message.id)) return;
if ((reaction.count ?? 0) < starboardThreshold()) return;
const board = await message.client.channels.fetch(boardChannelId);
if (!board?.isTextBased()) return;
const image = [...message.attachments.values()].find((a) =>
a.contentType?.startsWith('image/')
);
const embed = new EmbedBuilder()
.setColor(BRAND_YELLOW)
.setAuthor({
name: message.member?.displayName ?? message.author?.username ?? 'unbekannt',
iconURL: message.author?.displayAvatarURL?.() ?? undefined,
})
.setDescription(
`${(message.content || '').slice(0, 1800) || '*[Bild]*'}\n\n[→ Zum Original](${message.url})`
)
.setFooter({ text: `⭐ ${reaction.count} • #${message.channel?.name ?? ''}` })
.setTimestamp(message.createdAt);
if (image) embed.setImage(image.url);
const boardMessage = await board.send({ embeds: [embed] });
saveStarboard(message.id, boardMessage.id);
console.log(`[starboard] ${message.id} geboardet (${reaction.count} ⭐)`);
}
/* ── Listener-Registrierung ────────────────────────── */
export function registerCommunityListeners(client) {
client.on(Events.MessageReactionAdd, async (reaction) => {
try {
await handleStarReaction(reaction);
} catch (error) {
console.error('[starboard] Fehler:', error);
}
});
client.on(Events.MessageCreate, async (message) => {
if (message.channelId !== screenshotChannelId()) return;
try {
if (await archiveGalleryMessage(message)) {
console.log(`[galerie] Screenshot archiviert (${message.id})`);
await message.react('⭐').catch(() => {});
}
} catch (error) {
console.error('[galerie] Archivierung fehlgeschlagen:', error);
}
});
client.on(Events.MessageDelete, async (message) => {
try {
if (await removeGalleryMessage(message.id)) {
console.log(`[galerie] Eintrag entfernt (${message.id})`);
}
} catch (error) {
console.error('[galerie] Löschung fehlgeschlagen:', error);
}
});
}
src/db.js
+64
View File
@@ -114,6 +114,70 @@ export function takeBugReport(repo, issueNumber) {
return row ?? null;
}
// Community: Playtester, Starboard, Screenshot-Galerie
db.exec(`
CREATE TABLE IF NOT EXISTS playtesters (
user_id TEXT PRIMARY KEY,
username TEXT,
applied_at TEXT NOT NULL DEFAULT (datetime('now'))
);
CREATE TABLE IF NOT EXISTS starboard (
message_id TEXT PRIMARY KEY,
board_message_id TEXT,
starred_at TEXT NOT NULL DEFAULT (datetime('now'))
);
CREATE TABLE IF NOT EXISTS gallery (
message_id TEXT PRIMARY KEY,
author_name TEXT,
images TEXT NOT NULL,
posted_at TEXT NOT NULL
);
CREATE INDEX IF NOT EXISTS idx_gallery_posted ON gallery (posted_at DESC);
`);
const insertPlaytester = db.prepare(
'INSERT OR IGNORE INTO playtesters (user_id, username) VALUES (?, ?)'
);
const deletePlaytester = db.prepare('DELETE FROM playtesters WHERE user_id = ?');
const listPlaytestersStmt = db.prepare(
'SELECT user_id, username, applied_at FROM playtesters ORDER BY applied_at'
);
export const addPlaytester = (userId, username) => insertPlaytester.run(userId, username).changes > 0;
export const removePlaytester = (userId) => deletePlaytester.run(userId).changes > 0;
export const listPlaytesters = () => listPlaytestersStmt.all();
const hasStarboardStmt = db.prepare('SELECT 1 FROM starboard WHERE message_id = ?');
const insertStarboard = db.prepare(
'INSERT OR IGNORE INTO starboard (message_id, board_message_id) VALUES (?, ?)'
);
export const hasStarboard = (id) => Boolean(hasStarboardStmt.get(id));
export const saveStarboard = (id, boardId) => insertStarboard.run(id, boardId);
const insertGallery = db.prepare(`
INSERT OR IGNORE INTO gallery (message_id, author_name, images, posted_at)
VALUES (@message_id, @author_name, @images, @posted_at)
`);
const hasGalleryStmt = db.prepare('SELECT 1 FROM gallery WHERE message_id = ?');
const getGalleryImagesStmt = db.prepare('SELECT images FROM gallery WHERE message_id = ?');
const deleteGalleryStmt = db.prepare('DELETE FROM gallery WHERE message_id = ?');
const listGalleryStmt = db.prepare(`
SELECT message_id, author_name, images, posted_at
FROM gallery ORDER BY posted_at DESC LIMIT ? OFFSET ?
`);
const countGalleryStmt = db.prepare('SELECT count(*) AS n FROM gallery');
export const saveGalleryItem = (item) => insertGallery.run(item).changes > 0;
export const hasGalleryItem = (id) => Boolean(hasGalleryStmt.get(id));
export function deleteGalleryItem(id) {
const row = getGalleryImagesStmt.get(id);
if (!row) return { deleted: false, images: [] };
deleteGalleryStmt.run(id);
return { deleted: true, images: JSON.parse(row.images || '[]') };
}
export const listGallery = (limit, offset) => ({
items: listGalleryStmt.all(limit, offset),
total: countGalleryStmt.get().n,
});
// API-Keys für externe Skripte (/api/v1/*) — nur der SHA-256-Hash wird gespeichert
db.exec(`
CREATE TABLE IF NOT EXISTS api_keys (
src/runtime-settings.js
+21
View File
@@ -31,6 +31,27 @@ export function devlogThreadsEnabled() {
return getSetting('devlog_threads_enabled') !== '0';
}
/** Playtester-Rolle (Bewerbungs-Button) — leer = Feature aus */
export function playtesterRoleId() {
return getSetting('playtester_role_id') || null;
}
/** Starboard-Kanal — leer = Feature aus */
export function starboardChannelId() {
return getSetting('starboard_channel_id') || null;
}
/** Ab wie vielen ⭐ landet eine Nachricht im Starboard (Default: 3) */
export function starboardThreshold() {
const n = Number(getSetting('starboard_threshold'));
return Number.isInteger(n) && n >= 1 ? n : 3;
}
/** Screenshot-Kanal für die Galerie — leer = Feature aus */
export function screenshotChannelId() {
return getSetting('screenshot_channel_id') || null;
}
/** Ziel-Repo für /bug-Reports (Default: EcoGame) */
export function bugReportRepo() {
return getSetting('bug_report_repo') || 'D4rkst3r/EcoGame';
src/web/api.js
+40 -8
View File
@@ -3,6 +3,7 @@ import { EmbedBuilder } from 'discord.js';
import {
listDevlogs, searchDevlogs, listCommits, listReleases, archiveStats,
getSetting, setSetting, createApiKey, listApiKeys, deleteApiKey,
listGallery, listPlaytesters,
} from '../db.js';
import { config } from '../config.js';
import { removeDevlog } from '../bot/devlog-archive.js';
@@ -53,6 +54,23 @@ export function registerApiRoutes(app, client) {
return { items, total, page, pageSize: PAGE_SIZE };
});
// Screenshot-Galerie — öffentlich
app.get('/api/gallery', async (request) => {
const { limit, offset, page } = paging(request);
const { items, total } = listGallery(limit, offset);
const mapped = items.map(({ images, ...rest }) => ({
...rest,
images: JSON.parse(images || '[]').map((f) => `/gallery-assets/${f}`),
}));
return { items: mapped, total, page, pageSize: PAGE_SIZE };
});
// Playtester-Liste — Admin
app.get('/api/playtesters', async (request, reply) => {
if (requireAdmin(request, reply)) return;
return { playtesters: listPlaytesters() };
});
// Roadmap — öffentlich, aus Gitea-Milestones (5-Minuten-Cache gegen API-Hammering)
let roadmapCache = { at: 0, repo: null, data: null };
app.get('/api/roadmap', async (request, reply) => {
@@ -181,6 +199,10 @@ ${rssItems}
gitea_url: getSetting('gitea_url') ?? config.giteaUrl,
backup_enabled: getSetting('backup_enabled') !== '0',
backup_channel_id: getSetting('backup_channel_id') ?? '',
playtester_role_id: getSetting('playtester_role_id') ?? '',
starboard_channel_id: getSetting('starboard_channel_id') ?? '',
starboard_threshold: Number(getSetting('starboard_threshold')) || 3,
screenshot_channel_id: getSetting('screenshot_channel_id') ?? '',
};
}
@@ -208,11 +230,12 @@ ${rssItems}
const body = request.body ?? {};
// Kanäle: müssen existierende Textkanäle sein (release/backup dürfen leer sein = aus)
for (const key of ['commit_channel_id', 'devlog_channel_id', 'release_channel_id', 'backup_channel_id']) {
// Kanäle: müssen existierende Textkanäle sein (optionale dürfen leer sein = aus)
const OPTIONAL_CHANNELS = ['release_channel_id', 'backup_channel_id', 'starboard_channel_id', 'screenshot_channel_id'];
for (const key of ['commit_channel_id', 'devlog_channel_id', ...OPTIONAL_CHANNELS]) {
if (body[key] === undefined) continue;
const value = String(body[key]);
if (value === '' && ['release_channel_id', 'backup_channel_id'].includes(key)) {
if (value === '' && OPTIONAL_CHANNELS.includes(key)) {
setSetting(key, '');
continue;
}
@@ -222,18 +245,27 @@ ${rssItems}
}
setSetting(key, value);
}
// Ping-Rolle: muss existieren ('' = kein Ping)
if (body.devlog_ping_role_id !== undefined) {
const value = String(body.devlog_ping_role_id);
// Rollen: müssen existieren ('' = Feature aus)
for (const key of ['devlog_ping_role_id', 'playtester_role_id']) {
if (body[key] === undefined) continue;
const value = String(body[key]);
if (value !== '') {
const exists = [...client.guilds.cache.values()].some((g) =>
g.roles?.cache?.has?.(value)
);
if (!exists) {
return reply.code(400).send({ error: 'devlog_ping_role_id: Rolle nicht gefunden' });
return reply.code(400).send({ error: `${key}: Rolle nicht gefunden` });
}
}
setSetting('devlog_ping_role_id', value);
setSetting(key, value);
}
// Starboard-Schwellwert: 1–50
if (body.starboard_threshold !== undefined) {
const n = Number(body.starboard_threshold);
if (!Number.isInteger(n) || n < 1 || n > 50) {
return reply.code(400).send({ error: 'starboard_threshold: 1–50' });
}
setSetting('starboard_threshold', String(n));
}
if (body.commit_feed_enabled !== undefined) {
setSetting('commit_feed_enabled', body.commit_feed_enabled ? '1' : '0');
src/web/server.js
+9
View File
@@ -77,6 +77,15 @@ export async function startWebServer(client) {
maxAge: '30d',
immutable: true,
});
// Screenshot-Galerie-Bilder
const { galleryDir } = await import('../bot/community.js');
await app.register(fastifyStatic, {
root: galleryDir,
prefix: '/gallery-assets/',
decorateReply: false,
maxAge: '30d',
immutable: true,
});
if (existsSync(frontendDist)) {
// React-Frontend ausliefern; unbekannte GET-Pfade → index.html (SPA-Routing)