Koya is a hybrid Discord bot that combines a full-fledged RPG adventure themed around the hit anime One Piece with high-level server management tools.
Imagine turning your server into the “Thousand Sunny.” Users can sail the seas, collect characters, and interact with others, all while the bot handles essential tasks like Welcome Images and Moderation. It is the perfect choice for admins who want to balance fun with functionality.
🏴☠️ Why Koya? (The Spirit of “Nakama”)
Koya is incredibly popular in Southeast Asia, particularly in the Philippines, due to the massive cultural following of One Piece.
1. The “Nakama” Culture
In many communities, One Piece is more than just a show; it’s a shared language. Luffy’s dedication to his crew (Nakama) resonates deeply with community values. Koya brings this energy to Discord.
2. Your Server as a Pirate Ship
By inviting Koya, a server transforms into a pirate crew. New members aren’t just “users”; they are new recruits. The shared experience of leveling up and collecting bounties strengthens the bonds between members, creating a roleplay element that keeps users engaged.
⚙️ Key Features
Koya has two distinct faces: The Adventure RPG and the Server Utility.
🍖 One Piece Adventure
- Interactive Sailing: Use commands to set sail, encounter characters like Luffy or Zoro, and find treasure chests.
- Character Collection: It features a Gacha element where you collect anime characters to build your ultimate crew.
🖼️ Welcome Banner Maker
This is Koya’s most practical feature. When a user joins, Koya automatically generates a high-quality image displaying the user’s avatar and name against a background (like the deck of a ship).
🛠️ Utilities
- RSS Feeds: Get notifications for Reddit or YouTube updates.
- Moderation: Tools to ban users or clear chat logs.
💻 Essential Command List
Important: The default prefix for Koya is ^^ (two carets).
🌊 Adventure & Social
| Command | Description |
| ^^adventure | Sets sail on an adventure to gain XP and items. |
| ^^profile | Checks your Level, XP, and Berries (Currency). |
| ^^daily | Claims your daily bonus Berries. |
| ^^boat | Checks or upgrades your ship’s stats. |
| ^^rep @User | Gives a “Reputation” point to a friend. |
🛠️ Admin & Utility
| Command | Description |
| ^^welcome | Displays the welcome message configuration menu. |
| ^^ban @User | Bans a user from the server. |
| ^^help | Displays the full command list. |
🚀 Setup Tutorial: The “Welcome Image”
Setting up the visual welcome message is the best way to make your server look professional.
Step 1: Invite the Bot
Visit the Koya Website (koya.gg) or Top.gg and invite the bot.
- Permissions: You must grant “Attach Files” and “Embed Links” for the images to work.
Step 2: Set the Channel
Go to your welcome channel (e.g., #arrivals) and type:
^^welcome channel #arrivals
Step 3: Enable Image & Text
Turn the features on and customize the text:
- Enable Image: ^^welcome image on
- Set Text: ^^welcome message Hello {user}! Welcome to {server}!
- {user}: Replaced by the member’s mention.
- {server}: Replaced by the server name.
Step 4: Test It
Type ^^welcome test. The bot will generate a fake welcome message using your profile so you can see exactly how it looks.
❓ FAQ: Troubleshooting
Q: The ^^adventure command isn’t working.
A: It might be on cooldown or maintenance.
The adventure feature is heavy on the servers. If you spam commands, you will hit a cooldown. Also, because Koya is massive, the RPG module sometimes undergoes maintenance while the rest of the bot works fine. Check their support server for status updates.
Q: Can I play without paying?
A: Yes.
The core adventure and leveling are free. Premium is mostly for increased Gacha rates, XP boosts, or custom background slots.
Q: How do I change the Welcome Background?
A: Use the Web Dashboard.
While you can do it via command, it’s difficult. Log in to the Koya Dashboard on their website, go to “Welcome,” and upload your custom image there. It is much easier.
Q: The prefix ^^ is hard to type on mobile.
A: Change it.
You can change the prefix by typing ^^prefix ! (or any symbol you prefer).
Q: Do I need to watch One Piece to enjoy it?
A: No.
It functions as a standard RPG: Level up, get strong, collect rare cards. Many users start watching the show after playing the bot because they enjoy the mechanics.
Q: The level-up notifications are annoying.
A: Turn them off.
If the chat is getting spammed with “Level Up!” messages, type ^^level notice off to disable them.
🌟 Admin Tip: Level Roles
Koya allows you to sync Discord Roles with Bot Levels. This dramatically increases user retention.
- Level 5: Auto-assign “Apprentice Pirate” role.
- Level 20: Auto-assign “Pirate” role.
- Level 50: Auto-assign “Captain” role.
Set this up in the Dashboard under “Level Rewards.” It gives members a goal to grind for, keeping your server active!
Next Step for You: Invite Koya, set up the welcome image, and type ^^daily to start your voyage!