Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
9 hours ago
Downloads
66
Size
380KB
ADDatHost Valheim hosting
30% off

Thing

Version 0.1.14 source candidate. Targets Crucible 0.3.33 / Crucible.UI 0.3.22; the final provider binaries are pinned and Thing builds remain pending. Changes are in CHANGELOG.md.

Server administration and moderation from inside the game, checked against the server's own admin list.

Features

  • Administration window for admins (the Meadworks menu: F8 or Esc > Meadworks; Admin Window Key, unbound by default), with gamepad support. Players are identified by platform ID even when names match.
  • People: see who is online, kick, ban permanently or for a limited time, unban, warn and mute with reasons; edit the permitted list, and the admin list when the server allows it.
  • Freeze: an admin can freeze or unfreeze a connected player for this connection only. The frozen player cannot move or use actions. Menus and chat still work. The flag clears on unfreeze and on disconnect, and it is not saved.
  • Permissions: the host or a listed admin can grant World tools, Spawn, Teleport, Freeze, Inventory and Ward for one platform id, including an id that is offline. Grants are stored on the server for that world. Listed admins keep every right. Everyone else starts with none. The People page edits the grants. A player who holds one of these grants can open the People page. The other pages stay with a listed admin. A grant does not turn on a server switch that is off.
  • Inventory: an admin with the Inventory right can view a connected player's inventory (up to 48 stacks) and Take or Delete one stack. Take removes that stack from the player and puts it in an empty slot in your inventory as its own stack, or leaves it at your feet when no empty slot is free. It does not merge into a stack you already have. Delete asks a second time and is written to the server log. Custom data, quality, durability, crafter and variant are kept. Closing the window drops a delete that is still waiting for the second confirm.
  • Moderation log and the most recent audit records.
  • Messages: broadcast to everyone (center or top-left), schedule or cancel a shutdown, save the world, and edit the message of the day and recurring announcements.
  • World tools: show the world seed, set or freeze the global time, a session-only ward bypass, terrain reset in a previewed circle, and removal of loose dropped items, each with a confirmation step.
  • Player teleport: thing goto <player> and thing bring <player>, optionally asking the player first.
  • Server configuration: browse the server's config files and edit settings from in game, with a backup, and a check that the new value was saved. Files no plugin owns stay read-only.
  • With Delve installed: a Regeneration page with Delve's status, recent actions, known dungeon and resource clocks and reset requests; Regenerate nature and Reset resources on the World page (thing regenerate nature, thing resetresources) bring back felled trees, mined rocks and picked resources in generated zones around the admin, never near player buildings.
  • Admin pickup radius: thing pickup <1-10> or the World page sets your own item pickup radius in meters; thing pickup reset (or leaving the world, or losing admin) puts back the game's 2 m.
  • Console commands for the same actions, for example thing say, thing terrain, thing drops, thing ward and thing seed.
  • Every action is checked on the server against its own adminlist.txt by platform ID, never by display name, and refusal reasons reach the player in their language.

Qualification and source provenance

The 0.1.14 source adds the selected player name and platform ID to both Sub-Admin confirmations in all seven languages. It starts from the exact released 8.8 Thing 0.1.13 source archive (SHA256 4959D919E32D6B030CC93D5944DBC1D05E35376EEC8C4B67FE8221B670A08EC0). The 0.1.14 binaries were built from the frozen source and read back as local matching candidate archives. Exact source/runtime identities and scoped build evidence are recorded in SOURCE-SNAPSHOT.json. Native confirmation acceptance remains tracked separately; no installation or public release is claimed.

Historical 0.1.13 qualification

Focused dedicated-server checks passed recovery scheduling without a local player and the tested permission boundaries. A separate two-host check passed actual requests from a non-admin client: Save while Sub-Admin was granted, refusal of shutdown and another player's grant, self-revocation retaining Freeze, and refusal of Save after revocation. Both checks used the released 0.1.13 binaries. Their authorization and server-maintenance source remains unchanged here; they are not new 0.1.14 binary receipts.

These checks do not establish full other-player Take/Delete durability, lost-reply recovery, item accounting, disconnect/rejoin or cold/crash recovery. Those existing inventory features retain their unverified limits. No whole-suite, every-tool, physical-input or arbitrary-mod compatibility claim is made. This code-only release does not include the new art or material candidates.

Requirements

  • BepInExPack Valheim 5.4.2351
  • Jotunn 2.30.2
  • Crucible 0.3.33 or a later compatible 0.3.x, with Crucible.UI 0.3.22 (the shared Meadworks interface kit)

Installation

  • Mod manager (recommended): install Thing with r2modman, Gale or the Thunderstore Mod Manager; the dependencies above are installed for you.
  • Manual: install BepInExPack Valheim, then Jotunn and Crucible, then copy the plugins/Thing folder from this package into BepInEx/plugins/.
  • In multiplayer, install Thing on the server and on every client (see Multiplayer). Delve is optional and installed separately.

Configuration

  • Settings file: BepInEx/config/com.meadworks.thing.cfg. Edit it in game with Almanac (the Meadworks settings book) or any ConfigurationManager.
  • The server's values win for server settings (for example whether non-admins may reset terrain around their own pieces or remove drops) and admins can lock settings; locked settings show as read-only.
  • Thing has no cheat settings.
  • Optional Ward Override and Remove Drops keys are empty by default.
  • Converter: imports Valheim_Admin_Tool's Ward override and Remove drops hotkeys.

Multiplayer

  • Required on all peers: install it on the server and on every client, same major.minor version. The server delivers refusal reasons, warnings and localized messages through each player's Thing.
  • Joining a server without Meadworks: Crucible waits for the server's reply (10 seconds by default), then treats it as a vanilla server; Thing turns off for that session. Thing also turns off on a Meadworks server that does not run Thing.
  • Players without Meadworks (vanilla clients) cannot join a server running Thing. With only server-only or client-optional Meadworks products installed, an admin can let them join with Crucible's Network.AdmissionMode set to AllowVanilla.

Compatibility

  • Steps aside: if Valheim_Admin_Tool is installed, Thing hides only the world tools both offer and says so.
  • Converter imports: Valheim_Admin_Tool's Ward override and Remove drops hotkeys.
  • Optional Meadworks integrations: Delve (Regeneration page), Hex (boss and trader location lookups and spawn audit).

Notes

  • Gamepad: supported through the shared Crucible.UI controller navigation and configurable pad chords.
  • Languages: English, Spanish, Simplified Chinese, Russian, French, German and Korean (non-English text is machine-assisted).
  • Inspired by / replaces (behavior reimplemented, no code reused): Valheim_Admin_Tool (QoLTeam), administration part.
  • Listed under Thunderstore's AI Generated category; tested in-game.
  • Source: matching Corresponding Source is provided as expDARE-Thing-0.1.13-source.zip. The public source repository is https://github.com/ExtraPotions/Meadworks/tree/main/Thing; the matching source archive accompanies this release package.

Changelog

See the Changelog tab (CHANGELOG.md).

Credits and license

Code: GPL-3.0-or-later (LICENSE-CODE.md). Original artwork and documentation: CC BY-NC-SA 4.0 (LICENSE-ASSETS.md). The terrain reset adapts TerrainReset by aedenthorn (public domain); details in SOURCE_NOTICE.md. Other world administration rules follow the documented behavior of Valheim_Admin_Tool by QoLTeam (behavior reference only; no code used).

Author: expDARE.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.