Achievement Hints SeneaL UI

English · 한국어

English

Keep track of what you have crafted, eaten, built, caught, collected, and killed while using SeneaL UI. This unofficial companion adds history hints and an achievement detail browser that follows SeneaL UI's appearance.

Features

• Crafted / not crafted and eaten / not eaten in item tooltips and crafting details.
• Not crafted / not eaten recipe filters, plus a yellow ! on uneaten food slots. Existing food symbols and rarity borders stay visible.
• Inedible ingredients are excluded from uneaten hints. Items explicitly required by food-eating achievements are always included.
• A small UNKILLED badge above-left of eligible wild creature names. Names and their decorations keep their original layout.
• Achievement details with target names, progress, search, and All / Incomplete / Complete filters.
• Filters suited to the achievement: crafting station; creature or trophy-source biome; building usage and material; fish biome and bait.
• Optional creature portraits, generated for visible rows and cached. Standard 256px, 128px for lower-end systems. Unavailable portraits use trophy or achievement icons.
• Undiscovered targets are hidden by default. You can turn this off in settings.

Installation

Install this package and its dependencies with a compatible mod manager, then launch that profile. For a manual installation:

1. Install BepInEx, SeneaL UI, and SeneaL API first.
2. Close Valheim. Copy the archive's plugins/AchievementHintsSeneaLUI/ folder into your profile's BepInEx/plugins/ folder.
3. Launch the game. Open an item's tooltip, the crafting menu, or an achievement through SeneaL UI's achievement button.

When updating, replace the existing SeneaLAchievementHints.dll with the new file. Keep only one copy of this DLL in each profile to avoid duplicate loading.

This is a client mod. Each player who wants these displays installs it locally; a dedicated server does not need it.

Configuration

Open F7 → Mods → Achievement Hints SeneaL UI to adjust the display options. To edit the configuration file instead, launch the game once, close it, then open BepInEx/config/senealachievementhints.cfg. Settings are in [Display].

Undiscovered targets are hidden by default. Turn off Hide undiscovered targets to show all target names and icons.

How discovery and history work

With undiscovered-target hiding enabled, unknown entries show ???. Their icons, portraits, target IDs, progress values, search terms, and category details are concealed in this companion's achievement browser.

Items and building pieces become visible through the character's known materials, known recipes, or relevant recorded actions. Creatures become visible after a recorded kill; historical sightings are not tracked. An item can be known but still not crafted or eaten. Ordinary statistic goals remain readable.

History comes from the game's existing character action records. The mod does not award achievements or modify those records. History belongs to the character and carries across worlds. Missing historical records cannot be reconstructed, and an action shown as completed here does not guarantee it qualified for a platform achievement under that world's rules. Other menus and mods have their own spoiler behavior.

Steam achievement unlocking

This mod displays character history and does not remove Valheim's restrictions on Steam achievement progression. If you want to earn Steam achievements while playing with mods, use a compatible achievement-enabling mod such as AchievementEnabler separately. It is optional for this companion's displays and is not installed automatically as a dependency.

Compatibility

This release targets the following inspected Windows builds:

Game and SeneaL UI fingerprints identify the tested baseline. An unrecognized build produces a warning and runs independent structural checks for item tooltips, crafting details, creature badges, recipe filters, food badges, and the achievement browser. These checks validate required members and reflected field types; crafting patches also validate their insertion points. Only passing groups are enabled. A failed registration rolls back that group's patches and leaves the other groups available.

Jötunn remains optional. An unrecognized Jötunn build is checked separately for the portrait renderer's required API and component-order inspection method. If it is absent or that contract fails, the browser uses existing icons. Public SeneaL API settings are registered independently.

Structural checks are a compatibility precaution, not proof that every future build behaves correctly. Look for Unverified, Feature enabled, and Feature disabled in BepInEx/LogOutput.log; disabled groups include a reason. Package dependency versions are minimums. A newer build can still need a companion update.

Modded targets can appear when the game exposes their definitions and achievement requirements. Some have no usable model, translation, or biome metadata. Unresolved categories remain unclassified. Other mods that replace the same tooltips, crafting filters, or achievement detail view may need compatibility work.

Portraits use a 32-image resident cache and a persistent cache in the profile's BepInEx/cache/ folder. Only visible entries request images. Target preparation is spread across frames, but the first opening or first portrait may still take longer than a cached revisit. For lighter rendering, choose Low128 or disable CreaturePreviewSamples.

Release checks cover isolated game-Mono startup, native patch registration, settings, and linked behavior tests. They do not measure frame time or replace a live in-game check of this release.

Troubleshooting and removal

• No hints after an update: check BepInEx/LogOutput.log for Unverified and Feature disabled, including the affected group and reason.
• Everything is ???: check the discovery rules above or turn off Hide undiscovered targets.
• No creature photo: check the optional Jötunn version; fallback icons are expected for unsupported models.
• Report a problem: include the game/UI/API versions, this mod's version, the affected item or achievement, and the relevant log excerpt.

To remove the mod, close Valheim and remove its DLL from the active profile. The configuration and generated portrait cache may be retained for a later reinstall.

Credits

• SeneaL UI and SeneaL API by seneaL.
• Jötunn by the Valheim modding community, for the optional portrait renderer.
• Iron Gate for Valheim.

This is an independent companion. The package contains its own plugin and original package artwork; upstream libraries and game assets are not bundled.

한국어

SeneaL UI를 사용하면서 제작·섭취·건설·낚시·수집·처치 기록을 확인하는 비공식 업적 도우미입니다. 아이템과 제작창에 기록을 표시하고, SeneaL UI의 외형에 맞춘 업적 상세창을 제공합니다.

기능

• 아이템 툴팁과 제작 상세에 제작 완료 / 미제작, 섭취 완료 / 미섭취를 표시합니다.
• 제작창에 미제작 / 미섭취 필터를 추가하고, 미섭취 음식 슬롯에 노란 **!**를 표시합니다. 기존 음식 아이콘과 희귀도 테두리는 유지됩니다.
• 먹을 수 없는 재료는 미섭취 표시에서 제외합니다. 섭취 업적이 직접 요구하는 아이템은 항상 포함합니다.
• 처치 기록이 없는 야생 생물 이름 왼쪽 위에 작은 미처치 배지를 표시합니다. 기존 이름과 장식 배치는 유지합니다.
• 업적 상세에서 대상 이름·진행도·검색 및 전체 / 미완료 / 완료 필터를 제공합니다.
• 업적에 맞춰 제작대, 생물·트로피 획득 생물의 바이옴, 건축물 용도·재료, 물고기 바이옴·미끼로 필터링합니다.
• 보이는 생물의 미리보기를 생성해 캐시합니다. 기본 256px, 저사양용 128px를 지원하며, 표시할 수 없는 생물은 트로피·업적 아이콘을 사용합니다.
• 미확인 항목 숨김은 기본 켬입니다. 설정에서 끌 수 있습니다.

설치

호환되는 모드 매니저로 이 패키지와 의존성을 설치한 후 해당 프로필을 실행하세요. 수동 설치 방법은 다음과 같습니다.

1. BepInEx, SeneaL UI, SeneaL API를 먼저 설치합니다.
2. 발헤임을 종료합니다. 압축 파일의 plugins/AchievementHintsSeneaLUI/ 폴더를 프로필의 BepInEx/plugins/ 안에 복사합니다.
3. 게임을 실행하고 아이템 툴팁, 제작창, SeneaL UI 업적 버튼을 통해 표시를 확인합니다.

업데이트할 때는 기존 SeneaLAchievementHints.dll을 새 파일로 교체해 주세요. 같은 프로필에 DLL이 중복 설치되지 않도록 한 개만 유지해 주세요.

클라이언트 모드입니다. 표시가 필요한 각 플레이어가 설치하면 되며, 전용 서버에는 설치할 필요가 없습니다.

설정

F7 → Mods → Achievement Hints SeneaL UI에서 표시 옵션을 조절할 수 있습니다. 파일을 직접 편집하려면 게임을 한 번 실행한 뒤 종료하고, BepInEx/config/senealachievementhints.cfg의 [Display] 항목을 수정하세요.

미확인 항목 숨김은 기본으로 켜져 있습니다. 모든 대상의 이름과 아이콘을 보려면 설정에서 미확인 항목 숨김을 끄세요.

공개 기준과 기록 기준

미확인 항목 숨김을 켜면 모르는 대상은 ???로 표시합니다. 이 도우미의 업적 상세창에서 해당 대상의 아이콘·생물 사진·대상 ID·진행 수치·검색어·분류 정보도 함께 숨깁니다.

아이템과 건축물은 캐릭터가 알고 있는 재료·제작법 또는 관련 행동 기록을 기준으로 공개합니다. 생물은 처치 기록이 있어야 공개하며, 과거에 보기만 한 생물은 추적하지 않습니다. 이름을 알고 있는 아이템도 미제작·미섭취 상태일 수 있습니다. 일반 통계형 목표는 계속 표시됩니다.

게임이 저장한 캐릭터 행동 기록을 읽습니다. 업적을 달성시키거나 그 기록을 변경하지 않습니다. 기록은 캐릭터별로 저장되어 월드를 바꿔도 이어집니다. 과거에 저장되지 않은 기록은 복원할 수 없으며, 여기서 완료로 보여도 월드 규칙에 따라 플랫폼 업적에 반영되지 않았을 수 있습니다. 다른 메뉴와 모드의 스포일러 표시는 각 기능을 따릅니다.

Steam 업적 활성화

이 모드는 캐릭터 기록을 표시하며 Valheim의 Steam 업적 제한을 해제하지 않습니다. 모드를 사용하면서 Steam 업적을 달성하려면 AchievementEnabler 같은 호환되는 업적 활성화 모드를 별도로 사용하세요. 이 도우미의 표시 기능에는 선택 사항이며, 필수 의존성으로 자동 설치하지 않습니다.

호환성

이 배포본은 다음 Windows 빌드를 기준으로 확인했습니다.

게임과 SeneaL UI의 파일 지문으로 검사한 기준 빌드인지 확인합니다. 미검증 빌드에서는 경고를 남긴 뒤 아이템 툴팁·제작 상세·생물 배지·제작 필터·음식 표식·업적 상세창을 각각 구조 검사합니다. 필요한 함수와 필드 형식을 확인하고, 제작 패치는 삽입 위치도 확인합니다. 통과한 기능만 켜며, 등록 도중 실패하면 해당 기능의 패치만 되돌리고 나머지는 유지합니다.

Jötunn은 선택 사항입니다. 미검증 Jötunn 빌드는 사진 렌더러에 필요한 API와 컴포넌트 순서 검사 함수를 별도로 확인합니다. 없거나 검사에 실패하면 기존 아이콘을 사용합니다. SeneaL API 설정 등록도 독립적으로 처리합니다.

구조 검사는 호환성을 위한 사전 검사이며, 앞으로 나올 모든 버전의 정상 동작을 보장하지 않습니다. BepInEx/LogOutput.log의 Unverified, Feature enabled, Feature disabled에서 결과를 확인할 수 있으며, 꺼진 기능에는 이유가 표시됩니다. 패키지 의존성은 최소 버전이므로 새 빌드에 맞는 도우미 업데이트가 필요할 수 있습니다.

게임에서 정의와 업적 목표를 제공하면 모드로 추가된 대상도 표시할 수 있습니다. 일부 대상은 사용할 모델·번역·바이옴 정보가 없어 기존 아이콘이나 분류 없음으로 표시됩니다. 같은 툴팁·제작 필터·업적 상세창을 교체하는 모드는 별도 호환 작업이 필요할 수 있습니다.

생물 사진은 메모리에 최대 32장을 유지하며 프로필의 BepInEx/cache/ 폴더에도 저장합니다. 보이는 행만 사진을 요청하고, 목표 목록 준비는 여러 프레임에 나눕니다. 그래도 첫 목록 진입이나 첫 촬영은 캐시된 재방문보다 오래 걸릴 수 있습니다. 부담이 있으면 Low128을 선택하거나 CreaturePreviewSamples를 끄세요.

배포 검사는 격리된 게임 Mono에서의 시작·원본 패치 등록·설정 및 실제 로직을 연결한 행동 검사를 포함합니다. 프레임 시간을 실측하거나 이번 버전의 인게임 확인을 대신하는 검사는 아닙니다.

문제 해결과 제거

• 업데이트 후 표시가 없음: BepInEx/LogOutput.log의 Unverified, Feature disabled에서 해당 기능과 중지 이유를 확인하세요.
• 전부 ???로 보임: 위 공개 기준을 확인하거나 미확인 항목 숨김을 끄세요.
• 생물 사진이 안 나옴: 선택 의존성인 Jötunn 버전을 확인하세요. 지원되지 않는 모델은 기존 아이콘을 사용합니다.
• 오류 제보: 게임·UI·API 버전, 도우미 버전, 해당 아이템·업적, 관련 로그 부분을 함께 알려 주세요.

제거할 때는 게임을 종료하고 사용 중인 프로필에서 이 DLL을 제거합니다. 설정과 생성된 사진 캐시는 재설치를 위해 남겨 두어도 됩니다.

크레딧

• seneaL — SeneaL UI, SeneaL API.
• Valheim 모딩 커뮤니티 — 선택형 미리보기 렌더러에 사용하는 Jötunn.
• Iron Gate — Valheim.

독립적으로 제작한 비공식 도우미입니다. 패키지에는 이 도우미 DLL과 직접 만든 패키지 아이콘을 포함하며, 다른 모드의 라이브러리나 게임 에셋은 동봉하지 않습니다.