Wubarrk-Alice icon

Alice

Optional PC companion for Wonderland servers: craft and build from nearby chests, a production panel for smelters, kilns and fires, vacuum hand-over and chest settings, bigger chests from the first frame. Does nothing on any other server.

Last updated a day ago
Total downloads 10
Total rating 0 
Categories Utility Mods Tweaks Deep North Update AI Generated Client-side
Dependency string Wubarrk-Alice-0.12.2
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2360 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2360

README

🐇 Alice

ALICE VERSION CLIENT SIDE

Alice in Wonderland: Alice is the client, Wonderland is the server. "Curiouser and curiouser," said the Viking, as the smelter told her it had been fed twelve seconds ago.

Wonderland already does the work. Alice lets you see it, and steer it.

Alice is an optional PC mod for players on servers that run Wonderland. Wonderland 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 single player, or with Enabled = false, the game is plain vanilla.


NEW IN 0.12.0

Everything here is new: the whole companion, in one first release.

You It
Look at a fire, smelter or kiln its hover text says whether the server is feeding it, and what it last did
H · Shift+H · Ctrl+H switch the whole station, just its fuel, or just its ore
Ctrl+P opens the production panel: every station around you, with a switch for each
Craft or build materials in nearby chests count, drawn in blue; nothing is added to your inventory
Ctrl+K at a chest sets what the server's vacuum puts in it, and how far it reaches
Press E at a chest it opens first time, and at its full size from the first frame

🧲 Your drops handed to the vacuum at once · 💾 Your character saved after a chest craft · 📊 A few numbers for the server's Discord bot, only if you say yes


BEFORE YOU INSTALL

If… Then…
🏰 your server does not run Wonderland 1.12.0 or newer with its Alice link on Alice stays dormant and your game is vanilla. The owner switches it on with AliceLinkEnabled (section 20 - Alice Link, off by default).
🛑 you run another mod that changes how crafting counts materials do not run it alongside Alice.
🔌 you also run client mods that use ServerSync or Jotunn a server that enforces vanilla clients still refuses those. That is the server's setting, not Alice's: Alice itself uses neither.
🎮 you play on console you cannot install mods, and nothing changes for you.

I

Nothing in the left column ever depends on the right one.

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.

II

Know what every fire, smelter and kiln is doing, and switch it from where you stand.

You It
Look at a station Auto-supply ON · fed 12 s ago and the keys: 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
H switches the whole station
Shift+H · Ctrl+H just its fuel · just its ore, so you can hand-feed a smelter something precious while the fuel stays automatic
Ctrl+Shift+H · Ctrl+Shift+J every station within 20 m off · back on (like /thumbsup, this also resets the fuel/ore-by-hand choices)
Ctrl+P the production panel
📖 Read the saga — the panel, and why two players never fight over a switch

The production panel lists every fireplace, smelter and kiln within 32 m of you (PanelRadius, capped by the server): 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. All off, All on, Kilns off and Kilns on work on 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. The panel refreshes by itself, works like the inventory while it is open (your cursor is free and the game does not read the mouse or keyboard), and closes with the same key, with Esc, or when you leave the server. PanelScale sizes it.

A kiln takes only wood, and a fire only fuel, so each shows, and answers to, only the half it has (a kiln's wood switch is Ctrl+H).

A key press means "make it the opposite of what I am looking at", sent as a setting rather than a flip. Two players pressing together, or a slightly stale hover, still end where they meant. Switching a station back on keeps your fuel and ore choices.


III

The chests around you are part of your pack, and nothing ever leaves them by mistake.

🔵 Blue numbers a requirement that will come from chests is drawn in blue, with the chest count in its tooltip
🔨 Crafting and upgrading the server sets the missing materials aside when you press craft
🧱 Building one placement's materials are held while a piece is selected, so placing stays instant
↩️ Changed your mind cancel, close the window, change piece, put the hammer away or lose the connection: they go back to the chests
💾 Saved for you your character is saved a few seconds after a craft that used chest materials
📖 Read the saga — why nothing can be lost or doubled

Nothing is ever added to your inventory. The server holds the missing materials for you, and when the game takes its materials Alice takes only your inventory's share and lets the server use the rest. A craft or placement only goes ahead if your inventory plus what the server is holding really covers the cost. Alice never destroys an item.

Building waits until a piece has stayed selected for half a second, so scrolling through the hammer menu costs nothing.

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, say) is declined up front, with the numbers, instead of running out at the end; ask the server owner to raise AliceLinkEscrowSeconds. A reply that arrives after Alice stopped waiting is handed straight back.

Why it saves your character. 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, and skips it when the game's own free-disk-space check says there is not enough room, exactly as the autosave does. Turn it off with SaveAfterChestCraft.

If a game update ever changes how the game takes materials, Alice notices that what was taken is not exactly the cost, switches crafting and building from chests off for that session, says so in the BepInEx log, and hands everything back.


IV

What you drop goes where it belongs, at once, and you see it land.

🤝 Handed over at once your drops and mined items go straight to the vacuum, instead of waiting out the server's settling hold
👀 It looks at what you just made mining, chopping, kills and drops tell the server at once instead of waiting for its next pass
📬 You see where it went Vacuum: +12 Wood, +5 Stone -> Chest when items land in a chest near you
⚙️ Per-chest settings (Ctrl+K) collect from the ground on or off · what it collects · how far it reaches
📖 Read the saga — the hand-over, and the chest settings

Why the hand-over helps. 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 nudge is a hint, at most once a quarter second; VacuumNudge turns it off. VacuumToasts turns the messages off.

Chest settings (Ctrl+K while 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, and 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).
  • 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.


V

No more "press E twice", no more chests that grow when you put something in the bottom row.

📦 Full size 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 at once
🚪 Opens first time if a chest has not opened a moment after you press E (a lost request), Alice asks the server to hand the chest to you, and opens it

VI

A few numbers for the server's Discord bot, and nothing at all unless you answer Share.

❓ Asked once on a server whose owner has switched it on: Share on this server, Not on this server or Never share. Close the window without answering and it asks again next session
📊 What is sent how much your crafting, building, kills, bosses, trees felled and boss last hits rose since you joined, about once a minute, plus your best skill and the total of your skill levels
🚫 Never sent where you are, what you carry, your name beyond the one the server already knows, or anything else
↩️ Change your mind set a server to no and Alice asks that server to forget your numbers the next time you join it
📖 Read the saga — why a mod sends anything at all

Some Wonderland servers 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: kills are on the list because only your own game counts all of them, and a server cannot.

What is sent is only how those counters rose since a baseline taken when the link came up, and only when something changed. A report the server acknowledges moves the baseline by exactly what it carried; a game crash loses at most one interval. Alice only reads; it changes nothing in your game.

The 7 - Sharing section of the config shows your answer per server (address=yes / address=no, editable). ShareStats = Never shares with nobody; Always shares with every server that offers it, except the ones you said no to.


THE TOOLBOX

First ten minutes: install with a mod manager, or put Alice.dll in BepInEx/plugins → join a Wonderland server → look at a smelter and press H → Ctrl+P → craft something with the wood in the chest beside you.

Key Key
H switch a station Ctrl+Shift+H every station near you off
Shift+H its fuel only Ctrl+Shift+J every station near you on
Ctrl+H its ore only (a kiln's wood) Ctrl+P production panel
E open a chest, first time Ctrl+K a chest's vacuum settings

Alice's keys are all rebindable in its config; E is the game's own.

🔗 Check that Alice is linked

The BepInEx log says Linked to Wonderland ... when the server has accepted Alice. If it never does, the server is not running Wonderland 1.12.0 or newer with AliceLinkEnabled on, and Alice is staying out of the way. VerboseLogging logs every link message and decision, for bug reports.

🏰 Switch it on for your server (server owners)

In Wonderland's config, section 20 - Alice Link, set AliceLinkEnabled = true (off by default). Players without Alice are untouched. AliceLinkEscrowSeconds is how long a crafting reservation is held.


MULTIPLAYER

Works without Alice Needs Wonderland on the server, Alice link on Turns on only when the server offers it
everything Wonderland does, for every player on every platform everything Alice does crafting and building from chests · vacuum hand-over and chest settings · sharing numbers
📖 Read the saga — how the link works, and why vanilla enforcement lets it through

Alice talks to Wonderland through two messages the server itself registers, and only after the server has spoken first: the server advertises, Alice answers, the server switches the features on. Only the server is believed (a message from anyone else is dropped), and every message is read defensively.

Alice uses no ServerSync and no Jotunn, on purpose: a Wonderland server that enforces vanilla clients kicks a client that answers those frameworks' probes, and Alice never does.

Gameplay settings (ranges, which features are on) belong to the server and reach Alice when it connects; the radii Alice offers are capped by the server.


COMPATIBILITY

🛑 Other mods that change how crafting counts materials Do not run them alongside Alice.
Wonderland 1.12.0 or newer, with AliceLinkEnabled on. On an older Wonderland, or with the link off, Alice stays dormant. Alice's version number follows Wonderland's: this Alice is built for Wonderland 1.12.
Client mods using ServerSync or Jotunn Still refused by a server with vanilla enforcement on; that is the server's setting, not Alice's.
Platforms Valheim 1.0 on PC: Steam, Steam Deck, Linux. Console players cannot install mods and are unaffected.

SETTINGS

BepInEx/config/wubarrk.alice.cfg, local to your game. Nothing here changes what the server does. Alice has no server-synced settings: the server's own Wonderland config decides what is offered.

🖥️ Local to your game — yours alone
Section Setting What it does
1 - General Enabled master switch; off = the game is vanilla. Read once at start-up (restart to change it)
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: 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
7 - Sharing ReportedStatsServers · ReportedStatsSent your answer per server (address=yes;address=no, editable) · the servers Alice has reported to (managed by Alice)

CREDITS

Needs: BepInExPack Valheim 5.4.2360 · a server running Wonderland. Install with a mod manager, or unzip into BepInEx/plugins.

A Valheim mod by Raven Iron — ravenirongames.com. Bug reports welcome on Discord.