Alice is an optional PC client mod for servers that run Wonderland. Wonderland already does its work for every player with nothing installed; Alice lets the players who want to see and steer it do so. Install it or don't: the world behaves the same either way, and every player (Steam, Xbox, PlayStation, Switch) keeps exactly the experience they have today.
Alice does nothing on a server that is not running Wonderland with its Alice link switched on. It never sends a
message until the server speaks to it first, so on any other server, in singleplayer, or with Enabled = false, the game
is plain vanilla.
With and without Alice
| Without Alice (everyone, every platform) | With Alice (PC) | |
|---|---|---|
| 🔥 Kilns, smelters, fires | The server keeps them fed from nearby chests. /nonono stops a station, /thumbsup starts it again. |
You see whether it is being fed and what it last did, and switch the whole station, just its fuel, or just its ore with a key - or every station around you at once. The emotes keep working. |
| 📦 Chest size | Player-built chests and ship holds have extra rows; the server keeps a stack in the bottom row so your game draws them. | The full size is there from the first frame, empty or not. |
| 🚪 Opening a chest | Press E; if nothing happens, press E again. | If nothing happens within a moment, Alice asks the server to hand you the chest and opens it. |
| 🔨 Crafting and building | Materials must be in your inventory. | Materials in nearby chests count too, drawn in blue. Nothing is added to your inventory: the server holds them for you and puts them back if the craft or placement does not happen. (Turns on when the server offers it.) |
| 🧲 Vacuum | The server moves items lying on the ground into the chests that want them, after a short settling hold. | Stacks you drop or mine are handed over at once, you see what went where, and you can set each chest: on or off, what it collects, how far it reaches. (Turns on when the server offers it.) |
| 🏭 Production overview | /nonono and /thumbsup switch the station you are next to. |
One window lists every station around you with its state and a switch for each. |
Nothing in the left column ever depends on the right one.
What it adds
🔥 Production
Look at a fireplace, smelter or kiln on a Wonderland server and Alice adds a line to its hover text:
Auto-supply ON · fed 12 s ago
[H] switch [Shift+H] fuel [Ctrl+H] ore
It tells you whether the server's auto-supply is feeding that station, which half (fuel, ore) is on, and what it last did -
fed, full, no fuel in reach, no ore in reach, waiting for its owner. The keys switch it, for the whole station or for its
fuel or ore alone, so you can hand-feed a smelter with something precious while the fuel stays automatic. A kiln takes only wood, so it has just its wood switch (Ctrl+H), and a fire only its fuel. Ctrl+Shift+H switches every station within 20 m off in one go and Ctrl+Shift+J switches them back on (like /thumbsup, this also resets fuel/ore-by-hand choices). Pressing a key means
"make it the opposite of what I am looking at", so two players pressing together still end where they meant.
🏭 The production panel
Ctrl+P opens a window with every fireplace, smelter and kiln within 32 m of you (PanelRadius): its name, how far away it is, whether the server is feeding it and what
it last did (fed 4 s ago, no ore in reach...), and a switch for the whole station and for each half it has (fuel and ore; a kiln has only wood, a fire only fuel) - plus All off, All on, Kilns off and Kilns on for the whole list.
It is the same switching the hover keys do, laid out where you can see everything at once; a station farther than the server lets you reach is shown but not switchable until you walk closer. It refreshes by itself,
works like the inventory while it is open (your cursor is free, the game does not read the mouse or keyboard), and closes with the same key, with Esc, or when you leave the server.
🧲 Vacuum
Wonderland's vacuum already moves items lying on the ground into the chests that want them. With Alice:
- Your drops and mined items are handed over at once. Without Alice the server has to take ownership of a stack you are standing next to and hold it for a second before it dares move it, because your game could pick it up in that moment. With Alice the server asks, your game says yes (or "that one is mine"), and the stack goes straight into the chest. Alice agrees unless your own pickup is about to take the stack - anything within about 3 metres that your auto-pickup would claim stays yours. Alice never moves, edits or destroys an item: the only thing it does is hand the server ownership of the stack, and the server moves it only once it can see for itself that it now owns it. If anything is unclear the stack simply stays where it is and the server's usual way applies.
- The vacuum looks at what you just made. Mining, chopping, kills and drops tell the server at once (a hint, once a quarter second at most) instead of waiting for its next pass.
VacuumNudgeturns that off. - You see where it went. A short message when items land in a chest near you:
Vacuum: +12 Wood, +5 Stone -> Chest.VacuumToaststurns it off. - Per-chest settings (
Ctrl+Kwhile looking at a chest, or with its window open): Collect items from the ground on or off; what it collects - only what it already holds (today's behaviour), a list of chosen item types (it keeps collecting them after it runs empty - "Learn from contents" fills the list from what is inside), or everything nobody else wants (a sink chest, always ranked below any chest that matches); and the chest's own reach. The settings are stored by the server, not in the chest, so nothing about the chest or its contents changes; only players who may open the chest can change them, and players without Alice see only the effect.
📊 Sharing a few numbers with the server's Discord bot (only if you say yes)
Some Wonderland servers can show members things like who crafts the most or what is Cara's best skill through a Discord bot. Wonderland measures most of that itself, for everyone. A few numbers only your game knows, so, on a server whose owner has switched
it on, Alice asks you once: how many things you have crafted and built, how many creatures and bosses you have killed, how many trees you felled, your boss last hits, and your best skill (kills are on the list because only your own game counts all of them - a server cannot).
Nothing is sent unless you answer Share.
What is sent is only how those counters rose since you joined, about once a minute, plus your best skill and the total of your skill levels - never where you are, what you carry, your name beyond the one the server already knows, or anything else.
Change your mind whenever you like: the Sharing section of the config shows your answer per server (address=yes / address=no); setting a server to no makes Alice ask that server to forget your numbers the next time you join it. ShareStats = Never shares with nobody, Always with every server that offers it except the ones you said no to.
📦 Chests
- Full-size chests from the first frame. Wonderland gives player-built chests and ship cargo holds extra rows. A vanilla client only learns a chest is taller once a stack sits in the bottom row; Alice is told the size and builds the whole grid immediately.
- Chests that open first time. If a chest has not opened a moment after you press E (a lost request, the "press E twice" case), Alice asks the server to hand the chest to you and opens it.
🔨 Crafting and building from chests
Crafting, upgrading and placing pieces count the materials in player-built chests near you. A requirement that will come from chests is drawn in blue, with the chest count in its tooltip. Nothing is added to your inventory: when you start a craft, or while you hold a piece selected with the hammer, the server sets the missing materials aside, and when the game takes its materials Alice takes only your inventory's share. Change piece, put the hammer away, cancel the craft, close the window or lose the connection and they go back to the chests. Alice never destroys an item, and a craft or placement only goes ahead if your inventory plus what the server is holding really covers the cost.
- How long the server holds a craft's materials is the server's setting. A craft that would take longer than that (a high-quality
upgrade) is declined up front with the numbers; ask the server owner to raise
AliceLinkEscrowSeconds. - Your character is saved after a craft that used chest materials. The chests change the moment you craft, but your character is
only written to disk at the game's 30-minute autosave, so a game crash in between would leave the chests short while your character
forgets the craft (the same thing happens if you carry items out of a chest by hand and the game crashes). Alice asks the game to save
a few seconds after such a craft, never more than once every 20 seconds. Turn it off with
SaveAfterChestCraft. - If the game ever starts consuming materials differently from what Alice reserved for (a game update), Alice switches crafting and building from chests off for that session, says so in the BepInEx log, and hands everything back.
Compatibility
- Valheim 1.0.17, PC (Steam, Steam Deck, Linux). Console players cannot install mods and are unaffected.
- Wonderland 1.12.0 or newer with its Alice link on: config section
20 - Alice Link,AliceLinkEnabled(off by default). On an older Wonderland, or with the link off, Alice stays dormant. - Alice uses no ServerSync and no Jotunn, on purpose: a Wonderland server that enforces vanilla clients kicks a client that answers those frameworks' probes. Alice only talks to the server through two messages the server itself registers, and only after the server has spoken first.
- Other client mods that use ServerSync or Jotunn are still refused by a server with vanilla enforcement on - that is the server's setting, not Alice's. Do not run Alice alongside another mod that changes how crafting counts materials.
Configuration
BepInEx/config/wubarrk.alice.cfg, local to your game. Nothing here changes what the server does.
| Section | Setting | What it does |
|---|---|---|
1 - General |
Enabled |
Master switch. Off = the game is vanilla. |
1 - General |
VerboseLogging |
Log every link message and decision (for bug reports). |
2 - Production |
ProductionEnabled, ShowStationStatus |
The hover line and the keys. |
2 - Production |
ToggleStationKey, ToggleFuelKey, ToggleOreKey |
Default H, Shift+H, Ctrl+H. |
2 - Production |
AllOffKey, AllOnKey, BulkRadius |
Default Ctrl+Shift+H / Ctrl+Shift+J, 20 m: switch every station around you off or on at once. |
2 - Production |
ProductionPanelKey, PanelRadius |
Default Ctrl+P, 32 m: the production panel and how far around you it lists. |
3 - Containers |
GrowContainerRows, ReliableOpen |
Size chests from the server's table; the open fallback. |
4 - Crafting & Building |
CraftFromChests, BuildFromChests |
Use materials from nearby chests (when the server offers it). |
4 - Crafting & Building |
SaveAfterChestCraft |
Save your character a few seconds after a craft that used chest materials (default on). |
5 - Interface |
PanelScale |
Text and window size of Alice's windows (default 1.0; raise it on a high-resolution screen). |
6 - Vacuum |
VacuumCooperation |
Hand ground stacks to the server's vacuum when it asks, and use the chest settings (default on). |
6 - Vacuum |
VacuumNudge, VacuumToasts |
Tell the server about items you just made; show the "+12 Wood -> Chest" message (default on). |
6 - Vacuum |
ChestSettingsKey |
Default Ctrl+K: a chest's vacuum settings. |
7 - Sharing |
ShareStats |
Ask (default: once per server), Always or Never: whether Alice shares a few numbers with a server's Discord bot. |
7 - Sharing |
ReportedStatsServers, ReportedStatsSent |
Your answer per server (address=yes;address=no, editable) and the servers Alice has reported to (managed by Alice). |
Gameplay settings (ranges, which features are on) belong to the server and reach Alice when it connects.
Installation
- Install BepInExPack Valheim (the Valheim 1.0 pack, 5.4.2351).
- Drop
Alice.dllintoBepInEx/plugins. - Join a Wonderland server. The BepInEx log says
Linked to Wonderland ...when the server has accepted Alice.
A Valheim mod by Raven Iron.