Admin Setup

Everything about the RPG system is configured from the dashboard. This page walks through enabling the system, loading default content, adjusting settings, and creating custom content.

Enabling the RPG System

To turn on the RPG system for your server:

Go to your server's dashboard
Navigate to RPG → Settings
Toggle Enable RPG on

Once enabled, RPG commands become available to all members. You can disable it at any time without losing any data — progress is preserved.

Premium Required

The RPG system requires an active premium subscription. All RPG commands and dashboard pages are only accessible to premium servers.

Loading Default Data

After enabling the RPG, click Load Default Data on the Settings page. This populates your server with a complete starter package:

4 classes (Warrior, Mage, Rogue, Healer)
Starter items across all types and rarities
Monsters spanning level 1 to 50
Exploration zones with encounter tables
Crafting recipes from basic to legendary
5 introductory story quests
~25 default achievements

Loading defaults never overwrites existing content. If you have already created custom classes or items, they are preserved. The system skips any defaults that already exist.

Get Running in 30 Seconds

Enable RPG, click Load Default Data, and your server has a fully playable RPG system immediately. Customize everything later at your own pace.

Configuration Options

The RPG Settings page has several options to tune the gameplay experience for your server:

Setting	Default	Description
Stat Tier	Simple	Controls stat complexity (Simple / Moderate / Deep)
Class Level Cap	50	Maximum class level members can reach
Stat Points Per Level	3	How many allocatable stat points earned per class level
Class Switch Cooldown	24 hours	Time between class switches (0 = no cooldown)
Battle Cooldown	5 minutes	Time between monster battles (direct battle command)
Boss Attack Cooldown	30 minutes	Time between boss attack attempts per player
Inventory Cap	20	Maximum items a member can hold at once
Max Energy	100	Maximum energy pool for exploration
Energy Regen Rate	1 per 5 min	How quickly energy refills over time
Explore Cost	10	Energy cost per exploration

Feature Toggles

Several RPG subsystems can be individually enabled or disabled:

Toggle	Default	What It Controls
PvP	Enabled	Player-versus-player challenges and ranked matchmaking
Enhancement	Enabled	Equipment enhancement system (+0 to +10)
Achievements	Enabled	Achievement tracking and title rewards
Battle Command	Enabled	Direct `/rpg battle` command (disable to funnel players through exploration only)

Exploration Is Always On

The exploration system is always available when RPG is enabled. The toggles above only control additional subsystems. Even with PvP and enhancement disabled, members can still explore, battle monsters, and progress through the core RPG loop.

Zone Configuration

Zones are configured under RPG → Zones. For each zone, you can customize:

Encounter weights — Adjust the percentage for each encounter type (monster, treasure, trap, merchant, etc.)
Trap definitions — Choose which stat is checked, the difficulty, and the penalty for failure
Merchant inventory — Select which items the wandering merchant sells in this zone
Lore fragments — Write the text entries that tell the zone's story
Resource nodes — Choose which crafting materials can be gathered
Mastery thresholds — Set how many actions are needed for each mastery rank (Bronze through Platinum)
Environmental effects — Set passive combat modifiers active in the zone

Creating Custom Content

Every piece of RPG content can be created and customized from the dashboard. Here is where to find each content type:

Content	Dashboard Page	What You Can Create
Classes	RPG → Settings	Custom classes with stat bonuses, descriptions, and emoji icons
Items	RPG → Items & Shop	Weapons, armor, accessories, charms, consumables, and materials with custom stats and prices
Monsters	RPG → Monsters	Custom monsters with level ranges, combat stats, XP rewards, and loot tables
Zones	RPG → Zones	Exploration zones with encounter weights, traps, merchants, lore, and environmental effects
Recipes	RPG → Recipes	Crafting recipes with material requirements, XP costs, and class restrictions
Quests	RPG → Quests	Multi-step story quests with narrative text, objectives, rewards, and prerequisites
Achievements	RPG → Achievements	Custom achievements with conditions, thresholds, and rewards (XP, tokens, titles)
Bosses	RPG → Bosses	Boss events with HP, time limits, and reward tables

Wiping Data

At the bottom of the RPG Settings page is a Danger Zone section. This lets you reset RPG data for your server. Use this if you want to start fresh or make major changes that require a clean slate.

Data Wipe is Permanent

Wiping RPG data deletes all player progress, inventories, quest completions, and achievement progress. This action cannot be undone. Content definitions (classes, items, monsters, etc.) may be preserved depending on the reset option chosen.

Webhooks for RPG Events

The RPG system emits webhook events that your external services can listen for. Configure webhook endpoints under Integrations → Webhooks in the dashboard.

Event	When It Fires
`rpg.class_select`	A member selects or switches their class
`rpg.level_up`	A member gains a class level
`rpg.boss_kill`	A boss event is defeated by the community
`rpg.quest_complete`	A member completes a quest