01 What is IdleRPG?
IdleRPG is a quiet, asynchronous role-playing game that runs on IRC. Your character — a name, a class, a level, ten equipment slots — levels up simply by staying idle in the bot's channel. Talking, parting or changing nick all add time to your next level. The longer you remain present, the more powerful you become.
On top of that gentle clock, the bot runs a deep simulation: daily duels, boss encounters, tournaments, quest chains, guild wars, world events, an auction house, bounties, crafting, alliances, monthly seasons. None of it needs you to be active — your character does the work while you go on with your day.
02 Getting started
1. Pick a network & join the channel
The bot runs on multiple IRC networks simultaneously — characters from each network share one world and can battle, quest, and ally with each other. Active networks:
Connect with any IRC client, join the bot's channel, and stay connected — that's what "idling" means here.
2. Register a character
Open a private message with the bot and register, optionally with a class:
/msg idlrpg REGISTER <name> <password> [class] # example with a class /msg idlrpg REGISTER Nebula moonbeam77 Mage
If you skip the class, the bot picks one randomly. The 12 supported classes are listed in section 04. Names must be unique and the password is the same one you'll use here on the website.
3. Sign in here
Open Sign in with the same name and password. Once signed in, the header gets a My Hero link to your character sheet, where you can change your password and see your private stats.
irpg.db, and the password is checked with crypt(). Change it in one place and it changes for both.03 Levelling clock & penalties
Each character has a personal countdown — the next field on your sheet. While it counts down, you're idling. When it reaches zero, you level up, and a longer countdown begins.
The default schedule: level 1 takes ~3 minutes at the bot's default rpbase. Each subsequent level multiplies. By level 30 a single level is about a day, by level 60 several days. After level 60 the formula switches and each new level adds another full day.
Penalties — almost everything you do pushes the clock back
| Action | Base cost | Notes |
|---|---|---|
| Channel message | ~1 s × length | Longer messages cost more (scales with level) |
| Notice in channel | ~1 s × length | Same as message |
| Changing nick | 30 s | Per change |
| Parting the channel | 200 s | Goodbye costs |
| Being kicked | 250 s | Per kick |
| Quitting IRC | 20 s | Auto-rejoin doesn't escape it |
LOGOUT command | 20 s | Manual sign-out from the bot |
| Failing a quest | 15 s × everyone's level | Hits all online players when a quester misbehaves |
Penalties scale with your level (each penalty is multiplied by rppenstep ^ level), so high-level characters pay more. The bot caps individual penalties at the operator's limitpen value if set.
04 The 12 hero classes
Class is set at registration (or randomly assigned) and shapes which events your character excels at. Each class has a combat affinity — the bot looks up specific bonuses for duels, boss fights, tournaments, guild wars, quests, and building. Choose deliberately.
Change your class string later from IRC with CHCLASS (admin) or by re-registering. Skill points are auto-distributed every 30 minutes toward your class's preferred stats.
05 Guilds & infrastructure
Every new character is automatically assigned to the guild with the fewest members. Guilds share a treasury, hire workers, and construct buildings that benefit every member.
The six buildings
CRAFT command for the entire guild.The four workers
Workers are consumed when a building is constructed. Hire them from the guild treasury — the Engineer class needs one fewer worker per building, and pays 25% less gold for everything.
| Worker | Cost (per hire) | Used for |
|---|---|---|
| 🪚 Carpenter | 50g | Wood — Guild Hall, Watchtower |
| 🧱 Mason | 80g | Stone — Barracks, Treasury, Castle |
| ⚒ Metalworker | 120g | Forge — weapons & armor crafting |
| 📜 Scholar | 200g | Treasury, Library, research |
Guild XP & perks
Guilds earn XP from quest completions, boss kills, war victories, and tournament wins (their members confer it). At each guild level the whole guild unlocks a passive perk:
- Level 2 — Gold Bonus: +10% gold from events
- Level 3 — XP Bonus: +5% experience from battles
- Level 5 — Cooldown Reduction: −10% cooldowns
- Level 7 — Combat Mastery: +50 combat power per member
- Level 10 — Legendary Luck: 2× item blessing chance
06 Gold economy
Gold is the realm's main currency. It buys buildings, hires workers, declares wars, places bounties, fuels auctions, and disappears slowly through tax. The economy is designed so hoarding doesn't pay — gold should keep moving.
Tax brackets (charged every 20 minutes)
Your guild's Treasury shaves another 0.5% off your tax rate, and the Barbarian class shaves 1% more.
How gold flows in
- Idle tick: +1g every 30 minutes online
- Duel victory: +15g
- Boss participation: +20g
- Tournament victory: +40g
- Quest completion: +25g (more for chains)
- Guild quest completion: +50–75g
- Auction sale, war loot, bounty claim: varies
How gold flows out
- Tax: 1–3.5% every 20 minutes
- Workers: 50–200g per hire
- Buildings: 500–15,000g
- War declaration: 500g
- Periodic equipment purchases by the bot: 20–6,000g (tiered)
- Bounty placement, auction bidding
Gold flow simulator
Move the sliders to see how the tax brackets, idle income, and event income net out over a day. Useful for figuring out whether you're hoarding into the punitive bracket.
07 Wars, battles, tournaments
Guild War — 5 phases
Once a guild has a Castle, its admins can GDECLARE war on another. The war moves through five phases automatically:
Winners loot 20% of the loser's treasury, destroy one of their buildings (Castle excluded), and earn war titles. If the winner has a Castle, they qualify for the Kingdom War tournament 6 hours later — top 3 guilds compete for the Throne and a 10% gold tax on all rivals for 24h.
Chain Battle — 3 escalating waves
Every few hours a small party of online heroes faces a 3-wave dungeon. Clear all three to claim loot, fail one and retreat with a penalty.
Tournaments
Every ~6 hours of activity the bot runs a single-elimination tournament. Size is auto-scaled to the player count: 4, 8, 16, or 32. Rounds run two minutes apart. The champion earns a 25% time advancement, +40g, and +125 guild XP.
Battles, bosses, hand of god, calamities, godsends
Throughout the day the bot fires smaller events:
- Automated duels — paired by similar level, hourly cooldown per player
- Boss encounters — 3–5 heroes vs an Ancient Dragon, Lich King, Demon Lord, Void Titan, Shadow Beast, Storm Giant, Phoenix Lord, or Frost Wyrm
- Team battles — 3v3 with 20% time stake
- Hand of God — pushes a random hero toward (or away from) their next level
- Calamities — chips an item's effectiveness by 10%, or adds time
- Godsends — blesses an item by 10%, or removes time
- Monster encounters & mysterious merchant — surprise events
08 Quest systems
Four overlapping quest types run in parallel. You can be in several at once.
Standard quest
Four high-level (40+) characters are chosen by the gods every 6–12 hours. Either a type 1 (time-based: stay quiet and let the timer expire) or type 2 (map-based: walk to two waypoints). Success = 25% time reduction for the party + 25g each + 75 guild XP. Failure = penalty for every online player.
Quest chains
Every 2 hours, 2–4 mid-level heroes (15+) embark on a 5-step adventure — Dragon's Lair Expedition, Lost Kingdom Quest, Void Portal Crisis. Each step pays gold and guild XP; finishing the whole chain pays a big bonus, drops a crafting material, and immediately restarts the chain with the same party at +15% rewards. Perpetual loop: chains never truly end.
Guild quests
Once a guild has 3+ online members it can be picked for a guild quest: Treasury Heist (1h), Ancient Relic Recovery (80m), or Honor Defense (45m). Pays 50–75g per participant and 200–300 guild XP.
Unlimited quests
Solo or group missions that fire constantly — Treasure Hunt, Monster Slaying, Artifact Recovery, Bandit Camp Raid, Rescue Mission, Ancient Temple Exploration. Reward and duration scale with your level. Hard / Very Hard variants pay extra time reductions.
09 Crafting & materials
Once your guild has built a Forge, any member can use the CRAFT command. Crafting consumes raw materials and produces permanent item-level upgrades — typically much better than what random drops give you at the same level.
The four materials
Recipes
| Item | Materials | Bonus |
|---|---|---|
| Sword | 3 iron · 1 wood | +5 weapon levels |
| Shield | 2 iron · 2 leather | +4 shield levels |
| Helm | 2 iron · 1 leather | +3 helm levels |
| Armor | 3 iron · 2 leather | +6 tunic levels |
| Ring | 1 iron · 2 magic dust | +4 ring levels |
| Amulet | 1 iron · 3 magic dust | +5 amulet levels |
| Boots | 3 leather | +3 boot levels |
| Gloves | 2 leather · 1 iron | +3 glove levels |
Check your own stockpile any time with MATERIALS.
10 Prestige, titles & seasons
Prestige (level 60+)
When you reach level 60, type PRESTIGE to be reborn. Your level resets to 0, but every one of your 10 equipment slots gains a permanent +2 levels per prestige bonus. You also receive a prestige title: Reborn → Ascended → Mythic → Legendary → Divine → Immortal → Eternal → Transcendent → Ancient → The Undying.
Hero titles
Titles are earned by winning chain battles, guild wars, world events, and surviving seasonal resets. Your title shows on your profile and in the bot's announcements. View any player's title with TITLE <name>.
Seasons (monthly)
Every 30 days the realm rolls over into a new season. The top 5 heroes by level receive permanent seasonal trophies — Season Legend, Season Champion, Season Hero, Season Veteran, Season Challenger — plus a gold reward. Then every character is soft-reset: levels cut by 20%, but items, gold, and titles are preserved. Check the season clock on the dashboard.
11 Bounties, auctions, alliances, spy
Bounties
Want someone dead? Place a bounty with BOUNTY <player> <gold> (minimum 10g). Anyone who later defeats that target in a duel claims the entire pot. Top bounties are listed on the dashboard for everyone to see.
Auction house
Sell a piece of your own equipment with AUCTION <slot> <min_bid>. Other players bid via BID <id> <amount>; auctions last 1 hour. Outbid players get refunded automatically. If you're a Merchant, 10% of every sale you make goes to your guild's treasury as a trading levy.
Alliances
Guild admins can ALLY <guild> with another guild. Allies cannot attack each other, and grant a +10% war power bonus when allied members are online during a war's final battle.
Spy operations (Assassin only)
Only the Assassin class can run espionage. Use SPY <target_guild> steal|sabotage. Steal nets gold from the target's treasury; sabotage disables one of their buildings for 6 hours. Both have a 60% success rate; failure adds a sizeable penalty to your timer.
12 Achievements
The bot tracks named milestones and awards achievement points (5–30 per achievement). Your running total appears on your character sheet and on the leaderboard. A non-exhaustive list:
- First Milestone — reach level 10 (10 pts)
- Master Adventurer — reach level 50 (25 pts)
- Battle Veteran — 10 duel wins (10 pts)
- Boss Slayer — 5 boss kills (25 pts)
- Tournament Victor — win a tournament (25 pts)
- Guild Member — join a guild (5 pts)
- Elite Guild Member — your guild hits level 5 (15 pts)
- Legendary Guild Member — your guild hits level 10 (25 pts)
- Wealthy Adventurer — 1,000 gold (15 pts)
- Gold Magnate — 5,000 gold (30 pts)
Achievements are persistent — if you prestige or lose levels in a season reset, they stay with you.
13 Using this site
Everything except admin tools is publicly visible — no login needed to read. Signing in only adds the things that are specifically yours.
| Page | Anonymous | Signed in | Admin |
|---|---|---|---|
Dashboard index.php | view | view | view |
Profile of any character profile.php?u=Name | public fields | public fields | + nick / host / penalties |
My Hero profile.php | — | view + change password + materials | view all |
Guild page guild.php?g=Name | view (incl. treasury, buildings) | view | view |
Sign in login.php | open | — | — |
Command admin.php | — | — | full access |
System setup.php | — | — | full access |
| Help (this page) | view | view | view |
Theme picker
Click the moon icon in the header to pick a theme — Orbital, Lux, Claude, or Indigo. Your choice is remembered for your browser. Admins set the site-wide default in Command → Site Settings.
14 Bot commands — quick reference
All commands go to the bot in a private message: /msg idlrpg <command>.
# --- character --- REGISTER <name> <pass> [class] # create a character LOGIN <name> <pass> # sign back in LOGOUT # sign out (small penalty) NEWPASS <new password> # change your password ALIGN good | evil | neutral # pick/change alignment WHOAMI # full stat dump STATUS [player] # your stats or anyone's TOP [n] # top N leaderboard (default 5) INFO # bot/server info QUEST # status of the active quest REMOVEME # delete your own character (forever) # --- guild economy --- GDEPOSIT <amount> # deposit gold into guild treasury GWITHDRAW <amount> # withdraw (guild admin only) GHIRE <type> <count> # carpenter|mason|metalworker|scholar GBUILD <building> # hall|barracks|forge|watchtower|treasury|castle GINFO [guild] # show treasury/buildings/workers # --- combat --- GDECLARE <target_guild> # declare war (Castle required, 500g) WARS # list active wars BOUNTY <player> <gold> # place a bounty SPY <guild> <steal|sabotage> # Assassin only # --- trading --- AUCTION <item> <min_bid> # sell an item (1h auction) BID <auction_id> <amount> # bid on an auction # --- social --- ALLY <guild> # form an alliance (guild admin) TITLE [player] # view a player's title SEASON # current season + time to next reset PRESTIGE # rebirth at level 60+ # --- crafting --- CRAFT <item> # sword|shield|helm|armor|ring|amulet|boots|gloves MATERIALS # show your stockpile # --- admin (subset) --- MKADMIN <name> # promote DELADMIN <name> # demote CHPASS <name> <new pass> # force-reset a password DEL <name> # delete a character PAUSE | REHASH | BACKUP | DIE # control the bot HOG # manual Hand-of-God PUSH <name> <seconds> # push someone toward/away from their next level
The web's Command page mirrors the most common admin actions (view everything, edit, reset password, promote/demote, delete, CSV export, site settings) so you usually don't need to drop into IRC to do them.
15 House rules — conditions of play
These are the basic conditions for participating. Admins enforce them at their discretion; consequences range from a polite warning to a deleted character.
- One person, one character. Multi-accounting (one human running multiple characters across networks) ruins leaderboards and is the most common reason for a reset. The bot allows one active session per account.
- No account sharing. Your password is yours. Don't hand it out and don't ask anyone else for theirs.
- No anti-penalty automation. Auto-rejoin scripts, auto-LOGIN, away-message ping replies — anything that defeats the penalty system. If you're disconnected, you're disconnected.
- Be decent in channel. No harassment, no slurs, no doxxing, no posting other people's personal info.
- Don't probe for exploits. Spamming commands, injecting weird payloads, attempting to escalate privileges via creative inputs — grounds for a ban.
- Privacy. Don't share other players' IRC hosts. Admins see them out of necessity, not for gossip.
- Admins are players too. They earn their levels the same way you do.
By signing in here you accept these conditions and the bot operator's right to enforce them.
16 Frequently asked
Why isn't my level going up?
Check your Penalty Time on My Hero. If you've spoken, parted, or changed nick recently, that's where the time went. Penalties never cancel a level, they just push it back.
I forgot my password.
Ask an admin in the bot's channel for a reset (CHPASS or via the Command page on the web). Once they tell you the new password, sign in and change it immediately with NEWPASS.
How do I change my class?
Only an admin can change your class string from IRC: CHCLASS <name> <new class>. Class bonuses are tied to the names of the 12 canonical classes; custom strings still work but won't get class-specific bonuses.
Can I move my character between networks?
Your character lives on whichever network you registered on, but every network shares the same world — your character is visible and active everywhere. Migrations to a different network are an operator-only action.
Where does my gold go when I prestige?
You keep it. Prestige resets your level and grants permanent item bonuses, but gold, achievements, and titles stay.
What happens if the bot crashes?
The bot writes its full state (irpg.db + state.json) every 60 seconds. At worst you lose a minute. The web reflects whatever the bot last wrote — the System page shows readability and backup age.
Why does my hero need to be online to be in a quest/war?
Many events recruit from "currently online" players for fairness. Quests, guild quests, chain battles, and final-phase war fights all sample online heroes. Staying connected is the simplest way to maximise your involvement.