██╗  ██╗██╗███╗   ███╗ █████╗  ██████╗ ██╗   ██╗
 ██║ ██╔╝██║████╗ ████║██╔══██╗██╔═══██╗╚██╗ ██╔╝
 █████╔╝ ██║██╔████╔██║███████║██║   ██║ ╚████╔╝ 
 ██╔═██╗ ██║██║╚██╔╝██║██╔══██║██║   ██║  ╚██╔╝  
 ██║  ██╗██║██║ ╚═╝ ██║██║  ██║╚██████╔╝   ██║   
 ╚═╝  ╚═╝╚═╝╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝    ╚═╝   

A premium Discord bot for Sellers, Middlemen, and Ticket Management

---

✦ Overview

Kimaoy-Bot is a highly specialized, feature-rich Discord bot designed specifically for marketplace servers. It provides an all-in-one ecosystem for Ticket Management, Seller Verification & Vouches, Middleman (MM) Enforcement, and a beautiful interactive CV2 Embed Builder.

Built with discord.js v14 and powered by MongoDB, the bot enforces safe trading environments while giving admins ultimate control over their server's aesthetics.

---

✦ Core Features & Commands

🛍️ Seller & Marketplace System /completedeal: The flagship command for sellers to finalize a ticket. Automatically prompts the buyer for a rating, calculates middleman involvement, and adds Shiba vouches to the seller's profile. /seller: View or manage seller profiles, trust ratings, and vouch counts. /forcevouch: Admin command to manually adjust a seller's vouches if required. /tos: Displays the server's strictly enforced Terms of Service using beautifully integrated custom emojis. Middleman (MM) Enforcement: Built-in rules requiring buyers and sellers to accept MMs for safe transactions.

🎫 Advanced Ticket System /ticketpanel (Slash & Prefix): Deploys a fully interactive UI panel for users to open specific tickets (Nitro, Decorations, Server Boosts, Exchanges, Reports). Ticket Controls: Inside every ticket, users and staff get access to Dropdown (StringSelectMenu) interfaces to easily: Select Payment Methods (Crypto, PayPal, etc.) Set Order Quantities Claim / Unclaim / Close tickets Request a Middleman (MM) Add / Remove users from the ticket channel Save full transcripts of the trade

🎨 CV2 Interactive Embed Builder /embed: Launches a live, interactive workspace to build Discord v10 (CV2) embeds natively in chat. Dropdown Interface: Edit the title, description, colors, footers, and author fields entirely via StringSelectMenus (no command spam needed). Live Preview: See exactly how your embed looks as you build it. Channel Selector: Dispatch your finished creation directly to any channel in the server.

⚙️ Utilities & Backend Application Emoji Sync: Highly advanced, live automated synchronization. It dynamically scrapes all emojis from a designated source server, uploads them globally to your Bot Application (bypassing 50-slot limits), auto-patches the source code, and dumps an emojis.json reference map. Clean Architecture: 100% comment-free "raw" source code design. /feedback: Interactive modal for users to submit server feedback and suggestions. !remind: Utility prefix command for reminders.

---

✦ Prerequisites

Requirement	Version / Notes
Node.js	v18.0.0 or higher
MongoDB Cluster	A free MongoDB Atlas URI for saving tickets/vouches
Discord Bot Token	Enabled Message Content, Server Members, and Presence intents

---

✦ Setup & Installation

1 — Clone the repository

git clone https://github.com/ShadowZ001/Kimaoy-Bot.git
cd Kimaoy-Bot

2 — Install dependencies

npm install

3 — Configure Environment Create a .env file in the root directory and configure it:

TOKEN=your_bot_token_here
CLIENT_ID=your_bot_client_id_here
MONGODB_URI=mongodb+srv://...

# Advanced Application Emoji Sync
EMOJI_SYNC=true
EMOJI_GUILD_ID=123456789012345678

4 — Start the bot

node index.js

---

✦ Kimaoy Devs

Built for marketplace protection. Designed for ultimate CV2 styling.

© 2026 Kimaoy Devs — MIT License