add initial version of Kiai docs

Author: FinnyMarigold58

basics.mdx

@@ -0,0 +1,18 @@
+---
+title: Kiai Basics
+description: Learn the core ideas of Kiai — XP, levels, rewards, and leaderboards.
+---
+
+# Kiai Basics
+
+At its core, Kiai is about **turning participation into progress**.  
+The more you contribute to your server, the more XP you earn, and the higher you climb.
+
+## The Building Blocks
+- **XP (Experience Points):** Every message, every voice chat, every bit of activity adds up.  
+- **Levels:** As XP accumulates, you “level up” — showing your growth to the community.  
+- **Rewards:** Server admins can set up role rewards or perks tied to certain levels.  
+- **Leaderboards:** Friendly competition — see who’s the most active in your server.  
+
+## Why It Works
+Kiai makes everyday activity meaningful. Instead of chatting or hanging out aimlessly, members feel recognized for their contributions.  

commands.mdx

@@ -0,0 +1,15 @@
+---
+title: Basic Commands
+description: Your first steps with Kiai — the essential commands you’ll use most often.
+---
+
+# Basic Commands
+
+Once Kiai is in your server, you can start interacting with it right away.  
+Here are the **core commands** every user should know:
+
+- **`/rank`** → See your current level and XP progress (and how much XP until the next level).  
+- **`/leaderboard`** → View the top members in your server and how they rank.  
+- **`/preferences`** → Open your personal settings for Kiai: adjust notification preferences, and control other personal display or privacy options. This is where users manage how Kiai interacts with them.  
+
+Start with `/rank` to see where you’re at, then use `/preferences` to tailor the experience to your liking.

content/advanced-xp.mdx

@@ -0,0 +1,28 @@
+---
+title: Advanced XP Settings
+description:
+---
+
+# XP Streaks
+
+XP Streaks allow a user to gain extra XP for gaining a set amount of XP per day.
+
+XP Streaks can be enabled in `/settings > XP Streaks` and set to send in a specific channel. Advanced configuration of XP Streaks is only avaliable to premium guilds. For more information view Premium
+
+# XP Drops
+
+XP Drop settings can be found in `/settings > XP Drops`
+
+XP Drops allow for occasional drops of XP. These time between these drops is determined by the "Minimum Time Between Drops" setting, and can be triggered by the /drop command. 
+
+The drop will expire after the configured Expire Time and are limited to the Drops per Day setting. The XP amount is randomized between the Minimum and Maximum XP Amount.
+
+The message sent can be configured as well as what happens when the drop is claimed. 
+
+# XP Decay
+
+XP Decay is used to take away xp regularly. It can be used to ensure people are active to keep their levels.
+
+ When XP decay runs, the specified amount of XP set in the "XP Decay Amount" setting (located in the "XP Decay" category) will be deducted from everyone. 
+ 
+ The XP Interval determines how often XP decay runs.

content/customizing-xp.mdx

@@ -0,0 +1,27 @@
+---
+title: Customizing XP Gain
+description: 
+---
+
+# Message XP
+Message XP follow a simple set of settings found in `/settings > Message XP`. Message XP is randomly given reguardless of message length.
+
+XP Cooldown specifies how long until another message can count for XP.
+
+Minimum XP per message specifies the minimum amount of xp that can be gained from a message
+
+Maximum XP per message specifies the maximum amount of xp that can be gained from a message
+
+Level Cap specifies the max level that can be achieved. The users will continue to recieve xp, but they will not display as anything above this level.
+
+The Reset Member XP on Leave/Kick option resets a users xp when they leave the guild.
+
+Reset Member XP on Ban resets the xp a user has when they get banned from the server
+
+# XP Formula
+
+The XP Formula specifies how levels will be determined. By default, Kiai uses the formula `12 * ({level} * {level}) + {level} * 12`, which can be visualized here https://www.desmos.com/calculator/jpwyjlqih9.
+
+When making a custom XP Formula, it is important to include {level}, which is replaced with the member's current level and is used to calculate the xp cost to reach the next level.
+
+Kiai does not support restarting XP at 0 each level, but adding `+ {xp}` to your formula will achieve the same result.

content/exclusions.mdx

@@ -0,0 +1,24 @@
+---
+title: Exclusions
+description: A introduction the the ex
+---
+
+# Exclusions
+
+Exclusion settings can be found in `/settings > Denylist`.
+
+Exclusions in Kiai apply to all methods of recieving XP (message, voice, drops, etc). Kiai has 3 exclusion options: Channels, Roles, and Users.
+
+# Channels
+
+Channel exclusions are often set on channels that may be spammed or flooded often or just a channel that is not intended for XP.
+
+# Roles
+
+Roles exclusions can be used to remove the ability for a certain group of users from recieving XP.
+
+# Users
+
+User exclusions are useful on case-by-case basises where someone is abusing the XP system or doing something else that is disruptive.
+
+Exclusions could also be used to prevent top ranking leaderboard users and to encourage a more competitive leaderboard environment.

content/index.mdx

@@ -1,5 +1,16 @@
 ---
-title: Kiai
+title: Welcome
+description: Introduction to Kiai Docs — start here to learn what Kiai is and how to use it.
 ---
 
-[Check out our docs at https://docs.kiai.app](https://docs.kiai.app)
+# Welcome to Kiai Docs
+
+Thanks for checking out **Kiai**, the Discord leveling bot by Buape Studios.  
+This guide is here to help you understand what Kiai is, why servers use it, and how you can get the most out of it.  
+
+If you’re new, here’s what you’ll find in these docs:  
+- [What’s New](./whats-new) → quick overview of the latest improvements  
+- [Kiai Basics](./basics) → the building blocks of how Kiai works  
+- [What is Kiai?](./what-is-kiai) → a friendly introduction  
+- [What is a Leveling System?](./leveling-system) → context for new Discord users  
+- [Basic Commands](./commands) → your first steps in using the bot  

content/intro-to-rewards.mdx

@@ -0,0 +1,37 @@
+---
+title: Intro to Rewards
+description: Learn what Rewards are and how to use them.
+---
+
+# Rewards
+
+Kiai offers rewards as a way to give a user something at a certain level.
+
+Currently there are five reward options:
+- Roles 
+- Custom Messages
+- Money (Unbelivaboat Currency)
+- Nickname
+- Leaderboard Roles
+
+# Roles
+
+<Callout title="Required Permissions" type="info">This type of reward requires the bot to have the `Manage Roles` permission</Callout>
+
+Role rewards can be used to either give or remove a role upon reaching a specified level. Giving roles could be used for level roles such as Level 10, Level 20, etc. Where at a certain level, you want your guild members to gain a role.
+
+The removal action is a similar feature which allows a role to be removed from a user after reaching a level. The main use for this feature of role rewards is to remove a role (usually one that removes certain permissions), which users get on join.
+
+There are optional parameters to both of these to set a required role, where the user will need a role in order to recieve the reward, and a temporary length option that will give the user the reward for a limited amount of time.
+
+# Custom Messages
+
+Custom Messages are used to send a messsage seperate to the level up message. When a user reaches the reward level, Kiai will send the message in the same channel that xp was recieved in. The channel the message is sent in can be configured through the "channel" option in `/rewards add message` and a required role can also be set for this reward.
+
+# Money
+
+Kiai can be integrated with UnbelievaBoat to reward money for reaching a specified level. Similar to the other rewards, a required role can be set for this type of reward. For more information, see UnbelievaBoat Integration.
+
+# Nicknames
+
+Nicknames can be used to give a special nickname at a certain level. For example, if you wanted to put a emoji in someones name when they reach a certain level. This should only be used on one-off cases, if it should apply to all levels, use Nickname Format.

content/unbelivaboat.mdx

@@ -0,0 +1,8 @@
+---
+title: UnbelivaBoat Integration
+description: Learn about our Integration with Unbelivaboat
+---
+
+# UnbelivaBoat Integration
+
+<!-- TODO: Might be broke -->

content/voice-xp.mdx

@@ -0,0 +1,14 @@
+---
+title: Voice XP
+description:
+---
+
+# Voice XP
+
+<Callout type="info" title="Required Permissions">Kiai must have `View Channel` and `Connect` permissions to the voice channel for this feature to work</Callout>
+
+Voice XP settings can be found in `/settings > Voice XP`
+
+Kiai offers Voice XP, a feature that allows members to get XP by being in a voice channel.
+
+To gain XP, the voice channel must have more than the configured minimum users required to gain XP and will only recieve XP for the time they spent unmuted in the voice channel. XP is awarded when the user leaves the voice channel.

content/welcome.mdx

@@ -0,0 +1,8 @@
+---
+title: Welcome
+description: Introduction to Kiai, a profound and versatile levelling bot that allows communities to enhance their member experience.
+---
+
+![Kiai Logo](https://cdn.buape.com/Kiai.png)
+
+Kiai is a advanced leveling bot for Discord.