info

This command has been consolidated. Now use: /admin welcome <subcommand>

👋 Welcome - Welcome System

Complete welcome system with custom cards, AI video, AI poems, gamification and 70+ available variables.

Commands

/admin welcome canal

Set the welcome channel

Parameter	Type	Required	Description
canal	Channel	✅ Yes	Channel where welcomes will be sent

Example:

/admin welcome canal canal:#welcome

/admin welcome mensaje

Custom welcome message with variable support

Parameter	Type	Required	Description
mensaje	String	✅ Yes	Message with variables ({user}, {server}, {count}, etc.)

Example:

/admin welcome mensaje mensaje:Welcome {user} to {server}! You are member #{count}

/admin welcome imagen

Enable/disable welcome image card

Parameter	Type	Required	Description
activar	Boolean	✅ Yes	true/false

/admin welcome rol

Automatic role for new members

Parameter	Type	Required	Description
rol	Role	✅ Yes	Role to assign automatically

/admin welcome test

Test the current welcome message (simulates your own join)

---

Web Panel

Full welcome system configuration is available at panel.yumechanbot.com with many more options than commands.

Features by Tier

Feature	Free	Starter	PRO	ULTRA
PNG Card	✅	✅	✅	✅
Animated GIF Card	❌	✅	✅	✅
Basic templates	1	5	15	25
Advanced templates (with fields)	❌	❌	❌	✅
Random messages	❌	✅	✅	✅
Welcome DM	❌	✅	✅	✅
Bonus Yumes/XP	❌	✅	✅	✅
AI Background (image)	❌	❌	✅	✅
AI Poem	❌	❌	✅	✅
Gamification (Scratch, Wheel, Quiz)	❌	❌	✅	✅
AI Welcome Video	❌	❌	❌	✅
Discord Components V2	✅	✅	✅	✅
V2 Visual Builder (panel)	✅	✅	✅	✅

---

🎬 AI Welcome Video (ULTRA)

Servers with ULTRA tier can generate a 5-second AI video (Kling AI, 720p) displayed as welcome.

How it works

1. Generate the video from the panel: write a prompt describing the scene you want
2. The video is generated with Kling AI Standard (1280x720, 5 seconds)
3. Activate the video with the "AI Welcome Video" toggle
4. When a member joins, the bot:
   • Overlays avatar, username and poem on the video using ffmpeg
   • Auto-compresses the video if it exceeds Discord limits
   • Sends the message using Discord Components V2 (inline video with MediaGallery)
   • Includes all embed info (title, description, fields, footer, color)

Limits

• 5 generations per month (resets monthly)
• 100 credits per generation (Runware)
• Video is auto-compressed with ffmpeg to stay within Discord file limits

Discord File Limits

Boost Level	Limit
No boost (Tier 0)	10 MB
Level 1	25 MB
Level 2	50 MB
Level 3	100 MB

Discord Components V2

All welcome messages (with or without video) now use Discord's Components V2 format:

• ContainerBuilder with configurable accent color bar
• TextDisplayBuilder for title, description, fields and footer in markdown
• SectionBuilder with ThumbnailBuilder to show user avatar alongside text
• MediaGalleryBuilder for image cards, GIFs or inline videos
• SeparatorBuilder to visually divide sections
• ActionRowBuilder with buttons (rules, claim rewards, etc.)

caution

Discord does not support autoplay for videos. Users must click to play.

info

Old configurations (classic embeds) are auto-migrated to V2 automatically the first time they are loaded. No configuration is lost.

---

🎨 Image Cards

Welcome cards are generated as images (PNG or animated GIF) with:

• Customizable background: Color, URL, AI-generated background
• User avatar with circular border
• Custom welcome text
• AI poem overlay (styles: kawaii, epic, funny, haiku, rhyme)
• Darkening overlay configurable

Formats

Format	Description	Min. Tier
PNG	Static image	Free
GIF	Animation with entry effects	Starter

---

📝 Available Variables (70+)

User (20)

{user} {username} {displayName} {globalName} {nickname} {tag} {discriminator} {id} {avatar} {avatarHash} {banner} {accentColor} {isBot} {isSystem} {flags} {premiumType} {locale} {mfaEnabled} {verified} {userStatus}

Account (15)

{createdAt} {createdTimestamp} {createdRelative} {accountAge} {accountAgeDays} {accountAgeMonths} {accountAgeYears} {joinedAt} {joinedTimestamp} {joinedRelative} {memberAge} {memberAgeDays} {isNewAccount} {accountCreatedDate} {accountCreatedTime}

Server (20)

{server} {serverName} {serverId} {serverIcon} {serverBanner} {serverSplash} {serverDescription} {count} {memberCount} {humanCount} {botCount} {onlineCount} {offlineCount} {roleCount} {channelCount} {emojiCount} {boostCount} {boostLevel} {serverOwner} {serverCreatedAt}

Position (10)

{joinPosition} {joinPositionOrdinal} {joinPositionSuffix} {memberNumber} {highestRole} {highestRoleColor} {rolesList} {rolesCount} {isServerOwner} {isAdmin}

Date/Time (15)

{date} {time} {datetime} {timestamp} {day} {dayName} {dayShort} {month} {monthName} {monthShort} {year} {hour} {hour12} {minute} {ampm}

Economy (9)

{balance} {bank} {totalBalance} {level} {xp} {xpNeeded} {rank} {dailyStreak} {petsCount}

Invitation (5)

{inviter} {inviterName} {inviteCode} {inviteUses} {inviterInvites}

Special (5)

{newline} {everyone} {here} {randomEmoji} {randomColor}

---

🎨 Templates (25)

Free (1)

• Minimal — Simple and clean welcome

Starter (3)

• Kawaii — Cute and colorful style
• Gaming — Video game style
• Anime — Japanese style

PRO (15)

• Elegant — Golden and refined style
• Dark — Dark and mysterious style
• Neon — Neon/cyberpunk style
• Retro — Retro arcade style
• Statistics — Shows server stats
• Inviter — Shows who invited the user
• Detailed — Complete user info
• Economy — Starter pack with balance/level
• Party — Celebration style
• Hacker — Terminal/code style
• Royal — Medieval/royalty style
• Space — Sci-fi style
• Cute — Adorable/cute style
• Professional — Corporate style
• Boost Info — Server boost status

ULTRA (6) — With advanced fields

• Full Profile — ID, tag, account age, position, stats (6 fields)
• Server Hub — Community, infrastructure, boosts, invitation (6 fields)
• RPG Adventure — Adventurer sheet with level, XP, gold (4 fields)
• Cyberpunk — Terminal aesthetic with identity, economy, network (6 fields)
• Social Media — "New follower" style with profile and stats (4 fields)
• Security — Security report: verification, MFA, account age (8 fields)

---

📸 Gallery

Generated cards and videos are automatically saved to the gallery (max 20 per server). From the gallery you can:

• View all generated cards and videos
• Filter by type: Welcome, Goodbye, Video
• Reuse an image as card background
• Reuse a video as active welcome video
• Delete old cards

Videos in the gallery play on hover and have a yellow "VIDEO" badge.

---

🎮 Gamification (PRO+)

Scratch Card

Each new member receives a scratch card with configurable prizes (Yumes, XP, etc.)

Welcome Wheel

Wheel with customizable segments and random prizes

Welcome Quiz

Questions about the server with Yumes and XP bonuses for correct answers

---

🧱 V2 Visual Builder (Panel)

From the web panel you can build your V2 messages visually with a block editor:

Available block types

Block	Description
Text	Free markdown with variable support (###, **, -# for footer)
Section	Text with user avatar thumbnail
Media	Image card, video or custom URL
Separator	Divider line with configurable spacing
Buttons	Button row with roles, links or actions

Builder features

• Add blocks with the "+" menu (max 10 blocks)
• Reorder blocks with ↑↓ arrows
• Delete individual blocks
• Configurable accent color (container sidebar bar)
• Live preview with substituted variables and markdown rendering
• Responsive view (desktop / tablet / mobile)
• Insert variables directly into the selected block

V2 Templates

When applying a template, the equivalent V2 configuration is automatically generated with the appropriate blocks.

---

📝 Notes

• All welcome messages use Discord Components V2 (not classic embeds)
• Old configurations are auto-migrated to V2 without data loss
• Welcome DMs still use classic embeds (V2 not supported in DMs)
• Video overlay includes avatar, name and poem composited with ffmpeg
• If the video is too large for Discord, the bot auto-fallbacks to image card
• Videos are auto-compressed with ffmpeg if they exceed 9 MB
• Max 10 blocks per V2 message