Skip to content
M3rcena edited this page Nov 5, 2026 · 5 revisions

๐ŸŽฎ Welcome to the @m3rcena/weky Official Wiki

Welcome to the definitive documentation wiki for @m3rcena/weky (v14.28.1).

@m3rcena/weky is the blazingly fast, modern minigames and arcade engine for Discord.js v14 bots and web applications. It features 17 fully playable minigames, native Discord Components V2 support, Rust-powered canvas image generation (@napi-rs/canvas), intelligent AI opponents, automated tournaments, and decoupled headless engines.


๐ŸŒŸ Key Features

  • ๐ŸŽฎ 17 Complete Minigames: From classics like 2048, Snake, and Tic-Tac-Toe to RPG combat, Hangman, and party dilemmas.
  • โšก Discord Components V2 Native: Built using modern ContainerBuilder containers, visual accent borders, and zero deprecations.
  • ๐Ÿฆ€ Rust-Powered Canvas (@napi-rs/canvas): Renders photorealistic, high-resolution game boards and score cards in under 15ms.
  • ๐Ÿค– Intelligent Minimax AI & RPG Bosses: Play solo against smart algorithmic computer opponents and multi-phase dungeon bosses.
  • ๐Ÿ† Automated Tournament Engine: Run 4-player, 8-player, or 16-player tournaments with live rendered bracket posters.
  • ๐Ÿ•น๏ธ Arcade Hub Launcher: Centralized interactive menu to browse, customize, and launch all 17 minigames from a single message.
  • ๐ŸŒ Headless & Decoupled: Run games inside Discord OR headlessly for web dashboards (React, Vue, Next.js) via REST & WebSockets.
  • ๐Ÿ”’ Zero External Bloat: Zero database requirements, sub-millisecond execution, and 100% TypeScript type safety.

๐Ÿงญ Wiki Table of Contents

1. Getting Started

2. Games & Arcade Features

  • All 17 Minigames Catalog โ€” Exhaustive guide, options tables, and examples for every minigame.
  • Next-Gen Arcade Suite โ€” Arcade Hub, Tournaments & Brackets, AI Opponents & Bosses, Soundboard, ELO Leaderboards, and Gamer Share Cards.
  • Headless Engine & Canvas Card APIs โ€” Headless game engines, REST endpoints (/api/weky/games), and on-demand canvas card generator (/api/weky/cards/render).

3. Storage & Ecosystem Integrations

  • Database & Storage Handlers โ€” Zero-dependency native SQLite (node:sqlite), Prisma ORM auto-migration, JSON files, and custom storage adapters.
  • Weky <-> Economy Connector โ€” Automated win payouts, loss penalties, solo score multipliers, win streak bonuses, PvP wager bets, and tournament prize pools with @m3rcena/eco.
  • Connecting to Dashboard Bridge โ€” How to bridge @m3rcena/weky with web dashboards for live crossplay.

๐Ÿš€ Quick Example

import { Client, GatewayIntentBits } from "discord.js";
import { WekyManager, Game2048 } from "@m3rcena/weky";

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages],
});

export const weky = new WekyManager(client, {
  embedColor: "#5865F2",
  defaultTimeout: 120_000,
});

client.on("interactionCreate", async (interaction) => {
  if (interaction.isChatInputCommand() && interaction.commandName === "play2048") {
    await new Game2048(weky, { context: interaction }).start();
  }
});

client.login(process.env.DISCORD_TOKEN);

Clone this wiki locally