Guides
Step-by-step walkthroughs, from the first run to your own plugin.
Start here
First run: from download to entering the world
What you need, what the setup wizard asks and what happens when you press Play.
First steps
First steps
A tour of the launcher
What is where in the LonelyIce window: the Server and Game panels, the tabs, the Play button, the other pages and the tray icon.
beginner
First steps
Languages
The launcher's own language, the language the game starts in, and how LonelyIce uses your client's Config.wtf.
beginner
Packages
Development
Development
Start here: developing for LonelyIce
What you can build for LonelyIce, the tools you need, and the order in which to read the developer guides and reference.
developer
Development
Your first plugin
A plugin that greets every player on login, from an empty folder to a package installed by the launcher.
developer
Development
Plugin cookbook
Short patterns from real plugins for server code: hooks, timers, commands, config, databases, messages, gossip, creatures, translations, per-player data and playerbots.
developer
Development
Plugin settings
Give a plugin a config file and a group in the launcher's Settings, and read the values in server code.
developer
Development
Shipping SQL with a plugin
Tables and rows in the server's databases: folders, file names, when the SQL runs, and the SQL that works on every backend.
developer
Development
Client patches
Add spells and other DBC rows with patch recipes: named ids, server rows, the generated client archive and what happens on removal.
developer
Development
Wrapping an AzerothCore module
Build an existing AzerothCore module as a LonelyIce plugin without forking it: a pinned source, small patches, its conf and SQL laid out with the plugin.
developer
Development
Storage plugins
How a plugin like lonelyice.mysql adds a database backend to the core and a storage to the launcher.
developer
Development
Debugging plugins
Logs, loader errors, running the server process by hand, attaching a debugger, and switching a plugin off.
developer
Development
Versions, dependencies and platforms
Choosing version numbers, declaring depends and conflicts, shipping several platforms, rebuilding for a new core ABI, and stating languages.
developer
Development
Publishing a package
From a built plugin to the catalog: packing, uploading, automatic checks and review.
developer
Development
What the catalog checks and reviewers look for
Every automatic check on an upload, what each message means, how moderators review and decide, and a checklist before you upload.
developer
Development
Hosting your own catalog
Serve your packages from a folder or a web server: the index.json format, building it with --pkg pack, and adding the catalog to the launcher.
developer
Contributing
Contributing
Building the core
Build the AzerothCore fork on its own, build plugins against it, run a plain worldserver with plugins, and build LonelyIce with your own core checkout.
developer
Contributing
Contributing
Which repository a change belongs in, the conventions each one follows, how to report bugs and submit changes, and how documentation stays in sync.
developer
Server
Server
Accounts and GM access
Create game accounts in the launcher, change passwords and GM levels, and rename your realm.
beginner
Server
Console and commands
Read the server log, type server commands, use the ready-made command cards, and a list of useful AzerothCore console commands.
intermediate
Server
Settings
The Settings page: server rates and difficulty, network options, plugin settings, storage and the launcher's own options, and when each change takes effect.
beginner
Server
Backups and restoring
What LonelyIce backs up, when it does it, where the backups go and how to put one back.
beginner
Server
Updating LonelyIce and packages
How to put a new LonelyIce release in place without losing anything, how to update packages, and what happens to the databases.
beginner
Server
Moving the databases to MySQL
Keep the server's databases on a MySQL 8 server with the lonelyice.mysql package, and what changes when you do.
intermediate
Server
Game data: reading the client, the disk cache and navigation maps
How the server gets its data from your game client, what the disk cache and the movement maps for bots cost, and what to pick.
intermediate
Server
Running on Linux and macOS
How LonelyIce is meant to run on Linux and macOS, with the game client through Wine. Not tested yet.
intermediate
Help
Bots
Bots
Playing with bots
Fill your party with bots, give them the everyday orders and choose how many random bots live in the world.
beginner
Bots
Bot commands and strategies
The chat commands your bots understand, grouped by purpose, and how to switch their strategies.
intermediate
Bots
Bot tactics
Give each bot an ordered list of rules, manage your party from one window and let the bots follow what you do.
intermediate
Gameplay plugins
Gameplay plugins
Kirin Tor waystones
Touch a waycrystal once, then translocate between the crystals you know from any crystal or from the world map.
beginner
Gameplay plugins
Quality of life
Sprint for every character and auto-loot of money and quest items; bots never take a share of your coins.
beginner
Gameplay plugins
Living capitals
Random bots move into the capital you are in, stroll, rest, chat and greet you, and leave again after you go.
beginner
Gameplay plugins
NpcMap addon
Vendors, trainers, banks, mailboxes and other services as pins on the zone maps, with filters.
beginner
Community modules
Community modules
Auction House Bot
Give the bot a character of its own so the auction houses fill with items and your own auctions find a buyer.
intermediate
Community modules
Transmogrification
Place the Warpweaver, change the look of your gear, save sets and set the rules and prices.
beginner
Community modules
Beastmaster
Adopt tamed beasts from White Fang, as a hunter or, if you allow it, as any class.
beginner
Community modules
AoE loot
Loot every corpse around you with one click, and what to set if you want it to reach further.
beginner
Community modules
Instance reset
Place Cromi and clear your dungeon and raid lockouts whenever you like, for free or for a price.
beginner
Community modules
Learn spells on level up
Get your new class spells the moment you level up, without a trip to the trainer.
beginner
Community modules
MultiBot
Control your bots from a window instead of chat commands, with the MultiBot addon and its server bridge.
intermediate
No guide matches.